kahu-signalk 0.0.12 → 0.0.13

package/README.md

@@ -203,6 +203,21 @@ If you see *“kahu-signalk requires Node.js 22.5.0 or later”*, switch the Nod
 
 You may see an **ExperimentalWarning** about SQLite from Node; that is expected until the API is stabilized.
 
+## Route Cache Migration Fallback
+
+The plugin now auto-checks route cache schema compatibility at startup and will recreate an incompatible cache database automatically when needed.
+
+If you still see SQLite errors like:
+- `foreign key mismatch - "target_position" referencing "target"`
+
+you can manually reset the plugin cache and restart Signal K:
+
+```bash
+rm ~/.signalk/plugin-config-data/radarhub/routecache.sqlite3
+```
+
+This only clears the local cache used for upload buffering; it does not remove plugin code or configuration.
+
 ### Command typo
 
 Use `--config-dir` (with an **n**), not `--confic-dir`:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kahu-signalk",
-  "version": "0.0.12",
+  "version": "0.0.13",
   "description": "Contribute AIS and ARPA targets from your vessel to crowdsourcing for marine safety!",
   "keywords": [
     "signalk-node-server-plugin",

package/plugin/routecache.js

@@ -48,6 +48,7 @@ class Routecache {
       await this.openDB();
       await this.createEmpty();
       await this.migrate();
+      await this.ensureCompatibleSchemaOrRebuild();
       return;
     } catch (e) {
       console.error(e, ". Deleting route cache.");
@@ -62,6 +63,45 @@ class Routecache {
     }
   }
 
+  async ensureCompatibleSchemaOrRebuild() {
+    const hasTargetTable = this.doesTableExist("target");
+    const hasTargetPositionTable = this.doesTableExist("target_position");
+    if (!hasTargetTable || !hasTargetPositionTable) return;
+
+    const fkRows = this._all("PRAGMA foreign_key_list(target_position)");
+    const hasExpectedFk = fkRows.some(
+      (row) =>
+        row.from === "target_id" &&
+        row.table === "target" &&
+        row.to === "target_id"
+    );
+
+    if (hasExpectedFk) return;
+
+    console.warn(
+      "Detected incompatible route cache schema (target_position FK mismatch). Rebuilding route cache database."
+    );
+
+    await this.closeDB();
+    await fs.unlink(this.db_name);
+    await this.openDB();
+    await this.createEmpty();
+    await this.migrate();
+
+    const rebuiltFkRows = this._all("PRAGMA foreign_key_list(target_position)");
+    const rebuiltHasExpectedFk = rebuiltFkRows.some(
+      (row) =>
+        row.from === "target_id" &&
+        row.table === "target" &&
+        row.to === "target_id"
+    );
+    if (!rebuiltHasExpectedFk) {
+      throw new Error(
+        "Route cache rebuild completed, but target_position foreign key is still incompatible."
+      );
+    }
+  }
+
   doesTableExist(tableName) {
     const row = this.db
       .prepare("SELECT count(*) as count FROM sqlite_master WHERE type='table' AND name=?")