@signalk/tracks-plugin 3.0.0-beta.3 → 3.0.0-beta.4

package/dist/sourceWatch.d.ts

@@ -1,35 +1,24 @@
 import { Context } from './types.js';
-/**
- * Watches which `$source` each context's positions arrive from.
- *
- * `navigation.position` is a rapid update — a GPS may report at 10Hz — and a
- * typical boat has several receivers: an internal GPS, an AIS transponder, a
- * chart plotter echoing its own fix.
- *
- * Signal K resolves which one wins through source priority, and the bus this
- * plugin listens on is the filtered one: the server applies `toPreferredDelta`
- * before emitting `delta`, which is what feeds `getBus()`. So with a priority
- * rule in place, only the winner arrives and there is nothing to warn about.
- *
- * The gap is when no rule *matches* the path. Then the engine passes every
- * source through, the fixes from receivers metres apart interleave, and the
- * track zigzags between them rather than following the boat. The fix is to
- * configure source priority for `navigation.position`; this watcher exists to
- * say so, because the symptom (a track that looks noisy) does not obviously
- * point at the cause.
- *
- * Detection is therefore empirical rather than reading the priority config:
- * seeing several sources here *is* the evidence that no rule is matching,
- * which a config that merely exists would not tell us.
- */
 export declare class SourceWatch {
+    /** Last time each source produced a position, per context. */
     private readonly seen;
+    /** Sources found competing, per context, with when each was last seen so. */
+    private readonly competing;
+    /** The current alternation per context: who is in it, and how long it is. */
+    private readonly lastSeen;
     /** Record that `context` produced a position from `$source`. */
-    add(context: Context, source: string | undefined): void;
-    /** Sources seen for a context, in the order they first appeared. */
+    add(context: Context, source: string | undefined, now?: number): void;
+    /** Every source seen for a context, in the order they first appeared. */
     sourcesFor(context: Context): string[];
-    /** Contexts receiving positions from more than one source. */
-    conflicted(): Context[];
+    /**
+     * The sources found live at the same time, which is what a warning names.
+     *
+     * Expired entries are dropped rather than merely hidden, so a conflict that
+     * has stopped recurring leaves nothing behind.
+     */
+    competingFor(context: Context, now?: number): string[];
+    /** Contexts that have received positions from two sources at once. */
+    conflicted(now?: number): Context[];
     /**
      * A status line naming the problem, or undefined when nothing is wrong.
      *
@@ -38,7 +27,7 @@ export declare class SourceWatch {
      * vessels are usually AIS, where multiple receivers are expected and less
      * worth nagging about — they are counted, not named.
      */
-    warning(selfContext?: Context): string | undefined;
+    warning(selfContext?: Context, now?: number): string | undefined;
     /** Forget everything seen; used when the plugin restarts. */
     clear(): void;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@signalk/tracks-plugin",
-  "version": "3.0.0-beta.3",
+  "version": "3.0.0-beta.4",
   "description": "Plugin to keep track of tracks of vessels",
   "type": "module",
   "exports": {
@@ -20,12 +20,11 @@
   ],
   "signalk": {
     "displayName": "Tracks",
-    "appIcon": "app-icon.svg"
+    "appIcon": "./app-icon.svg"
   },
   "keywords": [
     "signalk-node-server-plugin",
     "signalk-webapp",
-    "signalk-embeddable-webapp",
     "signalk-category-utility"
   ],
   "author": "Teppo Kurki <teppo.kurki@iki.fi>",