signalk-tides 1.5.0 → 2.0.0-beta.0

package/.github/workflows/ci.yml

@@ -20,8 +20,8 @@ jobs:
       - name: Run linter
         run: npm run lint
 
-  build:
-    name: Build
+  test:
+    name: Test
     runs-on: ubuntu-latest
     env:
       CI: true
@@ -35,5 +35,31 @@ jobs:
       - name: Install dependencies
         run: npm install
 
+      - name: Install Playwright browsers
+        run: npx playwright install chromium
+
       - name: Run build
         run: npm run build
+
+      - name: Run Tests
+        run: npm run test
+
+  publish:
+    needs: [lint, test]
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+      pull-requests: write
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: actions/setup-node@v6
+
+      - name: Install modules
+        run: npm install
+
+      - name: Build
+        run: npm run build
+
+      - name: Publish to pkg.pr.new
+        run: npx pkg-pr-new publish

package/.playwright-mcp/console-2026-06-06T09-48-18-232Z.log

@@ -0,0 +1 @@
+[    2058ms] [ERROR] Failed to load resource: net::ERR_NETWORK_IO_SUSPENDED @ https://docs.stormglass.io/_media/logo.svg:0

package/.playwright-mcp/console-2026-06-12T13-01-03-706Z.log

@@ -0,0 +1 @@
+[     239ms] [ERROR] Failed to load resource: the server responded with a status of 404 (Not Found) @ http://localhost:3000/signalk-tides/assets/icon.svg:0

package/.playwright-mcp/console-2026-06-12T13-15-30-205Z.log

@@ -0,0 +1,44 @@
+[     260ms] [LOG] [ConnectionStateMachine] Service initialized @ http://localhost:3000/@mxtommy/kip/chunk-2TP7C66X.js:0
+[     265ms] [LOG] [AppInit Network Service] Connection Configuration not found. Creating configuration using Auto-Discovery URL: http://localhost:3000 @ http://localhost:3000/@mxtommy/kip/main-UBENKC2D.js:0
+[     268ms] [LOG] [ConnectionStateMachine] Starting HTTP discovery: Connecting to http://localhost:3000 @ http://localhost:3000/@mxtommy/kip/chunk-2TP7C66X.js:0
+[     268ms] [LOG] [Connection Service] Connecting to: http://localhost:3000 @ http://localhost:3000/@mxtommy/kip/chunk-2TP7C66X.js:0
+[     279ms] [LOG] [ConnectionStateMachine] HTTP discovery successful @ http://localhost:3000/@mxtommy/kip/chunk-2TP7C66X.js:0
+[     279ms] [LOG] [AppSettings Service] Service startup... @ http://localhost:3000/@mxtommy/kip/chunk-2TP7C66X.js:3
+[     279ms] [LOG] [AppSettings Service] LocalStorage enabled @ http://localhost:3000/@mxtommy/kip/chunk-2TP7C66X.js:4
+[     279ms] [LOG] [AppSettings Service] Error loading appConfig config. Force loading appConfig defaults @ http://localhost:3000/@mxtommy/kip/chunk-2TP7C66X.js:4
+[     279ms] [LOG] [AppSettings Service] Error loading dashboardsConfig config. Force loading dashboardsConfig defaults @ http://localhost:3000/@mxtommy/kip/chunk-2TP7C66X.js:4
+[     279ms] [LOG] [AppSettings Service] Error loading themeConfig config. Force loading themeConfig defaults @ http://localhost:3000/@mxtommy/kip/chunk-2TP7C66X.js:4
+[     280ms] [LOG] [AppSettings Service] Saving Application config to LocalStorage @ http://localhost:3000/@mxtommy/kip/chunk-2TP7C66X.js:4
+[     280ms] [LOG] [DatasetStreamService] Auto Starting 0 Datasets @ http://localhost:3000/@mxtommy/kip/chunk-5SMHTIVS.js:0
+[     280ms] [LOG] [AppInit Network Service] Initialization completed @ http://localhost:3000/@mxtommy/kip/main-UBENKC2D.js:0
+[     280ms] [LOG] [ConnectionStateMachine] WebSocket mode enabled @ http://localhost:3000/@mxtommy/kip/chunk-2TP7C66X.js:0
+[     280ms] [LOG] [AppInit Network Service] Starting WebSocket connection after initialization @ http://localhost:3000/@mxtommy/kip/main-UBENKC2D.js:0
+[     280ms] [LOG] [ConnectionStateMachine] Starting WebSocket connection @ http://localhost:3000/@mxtommy/kip/chunk-2TP7C66X.js:0
+[     280ms] [LOG] [Delta Service] ConnectionStateMachine request: WebSocket opening... @ http://localhost:3000/@mxtommy/kip/chunk-IXUKD73N.js:0
+[     287ms] [WARNING] [Dashboard Service] No dashboards found in settings, creating blank dashboard @ http://localhost:3000/@mxtommy/kip/chunk-5SMHTIVS.js:0
+[     289ms] [LOG] [Remote Dashboards] Cleaning paths on server @ http://localhost:3000/@mxtommy/kip/main-UBENKC2D.js:0
+[     290ms] [LOG] [UI Event Service] PWA mode: false @ http://localhost:3000/@mxtommy/kip/chunk-5SMHTIVS.js:49
+[     300ms] [LOG] *********** KIP Version Information *********** @ http://localhost:3000/@mxtommy/kip/chunk-NS2OV2OW.js:0
+[     300ms] [LOG] ** App Version: 4.8.0 @ http://localhost:3000/@mxtommy/kip/chunk-NS2OV2OW.js:0
+[     300ms] [LOG] ** Browser Version: Chrome 149 @ http://localhost:3000/@mxtommy/kip/chunk-NS2OV2OW.js:0
+[     300ms] [LOG] ** OS Version: macOS @ http://localhost:3000/@mxtommy/kip/chunk-NS2OV2OW.js:0
+[     300ms] [LOG] *********************************************** @ http://localhost:3000/@mxtommy/kip/chunk-NS2OV2OW.js:0
+[     305ms] [LOG] [AppSettings Service] Saving Dashboard config to LocalStorage @ http://localhost:3000/@mxtommy/kip/chunk-2TP7C66X.js:4
+[     323ms] [LOG] [Delta Service] WebSocket connected without Authorization Token @ http://localhost:3000/@mxtommy/kip/chunk-IXUKD73N.js:0
+[     324ms] [LOG] [ConnectionStateMachine] WebSocket connected @ http://localhost:3000/@mxtommy/kip/chunk-2TP7C66X.js:0
+[     324ms] [LOG] [Connection Service] Server Name: signalk-server, Version: 2.23.0-beta.1, Roles: ["master","main"] @ http://localhost:3000/@mxtommy/kip/chunk-2TP7C66X.js:0
+[     437ms] [WARNING] [Request Service] Status Code: 403 - DENIED: Authorization with R/W or Admin permission level is required to send commands. Configure Sign In credential. @ http://localhost:3000/@mxtommy/kip/chunk-W6MCE3GH.js:0
+[     437ms] [WARNING] [Request Service] Status Code: 403 - DENIED: Authorization with R/W or Admin permission level is required to send commands. Configure Sign In credential. @ http://localhost:3000/@mxtommy/kip/chunk-W6MCE3GH.js:0
+[     437ms] [WARNING] [Request Service] Status Code: 403 - DENIED: Authorization with R/W or Admin permission level is required to send commands. Configure Sign In credential. @ http://localhost:3000/@mxtommy/kip/chunk-W6MCE3GH.js:0
+[     450ms] [WARNING] An iframe which has both allow-scripts and allow-same-origin for its sandbox attribute can escape its sandboxing. @ http://localhost:3000/@mxtommy/kip/chunk-LEY6MANN.js:3
+[     515ms] [WARNING] An iframe which has both allow-scripts and allow-same-origin for its sandbox attribute can escape its sandboxing. @ http://localhost:3000/@signalk/freeboard-sk/:0
+[    1311ms] [ERROR] Failed to load resource: the server responded with a status of 401 (Unauthorized) @ http://localhost:3000/plugins/freeboard-sk:0
+[    1387ms] [ERROR] Failed to load resource: the server responded with a status of 401 (Unauthorized) @ http://localhost:3000/plugins/kip:0
+[    1387ms] [LOG] [KipSeriesApiClientService] POST http://localhost:3000/plugins/kip/series/reconcile (0 series) @ http://localhost:3000/@mxtommy/kip/chunk-6ZR3M3IQ.js:2
+[    1403ms] [INFO] Internet connection detected. @ http://localhost:3000/@signalk/freeboard-sk/main-YHMZXR5G.js:249
+[    1414ms] [ERROR] Failed to load resource: the server responded with a status of 401 (Unauthorized) @ http://localhost:3000/plugins/kip/series/reconcile:0
+[    1414ms] [ERROR] [KipSeriesApiClientService] Series reconcile request failed: Ar @ http://localhost:3000/@mxtommy/kip/chunk-6ZR3M3IQ.js:2
+[    1517ms] [ERROR] Failed to load resource: the server responded with a status of 404 (Not Found) @ http://localhost:3000/signalk/v1/api/vessels/self/navigation/anchor:0
+[    1784ms] [WARNING] Blocked aria-hidden on an element because its descendant retained focus. The focus must not be hidden from assistive technology users. Avoid using aria-hidden on a focused element or its ancestor. Consider using the inert attribute instead, which will also prevent focus. For more details, see the aria-hidden section of the WAI-ARIA specification at https://w3c.github.io/aria/#aria-hidden.
+Element with focus: <div>
+Ancestor with aria-hidden: <app-root> @ http://localhost:3000/@signalk/freeboard-sk/:0

package/.playwright-mcp/console-2026-06-12T13-16-00-389Z.log

@@ -0,0 +1 @@
+[      68ms] [LOG] [Delta Service] App suspended @ http://localhost:3000/@mxtommy/kip/chunk-IXUKD73N.js:0

package/README.md

@@ -1,12 +1,13 @@
 # signalk-tides
 
-A SignalK plugin that provides tidal predictions for the vessel's position from various [sources](#sources).
+A SignalK plugin that provides offline tidal predictions for the vessel's position, powered by [Neaps](https://github.com/neaps/neaps).
+
+Since 2.0, predictions are computed locally from harmonic constituents — no network access or API keys required.
 
 ## Installation
 
-1. Install `signalk-tides` from the SignalK Appstore or manually by running `npm install signalk-tides` in the SignalK server directory (`~/.signalk`).
+Install `signalk-tides` from the SignalK Appstore or manually by running `npm install signalk-tides` in the SignalK server directory (`~/.signalk`).
 
-2. Optionally go to the plugin settings in "Server => Plugin Config => Tides" and configure which source to use.
 
 ## Usage
 
@@ -21,204 +22,41 @@ It publishes the following [tide data](https://signalk.org/specification/1.7.0/d
 * `environment.tide.heightNow`
 * `environment.tide.stationName`
 
-### Tides resource
+### Tides API
 
-It also registers a `tides` resource, which returns tide predictions for yesterday and the next 6 days for the vessel's position.
+The plugin mounts the [Neaps API](https://github.com/neaps/neaps) at `/signalk/v2/api/tides`, which serves station search, extremes, and timeline predictions. The synthetic station `vessel/current` resolves to the nearest station to the vessel:
 
 ```
-$ curl http://localhost:3000/signalk/v2/api/resources/tides
+$ curl http://localhost:3000/signalk/v2/api/tides/stations/vessel/current/extremes
 ```
 
-##### Request Parameters
+### Tides resource
 
-* `date` (optional) - the date for which to get the tide predictions in the format `YYYY-MM-DD`. Default: yesterday's date.
+It also registers a `tides` resource, which returns the next 7 days of tide extremes for the vessel's position.
+
+```
+$ curl http://localhost:3000/signalk/v2/api/resources/tides
+```
 
 ##### Response
 
 ```json
 {
-   "extremes" : [
-      {
-         "time" : "2025-03-29T00:45:00.000Z",
-         "type" : "Low",
-         "value" : 0.025
-      },
-      {
-         "time" : "2025-03-29T07:20:00.000Z",
-         "type" : "High",
-         "value" : 1.928
-      },
-      {
-         "time" : "2025-03-29T13:18:00.000Z",
-         "type" : "Low",
-         "value" : 0.044
-      },
-      {
-         "time" : "2025-03-29T19:45:00.000Z",
-         "type" : "High",
-         "value" : 1.815
-      },
-      {
-         "time" : "2025-03-30T01:24:00.000Z",
-         "type" : "Low",
-         "value" : 0.164
-      },
-      {
-         "time" : "2025-03-30T07:52:00.000Z",
-         "type" : "High",
-         "value" : 2.024
-      },
-      {
-         "time" : "2025-03-30T14:05:00.000Z",
-         "type" : "Low",
-         "value" : -0.131
-      },
-      {
-         "time" : "2025-03-30T20:43:00.000Z",
-         "type" : "High",
-         "value" : 1.733
-      },
-      {
-         "time" : "2025-03-31T02:05:00.000Z",
-         "type" : "Low",
-         "value" : 0.334
-      },
-      {
-         "time" : "2025-03-31T08:27:00.000Z",
-         "type" : "High",
-         "value" : 2.084
-      },
-      {
-         "time" : "2025-03-31T14:53:00.000Z",
-         "type" : "Low",
-         "value" : -0.247
-      },
-      {
-         "time" : "2025-03-31T21:44:00.000Z",
-         "type" : "High",
-         "value" : 1.632
-      },
-      {
-         "time" : "2025-04-01T02:48:00.000Z",
-         "type" : "Low",
-         "value" : 0.517
-      },
-      {
-         "time" : "2025-04-01T09:06:00.000Z",
-         "type" : "High",
-         "value" : 2.094
-      },
-      {
-         "time" : "2025-04-01T15:46:00.000Z",
-         "type" : "Low",
-         "value" : -0.29
-      },
-      {
-         "time" : "2025-04-01T22:51:00.000Z",
-         "type" : "High",
-         "value" : 1.529
-      },
-      {
-         "time" : "2025-04-02T03:37:00.000Z",
-         "type" : "Low",
-         "value" : 0.695
-      },
-      {
-         "time" : "2025-04-02T09:49:00.000Z",
-         "type" : "High",
-         "value" : 2.05
-      },
-      {
-         "time" : "2025-04-02T16:43:00.000Z",
-         "type" : "Low",
-         "value" : -0.263
-      },
-      {
-         "time" : "2025-04-03T00:04:00.000Z",
-         "type" : "High",
-         "value" : 1.448
-      },
-      {
-         "time" : "2025-04-03T04:35:00.000Z",
-         "type" : "Low",
-         "value" : 0.847
-      },
-      {
-         "time" : "2025-04-03T10:39:00.000Z",
-         "type" : "High",
-         "value" : 1.957
-      },
-      {
-         "time" : "2025-04-03T17:50:00.000Z",
-         "type" : "Low",
-         "value" : -0.189
-      },
-      {
-         "time" : "2025-04-04T01:24:00.000Z",
-         "type" : "High",
-         "value" : 1.421
-      },
-      {
-         "time" : "2025-04-04T05:49:00.000Z",
-         "type" : "Low",
-         "value" : 0.946
-      },
-      {
-         "time" : "2025-04-04T11:40:00.000Z",
-         "type" : "High",
-         "value" : 1.837
-      },
-      {
-         "time" : "2025-04-04T19:07:00.000Z",
-         "type" : "Low",
-         "value" : -0.11
-      },
-      {
-         "time" : "2025-04-05T02:40:00.000Z",
-         "type" : "High",
-         "value" : 1.455
-      },
-      {
-         "time" : "2025-04-05T07:19:00.000Z",
-         "type" : "Low",
-         "value" : 0.958
-      },
-      {
-         "time" : "2025-04-05T12:53:00.000Z",
-         "type" : "High",
-         "value" : 1.728
-      },
-      {
-         "time" : "2025-04-05T20:25:00.000Z",
-         "type" : "Low",
-         "value" : -0.061
-      }
-   ],
-   "station" : {
-      "name" : "Rincon Point, Pier 22 1/2",
-      "position" : {
-         "latitude" : 37.79,
-         "longitude" : -122.387
-      }
-   }
+   "datum": "MLLW",
+   "units": "meters",
+   "station": {
+      "id": "noaa/9414290",
+      "name": "San Francisco",
+      "latitude": 37.806,
+      "longitude": -122.465
+   },
+   "extremes": [
+      { "time": "2025-03-29T00:45:00.000Z", "level": 0.025, "high": false, "low": true, "label": "Low" },
+      { "time": "2025-03-29T07:20:00.000Z", "level": 1.928, "high": true, "low": false, "label": "High" }
+   ]
 }
 ```
 
-## Sources
-
-- [Neaps](https://github.com/neaps/neaps)
-  - Offline, open source, runs locally
-  - Coverage: Regional — United States and territories (currently)
-- [NOAA](https://tidesandcurrents.noaa.gov/web_services_info.html)
-  - Online (NOAA web services)
-  - Regional — United States and territories
-- [WorldTides API](https://www.worldtides.info/)
-  - Online (requires API key, subject to API quotas)
-  - Coverage: Global - station and model coverage varies by location
-- [StormGlass.io](https://stormglass.io/)
-  - Online (requires API key)
-  - Coverage: Global - aggregated marine data; tide availability varies
-
 ## License
 
 This plugin is a fork of the [signalk-tides-api](https://github.com/joabakk/signalk-tides-api) plugin (which is no longer working) and is licensed under the [Apache License 2.0](LICENSE). Kudos to @joabakk and @sbender9 for the original work.

package/dist/calculations.js

@@ -1,15 +1,15 @@
 /** Given a list of tide extremes, estimate the height at a specific time. */
 export function approximateTideHeightAt(extremes, time) {
-    const sorted = extremes.slice().sort((a, b) => new Date(a.time).getTime() - new Date(b.time).getTime());
-    const prev = sorted.filter(h => new Date(h.time) <= time).at(-1);
-    const next = sorted.filter(h => new Date(h.time) >= time).at(0);
+    const sorted = extremes.slice().sort((a, b) => a.time.getTime() - b.time.getTime());
+    const prev = sorted.filter(h => h.time <= time).at(-1);
+    const next = sorted.filter(h => h.time >= time).at(0);
     if (!prev)
         throw new Error("Missing height data before " + time.toISOString());
     if (!next)
         throw new Error("Missing height data after " + time.toISOString());
-    const progress = (time.getTime() - new Date(prev.time).getTime()) /
-        (new Date(next.time).getTime() - new Date(prev.time).getTime());
-    const value = interpolate(prev.value, next.value, easeSine(progress));
+    const progress = (time.getTime() - prev.time.getTime()) /
+        (next.time.getTime() - prev.time.getTime());
+    const value = interpolate(prev.level, next.level, easeSine(progress));
     return parseFloat(value.toFixed(3));
 }
 /** Interpolate between two values using the given progress (0-1). */

package/dist/index.js

@@ -13,65 +13,58 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { approximateTideHeightAt } from "./calculations.js";
+import { createRoutes } from "@neaps/api";
+import { getExtremesPrediction, getWaterLevelAtTime } from "neaps";
 import FileCache from "./cache.js";
-import createSources from "./sources/index.js";
+import { withVesselPosition } from "./middleware.js";
+// Recompute and republish on a fixed interval. Predictions are computed locally
+// by neaps, so this is cheap and needs no configuration.
+const UPDATE_INTERVAL = 60 * 1000; // 1 minute
+const API_PATH = "/signalk/v2/api/tides";
 export default function (app) {
-    // Interval to update tide data
-    const defaultPeriod = 60; // 1 hour
     let unsubscribes = [];
-    const sources = createSources(app);
+    let activeRouter = null;
+    // Mount forwarding middleware once (Express doesn't support unmounting)
+    // @ts-expect-error: app is an Express app at runtime
+    app.use(API_PATH, (req, res, next) => {
+        if (activeRouter) {
+            activeRouter(req, res, next);
+        }
+        else {
+            next();
+        }
+    });
     const plugin = {
         id: "tides",
         name: "Tides",
-        description: "Tidal predictions for the vessel's position from various online sources.",
+        description: "Offline tidal predictions for the vessel's position, powered by Neaps.",
         schema: () => ({
-            title: "Tides API",
+            title: "Tides",
             type: "object",
-            properties: {
-                source: {
-                    title: "Data source",
-                    type: "string",
-                    anyOf: sources.map(({ id, title }) => ({
-                        const: id,
-                        title,
-                    })),
-                    default: sources[0].id,
-                },
-                // Update plugin schema with sources
-                ...sources.reduce((properties, source) => Object.assign(properties, source.properties ?? {}), {}),
-                period: {
-                    title: "Update frequency",
-                    type: "number",
-                    description: "How often to update tide forecast (minutes)",
-                    default: 60,
-                    minimum: 1,
-                },
-            },
+            properties: {},
         }),
         start,
         stop() {
             unsubscribes.forEach((f) => f());
             unsubscribes = [];
+            activeRouter = null;
         },
     };
-    async function start(props) {
-        app.debug("Starting tides-api: " + JSON.stringify(props));
+    async function start() {
+        app.debug("Starting tides");
         let lastForecast = null;
         let lastPosition = null;
         const cache = new FileCache(app.getDataDirPath());
-        // Use the selected source, or the first one if not specified
-        const source = sources.find((source) => source.id === props.source) || sources[0];
-        // Load the selected source
-        const provider = await source.start(props);
-        // Register the source as a resource provider
+        // Mount the Neaps API, with vessel/current resolved to the nearest station.
+        activeRouter = withVesselPosition(createRoutes({ prefix: API_PATH }), () => lastPosition);
+        // Register tide predictions as a resource provider
         app.registerResourceProvider({
             type: "tides",
             methods: {
-                async listResources(query) {
+                async listResources() {
                     if (!lastPosition)
                         throw new Error("No position available");
-                    return provider({ position: lastPosition, ...query });
+                    return forecastFor(lastPosition);
                 },
                 getResource() {
                     throw new Error("Not implemented");
@@ -89,29 +82,44 @@ export default function (app) {
             subscribe: [
                 {
                     path: "navigation.position",
-                    period: (props.period ?? defaultPeriod) * 60 * 1000,
+                    period: UPDATE_INTERVAL,
                     policy: "fixed",
                 },
             ],
         }, unsubscribes, (subscriptionError) => {
             app.error("Error:" + subscriptionError);
         }, updatePosition);
+        function forecastFor(position) {
+            const now = new Date();
+            return getExtremesPrediction({
+                latitude: position.latitude,
+                longitude: position.longitude,
+                start: now,
+                end: new Date(now.getTime() + 7 * 24 * 60 * 60 * 1000),
+            });
+        }
         async function updatePosition() {
-            lastPosition =
-                app.getSelfPath("navigation.position.value") || (await cache.get("position")) || null;
-            if (lastPosition) {
+            const newPosition = app.getSelfPath("navigation.position.value");
+            // New position received, save it to the cache
+            if (newPosition) {
+                lastPosition = newPosition;
                 await cache.set("position", lastPosition);
-                await updateForecast();
             }
+            // No last known position, try to load from cache.
+            if (!lastPosition) {
+                lastPosition = (await cache.get("position"));
+            }
+            if (lastPosition)
+                updateForecast();
         }
-        async function updateForecast() {
+        function updateForecast() {
             if (!lastPosition) {
-                app.debug("No position available, cannot fetch tide data");
+                app.debug("No position available, cannot compute tide data");
                 return;
             }
             try {
-                lastForecast = await provider({ position: lastPosition });
-                app.setPluginStatus("Updated tide forecast from " + source.title);
+                lastForecast = forecastFor(lastPosition);
+                app.setPluginStatus("Updated tide forecast");
                 updateTides();
             }
             catch (e) {
@@ -121,13 +129,18 @@ export default function (app) {
                 app.error(e);
             }
         }
-        async function updateTides(now = new Date()) {
-            if (!lastForecast)
+        function updateTides(now = new Date()) {
+            if (!lastForecast || !lastPosition)
                 return;
             // Get the next two upcoming extremes
             const nextTides = lastForecast.extremes
-                .filter(({ time }) => new Date(time) >= now)
+                .filter(({ time }) => time >= now)
                 .slice(0, 2);
+            const heightNow = getWaterLevelAtTime({
+                latitude: lastPosition.latitude,
+                longitude: lastPosition.longitude,
+                time: now,
+            }).level;
             const delta = {
                 context: ("vessels." + app.selfId),
                 updates: [
@@ -140,28 +153,35 @@ export default function (app) {
                             },
                             {
                                 path: "environment.tide.heightNow",
-                                value: approximateTideHeightAt(lastForecast.extremes, now),
+                                value: heightNow,
                             },
-                            ...nextTides.flatMap(({ type, time, value }) => {
+                            ...nextTides.flatMap(({ label, time, level }) => {
                                 return [
-                                    { path: `environment.tide.height${type}`, value },
-                                    { path: `environment.tide.time${type}`, value: time },
+                                    {
+                                        path: `environment.tide.height${label}`,
+                                        value: level,
+                                    },
+                                    {
+                                        path: `environment.tide.time${label}`,
+                                        value: time.toISOString(),
+                                    },
                                 ];
                             }),
                         ],
                     },
                 ],
             };
-            app.debug("Sending delta: " + JSON.stringify(delta));
+            if (app.debug.enabled) {
+                app.debug("Sending delta: " + JSON.stringify(delta));
+            }
             app.handleMessage(plugin.id, delta);
         }
         // Perform initial update on startup after short delay to allow gnss position to be populated
-        delay(4000).then(updatePosition);
-        // Update every minute
-        setInterval(updateTides, 60 * 1000);
-    }
-    function delay(time) {
-        return new Promise((resolve) => setTimeout(resolve, time));
+        const startupTimer = setTimeout(updatePosition, 4000);
+        unsubscribes.push(() => clearTimeout(startupTimer));
+        // Recompute the current height and next tides every minute
+        const updateTimer = setInterval(updateTides, UPDATE_INTERVAL);
+        unsubscribes.push(() => clearInterval(updateTimer));
     }
     return plugin;
 }

package/dist/middleware.js

@@ -0,0 +1,49 @@
+import { nearestStation } from 'neaps';
+/**
+ * Middleware that handles vessel/current station endpoints by redirecting to
+ * the nearest real station, and injects the default vessel position for
+ * location-based queries.
+ */
+export function withVesselPosition(router, getPosition) {
+    return (req, res, next) => {
+        const isVesselCurrentPath = /^\/stations\/vessel\/current(?:\/|$)/.test(req.path);
+        // Handle vessel/current station endpoints by redirecting to the nearest real station
+        if (isVesselCurrentPath) {
+            const pos = getPosition();
+            if (!pos) {
+                return res.status(503).json({
+                    message: "Vessel position not available",
+                });
+            }
+            try {
+                const station = nearestStation({
+                    latitude: pos.latitude,
+                    longitude: pos.longitude,
+                });
+                if (!station) {
+                    return res.status(404).json({
+                        message: "No nearby stations found",
+                    });
+                }
+                const path = req.url.replace(/^\/stations\/vessel\/current\b/, `/stations/${station.id}`);
+                // HTTP 303 See Other: the response can be found under a different URI
+                return res.redirect(303, `${req.baseUrl}${path}`);
+            }
+            catch {
+                return res.status(500).json({
+                    message: "Failed to find nearest station",
+                });
+            }
+        }
+        // Inject default position for location-based queries
+        const isLocationQueryPath = req.path === "/extremes" || req.path === "/timeline";
+        if (isLocationQueryPath && !req.query.latitude && !req.query.longitude) {
+            const pos = getPosition();
+            if (pos) {
+                req.query.latitude = String(pos.latitude);
+                req.query.longitude = String(pos.longitude);
+            }
+        }
+        router(req, res, next);
+    };
+}