digia_engage 1.12.0

Flutter SDK for rendering server-driven UIs using JSON from Digia Studio. Supports dynamic layouts, state, actions, and custom widgets.

Changelog

1.12.0 - 2026-07-18

New Features

• Story overlay controls — inline story overlays can show dashboard-configured close and mute controls (visibility, icon color, background color, size) over the full-screen story viewer; the mute control only appears on video items. A story can also be configured to start all of its videos muted or audible by default, and once the viewer changes the audio state, that choice persists for the rest of the story session.

Bug Fixes

• Bottom-sheet nudges no longer leave a gap below the sheet on devices with a bottom safe-area inset.
• Guide and Spotlight colors that specify an alpha channel (e.g. #80112233) now correctly combine that alpha with the component's own opacity, instead of the alpha being overwritten and ignored.
• Survey welcome CTA taps, inline carousel item taps, and inline story opens now forward an engagement signal to connected CEP platforms (WebEngage, CleverTap, MoEngage), matching how other surfaces already behave. Previously these three surfaces only recorded the click in Digia's own analytics.

1.11.0 - 2026-07-14

New Features

• Single-image story previews — a story campaign can now render inline as one campaign-level cover image instead of the circular story strip; tapping it opens the story viewer at the first item. The image supports a BlurHash loading placeholder, content fit (cover/contain/fill), aspect ratio or fixed height, corner radius, and per-side padding. Campaigns that don't configure it — or configure it incompletely — keep rendering the story strip.
• Story image content fit — each story item can choose how its image fills the full-screen viewer (cover, contain, or fill). Previously every image was cropped to cover.
• Carousel item spacing and corner radius — inline carousels can set the gap between slides and the corner radius of each slide's image.
• Clear inline content — new Digia.clearInlineContent([...]) and Digia.clearAllInlineContent() APIs remove loaded carousels and stories by placement key, or all of them at once. Inline content was previously retained for the life of the app session, so a signed-out user's content could linger across an account switch.

Improvements

• Analytics events that fail to send are now retried more reliably: the attempt count is persisted, so it survives an app restart instead of resetting; retries are capped at 10 attempts and back off exponentially up to two minutes with random jitter; and newly queued events no longer trigger an early send ahead of an already-scheduled retry.
• Analytics logging now honors the log level set in DigiaConfig — routine retry chatter is verbose-only, and permanent event drops are surfaced as warnings. Previously analytics logged only in debug builds and ignored the configured level.
• Guide outside-tap behavior is now either next (the default — advance, or dismiss after the last step) or nothing (scrim taps are inert). The dismiss value and the tooltip sticky flag have been removed.
• Inline carousels always span the full available width; the per-campaign width override has been removed.

Bug Fixes

• Analytics events are no longer silently discarded when the server replies with a 4xx or a response the SDK can't parse — those batches are now retried like any other failure. Only events the server explicitly rejects are dropped.
• The default maximum analytics batch size is lowered from 200 to 100 events; 200-event batches were failing on the backend.
• Carousel images no longer rebuild and re-fetch on every rotation of the carousel, in both inline carousels and carousel nudges.
• Completed segments in the story progress bar now render filled in the indicator's active color instead of a separate grey. The completedColor configuration value has been removed — completed segments follow activeColor.

1.10.0 - 2026-07-08

New Features

• Destructive button confirmation — buttons can be marked destructive; tapping one shows a confirm dialog (custom title/message/labels, message optional) before the action runs, styled in a fixed danger red.
• Image loading placeholders — nudges, surveys, and inline carousels show a BlurHash preview while images load, instead of a blank box. Dashboard already auto-computes the hash, so no CMS-side burden.
• In-App Review action — new CTA action type triggers the native "rate this app" prompt.
• Linear progress bar — new nudge component, direct-percent or computed-range mode (e.g. "spent 700 of 1000").
• Guides auto-dismiss on navigation — a guide no longer lingers on screen, orphaned, if the user navigates away mid-guide.

Improvements

• Video nudges: mute support wired end-to-end; playback failures now show "Couldn't load video" instead of a raw error dump.
• Surveys: removed a hardcoded 480px max-height cap on question cards — content sizes naturally now.
• Analytics events batched less frequently, in larger batches (flush interval 5s→30s, batch size 10→50) — fewer network calls.

Bug Fixes

• Guarded against a nudge occasionally re-presenting itself (and double-recording an impression) when unrelated inline-slot state changed.

1.9.0 - 2026-06-30

• Text widget in Nudges now supports Rich Text.
• Bug fixes in ToolTip/Spotlight arrow position and color.

1.8.0 - 2026-06-25

• Lottie now supports Content Fit & Aspect Ratio

Changed

• Fixed click tracking issues

1.1.2 - 2026-04-18

Changed

• Fixed deduplication of inline impressions

1.1.1 - 2026-04-02

Changed

• Fixed FontAwesomeFlutter issues

1.1.0 - 2026-03-27

Changed

• Improved payload handling: inline campaigns now use type: inline + placementKey instead of command: SHOW_INLINE + placementId
• Payloads missing both type and command are now dropped with a warning instead of silently ignored
• DigiaSlot lookup updated to use placementKey
• DigiaSlot and DigiaHost now handle render errors gracefully: collapse to SizedBox.shrink() in production, show an inline error box with console log in debug mode

1.0.0 - 2026-03-18

Added

• Initial stable release of the Digia Engage SDK

1.0.0-beta.2 - 2026-03-11

Added

• Inline support for DigiaSlot

1.0.0-beta.1 - 2026-03-11

Added

• Initial beta release
• UI framework for custom UI from engagement platform
• Public API exports for easy integration