Files
web/PR-NOTES.md
Ben Meadors bbe9a0d5cd feat(protobufs): sync to firmware-current and consume workspace package (#1097)
* feat(protobufs): sync to firmware-current and consume workspace package

Sync the vendored .proto sources to firmware-current (v2.7.25+48), regenerate the v2 TS bindings, and consume the workspace @meshtastic/protobufs (workspace:*) in place of the stale JSR 2.7.20 — finishing the monorepo migration (core was already workspace:*).

Includes the one required breaking-change fix: admin nodedb_reset changed int32 to bool, so resetNodes() now sends value: true.

* build(protobufs): vendor generated bindings for workspace consumers

The package is consumed via workspace:* — its exports point at the TS source, which imports ./dist/meshtastic/*_pb.ts — so the generated output must exist at build time. CI builds web/core with no codegen step and the runners have no buf CLI, so the bindings are vendored here (kept gitignored; lint/format skip them). Regenerate with: pnpm --filter @meshtastic/protobufs gen

* fix(protobufs): clean script removes the actual generated output dir

buf writes bindings to packages/ts/dist, but clean was removing a non-existent root dist — so it never cleaned stale output. Addresses Copilot review feedback.

* refactor: move web app packages/web -> apps/web

Aligns the web app with the apps/web layout (matching the Vercel web-test Root Directory and the SDK-migration direction). Pure directory move plus root config: pnpm-workspace (adds apps/*), vitest projects, root tsconfig reference, and the pr/release-web/nightly workflows. vercel.json moved with the app. Build + 36 validation tests green.

* feat: config fields, module pages, key verification, telemetry capture

Incorporates the firmware-current feature work onto the protobuf foundation: new config fields (Display message bubbles; LoRa fem_lna_mode + serial_hal_only; Telemetry air_quality_screen_enabled); 4 new ModuleConfig pages (TrafficManagement, StatusMessage, TAK, RemoteHardware); the manual Key Verification flow (sendKeyVerification + ClientNotificationDialog stages + Verify Key button); live telemetry capture (nodeDB addDeviceMetrics) and admin hardening (toggleMutedNode, graceful PortNum default); plus the sdk-preview ConfigEditor demo and store/config tests. Build + lint + format + 131 tests green.

* chore: drop #1062 (unsaved-change-detection) to match upstream revert

#1062 was merged to main by accident (per @danditomaso) and is being reverted. Reverse-applied its diff here via 3-way so #1097 stays consistent with where main is headed, while keeping the feature changes layered on the same files (deviceStore/changeRegistry). Build + 131 tests + lint + format green.

* fix(nodes): clean up SNR display in node table and map popup

SNR is a ratio measured in dB, not dBm (which is absolute power); the
node table and map popup both mislabeled it and crammed three values
together: '0dBm/50%/50raw'. The trailing '%/raw' pair was the same
heuristic ((snr+10)*5) shown twice — once clamped, once not.

Render SNR in dB rounded to one decimal, color-coded by a 0-100%
signal-quality heuristic (green/yellow/red), with the quality percentage
as a muted secondary. Drop the redundant raw value. Adds unit.db; this
matches the existing SNRTooltip, which already renders dB.
2026-06-15 13:23:28 -05:00

3.2 KiB

Protobuf catch-up to firmware-current

Draft PR description + the one decision for maintainers. This file is untracked — use it as the PR body, then delete it (or leave it, it won't be committed).

What this does

  • Syncs the vendored .proto sources in packages/protobufs/meshtastic/ from ~v2.7.20 to firmware-current (v2.7.25 + 48 commits) — +2 new files (deviceonly_legacy, serial_hal) and additions across config / module_config / mesh / admin / portnums / telemetry.
  • Regenerates the v2 TS bindings (buf generate).
  • Makes the app consume the workspace protobufs (workspace:*) instead of the stale JSR @meshtastic/protobufs@2.7.20, finishing the monorepo migration that was half-done (@meshtastic/core was already workspace:*; protobufs was still on JSR).
  • One breaking-change fix: admin.proto nodedb_reset changed int32 → bool, so MeshDevice.resetNodes() now sends value: true (the oneof-case presence triggers the reset; true preserves favorites through it).

Free wins (dynamic enum dropdowns — no UI code)

New LoRa regions (ITU/EU amateur bands), modem presets (LONG_TURBO, LITE/NARROW/TINY_*), ~25 hardware names, OLED_SH1107_ROTATED, serial LOG/LOGTEXT — they flow into the existing enum-bound <select>s automatically once the bindings regenerate.

Breaking proto changes that DON'T break us (verified)

  • deviceonly.proto NodeInfoLite restructure — core never imports NodeInfoLite.
  • channel.proto is_client_muted → is_muted + mute removed — neither web nor core references those fields yet.

The one decision for maintainers — how to consume the protobufs

This changeset takes Option A (workspace consumption): rename the workspace package @meshtastic/protobufs-ws → @meshtastic/protobufs (still private), point its exports at the TS source, and depend on it via workspace:* from root + core.

  • Monorepo is self-consuming and always firmware-current; no publish round-trip; matches the already-migrated @meshtastic/core.
  • ⚠️ Diverges from the JSR publish flow; the published JSR @meshtastic/protobufs (latest 2.7.23) is no longer what the app builds against.

Option B (canonical publish flow): keep the package JSR-published — sync the .proto sources here, publish a new @meshtastic/protobufs to JSR, then bump the root range.

  • Stays on the established pipeline; one source of truth on JSR.
  • ⚠️ Needs a JSR publish, and can't reach firmware-current until that release lands (JSR tops out at 2.7.23, still behind firmware).

If you prefer B, everything except the 3 dependency-wiring edits still applies — the .proto sync, the regen, and the nodedbReset fix are identical; only the root dep, the core dep, and the protobufs package.json name/exports get swapped for a JSR publish + range bump.

Regenerating bindings

pnpm --filter @meshtastic/protobufs gen

Output lands in packages/protobufs/packages/ts/dist/ (gitignored).

Verified in isolation (this branch only — no feature/demo code)

  • packages/core typecheck: clean except 2 pre-existing queue.ts strict-catch errors.
  • packages/web vite build: green.
  • 36 config/module validation tests: pass.