Skip to main content

jatayu_flutter 0.11.0 copy "jatayu_flutter: ^0.11.0" to clipboard
jatayu_flutter: ^0.11.0 copied to clipboard

PlatformAndroidiOS
unlisted

Mobile analytics, attribution, observability, and remote configuration for the Jatayu platform.

0.11.0 #

  • X-Jatayu-SDK now reports flutter/0.11.0.

0.10.0 #

  • Uninstall tracking, on by default (JatayuOptions.uninstallTracking). On Android a WorkManager job checks in (POST /api/v1/heartbeat) at the interval the session response sets, so the dashboard can tell a quiet install from an uninstalled one, including installs with no push token. Silent push probes (jatayu_probe) are answered on both platforms from jatayuPushBackground and the foreground handler, and are never shown. Revoking consent cancels the job and tells the server the check-ins are stopping on purpose. The plugin now depends on androidx.work:work-runtime.

0.9.1 #

  • The session challenge and the mint that spends it now send the device id, platform, and device type (model, manufacturer, osVersion, appVersion) together with X-Jatayu-SDK, X-Jatayu-Protocol, X-Jatayu-Device, X-Jatayu-Platform, and User-Agent. A call missing any of them, or with values that disagree, is rejected.

0.9.0 #

  • Session mint fetches a short-lived challenge (POST /api/v1/session/challenge) and sends it with POST /api/v1/session. Ship a server that issues challenges before this SDK, or new installs cannot connect.
  • Automatic error capture no longer marks network failures, Flutter framework errors, and other recoverable exceptions as fatal crashes. The same error reported by both FlutterError.onError and PlatformDispatcher.onError is recorded once.

0.8.0 #

  • Update prompts for outdated builds, driven by the dashboard (App settings → App updates). Below the minimum version the SDK shows a full-screen update screen that the back button can't close, and pushes it again if the app replaces or pops it. Below the recommended version it shows a dialog that "Later" puts off for JatayuUpdateOptions.snooze (3 days by default).
  • A required update is cached for the running app version, so the next launch blocks even when offline.
  • Checked on launch and on each new session. checkForUpdate() and pendingUpdate expose the verdict. Set JatayuUpdateOptions(enabled: false) to render your own UI.
  • The prompts need a navigator: attach JatayuNavigatorObserver or pass JatayuUpdateOptions.navigatorKey. "Update" opens the store listing through the new native openUrl method (on Android, the Play Store app when it is installed).
  • New lifecycle event jt_update_prompt (kind, action: shown / accepted / dismissed, version, target_version).

0.7.0 #

  • Event batches are encrypted end to end as a compact JWE (RSA-OAEP-256 + A256GCM) to the server's public event key. The key arrives with the device session; server key rotations reach the SDK through batch acknowledgements and 409 event_key_rotated responses, and no app update is needed.
  • The queue still holds plaintext events with stable IDs. Each send re-seals them, so a batch retried after a rotation keeps its event IDs. Batches are never sent in plaintext: without a key they stay queued.
  • Requests carry X-Jatayu-SDK and X-Jatayu-Protocol: jwe-v1. The server refuses plaintext batches from 0.7.0 onwards, so update the server before shipping this version.
  • The remote-config ETag is persisted with the cached values, so a cold start revalidates with If-None-Match instead of downloading them again.

0.6.0 #

  • Automatic lifecycle events with fixed names, listed on JatayuEvents: jt_app_install, jt_app_update (version, previous_version), jt_app_open (cold_start) and jt_app_background (durationMs of foreground time). jt_app_open replaces app_open.
  • track() throws for event names starting with the reserved jt_ prefix.
  • The reported sdkVersion context matches the package version.

0.5.0 #

  • Removed PushProvider.onesignal. Push is Firebase Cloud Messaging on both platforms.
  • enablePush registers Firebase Cloud Messaging on iOS and Android, shows Android notifications (image, action buttons) and reports delivery, opens and button taps. Register jatayuPushBackground in main before runApp.
  • In-app messages (modal, banner, fullscreen) load with enablePush and show on session start or a named event. Requires JatayuNavigatorObserver.

0.4.3 #

  • New JatayuNavigatorObserver: attach to MaterialApp.navigatorObservers or GoRouter(observers: ...) to record screen_view on named-route push, replace, and pop (screen plus previous_screen when known). Unnamed routes and dialogs are skipped; collection still respects consent.

0.4.2 #

  • New setRevenueCatAppUserId and setFirebaseUid: report the ids and the dashboard's user page looks the account up live in each connected provider (authenticateFirebase already links the Firebase uid automatically).
  • Batches send fingerprintHash and omit the full fingerprint until the server replies X-Jatayu-Fingerprint: stale (or the report itself changes).
  • Ingest acknowledgements are {accepted: n, duplicates: n}. Empty groups are omitted; groups: null clears memberships after resetIdentity / removing the last group. Requires a server that includes these ingest changes.

0.4.1 #

  • Fixed an iOS crash in device fingerprinting. sysctlString() passed the Swift Array struct to sysctlbyname instead of the element buffer, corrupting array metadata and crashing later; it now uses withUnsafeMutableBufferPointer, with a size guard, guaranteed NUL termination, and a hex fallback for numeric sysctls. Same buffer-pointer fix in the debugger check.
  • UIDevice / UIScreen reads in the fingerprint path now run on the main thread via a small onMain helper, since collection runs on a background queue. The collectHardwareSignals: !Platform.isIOS host-app workaround is no longer needed.

0.4.0 #

  • Breaking server protocol change — upgrade the SDK and server together. SDK routes now authenticate with a 24h device session JWT minted once via POST /api/v1/session (the only call that sends the write key); every later call verifies statelessly server-side with Authorization: Bearer <session>, retries once on 401, and rotates via X-Jatayu-Session. Requires a server build that includes server/session.ts. Old SDK versions get 401s against the new server, and 0.4.0 gets 401s against an old server.
  • Removed the 30s foreground heartbeat: events batches bump liveness server-side, so live-user counts ride on delivery with no separate call (heartbeat() is gone).
  • Steady-state batches now omit unchanged device context (server merges what it receives), cutting upload size; the omitted hash is re-sent automatically after consent rotation.
  • Remote-config default configFetchInterval is 15 minutes to match the server max-age.

0.3.0 #

  • Anti-fraud device fingerprinting, on by default and gated by consent. Identity is anchored on sources that survive reinstall and a "Clear storage" wipe — SSAID, Widevine device ID and App Set ID on Android, keychain and IDFV on iOS — reported as per-app salted hashes.
  • Probabilistic hardware signature from ten independently hashed components (sensors, GPU, camera, display, CPU, audio, features, kernel, build, memory), for fuzzy matching that survives OS updates.
  • Integrity signals: emulator, root, jailbreak, runtime hooking (Frida/Xposed/Substrate), debugger, sideload, mock location, clock tampering, VPN and proxy detection.
  • Play Install Referrer now reports click and install-begin timestamps, so the server can compute click-to-install time and detect click injection and click flooding.
  • requestPlayIntegrityToken (Android) and requestDeviceCheckToken (iOS) for server-verified attestation. Play Integrity is loaded reflectively and stays optional.
  • New JatayuFingerprintOptions; fingerprint getter and refreshFingerprint() on the client.
  • Link-open click attribution: handleLink forwards the open intent's click id (_jt_c) to /api/v1/links/resolve, records an attributed campaign_open, and stages the click id (new pendingClickId getter) on the next events batch so a first open still matches its tap within the link's click window.

0.2.0 #

  • OneSignal push provider: pass the OneSignal subscription (player) ID to registerPushToken with PushProvider.onesignal.
  • endpoint now defaults to Jatayu Cloud (https://api.jatayu.click); set it only for self-hosted servers.
  • New linkHosts option: extra hosts accepted by handleLink for campaign (/l/) and referral (/r/) links.

0.1.0 #

  • Batched event ingestion, persistent bounded queue, and retry with deduplication.
  • Consent, installation identity, sessions, errors, traces, and typed remote config.
  • Android Play Install Referrer and iOS SKAN / AdAttributionKit conversion bridges.
  • APNs and FCM token registration for server-side invalidation checks.