signalk-sailboat-simulator 0.3.0 → 0.3.1

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## [0.3.1] - 2026-09-09
+
+- Report polar loading and validation failures through the Signal K plugin error channel with their detailed cause.
+
 ## [0.3.0] - 2026-09-09
 
 - Calculate simulated boat speed directly from the active `signalk-polar-management` polar resource via `polar-math`.

package/index.js

@@ -479,8 +479,13 @@ module.exports = function createPlugin (app) {
   }
 
   function setStatus () {
-    if (!app.setPluginStatus) return
-    if (runtime.status === 'sailing') {
+    if (runtime.status === 'polarError') {
+      setError(`Polar error: ${runtime.polar && runtime.polar.error ? runtime.polar.error : 'unable to calculate boat speed'}`)
+    } else if (runtime.status === 'error') {
+      setError(`Simulator error: ${runtime.error || 'unexpected runtime failure'}`)
+    } else if (!app.setPluginStatus) {
+      return
+    } else if (runtime.status === 'sailing') {
       app.setPluginStatus(`Sailing at ${runtime.speedOverGround.toFixed(2)} m/s, heading ${runtime.headingTrueDeg.toFixed(1)} deg`)
     } else if (runtime.status === 'groundingProtection') {
       app.setPluginStatus(`Stopped: distance to shore ${runtime.distanceToShore.toFixed(1)} m`)
@@ -489,6 +494,14 @@ module.exports = function createPlugin (app) {
     }
   }
 
+  function setError (message) {
+    if (typeof app.setPluginError === 'function') {
+      app.setPluginError(message)
+    } else if (typeof app.setPluginStatus === 'function') {
+      app.setPluginStatus(message)
+    }
+  }
+
   function registerWithRouter (router) {
     router.get('/api/status', (req, res) => {
       res.json({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "signalk-sailboat-simulator",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Signal K plugin that simulates a sailing boat from autopilot turn-rate output, weather and an active polar resource.",
   "main": "index.js",
   "scripts": {