Something went wrong

Thank you for being patient! We're working hard on resolving the issue

What the connector is - Lona Docs Log in

tento-lona-connector

tento-lona-connector is the integration contract that lets a provider crate (tento-garmin, tento-whoop, tento-google, tento-weather, …) plug into a host that wants to surface its data as rows.

What the connector ships

  • Trait surfaceRow, Integration, RouteKey, RowKeySchema, SchemaEntry, UserAuth, RowKeyAuthProvider, AuthProvider.
  • Data shapesCell, Owner (host-data-free; the host converts to its own types at the dispatch boundary).
  • Argument bundlesSyncCtx, WriteCtx, ReadCtx, SyncShape, WriteOutput, RowKeyRequestCtx, Actor.
  • Schema primitivesRowKeyMethod, HandlerParams, SyncPlan, HandlerOutput, verb markers (Get/Post/Patch/ Delete).
  • Pattern matchermatch_pattern, match_key.
  • Param adapterFromHandlerParams.
  • Helperswearable_window_for_stage for daily/wearable integrations.
  • Proc-macro re-exportRowKeySchema derive (from tento-lona-connector-macros).

What it does not ship

  • A concrete cell/row store. Hosts plug their own.
  • Sync orchestration. That's lona-sync (the sync-plugin feature on each provider crate ties into it).
  • Any host-shaped data type — the connector is fully host-data-free so a tento-{provider} crate can be consumed by any host that bothers to write the adapter layer.

Where to start

If you're building a new integration, jump to Step-by-step walkthrough. The shape is small once you've seen it.