Skip to content

chore(release): 3.0.0 - #115

Merged
dirkwa merged 1 commit into
SignalK:mainfrom
dirkwa:tracks-release-3-0-0
Sep 21, 2026
Merged

dirkwa merged 1 commit into
SignalK:mainfrom
dirkwa:tracks-release-3-0-0

Conversation

@dirkwa

@dirkwa dirkwa commented Sep 21, 2026

Copy link
Copy Markdown
Collaborator

The v2 Track API this plugin registers with shipped in Signal K server 2.33.0, so the 3.x line leaves prerelease.

Verified against the v2.33.0 tag rather than the release note: src/api/tracks/ and registerTrackApiProvider are present, and storeTrack/deleteTrack are not — the read-only API, which is what this plugin needs.

The README now says what a reader needs before installing

Requires Signal K server >= 2.33.0 for the v2 Track API; older servers get the v1 routes only.

Worth being precise about "requires", because the plugin does not hard-require it. registerTrackApiProvider is called optionally (app.registerTrackApiProvider?.(...)) and its absence is neither an error nor a warning — trackProvider.test.ts covers a server without it and asserts the plugin starts clean and logs nothing. So an older server keeps a working plugin: v1 routes, webapp, GPX export, SQLite store. What it does not get is /signalk/v2/api/tracks.

Stating a flat "requires 2.33.0" would have told someone on 2.32 to uninstall a plugin that works for them.

What the 3.x line brought

Tracks recorded to SQLite so they survive a restart with no other plugin; reconciliation with an installed history provider per query; a webapp with GPX import and export; glitch filtering; Douglas-Peucker simplification; remembered vessel names; and v1 routes that reject a query they cannot honour rather than answering 200 with something else.

Note on the npm tag

This moves latest from 2.1.0, where it has been through the whole beta line. Existing 2.x users will see 3.0.0 on their next update.

Tested

568 unit tests pass; typecheck, eslint and prettier clean; build succeeds.

The v2 Track API this plugin registers with shipped in Signal K server
2.33.0, so the 3.x line leaves prerelease.

The README now states what that means for someone reading it before
installing: 2.33.0 or newer serves the v2 Track API, older servers serve the
v1 routes alone. The plugin does not require it -- `registerTrackApiProvider`
is called optionally and its absence is neither an error nor a warning -- so
an older server keeps a working plugin rather than a broken one.

What the 3.x line brought: tracks recorded to SQLite so they survive a
restart with no other plugin, reconciliation with an installed history
provider per query, a webapp with GPX import and export, glitch filtering,
Douglas-Peucker simplification, remembered vessel names, and v1 routes that
reject a query they cannot honour rather than answering 200 with something
else.
@dirkwa dirkwa added the skip-changelog Omit from generated release notes label Sep 21, 2026
@coderabbitai

coderabbitai Bot commented Sep 21, 2026

Copy link
Copy Markdown

Important

  • 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration

Configuration used: Repository: SignalK/tracks/.coderabbit.yaml

Review profile: ASSERTIVE

Plan: Advanced

Run ID: 6a2b7cc2-2395-4342-a1d5-02511c502da4


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@dirkwa
dirkwa merged commit 6e639a1 into SignalK:main Sep 21, 2026
16 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

skip-changelog Omit from generated release notes

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant