jatayu_flutter 0.11.0
jatayu_flutter: ^0.11.0 copied to clipboard
Mobile analytics, attribution, observability, and remote configuration for the Jatayu platform.
0.11.0 #
X-Jatayu-SDKnow reportsflutter/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 fromjatayuPushBackgroundand 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 onandroidx.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 withX-Jatayu-SDK,X-Jatayu-Protocol,X-Jatayu-Device,X-Jatayu-Platform, andUser-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 withPOST /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.onErrorandPlatformDispatcher.onErroris 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()andpendingUpdateexpose the verdict. SetJatayuUpdateOptions(enabled: false)to render your own UI. - The prompts need a navigator: attach
JatayuNavigatorObserveror passJatayuUpdateOptions.navigatorKey. "Update" opens the store listing through the new nativeopenUrlmethod (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_rotatedresponses, 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-SDKandX-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-Matchinstead 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) andjt_app_background(durationMsof foreground time).jt_app_openreplacesapp_open. track()throws for event names starting with the reservedjt_prefix.- The reported
sdkVersioncontext matches the package version.
0.5.0 #
- Removed
PushProvider.onesignal. Push is Firebase Cloud Messaging on both platforms. enablePushregisters Firebase Cloud Messaging on iOS and Android, shows Android notifications (image, action buttons) and reports delivery, opens and button taps. RegisterjatayuPushBackgroundinmainbeforerunApp.- In-app messages (modal, banner, fullscreen) load with
enablePushand show on session start or a named event. RequiresJatayuNavigatorObserver.
0.4.3 #
- New
JatayuNavigatorObserver: attach toMaterialApp.navigatorObserversorGoRouter(observers: ...)to recordscreen_viewon named-route push, replace, and pop (screenplusprevious_screenwhen known). Unnamed routes and dialogs are skipped; collection still respects consent.
0.4.2 #
- New
setRevenueCatAppUserIdandsetFirebaseUid: report the ids and the dashboard's user page looks the account up live in each connected provider (authenticateFirebasealready links the Firebase uid automatically). - Batches send
fingerprintHashand omit the full fingerprint until the server repliesX-Jatayu-Fingerprint: stale(or the report itself changes). - Ingest acknowledgements are
{accepted: n, duplicates: n}. Emptygroupsare omitted;groups: nullclears memberships afterresetIdentity/ 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 SwiftArraystruct tosysctlbynameinstead of the element buffer, corrupting array metadata and crashing later; it now useswithUnsafeMutableBufferPointer, with a size guard, guaranteed NUL termination, and a hex fallback for numeric sysctls. Same buffer-pointer fix in the debugger check. UIDevice/UIScreenreads in the fingerprint path now run on the main thread via a smallonMainhelper, since collection runs on a background queue. ThecollectHardwareSignals: !Platform.isIOShost-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 withAuthorization: Bearer <session>, retries once on 401, and rotates viaX-Jatayu-Session. Requires a server build that includesserver/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
configFetchIntervalis 15 minutes to match the servermax-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) andrequestDeviceCheckToken(iOS) for server-verified attestation. Play Integrity is loaded reflectively and stays optional.- New
JatayuFingerprintOptions;fingerprintgetter andrefreshFingerprint()on the client. - Link-open click attribution:
handleLinkforwards the open intent's click id (_jt_c) to/api/v1/links/resolve, records an attributedcampaign_open, and stages the click id (newpendingClickIdgetter) 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
registerPushTokenwithPushProvider.onesignal. endpointnow defaults to Jatayu Cloud (https://api.jatayu.click); set it only for self-hosted servers.- New
linkHostsoption: extra hosts accepted byhandleLinkfor 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.