analytics_hub_mixpanel

• Release 0.5.0: port zeely-mobile fixes, drop session support, add CI

Port behavior fixes made in the zeely-mobile copies of these packages:

• ProviderIdentifier equality/hashCode now include the runtime type so
  identifiers of different subclasses with the same name don't collide
• AnalyticsHub.initialize initializes providers sequentially
  (Future.forEach) instead of concurrently
• Quieter logging: sendEvent logs at fine level and the dispatch
  pipeline no longer logs each step
• Provider constructors accept an optional interceptors parameter

Remove session support (breaking): Session, HubSessionDelegate,
AnalyticsHub.sessionDelegate and AnalytycsProvider.setSession are gone;
apps manage user identity directly on the underlying SDKs. The
getAnonymousId parameters of the Mixpanel/Appsflyer providers are
removed with it.

Add GitHub Actions CI modeled on basalt_dart: analyze/format/test plus
publish dry-run on every push/PR, and tag-driven pub.dev publishing via
OIDC (-v tags).

Co-Authored-By: Claude Fable 5 [email protected]

• Audit cleanup: drop dead code and unnecessary dependencies

• Firebase/Appsflyer providers: remove flush() overrides that existed
  only to log a "not supported" message — the base AnalytycsProvider
  flush() is already a no-op. This drops the logging dependency from
  all three provider packages (mixpanel no longer imported it at all).
• analytics_hub core is now a pure Dart package: flutter_test dev
  dependency removed (tests only use package:test), so dart test
  works without a Flutter SDK.
• Remove unused dev dependencies: test from the provider packages
  (their tests use flutter_test), lints from mixpanel (inherited from
  the workspace root), test from the root package (no tests there).
• Provider tests: delete dead _TestEvent classes and
  registerFallbackValue setup left over from the removed setSession
  tests, plus the now-unused analytics_hub imports.
• Core internals: remove unused DispatchTarget.providerIdentifier
  getter; EventDispatcher.dispatch returns the executor future directly
  instead of awaiting into a local.
• Root README: close the unterminated yaml code fence in Quick start
  that swallowed the rest of the page on render.

Co-Authored-By: Claude Fable 5 [email protected]

• Rename AnalytycsProvider to AnalyticsProvider, fix workspace layout

Fix the long-standing typo in the provider base class name across all
packages, docs, examples, and tests. No compatibility alias is kept —
the packages have no external consumers yet.

Also move resolution: workspace from pubspec_overrides.yaml into each
package's pubspec.yaml (the layout basalt_dart and zeely-mobile use, and
what dart test's workspace validation expects) and delete the
overrides files.

Co-Authored-By: Claude Fable 5 [email protected]

• Fix mixpanel_flutter lower bound for pub.dev score compliance

Ran pana (the tool pub.dev uses to compute package score) against all
four packages. analytics_hub itself scores a clean 160/160.

Found a real bug via the "compatible with dependency constraint lower
bounds" check: mixpanel_flutter's declared minimum (2.0.0) allows
versions up to 2.2.0 where Mixpanel.track() returns void instead of
Future. MixpanelEventResolver.resolve declares a Future
return type and returns the track() call directly, so pinning an old
2.x mixpanel_flutter breaks analysis (and would break at runtime for
anyone actually on that range). Raised the lower bound to >=2.3.0,
where track() became async. Verified dart analyze is clean and tests
pass with dependencies downgraded to their lower bounds.

The three provider packages can't get a full pana score yet since they
depend on analytics_hub, which isn't published to pub.dev — pana (like
pub.dev itself) resolves dependency_overrides are ignored for scoring,
so this is a publish-order concern rather than a code issue: publish
analytics_hub first, then the providers.

Co-Authored-By: Claude Fable 5 [email protected]

• Add design spec for basalt_dart-style documentation

Covers badges + workspace banners on all READMEs, a "what's inside"
reference table in the core README, a packages/analytics_hub/doc/
folder with four deep-dive guides, and a root CONTRIBUTING.md —
scoped down from basalt_dart's equivalent docs to this repo's size.

Co-Authored-By: Claude Fable 5 [email protected]

• Add basalt_dart-style documentation

Badges + "part of workspace" banners on every README (EN/UA), a
"what's inside" reference table in the core README, a
packages/analytics_hub/doc/ folder with four deep-dive guides
(getting started, providers, interceptors & context, testing), and a
root CONTRIBUTING.md — implements the design spec, which is removed
now that it's realized in the actual docs.

Skipped the MIT license badge from the original spec: the repo has no
LICENSE file, so that badge would have been false.

Co-Authored-By: Claude Sonnet 5 [email protected]

• Remove initialize and dispose from provider lifecycle

SDK lifecycle belongs in the app — keep only flush for buffered backends.

Co-authored-by: Cursor [email protected]

• Fix example formatting for CI

Co-authored-by: Cursor [email protected]

Co-authored-by: Claude Fable 5 [email protected]
Co-authored-by: Cursor [email protected]

Added

• Optional interceptors constructor parameter for provider-level interceptors.

Changed

• Removed the unused logging dependency.
• Raised the mixpanel_flutter lower bound to >=2.3.0 — earlier 2.x releases had a synchronous Mixpanel.track() (returning void), which does not satisfy MixpanelEventResolver.resolve's Future<void> return type.

Breaking Changes

• Removed setSession and the getAnonymousId parameter along with core session support. Manage identity directly via Mixpanel.identify/Mixpanel.reset.
• Updated dependency constraint to analytics_hub: ">=0.5.0 <0.6.0".

Changed

• Updated dependency constraint to analytics_hub: ">=0.4.0 <0.5.0" to align with the core 0.4.0 release and the new EventProvider.overrides API.
• Renamed provider identifier from MixpanelAnalyticsHubProviderIdentifier to MixpanelAnalyticsHubIdentifier for consistency with other official providers.

Breaking Changes

• Event definitions and imports must now use MixpanelAnalyticsHubIdentifier instead of MixpanelAnalyticsHubProviderIdentifier.

Changed

• Updated dependency constraint to analytics_hub: ">=0.3.3 <0.4.0".
• Added logging dependency and provider-level logging for session handling.
• Updated MixpanelAnalyticsHubProvider constructor call to the new core provider contract (explicit interceptors).
• Implemented provider flush() override delegated to Mixpanel.flush().
• Added tests for provider flush delegation.

Changed

• Updated dependency constraint to analytics_hub: ">=0.3.1 <0.4.0".
• Synced resolver/tests with the refined typed context API used by core (Context/ContextEntry-based dispatch context).
• Updated README docs (EN/UA) and version snippets to 0.3.1.

Changed

• Updated examples/tests/docs to the log-only core API (List<EventProvider>).
• Updated dependency constraint to analytics_hub: ">=0.3.0 <0.4.0".
• Migrated MixpanelEventResolver to new core resolver API based on ResolvedEvent and EventDispatchContext.
• Updated tests for the new dispatch contract.

Breaking Changes

• Version aligned with analytics_hub 0.3.x API changes.
• Resolver implementation now must implement resolve({required ResolvedEvent event, required EventDispatchContext context}).

Changed

• Updated README to use providers and MixpanelAnalyticsHubProviderIdentifier.
• Updated installation/dependency snippets to current versions.

Breaking Changes

• MixpanelAnalyticsHubProviderKey was renamed to MixpanelAnalyticsHubProviderIdentifier.

Changed

• Migrated provider identity usage from ProviderKey to ProviderIdentifier.
• Updated examples and tests to the new Event.providers API with EventProvider.
• Updated dependency constraint to analytics_hub: ">=0.2.0 <0.3.0".

Breaking Changes

• MixpanelAnalyticsHubProvider now uses identifier instead of key.
• MixpanelAnalyticsHubProviderKey now extends ProviderIdentifier<MixpanelEventResolver>.
• Events targeting Mixpanel must define providers (List<EventProvider<...>>) instead of providerKeys.

Added

• Public API documentation for provider, key, and resolver.
• Dependency on analytics_hub: ">=0.0.1 <0.2.0".

Added

• Initial Mixpanel provider integration for analytics_hub.
• MixpanelAnalyticsHubProvider and MixpanelAnalyticsHubProviderKey for routing events to Mixpanel.
• MixpanelEventResolver mapping LogEvent to Mixpanel.track.
• Session handling in provider using Mixpanel.identify for authenticated users and identify/reset logic for anonymous sessions.