signalk-tides 1.5.0 → 2.0.0-beta.1

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/.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

@@ -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
 
@@ -20,205 +21,44 @@ 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 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,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) => 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);
-    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() - new Date(prev.time).getTime()) /
-        (new Date(next.time).getTime() - new Date(prev.time).getTime());
-    const value = interpolate(prev.value, next.value, 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);
 }