v0.0.50

May 20, 2025

Summary

This release introduces two improvements to Analytics.

On one hand, the solution now supports collecting data from campaigns — including full support for utm tags. These tags (e.g., utm_source, utm_medium, utm_campaign) are commonly used in URLs to track the origin and purpose of traffic. For example, a link like:

https://myapp.com/?utm_source=newsletter&utm_medium=email&utm_campaign=spring-launch

allows you to understand how visitors are reaching your app and which campaigns are driving engagement.

[!NOTE] To take advantage of utm tag support, make sure to upgrade both the Orbiter and the @junobuild/analytics JS library.

On the other hand, bot detection has been improved by relying on HTTP headers provided directly to the container (smart contract), rather than depending on the tracker to supply them. This increases reliability and reduces the chance of spoofed or missing data.

Brave Browser 2025-05-20 16:17:38 - Frame 158

[!NOTE] While this release includes many commits across the Console, Mission Control or crates, those parts are still under heavy development and not part of this release.

Overview

Module	Version	Breaking changes
Orbiter	v0.2.1	️

Library	Version	Breaking changes
`@junobuild/analytics`	v0.2.1
`@junobuild/core`	v0.1.14
`@junobuild/core-standalone`	v0.1.14
`@junobuild/admin`	v0.4.0
`@junobuild/config`	v0.1.8
`@junobuild/errors`	v0.0.10
`@junobuild/storage`	v0.1.9
`@junobuild/utils`	v0.1.3

CLI	Version	Breaking changes
`@junobuild/cli`	v0.4.0

Docker	Version	Breaking changes
`@junobuild/skylab`	v0.1.0
`@junobuild/satellite`	v0.1.0
`@junobuild/console`	v0.1.0
`@junobuild/action`	v0.1.2

Changes

Here is a list of changes included in this release:

Console (Backend)

No changes released (WIP).

Console (Frontend)

The Console UI/UX has been improved as follows:

Features

Added support to display the top 10 campaign sources and names (when available).
Displayed a progression indicator for each metric in the Analytics dashboard.
Updated tagline and social image.

Chore

Bumped ESLint rules.

Satellite

No changes released in this version.

Mission Control

No changes released (WIP).

Orbiter

The Orbiter has been updated as follows:

Features

Add support for optional utm tags in the state and extend endpoints to collect this data.
Limit the length of each utm tag to a maximum of 100 characters.
Use HTTP headers provided with the HTTP requests to prevent collecting analytics data from bots.
Deprecate internal bot detection based on user agent data contained in the request payload.

Refactoring

Split API endpoints into multiple modules to improve readability and discoverability.

Chore

Disallow the use of ic_cdk::print unless explicitly required.

Observatory

No changes released in this version (WIP).