WordPress Integration Guide

add_action( 'wp_enqueue_scripts', function () {
    wp_enqueue_script(
        'helios-fp',
        'https://fp.techstudio.live/sdk/latest/helios-fingerprint.umd.js',
        [], null, true
    );

    wp_add_inline_script( 'helios-fp', "
        (function(){
            if(typeof HeliosFingerprint==='undefined') return;
            var _agent=null;
            function runHeliosOnce(){
                var p=_agent?Promise.resolve(_agent):HeliosFingerprint.load({publicApiKey:'YOUR_PUBLIC_API_KEY'}).then(function(f){_agent=f;return f;});
                return p.then(function(f){return f.get();});
            }
            runHeliosOnce().then(function(r){
                    sessionStorage.setItem('helios_visitor_id',    r.visitorId    || '');
                    sessionStorage.setItem('helios_device_core_id', r.deviceCoreId || '');
                    sessionStorage.setItem('helios_browser_scoped', r.browserScopedId || '');
                    sessionStorage.setItem('helios_ip',             r.ip           || '');
                });
        }());
    " );
} );

// Safe to read on any user interaction (click, submit, etc.)
const visitorId    = sessionStorage.getItem('helios_visitor_id')     || '';
const deviceCoreId = sessionStorage.getItem('helios_device_core_id') || '';
const ip           = sessionStorage.getItem('helios_ip')             || '';

// Example: attach to a form submission
document.getElementById('checkout-form')
    .addEventListener('submit', function (e) {
        document.getElementById('hidden-visitor-id').value = visitorId;
    });

// Helios runs deferred on page load — by the time the user clicks
// anything, sessionStorage is already populated.
document.getElementById('launch-game-btn')
    .addEventListener('click', function () {
        const visitorId    = sessionStorage.getItem('helios_visitor_id')     || '';
        const deviceCoreId = sessionStorage.getItem('helios_device_core_id') || '';

        fetch('/wp-json/myplugin/v1/launch', {
            method: 'POST',
            headers: { 'Content-Type': 'application/json', 'X-WP-Nonce': myPlugin.nonce },
            body: JSON.stringify({
                gameId:       myPlugin.gameId,
                visitorId:    visitorId,
                deviceCoreId: deviceCoreId,
            }),
        });
    });

// Works at any WP hook where the user is known
add_action( 'wp_login', function ( string $username, WP_User $user ) {
    $visitor_id  = (string) get_user_meta( $user->ID, 'helios_visitor_id',    true );
    $device_core = (string) get_user_meta( $user->ID, 'helios_device_core_id', true );

    if ( '' !== $visitor_id ) {
        MyThirdPartySDK::identify( $visitor_id, $device_core );
    }
}, 10, 2 );

// Fires the moment the browser POSTs a fingerprint to /helios/v1/identify.
// Perfect for syncing to a remote fraud service immediately.
add_action( 'helios_fingerprint_identified', function ( array $data, WP_REST_Request $req ) {
    MyThirdPartySDK::trackVisit([
        'visitor_id'   => $data['visitorId'],
        'device_core'  => $data['deviceCoreId'],
        'ip'           => $data['ip'],
        'is_vpn'       => $data['flags']['isVpn']       ?? '',
        'is_incognito' => $data['flags']['isIncognito'] ?? '',
    ]);
}, 10, 2 );

add_action( 'wp_enqueue_scripts', function () {
    wp_enqueue_script(
        'helios-fp-sdk',
        'https://fp.techstudio.live/sdk/latest/helios-fingerprint.umd.js',
        [], null, true
    );

    wp_add_inline_script( 'helios-fp-sdk', "
        (function(){
            if(typeof HeliosFingerprint==='undefined') return;
            var _agent=null;
            function runHeliosOnce(){
                var p=_agent?Promise.resolve(_agent):HeliosFingerprint.load({publicApiKey:'YOUR_PUBLIC_API_KEY'}).then(function(f){_agent=f;return f;});
                return p.then(function(f){return f.get();});
            }
            runHeliosOnce().then(function(r){
                    sessionStorage.setItem('helios_visitor_id',    r.visitorId    || '');
                    sessionStorage.setItem('helios_device_core_id', r.deviceCoreId || '');

                    if(typeof MyThirdPartySDK !== 'undefined') {
                        MyThirdPartySDK.identify(r.visitorId, r.deviceCoreId, r.ip);
                    }
                });
        }());
    " );
} );

class My_Helios_Bridge {

    /** Returns visitorId from WC session or user meta. Empty string if unavailable. */
    public static function get_visitor_id(): string {
        return self::get_meta( 'helios_visitor_id' );
    }

    public static function get_device_core_id(): string {
        return self::get_meta( 'helios_device_core_id' );
    }

    public static function get_browser_scoped_id(): string {
        return self::get_meta( 'helios_browser_scoped_id' );
    }

    private static function get_meta( string $key ): string {
        $user_id = get_current_user_id();
        if ( $user_id > 0 ) {
            return (string) get_user_meta( $user_id, $key, true );
        }
        if ( function_exists( 'WC' ) && WC()->session ) {
            return (string) WC()->session->get( $key, '' );
        }
        return '';
    }
}

// ── Usage anywhere in your plugin: ────────────────────────────────────────────
$visitor_id  = My_Helios_Bridge::get_visitor_id();
$device_core = My_Helios_Bridge::get_device_core_id();

MyThirdPartyAPI::submitTransaction( $payload, $visitor_id, $device_core );