@aurora-blue/signalk-connector 0.2.0-dev.22 → 0.2.0-dev.23

package/README.md

@@ -53,6 +53,8 @@ The connector exchanges the pairing code once and clears it from the Signal K pl
 
 The default configuration sends up to 250 events per batch, waits up to five seconds to combine normal telemetry, samples selected own-vessel Signal K paths every second, samples selected AIS paths every five seconds, and enables the preliminary underway change-or-heartbeat profile. AIS can be disabled independently. The `auto` storage profile selects a constrained, standard, or extended byte budget from filesystem capacity while preserving a free-space reserve. Its effective event limit is derived from measured journal bytes per event instead of a fixed 10,000-event default. Protocol 1.1 permits no more than 500 events per batch, and the server continues to accept exact protocol 1.0 backlog batches during upgrades.
 
+The connector also subscribes to scalar values below `electrical.switches.*`, including separate channels on multi-output devices. Switch paths use the instant subscription policy so a periodic retransmission of a cached Signal K value is not mistaken for fresh device evidence. The server may use selected `.state` leaves for conservative equipment-runtime estimates. A silent or unpowered device stops contributing runtime after a short bounded interval; accurate long-running counters require a qualified device-originated liveness source.
+
 The optional anchor alarm is an experimental development scaffold. When enabled, position is requested every 250 milliseconds and every received position reaches the safety engine before telemetry reduction. The alarm publishes a local Signal K notification and detects stale position input without requiring the Aurora Blue target. It must not yet be used as the sole safety device.
 
 The paired Aurora Blue target controls the device operating mode. Active mode collects and transfers normal telemetry. Standby stops admitting new historical telemetry, drains existing backlog, and keeps only the local position input required by an enabled anchor alarm. Disabled mode preserves the backlog but stops collection, transfer, and local safety subscriptions. Standby and disabled connectors continue a low-rate authenticated configuration heartbeat so an administrator can reactivate them remotely.

package/VERSION

@@ -1 +1 @@
-0.2.0-dev.22
+0.2.0-dev.23

package/dist/src/connector.js

@@ -337,14 +337,16 @@ class ConnectorRuntime {
     subscribeToContext(context, paths, period) {
         this.app.subscriptionmanager.subscribe({
             context,
-            subscribe: paths.map((path) => ({
-                path: path,
-                period: context === "vessels.self" &&
-                    path === "navigation.position" &&
-                    this.config.anchorAlarm.enabled
-                    ? Math.min(this.config.samplePeriodMs, this.config.safetySamplePeriodMs)
-                    : period,
-            })),
+            subscribe: paths.map((path) => context === "vessels.self" && path === "electrical.switches.*"
+                ? { path: path, policy: "instant", minPeriod: 0 }
+                : {
+                    path: path,
+                    period: context === "vessels.self" &&
+                        path === "navigation.position" &&
+                        this.config.anchorAlarm.enabled
+                        ? Math.min(this.config.samplePeriodMs, this.config.safetySamplePeriodMs)
+                        : period,
+                }),
         }, this.unsubscribes, (error) => {
             this.app.setPluginError("Signal K subscription failed.");
             this.app.error(error instanceof Error ? error.message : String(error));

package/dist/src/delta.js

@@ -53,6 +53,15 @@ const validValue = (context, path, value) => {
     if (definition.valueKind === "number") {
         return typeof value === "number" && Number.isFinite(value) ? value : null;
     }
+    if (definition.valueKind === "switch") {
+        if (typeof value === "boolean")
+            return value;
+        if (typeof value === "number" && Number.isFinite(value))
+            return value;
+        return typeof value === "string" && value.length > 0
+            ? value.slice(0, 255)
+            : null;
+    }
     if (definition.valueKind === "string") {
         if (path === "mmsi" && !/^[0-9]{9}$/.test(String(value))) {
             return null;
@@ -101,6 +110,32 @@ const flattenedStaticValues = (context, path, value) => {
         { path: "navigation.state", value: navigation?.state },
     ];
 };
+const flattenedSwitchValues = (path, value) => {
+    if (path !== "electrical.switches" &&
+        !path.startsWith("electrical.switches.")) {
+        return [{ path, value }];
+    }
+    const leaves = [];
+    const visit = (currentPath, currentValue, depth) => {
+        if (leaves.length >= 100 || depth > 8)
+            return;
+        if (currentValue === null || Array.isArray(currentValue))
+            return;
+        if (typeof currentValue !== "object") {
+            leaves.push({ path: currentPath, value: currentValue });
+            return;
+        }
+        for (const [name, child] of Object.entries(currentValue)) {
+            if (!/^[A-Za-z0-9_:-]+$/.test(name))
+                continue;
+            visit(`${currentPath}.${name}`, child, depth + 1);
+            if (leaves.length >= 100)
+                break;
+        }
+    };
+    visit(path, value, 0);
+    return leaves;
+};
 const eventsFromDelta = (delta, bootId, receivedAt, subscriptionScope = "self") => {
     const events = [];
     const context = eventContext(delta, subscriptionScope);
@@ -115,7 +150,11 @@ const eventsFromDelta = (delta, bootId, receivedAt, subscriptionScope = "self")
             if (pathValue.state?.timedOut === true) {
                 continue;
             }
-            for (const candidate of flattenedStaticValues(context, String(pathValue.path), pathValue.value)) {
+            const path = String(pathValue.path);
+            const candidates = context === "vessels.self"
+                ? flattenedSwitchValues(path, pathValue.value)
+                : flattenedStaticValues(context, path, pathValue.value);
+            for (const candidate of candidates) {
                 const value = validValue(context, candidate.path, candidate.value);
                 if (value === null) {
                     continue;

package/dist/src/telemetry-catalog.d.ts

@@ -1,6 +1,6 @@
 import type { EventContext } from "./types";
 export type TelemetryScope = "self" | "ais";
-export type ValueKind = "number" | "position" | "string" | "aisShipType";
+export type ValueKind = "number" | "position" | "string" | "boolean" | "switch" | "aisShipType";
 export type ChangeKind = "scalar" | "angle" | "position" | "identity";
 export interface TelemetryDefinition {
     scope: TelemetryScope;

package/dist/src/telemetry-catalog.js

@@ -72,7 +72,7 @@ exports.AIS_TELEMETRY = [
     ais("communication.callsignVhf", "string", "identity", 60_000, 21_600_000, 0),
     ais("design.aisShipType", "aisShipType", "identity", 60_000, 21_600_000, 0),
 ];
-exports.SELF_SUBSCRIPTION_PATHS = exports.SELF_TELEMETRY.map((definition) => definition.path);
+exports.SELF_SUBSCRIPTION_PATHS = exports.SELF_TELEMETRY.map((definition) => definition.path).concat("electrical.switches.*");
 exports.AIS_SUBSCRIPTION_PATHS = exports.AIS_TELEMETRY.map((definition) => definition.path);
 const matchesPath = (pattern, path) => {
     const patternParts = pattern.split(".");
@@ -83,6 +83,12 @@ const matchesPath = (pattern, path) => {
 const isAisContext = (context) => /^vessels\.(?:urn:mrn:imo:mmsi:)?[0-9]{9}$/.test(context);
 exports.isAisContext = isAisContext;
 const telemetryDefinition = (context, path) => {
+    if (context === "vessels.self" &&
+        path.startsWith("electrical.switches.") &&
+        path.length <= 255 &&
+        /^electrical\.switches\.[A-Za-z0-9_:-]+(?:\.[A-Za-z0-9_:-]+)+$/.test(path)) {
+        return self(path, "switch", "identity", 0, 60_000, 0);
+    }
     const definitions = context === "vessels.self"
         ? exports.SELF_TELEMETRY
         : (0, exports.isAisContext)(context)

package/dist/src/types.d.ts

@@ -19,7 +19,7 @@ export interface AisShipTypeValue {
     id: number;
     name: string;
 }
-export type EventValue = number | string | PositionValue | AisShipTypeValue;
+export type EventValue = number | string | boolean | PositionValue | AisShipTypeValue;
 export interface EventInput {
     boot_id: string;
     context: EventContext;

package/dist/src/version.d.ts

@@ -1 +1 @@
-export declare const CONNECTOR_VERSION = "0.2.0-dev.22";
+export declare const CONNECTOR_VERSION = "0.2.0-dev.23";

package/dist/src/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CONNECTOR_VERSION = void 0;
-exports.CONNECTOR_VERSION = "0.2.0-dev.22";
+exports.CONNECTOR_VERSION = "0.2.0-dev.23";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aurora-blue/signalk-connector",
-  "version": "0.2.0-dev.22",
+  "version": "0.2.0-dev.23",
   "description": "Signal K edge connector for the Aurora Blue ABOARD ingest protocol",
   "private": false,
   "main": "dist/src/index.js",