signalk-tides 2.0.0-beta.0 → 2.0.0

package/.github/workflows/ci.yml

@@ -9,7 +9,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
 
       - name: Setup Node.js
         uses: actions/setup-node@v6
@@ -27,7 +27,7 @@ jobs:
       CI: true
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
 
       - name: Setup Node.js
         uses: actions/setup-node@v6
@@ -51,7 +51,7 @@ jobs:
       id-token: write
       pull-requests: write
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v7
 
       - uses: actions/setup-node@v6
 

package/.playwright-mcp/console-2026-06-12T14-41-49-989Z.log

@@ -0,0 +1,60 @@
+[     188ms] [LOG] [ConnectionStateMachine] Service initialized @ http://localhost:3000/@mxtommy/kip/chunk-2TP7C66X.js:0
+[     191ms] [LOG] [ConnectionStateMachine] Starting HTTP discovery: Connecting to http://localhost:3000 @ http://localhost:3000/@mxtommy/kip/chunk-2TP7C66X.js:0
+[     192ms] [LOG] [Connection Service] Connecting to: http://localhost:3000 @ http://localhost:3000/@mxtommy/kip/chunk-2TP7C66X.js:0
+[     213ms] [LOG] [ConnectionStateMachine] HTTP discovery successful @ http://localhost:3000/@mxtommy/kip/chunk-2TP7C66X.js:0
+[     214ms] [LOG] [AppSettings Service] Service startup... @ http://localhost:3000/@mxtommy/kip/chunk-2TP7C66X.js:3
+[     214ms] [LOG] [AppSettings Service] LocalStorage enabled @ http://localhost:3000/@mxtommy/kip/chunk-2TP7C66X.js:4
+[     214ms] [LOG] [DatasetStreamService] Auto Starting 0 Datasets @ http://localhost:3000/@mxtommy/kip/chunk-5SMHTIVS.js:0
+[     214ms] [LOG] [AppInit Network Service] Initialization completed @ http://localhost:3000/@mxtommy/kip/main-UBENKC2D.js:0
+[     214ms] [LOG] [ConnectionStateMachine] WebSocket mode enabled @ http://localhost:3000/@mxtommy/kip/chunk-2TP7C66X.js:0
+[     214ms] [LOG] [AppInit Network Service] Starting WebSocket connection after initialization @ http://localhost:3000/@mxtommy/kip/main-UBENKC2D.js:0
+[     214ms] [LOG] [ConnectionStateMachine] Starting WebSocket connection @ http://localhost:3000/@mxtommy/kip/chunk-2TP7C66X.js:0
+[     215ms] [LOG] [Delta Service] ConnectionStateMachine request: WebSocket opening... @ http://localhost:3000/@mxtommy/kip/chunk-IXUKD73N.js:0
+[     220ms] [LOG] [Remote Dashboards] Cleaning paths on server @ http://localhost:3000/@mxtommy/kip/main-UBENKC2D.js:0
+[     221ms] [LOG] [UI Event Service] PWA mode: false @ http://localhost:3000/@mxtommy/kip/chunk-5SMHTIVS.js:49
+[     226ms] [LOG] *********** KIP Version Information *********** @ http://localhost:3000/@mxtommy/kip/chunk-NS2OV2OW.js:0
+[     226ms] [LOG] ** App Version: 4.8.0 @ http://localhost:3000/@mxtommy/kip/chunk-NS2OV2OW.js:0
+[     226ms] [LOG] ** Browser Version: Chrome 149 @ http://localhost:3000/@mxtommy/kip/chunk-NS2OV2OW.js:0
+[     226ms] [LOG] ** OS Version: macOS @ http://localhost:3000/@mxtommy/kip/chunk-NS2OV2OW.js:0
+[     226ms] [LOG] *********************************************** @ http://localhost:3000/@mxtommy/kip/chunk-NS2OV2OW.js:0
+[     229ms] [LOG] [AppSettings Service] Saving Dashboard config to LocalStorage @ http://localhost:3000/@mxtommy/kip/chunk-2TP7C66X.js:4
+[     248ms] [LOG] [Delta Service] WebSocket connected without Authorization Token @ http://localhost:3000/@mxtommy/kip/chunk-IXUKD73N.js:0
+[     248ms] [LOG] [ConnectionStateMachine] WebSocket connected @ http://localhost:3000/@mxtommy/kip/chunk-2TP7C66X.js:0
+[     249ms] [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
+[     370ms] [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
+[     370ms] [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
+[     370ms] [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
+[     380ms] [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
+[     476ms] [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
+[     934ms] [INFO] Internet connection detected. @ http://localhost:3000/@signalk/freeboard-sk/main-YHMZXR5G.js:249
+[     940ms] [ERROR] Failed to load resource: the server responded with a status of 401 (Unauthorized) @ http://localhost:3000/plugins/freeboard-sk:0
+[    1000ms] [ERROR] Failed to load resource: the server responded with a status of 401 (Unauthorized) @ http://localhost:3000/plugins/kip:0
+[    1000ms] [LOG] [KipSeriesApiClientService] POST http://localhost:3000/plugins/kip/series/reconcile (0 series) @ http://localhost:3000/@mxtommy/kip/chunk-6ZR3M3IQ.js:2
+[    1007ms] [ERROR] Failed to load resource: the server responded with a status of 401 (Unauthorized) @ http://localhost:3000/plugins/kip/series/reconcile:0
+[    1007ms] [ERROR] [KipSeriesApiClientService] Series reconcile request failed: Ar @ http://localhost:3000/@mxtommy/kip/chunk-6ZR3M3IQ.js:2
+[    1073ms] [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
+[   87530ms] [ERROR] Failed to load resource: the server responded with a status of 401 (Unauthorized) @ http://localhost:3000/plugins/freeboard-sk:0
+[   87531ms] [ERROR] Failed to load resource: the server responded with a status of 401 (Unauthorized) @ http://localhost:3000/plugins/anchoralarm:0
+[   87532ms] [ERROR] Failed to load resource: the server responded with a status of 401 (Unauthorized) @ http://localhost:3000/plugins/tracks:0
+[   87532ms] [ERROR] Failed to load resource: the server responded with a status of 401 (Unauthorized) @ http://localhost:3000/plugins/signalk-polar-performance-plugin:0
+[   87532ms] [ERROR] Failed to load resource: the server responded with a status of 401 (Unauthorized) @ http://localhost:3000/plugins/resources-provider:0
+[   87536ms] [ERROR] Failed to load resource: the server responded with a status of 401 (Unauthorized) @ http://localhost:3000/plugins/signalk-racer:0
+[   87572ms] [ERROR] Failed to load resource: the server responded with a status of 401 (Unauthorized) @ http://localhost:3000/plugins/course-provider:0
+[   87573ms] [ERROR] Failed to load resource: the server responded with a status of 401 (Unauthorized) @ http://localhost:3000/plugins/autopilot:0
+[   87573ms] [ERROR] Failed to load resource: the server responded with a status of 401 (Unauthorized) @ http://localhost:3000/plugins/pypilot-autopilot-provider:0
+[  112153ms] [ERROR] ERROR _: NG0951
+    at Object.computation (http://localhost:3000/@mxtommy/kip/chunk-LEY6MANN.js:4:94168)
+    at Object.producerRecomputeValue (http://localhost:3000/@mxtommy/kip/chunk-LEY6MANN.js:3:33213)
+    at Qn (http://localhost:3000/@mxtommy/kip/chunk-LEY6MANN.js:3:30918)
+    at n.r [as iframe] (http://localhost:3000/@mxtommy/kip/chunk-LEY6MANN.js:3:32825)
+    at n.ngAfterViewInit (http://localhost:3000/@mxtommy/kip/chunk-5SMHTIVS.js:44:361583)
+    at ng (http://localhost:3000/@mxtommy/kip/chunk-LEY6MANN.js:4:27312)
+    at rI (http://localhost:3000/@mxtommy/kip/chunk-LEY6MANN.js:4:27474)
+    at Gg (http://localhost:3000/@mxtommy/kip/chunk-LEY6MANN.js:4:27201)
+    at wa (http://localhost:3000/@mxtommy/kip/chunk-LEY6MANN.js:4:26929)
+    at bS (http://localhost:3000/@mxtommy/kip/chunk-LEY6MANN.js:4:67813) @ http://localhost:3000/@mxtommy/kip/chunk-LEY6MANN.js:3
+[  263184ms] [LOG] [AppSettings Service] Saving Dashboard config to LocalStorage @ http://localhost:3000/@mxtommy/kip/chunk-2TP7C66X.js:4
+[  263185ms] [LOG] [AppSettings Service] Saving Application config to LocalStorage @ http://localhost:3000/@mxtommy/kip/chunk-2TP7C66X.js:4
+[  399636ms] [LOG] [AppSettings Service] Saving Dashboard config to LocalStorage @ http://localhost:3000/@mxtommy/kip/chunk-2TP7C66X.js:4
+[  399636ms] [LOG] [AppSettings Service] Saving Application config to LocalStorage @ http://localhost:3000/@mxtommy/kip/chunk-2TP7C66X.js:4
+[ 4767580ms] [LOG] [Delta Service] App suspended @ http://localhost:3000/@mxtommy/kip/chunk-IXUKD73N.js:0

package/.playwright-mcp/console-2026-06-12T14-51-31-609Z.log

@@ -0,0 +1,5 @@
+[    2353ms] [ERROR] Failed to load resource: the server responded with a status of 401 (Unauthorized) @ http://localhost:3000/skServer/plugins:0
+[    2353ms] [ERROR] Failed to load resource: the server responded with a status of 401 (Unauthorized) @ http://localhost:3000/skServer/appstore/available:0
+[    2353ms] [ERROR] Failed to load resource: the server responded with a status of 401 (Unauthorized) @ http://localhost:3000/skServer/security/access/requests:0
+[    2427ms] [LOG] connected @ http://localhost:3000/admin/assets/bootstrap-BbNbkfZh.js:69
+[    3712ms] [ERROR] Failed to load resource: the server responded with a status of 404 (Not Found) @ http://localhost:3000/signalk-usage/assets/icons/signalk-usage-icon_72x72.png:0

package/README.md

@@ -21,13 +21,15 @@ It publishes the following [tide data](https://signalk.org/specification/1.7.0/d
 * `environment.tide.timeLow`
 * `environment.tide.heightNow`
 * `environment.tide.stationName`
+* `environment.tide.state` — tide trend, `rising` or `falling`
+* `environment.tide.timeToNextExtreme` — seconds until the next high or low water
 
 ### Tides API
 
-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:
+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/default` resolves to the configured default station, or the nearest station to the vessel when none is set:
 
 ```
-$ curl http://localhost:3000/signalk/v2/api/tides/stations/vessel/current/extremes
+$ curl http://localhost:3000/signalk/v2/api/tides/stations/vessel/default/extremes
 ```
 
 ### Tides resource

package/dist/calculations.js

@@ -1,24 +1,37 @@
-/** 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) => 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());
+/**
+ * Trend of the tide at `time`: "rising" if the next extreme is a High,
+ * "falling" if it is a Low.
+ *
+ * Boundary: at the instant of an extreme the extreme itself satisfies
+ * `extreme.time >= time`, so it is still "next", and the state reads as that
+ * extreme's own type — e.g. "falling" with timeToNextExtreme 0 at the instant
+ * of low water — flipping on the following tick. Simplest consistent rule at
+ * one-minute resolution.
+ *
+ * Returns null when the forecast has no upcoming extreme (stale data).
+ */
+export function tideStateAt(extremes, time) {
+    const next = nextExtremeAt(extremes, time);
     if (!next)
-        throw new Error("Missing height data after " + time.toISOString());
-    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));
+        return null;
+    return next.high ? "rising" : "falling";
 }
-/** Interpolate between two values using the given progress (0-1). */
-function interpolate(start, end, progress) {
-    return start + (end - start) * progress;
+/** First extreme at or after `time`, or undefined. Tolerates unsorted input. */
+function nextExtremeAt(extremes, time) {
+    return extremes
+        .slice()
+        .sort((a, b) => a.time.getTime() - b.time.getTime())
+        .find((extreme) => extreme.time >= time);
 }
-function easeSine(progress) {
-    // Map progress [0..1] to angle [0..π]
-    const angle = progress * Math.PI;
-    // Use sine to ease in/out
-    return (1 - Math.cos(angle)) / 2;
+/**
+ * Whole seconds (rounded up) until the next tide extreme (high or low water)
+ * at `time`, or null when the forecast has no upcoming extreme. Ceiling keeps
+ * the countdown > 0 until the extreme is actually reached; see tideStateAt
+ * for the exactly-at-extreme boundary behaviour (this returns 0 for that tick).
+ */
+export function timeToNextExtreme(extremes, time) {
+    const next = nextExtremeAt(extremes, time);
+    if (!next)
+        return null;
+    return Math.ceil((next.time.getTime() - time.getTime()) / 1000);
 }

package/dist/index.js

@@ -14,7 +14,8 @@
  * limitations under the License.
  */
 import { createRoutes } from "@neaps/api";
-import { getExtremesPrediction, getWaterLevelAtTime } from "neaps";
+import { findStation, nearestStation, stationsNear } from "neaps";
+import { tideStateAt, timeToNextExtreme } from "./calculations.js";
 import FileCache from "./cache.js";
 import { withVesselPosition } from "./middleware.js";
 // Recompute and republish on a fixed interval. Predictions are computed locally
@@ -24,6 +25,8 @@ const API_PATH = "/signalk/v2/api/tides";
 export default function (app) {
     let unsubscribes = [];
     let activeRouter = null;
+    let lastPosition = null;
+    let config = {};
     // 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) => {
@@ -41,7 +44,15 @@ export default function (app) {
         schema: () => ({
             title: "Tides",
             type: "object",
-            properties: {},
+            properties: {
+                defaultStation: {
+                    type: "string",
+                    title: "Default tide station",
+                    description: "Use the closest station to the vessel's current position, or pick a default nearby station.",
+                    default: "auto",
+                    oneOf: defaultStationOptions(),
+                },
+            },
         }),
         start,
         stop() {
@@ -50,21 +61,59 @@ export default function (app) {
             activeRouter = null;
         },
     };
-    async function start() {
+    function defaultStationOptions() {
+        const options = [{ const: "auto", title: "Closest station" }];
+        if (lastPosition) {
+            for (const station of stationsNear({ ...lastPosition, maxResults: 10 })) {
+                options.push({ const: station.id, title: stationTitle(station) });
+            }
+        }
+        // Keep the saved station selectable even when it is not in the nearby
+        // list, so opening the settings far from it (or before a position fix)
+        // cannot clobber it on save.
+        const saved = savedDefaultStation();
+        if (saved && saved !== "auto" && !options.some((o) => o.const === saved)) {
+            let title = saved;
+            try {
+                title = stationTitle(findStation(saved));
+            }
+            catch {
+                // Unknown id: keep the raw value as the label
+            }
+            options.splice(1, 0, { const: saved, title });
+        }
+        return options;
+    }
+    function savedDefaultStation() {
+        try {
+            const saved = app.readPluginOptions();
+            return saved?.configuration?.defaultStation;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    async function start(options) {
         app.debug("Starting tides");
+        config = (options ?? {});
+        // Keep the forecast and the predictor that produced it together, so the
+        // extremes and the current height are always read from the same station.
         let lastForecast = null;
-        let lastPosition = null;
+        let lastPredictor = null;
         const cache = new FileCache(app.getDataDirPath());
-        // Mount the Neaps API, with vessel/current resolved to the nearest station.
-        activeRouter = withVesselPosition(createRoutes({ prefix: API_PATH }), () => lastPosition);
+        // Mount the Neaps API, with vessel/default resolved to the configured
+        // default station (or the nearest one).
+        activeRouter = withVesselPosition(createRoutes({ prefix: API_PATH }), () => lastPosition, () => config.defaultStation ?? null);
         // Register tide predictions as a resource provider
         app.registerResourceProvider({
             type: "tides",
             methods: {
                 async listResources() {
-                    if (!lastPosition)
-                        throw new Error("No position available");
-                    return forecastFor(lastPosition);
+                    const predictor = resolvePredictor();
+                    if (!predictor) {
+                        throw new Error("No position or default station available");
+                    }
+                    return forecastFor(predictor);
                 },
                 getResource() {
                     throw new Error("Not implemented");
@@ -89,11 +138,28 @@ export default function (app) {
         }, unsubscribes, (subscriptionError) => {
             app.error("Error:" + subscriptionError);
         }, updatePosition);
-        function forecastFor(position) {
+        function resolvePredictor() {
+            if (config.defaultStation && config.defaultStation !== "auto") {
+                try {
+                    return findStation(config.defaultStation);
+                }
+                catch {
+                    app.error(`Configured tide station not found: ${config.defaultStation}`);
+                }
+            }
+            if (lastPosition) {
+                try {
+                    return nearestStation(lastPosition);
+                }
+                catch {
+                    app.error("No tide station found near vessel position");
+                }
+            }
+            return null;
+        }
+        function forecastFor(predictor) {
             const now = new Date();
-            return getExtremesPrediction({
-                latitude: position.latitude,
-                longitude: position.longitude,
+            return predictor.getExtremesPrediction({
                 start: now,
                 end: new Date(now.getTime() + 7 * 24 * 60 * 60 * 1000),
             });
@@ -109,16 +175,20 @@ export default function (app) {
             if (!lastPosition) {
                 lastPosition = (await cache.get("position"));
             }
-            if (lastPosition)
-                updateForecast();
+            // A configured default station predicts without a position
+            updateForecast();
         }
         function updateForecast() {
-            if (!lastPosition) {
-                app.debug("No position available, cannot compute tide data");
+            const predictor = resolvePredictor();
+            if (!predictor) {
+                app.debug("No position or default station available, cannot compute tide data");
+                lastForecast = null;
+                lastPredictor = null;
                 return;
             }
             try {
-                lastForecast = forecastFor(lastPosition);
+                lastForecast = forecastFor(predictor);
+                lastPredictor = predictor;
                 app.setPluginStatus("Updated tide forecast");
                 updateTides();
             }
@@ -130,17 +200,15 @@ export default function (app) {
             }
         }
         function updateTides(now = new Date()) {
-            if (!lastForecast || !lastPosition)
+            if (!lastForecast || !lastPredictor)
                 return;
             // Get the next two upcoming extremes
             const nextTides = lastForecast.extremes
                 .filter(({ time }) => time >= now)
                 .slice(0, 2);
-            const heightNow = getWaterLevelAtTime({
-                latitude: lastPosition.latitude,
-                longitude: lastPosition.longitude,
-                time: now,
-            }).level;
+            const heightNow = lastPredictor.getWaterLevelAtTime({ time: now }).level;
+            const state = tideStateAt(lastForecast.extremes, now);
+            const secondsToNextExtreme = timeToNextExtreme(lastForecast.extremes, now);
             const delta = {
                 context: ("vessels." + app.selfId),
                 updates: [
@@ -155,6 +223,19 @@ export default function (app) {
                                 path: "environment.tide.heightNow",
                                 value: heightNow,
                             },
+                            // Omitted (not null) when the forecast has no upcoming extreme,
+                            // matching how the nextTides flatMap below goes empty.
+                            ...(state !== null
+                                ? [{ path: "environment.tide.state", value: state }]
+                                : []),
+                            ...(secondsToNextExtreme !== null
+                                ? [
+                                    {
+                                        path: "environment.tide.timeToNextExtreme",
+                                        value: secondsToNextExtreme,
+                                    },
+                                ]
+                                : []),
                             ...nextTides.flatMap(({ label, time, level }) => {
                                 return [
                                     {
@@ -169,6 +250,24 @@ export default function (app) {
                             }),
                         ],
                     },
+                    {
+                        timestamp: now.toISOString(),
+                        meta: [
+                            {
+                                path: "environment.tide.state",
+                                value: {
+                                    description: "Tide trend at the current position: rising or falling",
+                                },
+                            },
+                            {
+                                path: "environment.tide.timeToNextExtreme",
+                                value: {
+                                    units: "s",
+                                    description: "Seconds until the next tide extreme (high or low water)",
+                                },
+                            },
+                        ],
+                    },
                 ],
             };
             if (app.debug.enabled) {
@@ -185,3 +284,8 @@ export default function (app) {
     }
     return plugin;
 }
+function stationTitle(station) {
+    const where = [station.region, station.country].filter(Boolean).join(", ");
+    const distance = station.distance != null ? ` — ${station.distance.toFixed(1)} km` : "";
+    return `${station.name}${where ? ` (${where})` : ""}${distance}`;
+}

package/dist/middleware.js

@@ -1,33 +1,46 @@
-import { nearestStation } from 'neaps';
+import { findStation, 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.
+ * Middleware that resolves the vessel/default station alias and bare
+ * location-based queries (/extremes, /timeline) against the configured default
+ * station, falling back to the station nearest the vessel's position when no
+ * default is set.
  */
-export function withVesselPosition(router, getPosition) {
+export function withVesselPosition(router, getPosition, getDefaultStationId) {
     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) {
+        // HTTP 303 See Other: the response can be found under a different URI
+        const redirect = (toPath) => res.redirect(303, `${req.baseUrl}${toPath}`);
+        // The configured default station, or null when unset, "auto", or stale.
+        const defaultStation = () => {
+            const id = getDefaultStationId?.();
+            if (!id || id === "auto")
+                return null;
+            try {
+                return findStation(id);
+            }
+            catch {
+                return null; // stale or invalid saved id: fall back to position
+            }
+        };
+        // Redirect the vessel/default alias to the configured (or nearest) station.
+        if (/^\/stations\/vessel\/default(?:\/|$)/.test(req.path)) {
+            const toStation = (station) => redirect(req.url.replace(/^\/stations\/vessel\/default\b/, `/stations/${station.id}`));
+            // A configured default station resolves without a position
+            const station = defaultStation();
+            if (station)
+                return toStation(station);
             const pos = getPosition();
             if (!pos) {
-                return res.status(503).json({
-                    message: "Vessel position not available",
-                });
+                return res.status(503).json({ message: "Vessel position not available" });
             }
             try {
-                const station = nearestStation({
+                const nearest = nearestStation({
                     latitude: pos.latitude,
                     longitude: pos.longitude,
                 });
-                if (!station) {
-                    return res.status(404).json({
-                        message: "No nearby stations found",
-                    });
+                if (!nearest) {
+                    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}`);
+                return toStation(nearest);
             }
             catch {
                 return res.status(500).json({
@@ -35,9 +48,14 @@ export function withVesselPosition(router, getPosition) {
                 });
             }
         }
-        // Inject default position for location-based queries
+        // Bare location-based queries: redirect to the configured station when set,
+        // otherwise inject the vessel position so neaps uses the nearest station.
         const isLocationQueryPath = req.path === "/extremes" || req.path === "/timeline";
         if (isLocationQueryPath && !req.query.latitude && !req.query.longitude) {
+            const station = defaultStation();
+            if (station) {
+                return redirect(req.url.replace(/^\/(extremes|timeline)\b/, `/stations/${station.id}/$1`));
+            }
             const pos = getPosition();
             if (pos) {
                 req.query.latitude = String(pos.latitude);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "signalk-tides",
-  "version": "2.0.0-beta.0",
+  "version": "2.0.0",
   "description": "Tidal predictions for the vessel's position, powered by Neaps.",
   "type": "module",
   "main": "./dist/index.js",
@@ -34,11 +34,11 @@
   ],
   "license": "Apache-2.0",
   "dependencies": {
-    "@neaps/api": "https://pkg.pr.new/openwatersio/neaps/@neaps/api@4eed5db",
-    "@neaps/react": "https://pkg.pr.new/openwatersio/neaps/@neaps/react@4eed5db",
-    "@signalk/server-api": "^2.0",
+    "@neaps/api": "^0.5.1",
+    "@neaps/react": "^0.1.0",
+    "@signalk/server-api": "^2.28.0",
     "express": "^4.0",
-    "neaps": "https://pkg.pr.new/openwatersio/neaps@4eed5db",
+    "neaps": "^0.7.0",
     "react": "^19.1.0",
     "react-dom": "^19.1.0"
   },
@@ -53,7 +53,7 @@
     "@types/react": "^19.0.12",
     "@types/react-dom": "^19.0.4",
     "@types/supertest": "^7.2.0",
-    "@vitejs/plugin-react": "^5.0.2",
+    "@vitejs/plugin-react": "^6.0.2",
     "@vitest/browser": "^4.0.18",
     "@vitest/browser-playwright": "^4.0.18",
     "@vitest/ui": "^4.0.18",