Skip to content

charging: add charging source-of-record module (com.tesla.proto.charging.v1) - #20

Merged
Bre77 merged 3 commits into
mainfrom
fm/proto-charging-v1-publish
Jul 24, 2026
Merged

charging: add charging source-of-record module (com.tesla.proto.charging.v1)#20
Bre77 merged 3 commits into
mainfrom
fm/proto-charging-v1-publish

Conversation

@Bre77

@Bre77 Bre77 commented Jul 24, 2026

Copy link
Copy Markdown
Member

Intent

  • Add a new proto/charging/ source-of-record module modelling com.tesla.proto.charging.v1: Tesla's EV charge-session energy metering / billing schema (Energy, StemInfo, StemEventInfo, ChargeSessionTimeSeries, StemUi, StemBilling - 31 fields total). No imports, no enums, a clean self-contained tree.
    • This is a deliberate exception to the repo's standing "app-only namespaces are not published" policy: this schema isn't reachable over the BLE signed-command channel and the public Fleet API charging endpoints (/api/1/dx/charging/{history,sessions}) return JSON, not protobuf. It's published anyway because it describes the vehicle-charging product domain itself, based on our own observations and contributions from the community. Documented as a named exception in PROVENANCE.md.
    • Registered the module: buf.yaml (proto/charging), scripts/generate.sh (GROUPS_LIST), README layout, PROVENANCE.md source-of-record table.
  • Regenerated both language packages; verified round-trip encode/decode of StemBilling (with nested StemInfo/StemEventInfo/ChargeSessionTimeSeries) in both TypeScript and Python.
  • buf lint is clean; no buf breaking concern (net-new module, no wire compatibility to preserve).
  • Adds a minor changeset (new module = wire-compatible addition).

Bre77 and others added 3 commits July 24, 2026 16:21
Model Tesla's EV charge-session energy metering and per-session billing
schema (Energy, StemInfo, StemEventInfo, ChargeSessionTimeSeries, StemUi,
StemBilling) as a new proto/charging source-of-record module, published in
lockstep with the rest of tesla-protocol.
@Bre77
Bre77 merged commit b755065 into main Jul 24, 2026
1 check failed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant