🌐 Dwield Device Intelligence & Behavioural Biometrics SDK

$3

The Dwield SDK provides high-accuracy device fingerprinting, behavioural biometrics, and combined identity intelligence—all in a lightweight JavaScript package designed for modern web applications.

Whether you're building fraud detection, bot defense, risk scoring, or continuous authentication, Dwield gives you deep visibility into user behaviour & device environments with minimal integration effort.

---

✨ Key Capabilities

$3

Detect spoofing, automation, emulators, privacy modes, and high-risk environments.

Includes:
- Browser & OS attributes
- Canvas, audio & WebGL fingerprinting
- Incognito detection
- Plugin, fonts & storage capabilities
- Device sensors (orientation, motion, battery)
- Bot detection signals

---

$3

Understand how a user behaves—not just what they input.

Captures:
- Keystroke rhythm & timing
- Mouse movement velocity & acceleration
- Movement patterns & micro-behaviours
- Human vs bot interaction signals

Privacy-preserving (no raw keystrokes recorded).

---

$3

Merge device signals + behavioural signals into a single high-confidence identity token.

Ideal for:
- Login risk scoring
- Fraud detection
- Payment protection
- Session integrity
- Zero-trust systems

---

⚡ Installation

bash

npm install @dwield/device-biometrics-sdk

or

bash

yarn add @dwield/device-biometrics-sdk





---



🚀 Quick Start



Dwield provides three product tiers, each accessible via a different initializer.



---



1️⃣ Device Intelligence SDK



$3

js

import { initDeviceInfo } from "@dwield/device-biometrics-sdk";



const client = await initDeviceInfo({

  apiKey: "YOUR_API_KEY",

  verbose: true,

});

$3

js

const device = await client.getDeviceData();

console.log("Device Fingerprint:", device);





---



2️⃣ Behavioural Biometrics SDK



$3

js

import { initBiometrics } from "@dwield/device-biometrics-sdk";



const client = await initBiometrics({ apiKey: "YOUR_API_KEY" });



client.initKeyStrokeDynamics();

client.initMouseDynamics();

$3

js

const keystrokes = client.fetchKeyStrockDynamicsData();

const mouse = client.fetchMouseDynamicsData();

$3

js

client.stopKeyStrokeDynamics();

client.stopMouseDynamics();





---



3️⃣ Combined Fingerprinting SDK  

$3

js

import { initDeviceInfoWithBiometrics } from "@dwield/device-biometrics-sdk";



const client = await initDeviceInfoWithBiometrics({

  apiKey: "YOUR_API_KEY"

});





Start tracking:

js

client.initKeyStrokeDynamics();

client.initMouseDynamics();





Fetch full fingerprint:

js

const fingerprint = await client.getDeviceInfoWithBiometrics();

console.log("Full Fingerprint:", fingerprint);

$3

js

const result = await client.generateFingerPrint({

  userId: "user@example.com",

  firstName: "John", // optional, defaults to "System"

  lastName: "Doe"    // optional, defaults to "System"

});

console.log("Risk Score Result:", result);





Stop:

js

client.stopKeyStrokeDynamics();

client.stopMouseDynamics();





---



⚛️ React Integration (Recommended)

jsx

import { useEffect, useRef, useState } from "react";

import { initDeviceInfoWithBiometrics } from "@dwield/device-biometrics-sdk";



export default function FingerprintForm() {

  const sdkRef = useRef(null);

  const [result, setResult] = useState(null);



  useEffect(() => {

    const init = async () => {

      const client = await initDeviceInfoWithBiometrics({

        apiKey: "YOUR_API_KEY",

        verbose: true

      });



      client.initKeyStrokeDynamics();

      client.initMouseDynamics();



      sdkRef.current = client;

    };



    init();



    return () => {

      if (sdkRef.current) {

        sdkRef.current.stopKeyStrokeDynamics();

        sdkRef.current.stopMouseDynamics();

      }

    };

  }, []);



  const handleSubmit = async () => {

    // Generate device fingerprint & risk score

    const result = await sdkRef.current.generateFingerPrint({

      userId: "user@example.com",

      firstName: "John",

      lastName: "Doe"

    });

    setResult(result);

  };



  return (

    <>

      

      {result && {JSON.stringify(result, null, 2)}}

    

  );

}





---



🌍 Vanilla JavaScript Example

html





---



📊 Sample Combined Fingerprint

json

{

  "behavioural": {

    "keystroke": { ... },

    "mouse": { ... }

  },

  "device": {

    "browserInfo": { ... },

    "webglInfo": { ... },

    "fonts_available": [ ... ],

    "batteryInfo": { ... }

  },

  "timestamp": "2025-01-01T10:05:32.911Z"

}





---



📚 API Reference



$3

ts

 interface DeviceInfoSDK {

   product: "device_id";

   getDeviceData(): Promise;

   generateFingerPrint(userInfo: { userId: string; firstName?: string; lastName?: string }): Promise;

 }



 

 ---

 

 ###

initBiometrics(config) → BiometricsSDK

ts

 interface BiometricsSDK {

   initKeyStrokeDynamics(): void;

   stopKeyStrokeDynamics(): void;

   initMouseDynamics(): void;

   stopMouseDynamics(): void;

   fetchKeyStrockDynamicsData(): any;

   fetchMouseDynamicsData(): any;

   generateFingerPrint(userInfo: { userId: string; firstName?: string; lastName?: string }): Promise;

 }



 

 ---

 

 ###

initDeviceInfoWithBiometrics(config) → CombinedSDK

ts

 interface CombinedSDK {

   initKeyStrokeDynamics(): void;

   stopKeyStrokeDynamics(): void;

   initMouseDynamics(): void;

   stopMouseDynamics(): void;

   fetchKeyStrockDynamicsData(): any;

   fetchMouseDynamicsData(): any;

   getDeviceData(): Promise;

   getDeviceInfoWithBiometrics(): Promise;

   generateFingerPrint(userInfo: { userId: string; firstName?: string; lastName?: string }): Promise;

 }





---



🔐 Security & Privacy



Dwield SDK is built with privacy in mind:



- No raw keystrokes recorded  

- No PII captured  

- Behavioural signals are anonymized  

- Fully compliant with GDPR when used with proper consent



---



🛡️ Error Handling



The SDK performs an asynchronous validation of the API Key during initialization. If validation fails, it throws an error.



It is recommended to wrap the initialization in a

try...catch

 block to handle unauthorized access gracefully:

js

try {

  const client = await initDeviceInfoWithBiometrics({ apiKey: "YOUR_KEY" });

  // ... use client

} catch (error) {

  console.error("SDK Initialization Failed:", error.message);

  // Handle error (e.g., disable features, fallback)

}

  



---



🧠 TypeScript Support



Rich TypeScript definitions included:



- Strong typing  

- IntelliSense  

- Autocomplete for all SDK clients  



Enable using:

json

"types": "./types/index.d.ts"

``

---

🏢 Enterprise Features (Optional Add-ons)

- License key validation
- Server-side risk scoring engine
- Device correlation
- Session intelligence
- Real-time fraud rules

---

📞 Support

For enterprise licensing, help, or integration:

📧 support@dwield.com
🌍 https://dwield.com (placeholder)

---

📄 License

Proprietary — Dwield Technologies.
Contact us for commercial usage and redistribution permissions.