signalk-tides 1.4.0 → 2.0.0-beta.0

package/.github/workflows/ci.yml

@@ -0,0 +1,65 @@
+name: CI
+
+on:
+  push: {}
+
+jobs:
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v6
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v6
+
+      - name: Install dependencies
+        run: npm install
+
+      - name: Run linter
+        run: npm run lint
+
+  test:
+    name: Test
+    runs-on: ubuntu-latest
+    env:
+      CI: true
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v6
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v6
+
+      - 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 online 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,195 +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
+
+It also registers a `tides` resource, which returns the next 7 days of tide extremes for the vessel's position.
 
-* `date` (optional) - the date for which to get the tide predictions in the format `YYYY-MM-DD`. Default: yesterday's date.
+```
+$ 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
-
-- [NOAA](https://tidesandcurrents.noaa.gov/web_services_info.html) (US only)
-- [WorldTides API](https://www.worldtides.info/) (requires an API key)
-- [StormGlass.io](https://stormglass.io/) (requires an API key)
-
 ## 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/cache.js

@@ -1,28 +1,25 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const path_1 = require("path");
-const promises_1 = require("fs/promises");
-class FileCache {
+import { join } from "path";
+import { writeFile, readFile, mkdir } from "fs/promises";
+export default class FileCache {
     path;
     constructor(path) {
         this.path = path;
     }
     async get(key) {
         try {
-            const content = await (0, promises_1.readFile)(this.getKey(key), 'utf-8');
+            const content = await readFile(this.getKey(key), "utf-8");
             return JSON.parse(content);
         }
-        catch (err) {
+        catch {
             return undefined;
         }
     }
     async set(key, value) {
         // Ensure directory exists
-        await (0, promises_1.mkdir)(this.path, { recursive: true });
-        return (0, promises_1.writeFile)(this.getKey(key), JSON.stringify(value));
+        await mkdir(this.path, { recursive: true });
+        return writeFile(this.getKey(key), JSON.stringify(value));
     }
     getKey(key) {
-        return (0, path_1.join)(this.path, `${key}.json`);
+        return join(this.path, `${key}.json`);
     }
 }
-exports.default = FileCache;

package/dist/calculations.js

@@ -1,18 +1,15 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.approximateTideHeightAt = approximateTideHeightAt;
 /** Given a list of tide extremes, estimate the height at a specific time. */
-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);
+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());
     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). */