justgold_sdk 1.1.22
justgold_sdk: ^1.1.22 copied to clipboard
JustGold Connect SDK for Flutter — embeddable gold & silver trading UI for partner apps.
Changelog #
1.1.22 #
- Make the boot-shimmer back button interactive so users can close the SDK while it is still loading
- Keep the loading back button correctly positioned for Arabic when the locale resolves during startup
- Refresh the Buy, Sell, and Delivery FAQ wording
1.1.21 #
- Keep the native startup shimmer visible until the first SDK route is ready, eliminating the transition blink and preventing an intermittent stuck loader
- Initialize Sell with the customer's available gold or silver balance without briefly displaying zero
1.1.20 #
- Add a native boot shimmer while the CDN UI loads to prevent white flashes, with locale-aware layout
- Improve trading and FAQ UI, remove the pre-buy terms gate, and simplify transaction filters
1.1.19 #
- Embedded UI: minimum buy/sell validation always shows the configured currency limit, including when the customer enters grams (for example,
Minimum amount to sell is AED 10) - Embedded UI: transaction Date filter shows the current launch year; from 2027 onward it also shows the previous calendar year
1.1.18 #
- Drop the native boot shimmer; show the SDK page background until the HTML boot loader paints (no white/black flash). Local Vite appends
localeon the URL so the boot shimmer matches the app language - Embedded UI: new transactions icon; FAQ copy (Buy Gold & Silver, VAT on the service fee, instant vault/wallet credit); quote lock-in countdown 3 minutes; buy amount defaults to AED 10
1.1.17 #
- Android: reserve the 3-button navigation inset when
MediaQuery.paddingis 0 (edge-to-edge)
1.1.16 #
onInvoiceShare/onInvoiceDownload— opt-in invoice handoff (InvoiceHostPayload). SetsuseHostInvoiceActionsonINIT_SESSION. Requires an SDK UI CDN build that emitsINVOICE_SHARE/INVOICE_DOWNLOAD. Fill AcroForm widgetcustomerName
1.1.15 #
- iOS: fix CocoaPods / Xcode 26 archive (
justgold_sdk_keyboard/JustGoldWkKeyboard.hfile not found). Keyboard headers are private so they are not imported through the module umbrella.
1.1.14 #
- iOS: Swift Package Manager support for Flutter 3.44+ (keep CocoaPods for older Flutter apps). Partners still install
justgold_sdkfrom pub.dev — no separate Xcode package URL.
1.1.13 #
- iOS: keep the WebView full-screen when the keypad is open (
resizeToAvoidBottomInset/ view-inset removal) and lock document scroll on buy/sell so Continue stays behind the keyboard until Done - iOS: longer CDN load timeout (180s) and session-init timeout (25s); SSL trust evaluation no longer fails the load on unexpected errors
- Embedded UI: pad all dismissed amounts to 2dp; hide Delivery in history Type filter when
deliveryTransactionsis off; drop the home “Investment” title
1.1.12 #
onAnalytics— optional callback for UI taps (ANALYTICS/ Invest_* catalog). Also delivered ononSdkEvent. Requires SDK UI CDN with analytics emit.
1.1.11 #
- Allow
share_plus10.x–12.x so partner apps on newer Flutter (e.g.share_plus12.0.1) can resolvejustgold_sdkwithout downgrading
1.1.10 #
- Embedded UI: terms gate on buy, invoice back/swipe, vault grams grouping, keyboard dismiss, faster first paint, swipe-back, and
Accept-Languageso API errors match the SDK locale
1.1.9 #
- Invoice preview and share: wrapper caches PDF bytes from binary
API_FETCH, previews in-SDK (iOS blob iframe / Android PDF.js), and shares a temp file viashare_plus.
1.1.8 #
- Embedded UI: keep buy/sell amount after confirmation Back; sharper success badge; failed result/detail Help & Support (no share); Try Again prefills the last amount
- iOS: open the native keypad on buy/sell autofocus (WebView first responder + focus retry)
1.1.7 #
- Fatal
onErrorfor load / SSL / session-init / WebView process-gone failures while keeping the in-wrapper fallback text. Recoverable API errors stay non-fatal. - Silent session renew:
ENSURE_SESSIONon resume and every 30s while the app is active
1.1.6 #
- Embedded UI: multi-phase session recovery, auto-retry on foreground, Try again on session expired overlay
- Embedded UI: payment Back → host PATCH
Cancelledthen restore buy/sell amount; do not keep pending UI forStaleor Pending older than 10 minutes. Seedocs/architecture/payment-status-and-abandon.md. - App resume + WebView process recovery; host auth-recovery retries on resume during pending recovery
1.1.5 #
- App resume + WebView process recovery; auth recovery retries start at 600ms
1.1.4 #
- Native API request/response console prints only when
logLevelisdebugandkDebugMode(was always on in debug builds)
1.1.3 #
onPartnerAction— host callback forPARTNER_ACTION(e.g. ADD FUNDS after fee rejection dialog)PartnerFeeAction/PartnerActionOutcome/PartnerFeeError.actions— partner-driven SDK dialog CTAs- Embedded UI: partner fee error BottomSheet (
proceed/cancel/close)
1.1.2 #
- Embedded UI bundle: investment home redesign — vault stack, live buy/sell bar, invested/growth/sell value metrics (Figma-aligned colors and typography)
- Partner fee request timeout increased to 60 seconds (was 8s)
- Delivery routes and shortcuts hidden when org
deliveryTransactionsflag is off - Metal-specific secure vault footer copy (gold/silver)
1.1.1 #
- Loading overlay — dismisses correctly after WebView load (
setStatefix; was stuck on “Loading JustGold…”) - Embedded UI bundle (CDN): du Co Headline 16 font and Dirham symbol WebView fixes (via
@justgold/sdk-bridgetypes)
1.1.0 #
PartnerFeeBreakupmodel and extendedPaymentRequiredPayloadonPartnerFeeRequestreturns full fee breakup (platform + minting/delivery splits)PAYMENT_REQUIREDincludesgrandTotaland cached partner fee breakup- pub.dev platform metadata — register
iosinpubspec.yamlplugin platforms so iOS + Android both appear (minimal iOS plugin stub) OPEN_EXTERNAL_URLbridge handler — opens links viaurl_launcher(LaunchMode.externalApplication)
1.0.3 #
- SPKI SSL pinning for Partner API (
GET /v1/sdk/ui-url,API_FETCH) and SDK CDN WebView loads - Pins stage + production Partner API and CDN hosts; exempt localhost / LAN when
useDevUi - Optional
sslPinning: falsefor maintainer Local Vite workflow - Android WebView CDN pinning via platform plugin (
JustGoldSdkPlugin) and OkHttp intercept - SPKI validation: detect Charles / mitmproxy certs; support WebView-exposed SPKI DER bytes
- System proxy detection for pinned HTTP client (Charles baseline on iOS)
1.0.2 #
- SDK UI loads from JustGold CDN by default — the wrapper fetches a short-lived signed URL from
GET /v1/sdk/ui-urlusing the session token sandbox: true→ partner sandbox API and CDN (api.stage.partner.justgold.app/sdk.stage.justgold.app)sandbox: false→ production API and CDN (api.partner.justgold.app/sdk.justgold.app)- Optional
sdkUiSignedUrl— pass a pre-signed URL from your backend (same token response) to skip the in-app CDN fetch - Optional
sdkUrl— override the UI load URL when required by your integration - Reliable behaviour on physical devices in debug and release builds (HTTPS CDN; no local dev server assumed)
1.0.1 #
- Partner-facing README on pub.dev (integration guide only)
- Payment handoff documentation simplified (no internal pattern labels)
JustGoldConnectas the public entry point
1.0.0 #
- Initial pub.dev release of
justgold_sdk JustGoldConnect— embed the JustGold trading experience in Flutter apps- Session token + refresh token support with silent renew
- Partner branding via
SdkTheme - Full-page payment handoff via
onPaymentRequired