signalk-underkeel 0.4.0 → 0.5.1

package/CHANGELOG.md

@@ -2,6 +2,54 @@
 
 All notable changes to signalk-underkeel are documented here.
 
+## [0.5.1] - 2026-11-10
+
+### Changed
+
+- The package is listed in the Signal K plugin registry's **Plotter Extensions** category
+  (keyword `signalk-category-plotter-extensions`).
+
+## [0.5.0] - 2026-11-09
+
+### Changed
+
+- **Breaking:** ENC cells come only from a chart provider service. **ENC cells directory**,
+  **ENC from Charts Provider** and **Ask Charts Provider for the ENC around the vessel** are
+  replaced by one pulldown, **Charts provider**, which chooses the service:
+  signalk-charts-provider-simple. Every ENC cell it shares is read, and the pulldown marks it
+  when it is not running and says what it shares. Cells of your own reach the index by
+  converting them in the charts provider with its **Keep the ENC cells of converted charts**
+  on.
+- Each new index box asks the chosen charts provider for the ENC cells of its area, without a
+  setting of its own; its **Download the ENC cells around the vessel** decides whether it
+  downloads them (signalk-charts-provider-simple 2.18.0 or later).
+- Where the vessel has no chart coverage, the reason adds what the charts provider answered
+  for the box: it is downloading the area, it has no ENC for this area (by the cells it has
+  stored there, with its reason), it is not running, or it is too old to be asked.
+- The configuration moves to version 3. The migration drops the cells directory and the two
+  Charts Provider settings, chooses the charts provider when a collection was named, and
+  keeps the version 2 configuration as `config-v2.json` in the plugin data directory. When it
+  drops a cells directory and no charts provider takes its place, the server log says so, and
+  the setup check says no ENC is read until one is chosen.
+
+- Of a cell two charts provider collections hold, the index reads the copy of the newest
+  edition and update, as the cell's DSID and its update files give them, rather than the first
+  in path order. A copy counts only the updates GDAL applies to it, and a copy GDAL cannot
+  read ranks below every copy it can.
+- An index saved from one Charts Provider collection is the whole charts provider's, so it
+  stays in use after the upgrade while the charts provider's store is away.
+- With no index yet, a failed box build's reason adds what the charts provider said of the
+  box, such as that it is downloading the area.
+
+### Fixed
+
+- A failing area request to the charts provider is logged and no longer fails the box
+  refresh that made it, and is asked again after 5 minutes rather than when the box moves.
+  An area request that fails in the plugin itself is asked again after 5 minutes too.
+- The no-coverage reason says the charts provider is not running once it stops, rather than
+  repeating its last answer; and with no index, the reason says so when it was not running at
+  start.
+
 ## [0.4.0] - 2026-11-02
 
 ### Added

package/README.md

@@ -102,23 +102,24 @@ shows the RAM and CPUs it finds and says the same; it never changes a setting.
 ## Prepare the charts
 
 The plugin reads unencrypted S-57 ENC cells as they are delivered: each `.000` base cell with
-its `.001`, `.002`, … updates beside it. Copy the exchange set, for example its `ENC_ROOT`
-folder, under one directory and set **ENC cells directory** to it; `.000` files are found down
-to three folders deep, and down to six below a folder holding the exchange set's `CATALOG.031`,
-so an unzipped Inland ENC download (`<set>/ENC_ROOT/1R/7/1R7WAD07/1R7WAD07.000`) can be pointed
-at as it is.
-
-Cells downloaded with signalk-charts-provider-simple (2.16.0 or later) are read where that
-plugin shares them, in its ENC store: set **ENC from Charts Provider** to one of the chart sets
-or converted charts the admin form lists as shared, or to `*` for all of them. It is used
-instead of **ENC cells directory**. When the charts provider writes new editions or updates of
-those cells, the plugin restarts itself and rebuilds the index from them. When the collection
-has no cells yet, the reason says why, as the charts provider tells it: a chart set not
-downloaded or still downloading, cells being written, or no such collection. With `*` and
-**Ask Charts Provider for the ENC around the vessel** on (an expert setting, off by default),
-each new index box asks the charts provider to download the free ENC cells of that area, when
-its **Download the ENC cells around the vessel** is on too; they arrive in its chart set
-"Around the vessel" and the index is rebuilt with them. The cells are
+its `.001`, `.002`, … updates beside it. It reads them from a chart provider service, chosen in
+**Charts provider**: signalk-charts-provider-simple, which keeps the cells behind its ENC
+charts in its ENC store (2.16.0 or later; 2.18.0 or later for the area requests below). Every
+cell it shares is read: its ENC Charts sets, and the charts it converted from an upload or a
+folder on the server while its **Keep the ENC cells of converted charts** is on, so an
+exchange set or an Inland ENC download goes in by converting it there. The plugin keeps no
+cells directory of its own. The pulldown marks a provider that is not running and says what
+it shares now. When the charts provider writes new editions or updates of those cells, the
+plugin restarts itself and rebuilds the index from them.
+
+Each new index box asks the charts provider for the ENC cells of its area. With its
+**Download the ENC cells around the vessel** on, it downloads the free ENC cells there into its
+chart set "Around the vessel" and the index is rebuilt with them. Where the vessel has no
+chart coverage, the reason says what the charts provider answered: it is downloading the
+area, it has no ENC for this area (with its reason, such as no free ENC covering it), it is
+not running, or it is too old to be asked. Traficom WFS depths (below) are downloaded
+whatever ENC the charts provider has, and with none at all.
+The cells are
 read in place with GDAL compiled to WebAssembly
 (gdal3.js), which the plugin installs with it, and the updates are applied as they are read.
 Nothing is converted or written next to the cells. A cell without an `M_COVR` coverage layer
@@ -160,7 +161,7 @@ rebuilds in 12–15 s instead of 30–34 s on x86. Deleting the folder is safe;
 read again.
 
 Folders of GeoJSON layers exported by `scripts/enc-to-geojson.sh` for earlier versions are no
-longer read: point **ENC cells directory** at the original `.000` cells instead. Such a folder
+longer read: convert the original `.000` cells in the charts provider instead. Such a folder
 named like a cell is listed in `GET /status` as skipped.
 
 ## Settings
@@ -180,14 +181,13 @@ There are two places to set the plugin up, and both write the same configuration
 
 ![The setup steps: boat, water level and warnings](docs/images/how-it-works/setup-panel.png)
 
-| Setting                  | What it does                                                                                                                                                                 |
-| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| ENC cells directory      | where the `.000` cells are                                                                                                                                                   |
-| ENC from Charts Provider | or a chart set or converted chart whose cells signalk-charts-provider-simple shares, `*` for all of them; used instead of the directory                                      |
-| Boat                     | draft (empty uses Signal K `design.draft.maximum`) and safety margin under the keel (0 m); only the keel's lowest point counts, and squat and waves are added on top (below) |
-| Water level              | source (`none`, `manual`, `signalk-tide`, `fmi`, see below); only the chosen source's fields are shown                                                                       |
-| Warnings                 | Early, Balanced or Late, in the table below                                                                                                                                  |
-| Optional features        | living chart (own soundings), Traficom WFS depths, grounding detector; each off until enabled                                                                                |
+| Setting           | What it does                                                                                                                                                                 |
+| ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Charts provider   | the chart provider service whose ENC cells are read: signalk-charts-provider-simple; empty: no ENC                                                                           |
+| Boat              | draft (empty uses Signal K `design.draft.maximum`) and safety margin under the keel (0 m); only the keel's lowest point counts, and squat and waves are added on top (below) |
+| Water level       | source (`none`, `manual`, `signalk-tide`, `fmi`, see below); only the chosen source's fields are shown                                                                       |
+| Warnings          | Early, Balanced or Late, in the table below                                                                                                                                  |
+| Optional features | living chart (own soundings), Traficom WFS depths, grounding detector; each off until enabled                                                                                |
 
 | Warning style      | Looks ahead | Alert at | Warn at, within | Alarm at, within | Alarm on negative mean UKC |
 | ------------------ | ----------- | -------- | --------------- | ---------------- | -------------------------- |
@@ -214,7 +214,7 @@ Expert settings, with their defaults:
 
 | Group        | Settings                                                                                                                                                                                                                               |
 | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Chart index  | index directory, rebuild at start, index leaf zoom (20), box around the vessel (10 km), ask Charts Provider for the ENC around the vessel                                                                                              |
+| Chart index  | index directory, rebuild at start, index leaf zoom (20), box around the vessel (10 km)                                                                                                                                                 |
 | Boat         | length, beam (fallback: Signal K `design.*`); draft σ (0.05 m); block coefficient and heel effect (none, fin keel or a table); double squat in narrow channels; wave allowance factor (0.4 × Hs)                                       |
 | Look-ahead   | minimum horizon (60 s); position buffer (10 m, 2σ); fan spread (COG 5°, rate of turn 0.1°/s); escape-heading rate of turn (3°/s); and the distance, probabilities and windows of the warning style, each overriding the style when set |
 | Water level  | manual height and σ; FMI refresh (600 s); chart-datum mappings for FMI                                                                                                                                                                 |
@@ -225,9 +225,12 @@ Expert settings, with their defaults:
 The saved configuration carries a version, `configVersion`. At the first start after an update
 from a configuration without one, the plugin keeps a copy as `config-v1.json` in its data
 directory, removes the look-ahead values the old admin form had filled in with their
-defaults, so the warning style can set them, and saves the result. The plugin then
-behaves exactly as before; a value that differed from its default stays and overrides the
-style.
+defaults, so the warning style can set them, and saves the result. The warnings then
+behave exactly as before; a value that differed from its default stays and overrides the
+style. A configuration of version 2 is kept as `config-v2.json` and loses its ENC settings:
+one that named a Charts Provider collection reads the whole charts provider from then on,
+and one with an ENC cells directory reads no ENC until its cells are converted in the
+charts provider and **Charts provider** is chosen, which the setup check asks for.
 
 ## Water level
 
@@ -351,13 +354,13 @@ datum mapping. Absolute paths in its reasons, in 5xx replies and in notification
 as `<path>` (an S-57 cell file keeps its name); the plugin status line and the server log keep
 them whole.
 
-| Reason shown                                                  | Cause and fix                                                          |
-| ------------------------------------------------------------- | ---------------------------------------------------------------------- |
-| `vessel draft not configured`                                 | set **Draft** under Boat, or `design.draft.maximum` in Signal K        |
-| `position stale`                                              | no recent `navigation.position`; check the GNSS source                 |
-| `course or speed stale: only the current position is checked` | no recent COG or SOG                                                   |
-| `no chart index loaded`                                       | set the cells directory; an index error is shown as the plugin's error |
-| `no chart coverage`                                           | the boat or its footprints are outside every ENC cell                  |
+| Reason shown                                                  | Cause and fix                                                             |
+| ------------------------------------------------------------- | ------------------------------------------------------------------------- |
+| `vessel draft not configured`                                 | set **Draft** under Boat, or `design.draft.maximum` in Signal K           |
+| `position stale`                                              | no recent `navigation.position`; check the GNSS source                    |
+| `course or speed stale: only the current position is checked` | no recent COG or SOG                                                      |
+| `no chart index loaded`                                       | choose the charts provider; an index error is shown as the plugin's error |
+| `no chart coverage`                                           | the boat or its footprints are outside every ENC cell                     |
 
 # For developers
 

package/lib/config-charts.js

@@ -1,34 +1,26 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CHART_AREA_FIELD = void 0;
+exports.CHART_PROVIDERS = void 0;
 exports.chartFields = chartFields;
 const shared_enc_1 = require("./shared-enc");
+/** The services whose ENC store the plugin reads. */
+exports.CHART_PROVIDERS = [
+    { id: shared_enc_1.CHARTS_PROVIDER_ID, name: "Charts Provider (signalk-charts-provider-simple)" }
+];
+const DESCRIPTION = "The chart provider service whose ENC cells the index is built from. Every ENC cell it shares is read in place with GDAL, and the index is rebuilt when its cells change. Empty: no charts.";
 /**
- * The admin form's chart fields: a directory of S-57 cells, or the cells
- * signalk-charts-provider-simple shares (`shared-enc.ts`).
+ * The chart field: a pulldown of CHART_PROVIDERS. With `choices`, each is marked running or
+ * not, and the description says what Charts Provider shares now.
  */
-function chartFields(sharedNow) {
+function chartFields(choices) {
+    const running = new Set(choices?.running ?? []);
     return {
-        cellsDir: {
+        chartsProvider: {
             type: "string",
-            title: "ENC cells directory",
-            description: "S-57 ENC cells as delivered: .000 files with their .001, .002 … updates, also in sub-folders such as ENC_ROOT. Read directly with GDAL (WebAssembly); nothing is converted."
-        },
-        chartsProviderEnc: {
-            type: "string",
-            pattern: shared_enc_1.COLLECTION_CHOICE_PATTERN,
-            title: "ENC from Charts Provider",
-            description: "Or read the ENC cells signalk-charts-provider-simple keeps: the name of an ENC Charts set there (Gulf of Finland is Gulf_of_Finland) or of a converted chart whose cells it keeps, or * for all of them. Used instead of the ENC cells directory; the index is rebuilt when the cells change." +
-                (sharedNow ? ` ${sharedNow}` : "")
+            title: "Charts provider",
+            description: choices?.shared === undefined ? DESCRIPTION : `${DESCRIPTION} ${choices.shared}`,
+            enum: exports.CHART_PROVIDERS.map((p) => p.id),
+            enumNames: exports.CHART_PROVIDERS.map((p) => choices === undefined || running.has(p.id) ? p.name : `${p.name}: not running`)
         }
     };
 }
-/** The expert field asking Charts Provider for the cells around the vessel (`shared-enc.ts`). */
-exports.CHART_AREA_FIELD = {
-    chartsProviderArea: {
-        type: "boolean",
-        title: "Ask Charts Provider for the ENC around the vessel",
-        description: 'With ENC from Charts Provider set to * and Charts Provider\'s "Download the ENC cells around the vessel" on, each new index box asks it to download the free ENC cells of that area; they arrive in its chart set "Around the vessel" and the index is rebuilt with them. Off: only the cells already shared are read.',
-        default: false
-    }
-};

package/lib/config-migrate.js

@@ -7,7 +7,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CONFIG_VERSION = void 0;
 exports.migrateConfig = migrateConfig;
-exports.CONFIG_VERSION = 2;
+const shared_enc_1 = require("./shared-enc");
+exports.CONFIG_VERSION = 3;
 /**
  * Values the version 1 form filled into every saved configuration as
  * defaults. Version 2 leaves these fields empty so the warning style sets
@@ -49,8 +50,29 @@ function v1ToV2(c, dropped) {
     }
     return out;
 }
+/**
+ * Version 3 reads ENC only from a chart provider service, every cell it shares, and asks it
+ * for the cells around the vessel unasked: the cells directory and the asking switch are gone,
+ * and a Charts Provider collection chosen in version 2 becomes the choice of that service.
+ */
+function v2ToV3(c, dropped) {
+    const { cellsDir, chartsProviderEnc, chartsProviderArea, ...out } = c;
+    if (cellsDir !== undefined) {
+        dropped.push("cellsDir");
+    }
+    if (chartsProviderArea !== undefined) {
+        dropped.push("chartsProviderArea");
+    }
+    if (chartsProviderEnc !== undefined) {
+        dropped.push("chartsProviderEnc");
+        if (typeof chartsProviderEnc === "string" && chartsProviderEnc.trim() !== "") {
+            out.chartsProvider ??= shared_enc_1.CHARTS_PROVIDER_ID;
+        }
+    }
+    return out;
+}
 /** Step n takes version n to n + 1. */
-const STEPS = { 1: v1ToV2 };
+const STEPS = { 1: v1ToV2, 2: v2ToV3 };
 function migrateConfig(raw) {
     const saved = record(raw);
     const stated = saved.configVersion;

package/lib/config-schema.js

@@ -265,8 +265,7 @@ const CHART_INDEX = {
         maximum: 22
     },
     boxRadiusKm: boxKm("Index box around the vessel (km)", 10, "Half-width of the area the index is built in around the vessel; it is rebuilt as the vessel moves. Outside it the plugin reports no coverage, and the reason says the vessel is outside the chart box. At speed the box grows past this radius, up to the largest index box, so the vessel cannot reach its edge, less the look-ahead, before the next box is built: a box must hold 1.5 times the distance run during the last build (grown with the build area) plus the look-ahead and a 2.4 km band. It grows at once when too small, and shrinks only at the next rebuild once the speed needs under 70% of it. 0 indexes every cell (slow for large chart sets); a radius under 2 km is raised to 2. With the Traficom WFS on, its radius is used, and the box grows to 25 km at most."),
-    boxMaxRadiusKm: boxKm("Largest index box at speed (km)", 0, "The box around the vessel grows up to this half-width at speed. 0 sizes it from the RAM the system reports: 10 km on a 1 GB Raspberry Pi or Cerbo GX, about 19 km on a 4 GB Raspberry Pi 4, about 27 km with 8 GB. The status says when even this box is too small for the speed and build time."),
-    ...config_charts_1.CHART_AREA_FIELD
+    boxMaxRadiusKm: boxKm("Largest index box at speed (km)", 0, "The box around the vessel grows up to this half-width at speed. 0 sizes it from the RAM the system reports: 10 km on a 1 GB Raspberry Pi or Cerbo GX, about 19 km on a 4 GB Raspberry Pi 4, about 27 km with 8 GB. The status says when even this box is too small for the speed and build time.")
 };
 const EXPERT = {
     ...CHART_INDEX,
@@ -303,7 +302,7 @@ function adminSchema(hints = {}) {
         type: "object",
         description: `${ADVISORY}${checks}`,
         properties: {
-            ...(0, config_charts_1.chartFields)(hints.encCollections),
+            ...(0, config_charts_1.chartFields)(hints.enc),
             vessel: {
                 ...VESSEL_ESSENTIAL,
                 properties: { ...VESSEL_ESSENTIAL.properties, draft: draftField(hints.signalkDraft) }

package/lib/config.js

@@ -23,14 +23,6 @@ function optionalPositive(v) {
 function str(v) {
     return typeof v === "string" && v.trim() !== "" ? v : undefined;
 }
-/**
- * A charts provider collection id or `*`, trimmed. Anything else, a path out of the store
- * among them, is no choice, and the ENC cells directory stays in use.
- */
-function collectionChoice(v) {
-    const s = str(v)?.trim();
-    return s !== undefined && (0, shared_enc_1.isCollectionChoice)(s) ? s : undefined;
-}
 function record(v) {
     return typeof v === "object" && v !== null ? v : {};
 }
@@ -167,9 +159,7 @@ function parseConfig(raw) {
     const style = (0, config_presets_1.warningStyle)(r.warningStyle);
     return {
         indexDir: str(r.indexDir),
-        cellsDir: str(r.cellsDir),
-        chartsProviderEnc: collectionChoice(r.chartsProviderEnc),
-        chartsProviderArea: r.chartsProviderArea === true,
+        chartsProviderEnc: r.chartsProvider === shared_enc_1.CHARTS_PROVIDER_ID ? shared_enc_1.ALL_COLLECTIONS : undefined,
         rebuildIndex: r.rebuildIndex === true,
         leafZoom: Math.round(num(r.leafZoom, 20, 14, 22)),
         boxRadiusKm: boxRadius(r.boxRadiusKm),

package/lib/engine/chart-box.js

@@ -41,18 +41,20 @@ function boxState(box) {
 }
 /**
  * `reason` with what the chart box has to do with it, when it is a no-coverage reason
- * (`verdict.ts`) and the footprint it names reaches the box edge; otherwise `reason`. The
- * footprint is the first at or after the time the reason gives.
+ * (`verdict.ts`) and the footprint it names reaches the box edge; with what the charts
+ * provider last answered when no box edge explains it; otherwise `reason`. The footprint is
+ * the first at or after the time the reason gives.
  */
 function boxCoverage(reason, fps, box) {
     const m = COVERAGE_REASON.exec(reason);
-    if (!m || !box.bbox) {
+    if (!m) {
         return reason;
     }
     const t = m[1] === undefined ? 0 : Number(m[1]);
     const f = fps.find((x) => x.t >= t - 0.5) ?? fps[fps.length - 1];
-    if (!f || !atEdge(f, box.bbox)) {
-        return reason;
+    if (!f || !box.bbox || !atEdge(f, box.bbox)) {
+        // No box edge explains it: the charts have none there, and the provider may say why.
+        return box.providerNote === undefined ? reason : `${reason}: ${box.providerNote}`;
     }
     const where = insideBox(f.center, box.bbox) ? "at the chart box edge" : "outside the chart box";
     return `${reason}: ${where}, ${boxState(box)}`;

package/lib/index-loader.js

@@ -73,7 +73,7 @@ function skippedNote(cellsDir, scan) {
     return scan.skipped.length === 0
         ? []
         : [
-            `skipped ${scan.skipped.join(", ")} in ${cellsDir ?? "cellsDir"}: ` +
+            `skipped ${scan.skipped.join(", ")} in ${cellsDir ?? "the charts provider's ENC"}: ` +
                 "no S-57 cell (.000) in it, a dangling link, or a cell name met twice"
         ];
 }
@@ -180,7 +180,7 @@ function scanCells(cellsDir, saved) {
     }
     const scan = (0, cell_source_1.scanCellSources)(cellsDir);
     return cellsMissing(cellsDir, scan.sources, saved)
-        ? { away: `no S-57 cell found in ${cellsDir ?? "cellsDir"}` }
+        ? { away: `no S-57 cell found in ${cellsDir ?? "the charts provider's ENC"}` }
         : { scan };
 }
 function plan(cfg, indexDir, extraDirs, syncLoadBytes) {
@@ -290,7 +290,7 @@ function boxPlan(cfg, indexDir, dirs, keys, p) {
         : (p.mismatch ??
             (sameCells
                 ? `leaf zoom ${cfg.leafZoom} differs from the saved ${box.leafZoom ?? "?"}`
-                : `cells in ${cfg.cellsDir ?? "cellsDir"} changed since it was saved`));
+                : `cells in ${cfg.cellsDir ?? "the charts provider's ENC"} changed since it was saved`));
     const notes = [...(why ? [`rebuilt the index: ${why}`] : []), ...p.notes];
     return buildPlan(cfg, indexDir, dirs, notes, { bbox: box.bbox, sources });
 }
@@ -308,7 +308,11 @@ function savedPlan(indexDir, notes, unreadable, syncLoadBytes) {
 }
 function buildPlan(cfg, indexDir, dirs, notes, box) {
     if (dirs.length === 0) {
-        const none = { indexDir, built: false, reason: `no cells in ${cfg.cellsDir ?? "cellsDir"}` };
+        const none = {
+            indexDir,
+            built: false,
+            reason: `no cells in ${cfg.cellsDir ?? "the charts provider's ENC"}`
+        };
         return { load: withNotes(none, notes) };
     }
     // The build would be refused only once it is done: minutes on a Pi 4.
@@ -321,7 +325,7 @@ function buildPlan(cfg, indexDir, dirs, notes, box) {
     return { build: box ? { ...build, box } : build, indexDir, notes };
 }
 function missingReason(cfg, indexDir) {
-    return cfg.wfs ? exports.WFS_WAITING_REASON : `no chart index in ${indexDir}; set cellsDir`;
+    return cfg.wfs ? exports.WFS_WAITING_REASON : `no chart index in ${indexDir}; choose the charts provider`;
 }
 /**
  * `refused`, why the saved index is not used even with nothing to build another from: it holds
@@ -344,9 +348,9 @@ function savedMatches(cfg, indexDir, saved, extraDirs) {
                     ? "the saved one lacks the Traficom WFS cell"
                     : dropped;
     const refused = stale
-        ? "the saved index holds Traficom WFS depths and that source is off; set cellsDir"
+        ? "the saved index holds Traficom WFS depths and that source is off; choose the charts provider"
         : dropped && extraDirs.length === 0
-            ? `not using the saved index: ${dropped}; set cellsDir`
+            ? `not using the saved index: ${dropped}; choose the charts provider`
             : undefined;
     return { refused, mismatch };
 }

package/lib/index-source.js

@@ -17,12 +17,19 @@ const build_source_1 = require("./spatial/build-source");
  * used meanwhile, while a source the user chose since was never the saved index's.
  *
  * A collection is recorded by its id, not the directory it resolves to: the charts provider
- * may keep its store elsewhere than the default path read while it is still starting.
+ * may keep its store elsewhere than the default path read while it is still starting. The
+ * whole store holds every collection, so an index of one collection, as saved before version
+ * 3 of the configuration, is the whole store's too.
  */
+const PROVIDER = "charts-provider:";
+/** Whether an index saved from `saved` was built from the cells `now` names. */
+function sameSource(saved, now) {
+    return saved === now || (now === `${PROVIDER}*` && saved.startsWith(PROVIDER));
+}
 /** The source `cfg` reads its S-57 cells from; undefined without one. */
 function indexSource(cfg) {
     if (cfg.chartsProviderEnc !== undefined) {
-        return `charts-provider:${cfg.chartsProviderEnc}`;
+        return `${PROVIDER}${cfg.chartsProviderEnc}`;
     }
     return cfg.cellsDir ? `dir:${path_1.default.resolve(cfg.cellsDir)}` : undefined;
 }
@@ -33,13 +40,13 @@ function indexSource(cfg) {
 function sourceChanged(cfg, indexDir) {
     const saved = (0, build_source_1.readSource)(indexDir);
     const now = indexSource(cfg);
-    return saved !== undefined && saved !== now
+    return saved !== undefined && !sameSource(saved, now)
         ? `the saved index was built from ${describe(saved)}, not ${now === undefined ? "the cells now set" : describe(now)}`
         : undefined;
 }
 function describe(source) {
-    return source.startsWith("charts-provider:")
-        ? `Charts Provider's ${source.slice("charts-provider:".length)}`
+    return source.startsWith(PROVIDER)
+        ? `Charts Provider's ${source.slice(PROVIDER.length)}`
         : source.slice(source.indexOf(":") + 1);
 }
 /**

package/lib/index.js

@@ -91,6 +91,8 @@ function formSchema(app, state) {
     catch (err) {
         app.error(`setup checks failed: ${err.message}`);
     }
+    // The chart pulldown lists what Charts Provider shares also while this plugin is off.
+    hints.enc ??= (0, shared_enc_1.runningProviders)();
     const schema = (0, config_schema_1.adminSchema)(hints);
     const version = app.config?.version;
     return (0, config_schema_1.formsFollowDependencies)(version) ? schema : (0, config_schema_1.flatten)(schema);

package/lib/ingest/cell-source.js

@@ -8,6 +8,7 @@ exports.sourceName = sourceName;
 exports.currentInfo = currentInfo;
 exports.sourceIdentity = sourceIdentity;
 exports.readCell = readCell;
+exports.cellVersionRank = cellVersionRank;
 exports.scanCellSources = scanCellSources;
 const crypto_1 = require("crypto");
 const fs_1 = __importDefault(require("fs"));
@@ -64,6 +65,46 @@ function readCell(source, cellRef) {
         ? (0, enc_wasm_1.readEncCell)(source, cellRef)
         : Promise.resolve((0, cell_reader_1.readCellDirectory)(source, cellRef));
 }
+/**
+ * A copy's edition and update as one comparable number, as GDAL's S-57 reader (3.8) applies
+ * its updates: from `.001` on, one file after another until one is missing or does not open as
+ * ISO 8211, whatever update the base cell's DSID carries. Each update's DSID must name the edition the
+ * reader holds, or 0 (as NOAA's do), and the update after the one it holds; otherwise the
+ * reader gives up on the whole cell, as it does on a cell re-issued at update 3 with a `.001`
+ * beside it. -1 when the copy would not be read so, or its edition or files cannot be read.
+ */
+function cellVersionRank(file) {
+    try {
+        const version = (0, enc_wasm_1.baseVersion)(file);
+        if (version === undefined) {
+            return -1;
+        }
+        const updates = new Map((0, enc_wasm_1.encFiles)(file)
+            .slice(1)
+            .map((f) => [Number(path_1.default.extname(f).slice(1)), f]));
+        let { edition, update } = version;
+        for (let n = 1;; n++) {
+            const f = updates.get(n);
+            // A file missing, or one that does not open as ISO 8211, ends the updates GDAL applies.
+            if (f === undefined || !(0, enc_wasm_1.isIso8211)(f)) {
+                break;
+            }
+            // One that opens but whose DSID gives no edition and update in step makes it give up.
+            const own = (0, enc_wasm_1.dsidVersion)(f);
+            if (own.edition === undefined ||
+                own.update !== update + 1 ||
+                (own.edition !== 0 && own.edition !== edition)) {
+                return -1;
+            }
+            edition = own.edition;
+            update = own.update;
+        }
+        return version.edition * 100_000 + update;
+    }
+    catch {
+        return -1;
+    }
+}
 /** How deep below the cells directory S-57 cells are looked for: ENC_ROOT/<cell>/<cell>.000. */
 const MAX_DEPTH = 4;
 /**
@@ -85,8 +126,10 @@ function isDirectory(p) {
 /**
  * The S-57 cells under `cellsDir`: every `.000` file down to MAX_DEPTH, such
  * as in an ENC_ROOT exchange set, and down to EXCHANGE_SET_DEPTH below any
- * directory holding a CATALOG.031 within it. A name met twice keeps its first
- * file in path order; one file met again through a link counts once. A
+ * directory holding a CATALOG.031 within it. A name met twice, as one cell in two charts
+ * provider collections, keeps the copy of the newest edition and update; between copies of
+ * the same version, or whose edition cannot be read, the first in path order. One file met
+ * again through a link counts once. A
  * directory is read again only when reached with more depth left than
  * before, and never from within itself, so a linked loop ends where it comes
  * back.
@@ -96,7 +139,8 @@ function scanCellSources(cellsDir) {
     if (!cellsDir) {
         return scan;
     }
-    const seen = new Set();
+    /** Each cell name's index in `scan.sources`, and the version of the copy kept there. */
+    const seen = new Map();
     const files = new Set();
     /** Folders named like a cell, by real path: skipped unless a cell is read from under one. */
     const named = new Map();
@@ -110,11 +154,21 @@ function scanCellSources(cellsDir) {
         }
         files.add(real);
         const name = sourceName(source);
-        if (seen.has(name)) {
-            scan.skipped.push(path_1.default.relative(cellsDir, source));
+        const kept = seen.get(name);
+        if (kept) {
+            // Versions are read only for a name met twice: one header each, not a scan of every cell.
+            // A copy that cannot be read ranks -1 and never displaces one that can.
+            kept.rank ??= cellVersionRank(scan.sources[kept.at]);
+            const rank = cellVersionRank(source);
+            const older = rank > kept.rank ? scan.sources[kept.at] : source;
+            if (older !== source) {
+                scan.sources[kept.at] = source;
+                kept.rank = rank;
+            }
+            scan.skipped.push(path_1.default.relative(cellsDir, older));
             return;
         }
-        seen.add(name);
+        seen.set(name, { at: scan.sources.length });
         scan.sources.push(source);
     };
     /** Depth left when each real directory was read, and those being read now. */

package/lib/ingest/enc-wasm.js

@@ -8,7 +8,10 @@ exports.encReaderId = encReaderId;
 exports.sharedLayers = sharedLayers;
 exports.readEncLayers = readEncLayers;
 exports.readEncParts = readEncParts;
+exports.baseVersion = baseVersion;
 exports.baseEdition = baseEdition;
+exports.isIso8211 = isIso8211;
+exports.dsidVersion = dsidVersion;
 exports.encCell = encCell;
 exports.readEncCell = readEncCell;
 exports.encFiles = encFiles;
@@ -226,13 +229,16 @@ async function readEncParts(file) {
     parts.set(s57_geojson_1.POSITION_LAYER, Buffer.from(JSON.stringify(positionLayer(primitives))));
     return parts;
 }
+/** The highest edition and update numbers read as known: an update has a 3-digit file. */
+const MAX_EDITION = 9_999;
+const MAX_UPDATE = 999;
 /**
- * The edition number in the base cell's DSID record, read from the ISO 8211
- * file itself. GDAL reports the last update's DSID_EDTN once updates are
- * applied, and NOAA updates carry 0 there: US5FL65M, edition 38, read as
- * edition 0 with its three updates.
+ * The EDTN and UPDN fields of a cell file's DSID record, read from the ISO 8211 file itself;
+ * each undefined when it is missing, not all digits, or out of range, and both when the record
+ * is not laid out as S-57 sets it, as a separator lost or misplaced leaves it. EDTN may be 0,
+ * as NOAA update files carry it.
  */
-function baseEdition(file) {
+function dsidFields(file) {
     const fd = fs_1.default.openSync(file, "r");
     try {
         const head = Buffer.alloc(65_536);
@@ -241,26 +247,150 @@ function baseEdition(file) {
         // The data descriptive record comes first; the DSID is in the first data record after it.
         const dr = num(0, 5);
         if (!(dr > 0) || dr + 24 > size) {
-            return undefined;
+            return {};
         }
         const base = dr + num(dr + 12, 5);
         const [lenSize, posSize, tagSize] = [num(dr + 20, 1), num(dr + 21, 1), num(dr + 23, 1)];
-        for (let e = dr + 24; head[e] !== 0x1e && e < base; e += tagSize + lenSize + posSize) {
+        // A size of 0, or not a digit, would leave the directory walk where it is.
+        if (![lenSize, posSize, tagSize].every((n) => Number.isInteger(n) && n > 0)) {
+            return {};
+        }
+        const entry = tagSize + lenSize + posSize;
+        for (let e = dr + 24; head[e] !== 0x1e && e < base; e += entry) {
             if (head.toString("latin1", e, e + tagSize) === "DSID") {
-                // RCNM (1 byte), RCID (4), EXPP (1), INTU (1), then DSNM and EDTN, each ended by 0x1f.
-                const dsnm = base + num(e + tagSize + lenSize, posSize) + 7;
-                const edtn = head.indexOf(0x1f, dsnm) + 1;
-                const end = head.indexOf(0x1f, edtn);
-                const n = edtn > 0 && end > edtn ? Number(head.toString("latin1", edtn, end)) : NaN;
-                return Number.isInteger(n) && n > 0 ? n : undefined;
+                // RCNM (1 byte), RCID (4), EXPP (1), INTU (1), then DSNM, EDTN and UPDN, each ended by
+                // 0x1f, then UADT and ISDT, 8 characters each with no separator, all within the field.
+                const start = base + num(e + tagSize + lenSize, posSize);
+                const stop = Math.min(size, start + num(e + tagSize, lenSize));
+                const after = (from) => {
+                    const at = head.indexOf(0x1f, from);
+                    return at >= 0 && at < stop ? at : -1;
+                };
+                const dsnmEnd = after(start + 7);
+                const edtnEnd = dsnmEnd < 0 ? -1 : after(dsnmEnd + 1);
+                const updnEnd = edtnEnd < 0 ? -1 : after(edtnEnd + 1);
+                // A separator lost or misplaced leaves no two dates where they belong.
+                const dates = head.toString("latin1", updnEnd + 1, updnEnd + 17);
+                if (updnEnd < 0 || updnEnd + 17 > stop || !/^[\d ]{16}$/.test(dates)) {
+                    return {};
+                }
+                const field = (from, to, max) => {
+                    const text = head.toString("latin1", from, to);
+                    const n = /^\d{1,5}$/.test(text) ? Number(text) : NaN;
+                    return n <= max ? n : undefined;
+                };
+                const edition = field(dsnmEnd + 1, edtnEnd, MAX_EDITION);
+                const update = field(edtnEnd + 1, updnEnd, MAX_UPDATE);
+                return {
+                    ...(edition === undefined ? {} : { edition }),
+                    ...(update === undefined ? {} : { update })
+                };
             }
         }
-        return undefined;
+        return {};
     }
     finally {
         fs_1.default.closeSync(fd);
     }
 }
+/**
+ * The edition and update numbers in the base cell's DSID record. GDAL reports the last
+ * update's DSID_EDTN once updates are applied, and NOAA updates carry 0 there: US5FL65M,
+ * edition 38, read as edition 0 with its three updates. A base cell re-issued with its updates
+ * applied carries their number in UPDN. Undefined unless both read as numbers in range, as a
+ * version that cannot be read is not known.
+ */
+function baseVersion(file) {
+    const { edition, update } = dsidFields(file);
+    return edition !== undefined && edition > 0 && update !== undefined
+        ? { edition, update }
+        : undefined;
+}
+/** The edition number in the base cell's DSID record, whatever its UPDN holds. */
+function baseEdition(file) {
+    const { edition } = dsidFields(file);
+    return edition !== undefined && edition > 0 ? edition : undefined;
+}
+/**
+ * Whether `file` opens as ISO 8211 as GDAL's `DDFModule::Open` (3.8) checks it: a 24-byte
+ * leader of printable characters with an interchange level of 1 to 3, the leader identifier L,
+ * a version of 1 or blank, and sizes in range; then the whole data descriptive record, each of
+ * its directory entries naming a field that lies within it. GDAL stops looking for updates at
+ * a file that does not open.
+ */
+function isIso8211(file) {
+    let fd;
+    try {
+        // GDAL's Open refuses a directory, and a file it cannot open ends the updates too.
+        if (!fs_1.default.statSync(file).isFile()) {
+            return false;
+        }
+        fd = fs_1.default.openSync(file, "r");
+    }
+    catch {
+        return false;
+    }
+    try {
+        const leader = Buffer.alloc(LEADER);
+        const sizes = fs_1.default.readSync(fd, leader, 0, LEADER, 0) === LEADER ? leaderSizes(leader) : undefined;
+        if (!sizes) {
+            return false;
+        }
+        const record = Buffer.alloc(sizes.recLength);
+        return (fs_1.default.readSync(fd, record, 0, sizes.recLength, 0) === sizes.recLength &&
+            directoryFits(record, sizes));
+    }
+    catch {
+        return false;
+    }
+    finally {
+        fs_1.default.closeSync(fd);
+    }
+}
+const LEADER = 24;
+/** DDFScanInt: atoi over a fixed width, 0 where no digits lead. */
+const scanInt = (bytes, at, len) => Number.parseInt(bytes.toString("latin1", at, at + len), 10) || 0;
+/** The record and entry sizes a leader gives, or undefined where GDAL refuses it. */
+function leaderSizes(leader) {
+    const char = (at) => String.fromCharCode(leader[at]);
+    const valid = leader.every((b) => b >= 32 && b <= 126) &&
+        "123".includes(char(5)) &&
+        char(6) === "L" &&
+        "1 ".includes(char(8));
+    if (!valid) {
+        return undefined;
+    }
+    const sizes = {
+        recLength: scanInt(leader, 0, 5),
+        areaStart: scanInt(leader, 12, 5),
+        lenSize: scanInt(leader, 20, 1),
+        posSize: scanInt(leader, 21, 1),
+        tagSize: scanInt(leader, 23, 1)
+    };
+    const inRange = sizes.recLength >= LEADER &&
+        scanInt(leader, 10, 2) > 0 &&
+        sizes.areaStart >= LEADER &&
+        sizes.lenSize > 0 &&
+        sizes.posSize > 0 &&
+        sizes.tagSize > 0;
+    return inRange ? sizes : undefined;
+}
+/** Whether every directory entry of the data descriptive record names a field within it. */
+function directoryFits(record, s) {
+    const width = s.lenSize + s.posSize + s.tagSize;
+    for (let e = LEADER; e + width <= s.recLength && record[e] !== 0x1e; e += width) {
+        const length = scanInt(record, e + s.tagSize, s.lenSize);
+        const position = scanInt(record, e + s.tagSize + s.lenSize, s.posSize);
+        if (position < 0 || length < 2 || s.recLength - (s.areaStart + position) < length) {
+            return false;
+        }
+    }
+    return true;
+}
+/** The EDTN and UPDN of any cell file's DSID record, an update file's among them; EDTN may be 0. */
+function dsidVersion(file) {
+    return dsidFields(file);
+}
 /** The cell `readEncLayers` read from `file`, parsed as `readCellDirectory` parses an export. */
 function encCell(file, layers, cellRef, bandOverride) {
     const name = path_1.default.basename(file, path_1.default.extname(file));

package/lib/settings-service.js

@@ -4,6 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.V1_BACKUP = void 0;
+exports.backupName = backupName;
 exports.persistMigration = persistMigration;
 exports.settingsReply = settingsReply;
 exports.patchErrors = patchErrors;
@@ -18,17 +19,26 @@ const vessel_1 = require("./model/vessel");
 const setup_checks_1 = require("./setup-checks");
 /** Where the version 1 configuration is kept when it is first migrated. */
 exports.V1_BACKUP = "config-v1.json";
+/** Where a configuration of version `from` is kept when it is first migrated. */
+function backupName(from) {
+    return `config-v${from}.json`;
+}
 function isObject(v) {
     return typeof v === "object" && v !== null && !Array.isArray(v);
 }
-/** Saves a migrated configuration, after keeping a version 1 one beside the plugin data. */
+/** Saves a migrated configuration, after keeping the one it replaces beside the plugin data. */
 function persistMigration(app, saved, m) {
     if (!m.changed) {
         return;
     }
-    const backup = path_1.default.join(app.getDataDirPath(), exports.V1_BACKUP);
+    const dir = isObject(saved) ? saved.cellsDir : undefined;
+    if (typeof dir === "string" && dir.trim() !== "" && m.config.chartsProvider === undefined) {
+        app.error("the ENC cells directory setting is gone: ENC now comes only from a charts provider; " +
+            `choose it under Charts provider (the earlier settings are kept in ${backupName(m.from)})`);
+    }
+    const backup = path_1.default.join(app.getDataDirPath(), backupName(m.from));
     try {
-        if (m.from === 1 && !fs_1.default.existsSync(backup)) {
+        if (!fs_1.default.existsSync(backup)) {
             fs_1.default.writeFileSync(backup, JSON.stringify(saved ?? {}, null, 2));
         }
     }

package/lib/setup-checks.js

@@ -62,13 +62,18 @@ function suggestedSource(datums) {
 }
 function chartsCheck(s, facts) {
     if (facts.cells > 0) {
-        return { id: "charts", level: "ok", text: `Charts: ${facts.cells} cells indexed` };
+        // With no provider chosen no ENC is read, as a cells directory dropped by the version 3
+        // migration leaves it: said for as long as none is chosen.
+        const only = s.config?.chartsProviderEnc
+            ? ""
+            : "; no charts provider chosen, so no ENC is read: choose the charts provider";
+        return { id: "charts", level: "ok", text: `Charts: ${facts.cells} cells indexed${only}` };
     }
-    if (!s.config?.cellsDir && !s.config?.wfs) {
+    if (!s.config?.chartsProviderEnc && !s.config?.wfs) {
         return {
             id: "charts",
             level: "todo",
-            text: "Charts: set the ENC cells directory or ENC from Charts Provider"
+            text: "Charts: choose the charts provider"
         };
     }
     const reason = (0, public_text_1.publicReason)(s.load?.reason) ?? "no chart index loaded";
@@ -183,6 +188,6 @@ function schemaHints(app, s) {
         checks: setupChecks(s, facts).map((c) => `${MARK[c.level]} ${c.text}`),
         signalkDraft: facts.signalk.draft,
         source: sourceHint(facts),
-        encCollections: (0, shared_enc_1.collectionsHint)()
+        enc: (0, shared_enc_1.runningProviders)()
     };
 }

package/lib/shared-enc.js

@@ -3,15 +3,17 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.COLLECTION_CHOICE_PATTERN = exports.ALL_COLLECTIONS = exports.CHARTS_PROVIDER_ID = void 0;
-exports.isCollectionChoice = isCollectionChoice;
+exports.AREA_ERROR_RETRY_MS = exports.ALL_COLLECTIONS = exports.CHARTS_PROVIDER_ID = void 0;
 exports.sharedEncApi = sharedEncApi;
 exports.sharedEncRoot = sharedEncRoot;
 exports.sharedCellsDir = sharedCellsDir;
 exports.withSharedCells = withSharedCells;
+exports.runningProviders = runningProviders;
+exports.sharedCollections = sharedCollections;
 exports.collectionsHint = collectionsHint;
 exports.sharedCellsNote = sharedCellsNote;
 exports.noteSharedCells = noteSharedCells;
+exports.sharedCellsIn = sharedCellsIn;
 exports.requestSharedArea = requestSharedArea;
 exports.watchSharedCells = watchSharedCells;
 const path_1 = __importDefault(require("path"));
@@ -20,19 +22,12 @@ const path_1 = __importDefault(require("path"));
  * cells behind its ENC charts as delivered, one folder per collection (an
  * ENC Charts set's cells, or a converted chart's):
  * `<root>/<collection>/<CELL>/<CELL>.000` with the updates beside it. The
- * plugin reads a collection, or the whole store, as its cells directory,
+ * plugin reads a collection, or the whole store, as its only cells directory,
  * and is told when the cells change. See that plugin's docs/enc-store.md.
  */
 exports.CHARTS_PROVIDER_ID = "signalk-charts-provider-simple";
 /** Every collection the charts provider shares. */
 exports.ALL_COLLECTIONS = "*";
-const COLLECTION_ID = /^[A-Za-z0-9_-]{1,80}$/;
-/** A collection choice for the admin form, with the space around it that parsing trims. */
-exports.COLLECTION_CHOICE_PATTERN = "^\\s*(\\*|[A-Za-z0-9_-]{1,80})?\\s*$";
-/** A collection's id, or ALL_COLLECTIONS. */
-function isCollectionChoice(value) {
-    return value === exports.ALL_COLLECTIONS || COLLECTION_ID.test(value);
-}
 /** The charts provider's ENC store API, while that plugin runs in this server. */
 function sharedEncApi(scope = globalThis) {
     const api = scope.__signalk_chartsProviderEnc;
@@ -59,24 +54,43 @@ function sharedCellsDir(dataDir, collection, api = sharedEncApi()) {
     const root = sharedEncRoot(dataDir, api);
     return collection === exports.ALL_COLLECTIONS ? root : path_1.default.join(root, collection);
 }
-/** `cfg` reading its cells from the charts provider's collection when it names one. */
+/** `cfg` reading its cells from the charts provider's collection it names; none without one. */
 function withSharedCells(cfg, dataDir, api = sharedEncApi()) {
+    const { cellsDir: _none, ...rest } = cfg;
     return cfg.chartsProviderEnc === undefined
-        ? cfg
-        : { ...cfg, cellsDir: sharedCellsDir(dataDir, cfg.chartsProviderEnc, api) };
+        ? rest
+        : { ...rest, cellsDir: sharedCellsDir(dataDir, cfg.chartsProviderEnc, api) };
 }
-/** One line naming the collections the charts provider shares, for the admin form. */
-function collectionsHint(api = sharedEncApi()) {
+/**
+ * The chart provider services running in this server, by id, and what Charts Provider shares
+ * now, for the admin form.
+ */
+function runningProviders(scope = globalThis) {
+    const api = sharedEncApi(scope);
+    const shared = collectionsHint(api);
+    return {
+        running: api ? [exports.CHARTS_PROVIDER_ID] : [],
+        ...(shared === undefined ? {} : { shared })
+    };
+}
+/** The collections the charts provider shares now; undefined while it cannot tell. */
+function sharedCollections(api = sharedEncApi()) {
     if (!api) {
         return undefined;
     }
-    let collections;
     try {
-        collections = api.collections();
+        return api.collections();
     }
     catch {
         return undefined;
     }
+}
+/** One line naming the collections the charts provider shares. */
+function collectionsHint(api = sharedEncApi()) {
+    const collections = sharedCollections(api);
+    if (collections === undefined) {
+        return undefined;
+    }
     return collections.length === 0
         ? "Charts Provider shares no ENC cells yet: download an ENC Charts set there."
         : `Shared now: ${collections
@@ -84,12 +98,13 @@ function collectionsHint(api = sharedEncApi()) {
             .join(", ")}.`;
 }
 /**
- * Why the charts provider's `collection` holds no cells to read, as it tells it; undefined
- * when it is ready, or the provider cannot tell.
+ * Why the charts provider's `collection` holds no cells to read, as it tells it, or that it is
+ * not running; undefined when it is ready, or cannot tell. A provider started later restarts
+ * the plugin (`watchShared`), so the note is read again then.
  */
 function sharedCellsNote(collection, api = sharedEncApi()) {
     if (!api) {
-        return undefined;
+        return "Charts Provider is not running";
     }
     if (collection === exports.ALL_COLLECTIONS) {
         return collectionsHint(api)?.startsWith("Charts Provider shares no")
@@ -111,7 +126,7 @@ function sharedCellsNote(collection, api = sharedEncApi()) {
                 ? `Charts Provider is downloading ${collection}; the index is built once its cells are shared`
                 : `${collection} is a Charts Provider chart set not downloaded yet: download it in its ENC Charts tab`;
         case "absent":
-            return `Charts Provider shares no ${collection}: check ENC from Charts Provider`;
+            return `Charts Provider shares no ${collection}: check the charts it shares`;
         default:
             return undefined;
     }
@@ -123,13 +138,36 @@ function noteSharedCells(load, cfg, api = sharedEncApi()) {
         : undefined;
     return note === undefined ? load : { ...load, reason: `${load.reason ?? ""}; ${note}` };
 }
-/** Asks the charts provider for the cells around `bbox`; undefined when it cannot be asked. */
+/**
+ * The stored cells of the charts provider reaching `bbox`; undefined when it cannot tell: not
+ * running, too old, or failing.
+ */
+function sharedCellsIn(bbox, api = sharedEncApi()) {
+    try {
+        return api?.cellsIn?.(bbox);
+    }
+    catch {
+        return undefined;
+    }
+}
+/** When to ask again after the charts provider failed to answer, ms: it may recover. */
+exports.AREA_ERROR_RETRY_MS = 5 * 60_000;
+/**
+ * Asks the charts provider for the cells around `bbox`; undefined when it cannot be asked. A
+ * request that throws is a refusal asked again after AREA_ERROR_RETRY_MS, unlike one it
+ * refuses on purpose, which stays until the area changes.
+ */
 function requestSharedArea(bbox, api = sharedEncApi()) {
     try {
         return api?.requestArea?.(bbox, "signalk-underkeel");
     }
     catch (err) {
-        return { accepted: false, started: false, reason: err.message };
+        return {
+            accepted: false,
+            started: false,
+            reason: err.message,
+            retryAfterMs: exports.AREA_ERROR_RETRY_MS
+        };
     }
 }
 /**

package/lib/wfs-service.js

@@ -12,6 +12,7 @@ const box_sizing_1 = require("./box-sizing");
 const box_status_1 = require("./box-status");
 const cell_reader_1 = require("./ingest/cell-reader");
 const wfs_1 = require("./ingest/wfs");
+const shared_enc_1 = require("./shared-enc");
 const build_box_1 = require("./spatial/build-box");
 const chart_position_1 = require("./spatial/chart-position");
 const chart_index_1 = require("./spatial/chart-index");
@@ -53,7 +54,7 @@ class WfsService {
     indexed;
     /** The box of the last index this service handed over in this run. */
     handed;
-    /** The box `onBox` is to be told of again, and when. */
+    /** The box the charts provider is to be asked about again, and when. */
     again;
     /** The saved WFS cell was missing or unreadable at start: the box is downloaded again. */
     cellLost = false;
@@ -136,12 +137,14 @@ class WfsService {
     view() {
         const bbox = this.handed ?? this.box?.bbox;
         const lastMs = this.box?.durationMs;
+        const note = this.deps.area?.note();
         return {
             ...(bbox ? { bbox } : {}),
             rebuilding: this.busy,
             failed: !this.busy && this.lastError !== undefined,
             ...(lastMs === undefined ? {} : { lastMs }),
-            summary: this.status().summary
+            summary: this.status().summary,
+            ...(note === undefined ? {} : { providerNote: note })
         };
     }
     /** The cap the box grows to, never below the configured radius. */
@@ -265,8 +268,19 @@ class WfsService {
             this.ceilingKm = Math.max(min, Math.floor((radiusKm * 0.75) / box_sizing_1.STEP_KM) * box_sizing_1.STEP_KM);
         }
     }
+    /**
+     * Tells the charts provider of the box; advisory, so a failure never stops the refresh. A
+     * failed ask is tried again later, as a provider that failed to answer may recover.
+     */
     announce(bbox, now) {
-        const ms = this.deps.onBox?.(bbox);
+        let ms;
+        try {
+            ms = this.deps.area?.ask(bbox);
+        }
+        catch (err) {
+            this.deps.error(`${this.label}: asking for the area's cells failed: ${err.message}`);
+            ms = shared_enc_1.AREA_ERROR_RETRY_MS;
+        }
         this.again = ms === undefined ? undefined : { bbox, at: now + ms };
     }
     announceAgain(now) {
@@ -315,6 +329,8 @@ class WfsService {
                     }
                     : undefined,
                 cellsDir,
+                // WFS depths are built whatever ENC the charts provider has, but an index of
+                // charted hazards is kept while its cells are away, not replaced by depths alone.
                 cellsRequired: !("url" in config) || cells === true,
                 box: inBox ? bbox : undefined,
                 build: {

package/lib/wfs-wiring.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.AREA_ASK_MAX_MS = exports.AREA_ASK_MIN_MS = void 0;
 exports.startBox = startBox;
 exports.areaRequests = areaRequests;
+exports.areaNote = areaNote;
 exports.startWfs = startWfs;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
@@ -84,47 +85,84 @@ function startBox(w) {
         : undefined;
 }
 /**
- * What each new box tells the charts provider: asks for its cells with `chartsProviderArea`
- * on, and only while the source is `*`, as they arrive in a chart set of their own.
+ * The asking a configuration does: every new box asks the chosen charts provider for its
+ * cells, which it downloads into a chart set of its own; none without a provider.
  */
 function areaRequests(config, app) {
-    return config.chartsProviderArea && config.chartsProviderEnc === shared_enc_1.ALL_COLLECTIONS
-        ? askForArea(app)
-        : undefined;
+    return config.chartsProviderEnc === shared_enc_1.ALL_COLLECTIONS ? askForArea(app) : undefined;
 }
 /** How soon, and how late, a box is asked about again: Charts Provider starting, or busy. */
 exports.AREA_ASK_MIN_MS = 60_000;
 exports.AREA_ASK_MAX_MS = 30 * 60_000;
 const ASK_STARTING_MS = 5 * 60_000;
+/**
+ * What the provider said of a box, as the status gives it when the vessel has no chart
+ * coverage: from its answer to the area request and the cells it has stored there (`cells`,
+ * undefined when it cannot tell). Undefined when it has cells there and is not downloading:
+ * a gap at the vessel is then the charts'.
+ */
+function areaNote(answer, cells, running = (0, shared_enc_1.sharedEncApi)() !== undefined) {
+    if (answer === undefined) {
+        return unaskedNote(running);
+    }
+    if (answer.started) {
+        return "Charts Provider is downloading the ENC around the vessel";
+    }
+    if (cells === undefined) {
+        return `Charts Provider: ${answer.reason}`;
+    }
+    if (cells.length > 0) {
+        return undefined;
+    }
+    // Accepted and not started: no free ENC covers the area, or its download waits for the
+    // internet connection; the provider's reason says which.
+    return answer.accepted
+        ? `Charts Provider has no ENC for this area: ${answer.reason}`
+        : `Charts Provider has no ENC for this area and does not download it: ${answer.reason}`;
+}
+/** Why the charts provider could not be asked: not running, or a version without `requestArea`. */
+function unaskedNote(running) {
+    return running
+        ? "Charts Provider is too old to be asked for the ENC around the vessel: update it"
+        : "Charts Provider is not running";
+}
 /**
  * Asks the charts provider for each box's cells, logging its answer when it changes, and says
  * when to ask again: when the provider says so, or is not running yet.
  */
 function askForArea(app) {
     let last;
-    return (bbox) => {
-        const answer = (0, shared_enc_1.requestSharedArea)(bbox);
-        const line = answer === undefined
-            ? "Charts Provider cannot be asked for the ENC around the vessel: it is not running, or too old"
-            : `Charts Provider, asked for the ENC around the vessel: ${answer.reason}`;
-        if (line !== last) {
-            last = line;
-            if (answer?.accepted === true) {
-                app.debug(line);
-            }
-            else {
-                app.error(line);
+    let note;
+    return {
+        // A provider stopped since its answer leaves that answer stale: it is not running now.
+        note: () => ((0, shared_enc_1.sharedEncApi)() === undefined ? unaskedNote(false) : note),
+        ask: (bbox) => {
+            const api = (0, shared_enc_1.sharedEncApi)();
+            const answer = (0, shared_enc_1.requestSharedArea)(bbox, api);
+            note = areaNote(answer, answer === undefined ? undefined : (0, shared_enc_1.sharedCellsIn)(bbox, api), !!api);
+            const line = answer === undefined
+                ? unaskedNote(!!api)
+                : `Charts Provider, asked for the ENC around the vessel: ${answer.reason}`;
+            if (line !== last) {
+                last = line;
+                if (answer?.accepted === true) {
+                    app.debug(line);
+                }
+                else {
+                    app.error(line);
+                }
             }
+            const ms = answer === undefined ? ASK_STARTING_MS : answer.retryAfterMs;
+            return typeof ms === "number" && Number.isFinite(ms)
+                ? Math.min(exports.AREA_ASK_MAX_MS, Math.max(exports.AREA_ASK_MIN_MS, ms))
+                : undefined;
         }
-        const ms = answer === undefined ? ASK_STARTING_MS : answer.retryAfterMs;
-        return typeof ms === "number" && Number.isFinite(ms)
-            ? Math.min(exports.AREA_ASK_MAX_MS, Math.max(exports.AREA_ASK_MIN_MS, ms))
-            : undefined;
     };
 }
 function startWfs(w, config, dirName = "wfs") {
     const dir = path_1.default.join(w.app.getDataDirPath(), dirName);
     fs_1.default.mkdirSync(dir, { recursive: true });
+    const area = areaRequests(w.config, w.app);
     return new wfs_service_1.WfsService({
         config,
         dir,
@@ -132,7 +170,7 @@ function startWfs(w, config, dirName = "wfs") {
         cacheDir: (0, index_loader_1.cellCacheDir)(w.app.getDataDirPath()),
         leafZoom: w.config.leafZoom,
         source: (0, index_source_1.indexSource)(w.config),
-        onBox: areaRequests(w.config, w.app),
+        area,
         cellsDir: w.config.cellsDir,
         inBox: w.config.boxRadiusKm > 0,
         index: () => w.state.load?.index,
@@ -147,11 +185,14 @@ function startWfs(w, config, dirName = "wfs") {
         onIndex: (index, changed) => useIndex(w, index, changed),
         error: (m) => {
             w.app.error(m);
-            // With no index in use the failure is why the look-ahead is off: an error, not "waiting".
+            // With no index in use the failure is why the look-ahead is off: an error, not "waiting",
+            // with what the charts provider said of the box, as when it is downloading its cells.
             const { load, monitor } = w.state;
             if (load && !load.index) {
-                w.state.load = { ...load, reason: m };
-                monitor?.noIndex(m);
+                const note = area?.note();
+                const reason = note === undefined ? m : `${m}; ${note}`;
+                w.state.load = { ...load, reason };
+                monitor?.noIndex(reason);
             }
         }
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "signalk-underkeel",
-  "version": "0.4.0",
+  "version": "0.5.1",
   "description": "Under-keel clearance awareness for Signal K: look-ahead grounding risk, route checks and a living chart.",
   "main": "lib/index.js",
   "files": [
@@ -19,6 +19,7 @@
   "keywords": [
     "signalk-node-server-plugin",
     "signalk-category-notifications",
+    "signalk-category-plotter-extensions",
     "signalk-category-chart-plotters"
   ],
   "signalk": {