DevRoute SDK

<!-- Step 2: Add the SDK -->
<script src="https://devroute.app/sdk/v3/devroute.min.js"></script>

<!-- Step 3: Initialize -->
<script>
  DevRoute.init({
    apiKey: 'esim_live_YOUR_API_KEY',
    onResult: function(result) {
      console.log('Device:', result.brand, result.model);
      console.log('eSIM supported:', result.esim.esimSupported);
    }
  });
</script>

<script src="https://devroute.app/sdk/v3/devroute.min.js"></script>

<script src="https://devroute.app/sdk/v3.0.0/devroute.min.js"></script>

DevRoute.init({
  // Required
  apiKey: 'esim_live_YOUR_API_KEY',

  // Called with the result object when detection succeeds
  onResult: function(result) {
    // result contains device, eSIM, network, and risk data
  },

  // Called if the API request fails (optional)
  onError: function(err) {
    console.warn('DevRoute error:', err.message);
  }
});

{
  // ── Device — Free+ ──────────────────────────────────────────────────
  id:               "sha256_device_hash",  // unique device fingerprint
  brand:            "Samsung",
  model:            "Galaxy S24",
  confidence:       0.92,            // 0.0–1.0 detection confidence
  detectionMethod:  "server-index-lookup",
  OS: {
    name:    "Android",
    version: "14"
  },
  screenResolution: "1080x2340",
  pixelRatio:       3,
  timezone:         "America/New_York",
  language:         "en-US",

  // ── eSIM & Routing — Starter+ ────────────────────────────────────────
  family:       "Galaxy S24 Series",
  GPU:          "Adreno 750",
  networkType:  "4g",       // "2g" | "3g" | "4g" | "5g" | "wifi"
  device_tier: "premium",  // "premium" | "mid" | "budget" | "unknown"
  device_hash: "sha256...", // stable fingerprint across sessions
  esim: {
    esimSupported:      true,
    dualEsim:           false,
    conversionStrategy: "guided_install",  // see Conversion Strategies below
    recommendedFlow:    "step_by_step"
  },
  intelligence: {               // see Intelligence Engine section
    decisions: {
      esim_flow:     { value: "step_by_step", reason: "Samsung device on Android 14..." },
      friction:      { value: "none",          reason: "Low risk score, trusted signals" },
      security_gate: { value: "none",          reason: "No fraud signals detected" },
      ui_mode:       { value: "streamlined",  reason: "Premium device, simplify UI" },
      priority:      { value: "high",          reason: "eSIM capable, premium segment" }
    },
    narrative: {
      headline: "Genuine Samsung user ready for guided eSIM install"
    }
  },

  // ── Network — Growth+ ────────────────────────────────────────────────
  IP:          "203.0.113.42",
  isp:         "Comcast Cable",
  vpn:         false,
  ram:         8,    // GB, from navigator.deviceMemory
  cores:       8,    // from navigator.hardwareConcurrency
  asn:         7922,
  httpProtocol: "HTTP/2",

  // ── Fraud + Geo — Enterprise+ ────────────────────────────────────────
  emulator:         false,
  bot:              false,
  risk_score:       8,      // 0–100, higher = riskier
  signal_conflicts: [],    // array of detected signal contradictions
  timezone_mismatch: false, // browser TZ ≠ IP TZ → VPN signal
  country:          "US",  // ISO 3166-1 alpha-2
  city:             "New York",
  region:           "New York",
  latitude:         40.71,
  longitude:        -74.00,
  postalCode:       "10001",
  isEUCountry:      false,
  tlsVersion:       "TLSv1.3",
  threatScore:      0       // Proxycheck.io threat score (0–100)
}

var d = result.intelligence.decisions;

// Always use .value to drive your logic
console.log(d.esim_flow.value);   // "auto_install"
console.log(d.esim_flow.reason);  // "iOS 17 with confirmed eSIM — use Quick Transfer"

console.log(d.friction.value);    // "none" | "soft" | "hard"
console.log(d.security_gate.value); // "none" | "review" | "block"
console.log(d.ui_mode.value);     // "streamlined" | "standard" | "cautious"
console.log(d.priority.value);    // "high" | "medium" | "low"

var intel = result.intelligence;

// User segment
intel.profile.segment;     // "genuine_user" | "corporate_user" | "privacy_user"
                            // | "traveler" | "developer" | "fraudulent_actor"
                            // | "automated_actor" | "tor_user" | "unclassified"
intel.profile.confidence;  // 0.0–1.0 segment confidence
intel.profile.signals;    // ["esim_capable", "residential_isp", ...]

// Authenticity
intel.authenticity.score;   // 0–100 (higher = more authentic)
intel.authenticity.verdict; // "authentic" | "suspicious" | "likely_bot"

// Scores (0–100)
intel.scores.risk;        // fraud risk (lower = safer)
intel.scores.conversion;  // likelihood to convert (higher = better)
intel.scores.experience;  // UX quality score — use to gate premium features

DevRoute.init({
  apiKey: 'esim_live_YOUR_KEY',
  onResult: function(result) {
    // happy path
  },
  onError: function(err) {
    // err.message — human-readable error
    // Common: "HTTP 401" (bad key), "HTTP 429" (limit reached), network errors
    console.warn('[DevRoute]', err.message);
  }
});

DevRoute.init({
  apiKey: 'esim_live_YOUR_KEY',
  onResult: function(result) {
    var flow = result.esim.conversionStrategy;

    if (flow === 'direct_install') {
      // iOS 16+ / Pixel — tap-through carrier activation, no QR needed
      showActivateButton(carrierDeepLinkUrl);

    } else if (flow === 'guided_install') {
      // Samsung / Android 12+ — OS-native Settings wizard
      showGuidedModal(result.brand, result.OS.version);

    } else if (flow === 'qr_install') {
      // eSIM supported, show QR code for profile download
      showQRCode();

    } else if (flow === 'manual_install') {
      // Low-confidence detection — show activation code entry
      showActivationCodeForm();

    } else if (flow === 'unsupported_device') {
      // Device can't use eSIM — offer physical SIM or upgrade
      showPhysicalSimFallback();
    }

    // Optional: use intelligence decisions for UX fine-tuning
    var d = result.intelligence?.decisions;
    if (d?.ui_mode?.value === 'streamlined') collapseSecondaryOptions();
    if (d?.priority?.value === 'high') showPremiumPlanBanner();
  }
});

DevRoute.init({
  apiKey: 'esim_live_YOUR_KEY',
  onResult: function(result) {
    var gate     = result.intelligence?.decisions?.security_gate?.value;
    var friction = result.intelligence?.decisions?.friction?.value;

    if (gate === 'block') {
      blockSession();          // high-confidence fraud
    } else if (gate === 'review' || friction === 'hard') {
      showSmsVerification();   // suspicious — step-up auth
    } else if (friction === 'soft') {
      showCaptcha();           // mild friction only
    } else {
      enableCheckout();        // clean session
    }
  }
});

DevRoute.init({
  apiKey: 'esim_live_YOUR_KEY',
  onResult: function(result) {
    var riskScore  = result.risk_score;   // 0–100
    var isBot      = result.bot;
    var isVpn      = result.vpn;           // Growth+
    var conflicts  = result.signal_conflicts; // array of contradiction strings

    if (isBot || riskScore > 80) {
      blockSession();
    } else if (isVpn || riskScore > 50 || conflicts.length > 1) {
      triggerStepUpVerification();
    } else {
      enableCheckout();
    }
  }
});

var REGIONAL_PRICES = {
  'US': { amount: '$4.99',  currency: 'USD' },
  'GB': { amount: '£3.99',  currency: 'GBP' },
  'DE': { amount: '€4.49',  currency: 'EUR' },
  'IN': { amount: '₹99',    currency: 'INR' },
};

DevRoute.init({
  apiKey: 'esim_live_YOUR_KEY',
  onResult: function(result) {
    var country = result.country;
    var price   = REGIONAL_PRICES[country] || REGIONAL_PRICES['US'];
    document.getElementById('price-display').textContent = price.amount;
  }
});