@noforeignland/signalk-to-noforeignland 1.0.1-beta.8 → 1.1.0-beta.11
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +14 -5
- package/PROJECT_STRUCTURE.md +357 -0
- package/README.md +15 -6
- package/cleanup-old-plugin.js +69 -21
- package/doc/beta_install_cerbo.md +27 -6
- package/index.js +206 -891
- package/lib/ConfigManager.js +216 -0
- package/lib/DataPathEmitter.js +93 -0
- package/lib/DirectoryUtils.js +38 -0
- package/lib/HealthMonitor.js +91 -0
- package/lib/PluginCleanup.js +259 -0
- package/lib/TrackLogger.js +306 -0
- package/lib/TrackMigration.js +110 -0
- package/lib/TrackSender.js +219 -0
- package/package.json +1 -1
- package/doc/dev +0 -17
package/index.js
CHANGED
|
@@ -1,195 +1,47 @@
|
|
|
1
|
-
const { EOL } = require('os');
|
|
2
|
-
const fs = require('fs-extra');
|
|
3
|
-
const path = require('path');
|
|
4
1
|
const CronJob = require('cron').CronJob;
|
|
5
|
-
const readline = require('readline');
|
|
6
|
-
const fetch = require('node-fetch');
|
|
7
2
|
|
|
8
|
-
|
|
9
|
-
const
|
|
10
|
-
const
|
|
11
|
-
const
|
|
12
|
-
const
|
|
3
|
+
// Import all modules
|
|
4
|
+
const ConfigManager = require('./lib/ConfigManager');
|
|
5
|
+
const PluginCleanup = require('./lib/PluginCleanup');
|
|
6
|
+
const TrackMigration = require('./lib/TrackMigration');
|
|
7
|
+
const TrackLogger = require('./lib/TrackLogger');
|
|
8
|
+
const TrackSender = require('./lib/TrackSender');
|
|
9
|
+
const HealthMonitor = require('./lib/HealthMonitor');
|
|
10
|
+
const DataPathEmitter = require('./lib/DataPathEmitter');
|
|
11
|
+
const DirectoryUtils = require('./lib/DirectoryUtils');
|
|
13
12
|
|
|
14
13
|
class SignalkToNoforeignland {
|
|
15
14
|
constructor(app) {
|
|
16
15
|
this.app = app;
|
|
17
16
|
this.pluginId = 'signalk-to-noforeignland';
|
|
18
17
|
this.pluginName = 'Signal K to Noforeignland';
|
|
19
|
-
this.creator = 'signalk-track-logger';
|
|
20
18
|
|
|
21
|
-
//
|
|
22
|
-
this.
|
|
23
|
-
this.unsubscribesControl = [];
|
|
24
|
-
this.lastPosition = null;
|
|
19
|
+
// Runtime state
|
|
20
|
+
this.options = {};
|
|
25
21
|
this.upSince = null;
|
|
26
22
|
this.cron = null;
|
|
27
|
-
this.options = {};
|
|
28
23
|
this.lastSuccessfulTransfer = null;
|
|
29
24
|
|
|
30
|
-
//
|
|
31
|
-
this.
|
|
32
|
-
this.
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
this.
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
// Emit SignalK deltas for data paths
|
|
39
|
-
emitDelta(path, value) {
|
|
40
|
-
try {
|
|
41
|
-
const delta = {
|
|
42
|
-
context: 'vessels.self',
|
|
43
|
-
updates: [{
|
|
44
|
-
timestamp: new Date().toISOString(),
|
|
45
|
-
values: [{
|
|
46
|
-
path: path,
|
|
47
|
-
value: value
|
|
48
|
-
}]
|
|
49
|
-
}]
|
|
50
|
-
};
|
|
51
|
-
this.app.handleMessage(this.pluginId, delta);
|
|
52
|
-
} catch (err) {
|
|
53
|
-
this.app.debug(`Failed to emit delta for ${path}:`, err.message);
|
|
54
|
-
}
|
|
55
|
-
}
|
|
56
|
-
|
|
57
|
-
updateStatusPaths() {
|
|
58
|
-
const hasError = this.currentError !== null;
|
|
59
|
-
|
|
60
|
-
// SHORT format for data path
|
|
61
|
-
if (!hasError) {
|
|
62
|
-
const activeSource = this.options.filterSource || this.autoSelectedSource || '';
|
|
63
|
-
const saveTime = this.lastPosition ? new Date(this.lastPosition.currentTime).toLocaleTimeString() : 'None since start';
|
|
64
|
-
const transferTime = this.lastSuccessfulTransfer ? this.lastSuccessfulTransfer.toLocaleTimeString() : 'None since start';
|
|
65
|
-
const shortStatus = `Save: ${saveTime} | Transfer: ${transferTime}`;
|
|
66
|
-
this.emitDelta('noforeignland.status', shortStatus);
|
|
67
|
-
this.emitDelta('noforeignland.source', activeSource);
|
|
68
|
-
} else {
|
|
69
|
-
this.emitDelta('noforeignland.status', `ERROR: ${this.currentError}`);
|
|
70
|
-
}
|
|
71
|
-
this.emitDelta('noforeignland.status_boolean', hasError ? 1 : 0);
|
|
72
|
-
}
|
|
73
|
-
|
|
74
|
-
// Override setPluginStatus to also emit data path
|
|
75
|
-
setPluginStatus(status) {
|
|
76
|
-
this.currentStatus = status;
|
|
77
|
-
this.currentError = null;
|
|
78
|
-
this.app.setPluginStatus(status);
|
|
79
|
-
this.updateStatusPaths();
|
|
80
|
-
}
|
|
81
|
-
|
|
82
|
-
// Override setPluginError to also emit data path
|
|
83
|
-
setPluginError(error) {
|
|
84
|
-
this.currentError = error;
|
|
85
|
-
this.app.setPluginError(error);
|
|
86
|
-
this.updateStatusPaths();
|
|
25
|
+
// Module instances
|
|
26
|
+
this.configManager = new ConfigManager(app);
|
|
27
|
+
this.pluginCleanup = new PluginCleanup(app);
|
|
28
|
+
this.dataPathEmitter = new DataPathEmitter(app, this.pluginId);
|
|
29
|
+
this.trackLogger = null;
|
|
30
|
+
this.trackSender = null;
|
|
31
|
+
this.healthMonitor = null;
|
|
32
|
+
this.trackMigration = null;
|
|
87
33
|
}
|
|
88
34
|
|
|
35
|
+
/**
|
|
36
|
+
* Get plugin schema
|
|
37
|
+
*/
|
|
89
38
|
getSchema() {
|
|
90
|
-
return
|
|
91
|
-
title: this.pluginName,
|
|
92
|
-
description: 'Some parameters need for use',
|
|
93
|
-
type: 'object',
|
|
94
|
-
properties: {
|
|
95
|
-
// Mandatory Settings Group
|
|
96
|
-
mandatory: {
|
|
97
|
-
type: 'object',
|
|
98
|
-
title: 'Mandatory Settings',
|
|
99
|
-
properties: {
|
|
100
|
-
boatApiKey: {
|
|
101
|
-
type: 'string',
|
|
102
|
-
title: 'Boat API Key',
|
|
103
|
-
description: 'Boat API Key from noforeignland.com. Can be found in Account > Settings > Boat tracking > API Key.'
|
|
104
|
-
}
|
|
105
|
-
}
|
|
106
|
-
},
|
|
107
|
-
|
|
108
|
-
// Advanced Settings Group
|
|
109
|
-
advanced: {
|
|
110
|
-
type: 'object',
|
|
111
|
-
title: 'Advanced Settings',
|
|
112
|
-
properties: {
|
|
113
|
-
minMove: {
|
|
114
|
-
type: 'number',
|
|
115
|
-
title: 'Minimum boat move to log in meters',
|
|
116
|
-
description: 'To keep file sizes small we only log positions if a move larger than this size (if set to 0 will log every move)',
|
|
117
|
-
default: 80
|
|
118
|
-
},
|
|
119
|
-
minSpeed: {
|
|
120
|
-
type: 'number',
|
|
121
|
-
title: 'Minimum boat speed to log in knots',
|
|
122
|
-
description: 'To keep file sizes small we only log positions if boat speed goes above this value to minimize recording position on anchor or mooring (if set to 0 will log every move)',
|
|
123
|
-
default: 1.5
|
|
124
|
-
},
|
|
125
|
-
sendWhileMoving: {
|
|
126
|
-
type: 'boolean',
|
|
127
|
-
title: 'Attempt sending location while moving',
|
|
128
|
-
description: 'Should the plugin attempt to send tracking data to NFL while detecting the vessel is moving or only when stopped?',
|
|
129
|
-
default: true
|
|
130
|
-
},
|
|
131
|
-
ping_api_every_24h: {
|
|
132
|
-
type: 'boolean',
|
|
133
|
-
title: 'Force a send every 24 hours',
|
|
134
|
-
description: 'Keeps your boat active on NFL in your current location even if you do not move',
|
|
135
|
-
default: true
|
|
136
|
-
}
|
|
137
|
-
}
|
|
138
|
-
},
|
|
139
|
-
|
|
140
|
-
// Expert Settings Group
|
|
141
|
-
expert: {
|
|
142
|
-
type: 'object',
|
|
143
|
-
title: 'Expert Settings',
|
|
144
|
-
properties: {
|
|
145
|
-
filterSource: {
|
|
146
|
-
type: 'string',
|
|
147
|
-
title: 'Position source device',
|
|
148
|
-
description: 'EMPTY DEFAULT IS FINE - Set this value to the name of a source if you want to only use the position given by that source.'
|
|
149
|
-
},
|
|
150
|
-
trackDir: {
|
|
151
|
-
type: 'string',
|
|
152
|
-
title: 'Directory to cache tracks',
|
|
153
|
-
description: 'EMPTY DEFAULT IS FINE - Path to store track data. Relative paths are stored in plugin data directory. Absolute paths can point anywhere.\nDefault: nfl-track'
|
|
154
|
-
},
|
|
155
|
-
keepFiles: {
|
|
156
|
-
type: 'boolean',
|
|
157
|
-
title: 'Keep track files on disk',
|
|
158
|
-
description: 'If you have a lot of hard drive space you can keep the track files for logging purposes.',
|
|
159
|
-
default: false
|
|
160
|
-
},
|
|
161
|
-
trackFrequency: {
|
|
162
|
-
type: 'integer',
|
|
163
|
-
title: 'Position tracking frequency in seconds',
|
|
164
|
-
description: 'To keep file sizes small we only log positions once in a while (unless you set this value to 0)',
|
|
165
|
-
default: 60
|
|
166
|
-
},
|
|
167
|
-
apiCron: {
|
|
168
|
-
type: 'string',
|
|
169
|
-
title: 'Send attempt CRON',
|
|
170
|
-
description: 'We send the tracking data to NFL once in a while, you can set the schedule with this setting.\nCRON format: https://crontab.guru/',
|
|
171
|
-
default: '*/10 * * * *'
|
|
172
|
-
},
|
|
173
|
-
internetTestTimeout: {
|
|
174
|
-
type: 'number',
|
|
175
|
-
title: 'Timeout for testing internet connection in ms',
|
|
176
|
-
description: 'Set this number higher for slower computers and internet connections',
|
|
177
|
-
default: 2000
|
|
178
|
-
},
|
|
179
|
-
apiTimeout: {
|
|
180
|
-
type: 'integer',
|
|
181
|
-
title: 'API request timeout in seconds',
|
|
182
|
-
description: 'Timeout for sending data to NFL API. Increase for slow connections.',
|
|
183
|
-
default: 30,
|
|
184
|
-
minimum: 10,
|
|
185
|
-
maximum: 180
|
|
186
|
-
}
|
|
187
|
-
}
|
|
188
|
-
}
|
|
189
|
-
}
|
|
190
|
-
};
|
|
39
|
+
return ConfigManager.getSchema(this.pluginName);
|
|
191
40
|
}
|
|
192
41
|
|
|
42
|
+
/**
|
|
43
|
+
* Get plugin object for SignalK
|
|
44
|
+
*/
|
|
193
45
|
getPluginObject() {
|
|
194
46
|
return {
|
|
195
47
|
id: this.pluginId,
|
|
@@ -201,776 +53,239 @@ class SignalkToNoforeignland {
|
|
|
201
53
|
};
|
|
202
54
|
}
|
|
203
55
|
|
|
56
|
+
/**
|
|
57
|
+
* Start the plugin
|
|
58
|
+
*/
|
|
204
59
|
async start(options = {}, restartPlugin) {
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
// Backward compatibility: migrate old flat structure to new nested structure
|
|
210
|
-
let needsSave = false;
|
|
211
|
-
if (options.boatApiKey && !options.mandatory) {
|
|
212
|
-
this.app.debug('Migrating old configuration to new grouped structure');
|
|
213
|
-
needsSave = true;
|
|
60
|
+
try {
|
|
61
|
+
// 1. Migrate old config structure if needed
|
|
62
|
+
const { options: migratedOptions, migrated } = await this.configManager.migrateOldConfig(options);
|
|
63
|
+
options = migratedOptions;
|
|
214
64
|
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
boatApiKey: options.boatApiKey
|
|
218
|
-
},
|
|
219
|
-
advanced: {
|
|
220
|
-
minMove: options.minMove !== undefined ? options.minMove : 50,
|
|
221
|
-
minSpeed: options.minSpeed !== undefined ? options.minSpeed : 1.5,
|
|
222
|
-
sendWhileMoving: options.sendWhileMoving !== undefined ? options.sendWhileMoving : true,
|
|
223
|
-
ping_api_every_24h: options.ping_api_every_24h !== undefined ? options.ping_api_every_24h : true
|
|
224
|
-
},
|
|
225
|
-
expert: {
|
|
226
|
-
filterSource: options.filterSource,
|
|
227
|
-
trackDir: options.trackDir,
|
|
228
|
-
keepFiles: options.keepFiles !== undefined ? options.keepFiles : false,
|
|
229
|
-
trackFrequency: options.trackFrequency !== undefined ? options.trackFrequency : 60,
|
|
230
|
-
internetTestTimeout: options.internetTestTimeout !== undefined ? options.internetTestTimeout : 2000,
|
|
231
|
-
apiCron: options.apiCron || '*/10 * * * *',
|
|
232
|
-
apiTimeout: options.apiTimeout !== undefined ? options.apiTimeout : 30
|
|
233
|
-
}
|
|
234
|
-
};
|
|
65
|
+
// 2. Flatten config and apply defaults
|
|
66
|
+
this.options = this.configManager.flattenConfig(options);
|
|
235
67
|
|
|
68
|
+
// 3. Validate API key
|
|
236
69
|
try {
|
|
237
|
-
this.
|
|
238
|
-
await this.app.savePluginOptions(options, () => {
|
|
239
|
-
this.app.debug('Configuration successfully migrated and saved');
|
|
240
|
-
});
|
|
70
|
+
this.configManager.validateApiKey(this.options);
|
|
241
71
|
} catch (err) {
|
|
242
|
-
this.app.debug(
|
|
72
|
+
this.app.debug(err.message);
|
|
73
|
+
this.setPluginError(err.message);
|
|
74
|
+
this.stop();
|
|
75
|
+
return;
|
|
243
76
|
}
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
// Flatten the nested structure for easier access and apply defaults
|
|
247
|
-
this.options = {
|
|
248
|
-
boatApiKey: options.mandatory?.boatApiKey,
|
|
249
|
-
minMove: options.advanced?.minMove !== undefined ? options.advanced.minMove : 80,
|
|
250
|
-
minSpeed: options.advanced?.minSpeed !== undefined ? options.advanced.minSpeed : 1.5,
|
|
251
|
-
sendWhileMoving: options.advanced?.sendWhileMoving !== undefined ? options.advanced.sendWhileMoving : true,
|
|
252
|
-
ping_api_every_24h: options.advanced?.ping_api_every_24h !== undefined ? options.advanced.ping_api_every_24h : true,
|
|
253
|
-
filterSource: options.expert?.filterSource,
|
|
254
|
-
trackDir: options.expert?.trackDir || defaultTracksDir,
|
|
255
|
-
keepFiles: options.expert?.keepFiles !== undefined ? options.expert.keepFiles : false,
|
|
256
|
-
trackFrequency: options.expert?.trackFrequency !== undefined ? options.expert.trackFrequency : 60,
|
|
257
|
-
internetTestTimeout: options.expert?.internetTestTimeout !== undefined ? options.expert.internetTestTimeout : 2000,
|
|
258
|
-
apiCron: options.expert?.apiCron || '*/10 * * * *',
|
|
259
|
-
apiTimeout: options.expert?.apiTimeout !== undefined ? options.expert.apiTimeout : 30
|
|
260
|
-
};
|
|
261
|
-
|
|
262
|
-
// Validate that boatApiKey is set
|
|
263
|
-
if (!this.options.boatApiKey || this.options.boatApiKey.trim() === '') {
|
|
264
|
-
const errorMsg = 'No boat API key configured. Please set your API key in plugin settings (Mandatory Settings > Boat API key). You can find your API key at noforeignland.com under Account > Settings > Boat tracking > API Key.';
|
|
265
|
-
this.app.debug(errorMsg);
|
|
266
|
-
this.setPluginError(errorMsg);
|
|
267
|
-
this.stop();
|
|
268
|
-
return;
|
|
269
|
-
}
|
|
270
|
-
|
|
271
|
-
// Resolve track directory path
|
|
272
|
-
if (!path.isAbsolute(this.options.trackDir)) {
|
|
77
|
+
|
|
78
|
+
// 4. Resolve track directory path
|
|
273
79
|
const dataDirPath = this.app.getDataDirPath();
|
|
274
|
-
this.options.trackDir =
|
|
275
|
-
}
|
|
276
|
-
|
|
277
|
-
if (!this.createDir(this.options.trackDir)) {
|
|
278
|
-
this.stop();
|
|
279
|
-
return;
|
|
280
|
-
}
|
|
281
|
-
|
|
282
|
-
// Cleanup old plugin (fire and forget, non-blocking)
|
|
283
|
-
this.cleanupOldPlugin().catch(err => {
|
|
284
|
-
this.app.debug('Error in cleanupOldPlugin:', err.message);
|
|
285
|
-
});
|
|
286
|
-
|
|
287
|
-
// Migrate old track files
|
|
288
|
-
await this.migrateOldTrackFile();
|
|
289
|
-
|
|
290
|
-
this.app.debug('track logger started, now logging to', this.options.trackDir);
|
|
291
|
-
this.setPluginStatus(`Started${needsSave ? ' (config migrated)' : ''}`);
|
|
292
|
-
this.upSince = new Date().getTime();
|
|
293
|
-
|
|
294
|
-
// Adjust default CRON if unchanged
|
|
295
|
-
if (!this.options.apiCron || this.options.apiCron === '*/10 * * * *') {
|
|
296
|
-
const startMinute = Math.floor(Math.random() * 10);
|
|
297
|
-
const startSecond = Math.floor(Math.random() * 60);
|
|
298
|
-
this.options.apiCron = `${startSecond} ${startMinute}/10 * * * *`;
|
|
299
|
-
}
|
|
300
|
-
|
|
301
|
-
this.app.debug('Setting CRON to', this.options.apiCron);
|
|
302
|
-
this.app.debug('trackFrequency is set to', this.options.trackFrequency, 'seconds');
|
|
303
|
-
|
|
304
|
-
// Subscribe and start logging
|
|
305
|
-
this.doLogging();
|
|
306
|
-
|
|
307
|
-
// Start cron job
|
|
308
|
-
this.cron = new CronJob(this.options.apiCron, this.interval.bind(this));
|
|
309
|
-
this.cron.start();
|
|
310
|
-
|
|
311
|
-
// Start position health check
|
|
312
|
-
this.startPositionHealthCheck();
|
|
313
|
-
}
|
|
314
|
-
|
|
315
|
-
async cleanupOldPlugin() {
|
|
316
|
-
try {
|
|
317
|
-
// Detect SignalK directory (standard or Victron Cerbo)
|
|
318
|
-
const victronPath = '/data/conf/signalk';
|
|
319
|
-
const standardPath = process.env.SIGNALK_NODE_CONFIG_DIR ||
|
|
320
|
-
path.join(process.env.HOME || process.env.USERPROFILE, '.signalk');
|
|
80
|
+
this.options.trackDir = this.configManager.resolveTrackDir(this.options, dataDirPath);
|
|
321
81
|
|
|
322
|
-
|
|
323
|
-
|
|
82
|
+
// 5. Create track directory
|
|
83
|
+
try {
|
|
84
|
+
DirectoryUtils.createDir(this.options.trackDir, this.app);
|
|
85
|
+
} catch (err) {
|
|
86
|
+
this.setPluginError(err.message);
|
|
87
|
+
this.stop();
|
|
88
|
+
return;
|
|
89
|
+
}
|
|
324
90
|
|
|
325
|
-
|
|
91
|
+
// 6. Cleanup old plugin versions (with callback handling)
|
|
92
|
+
this.pluginCleanup.cleanup()
|
|
93
|
+
.then((result) => {
|
|
94
|
+
if (result === 'all_removed') {
|
|
95
|
+
this.app.debug('Old plugins successfully cleaned up');
|
|
96
|
+
// Update status if plugin started successfully
|
|
97
|
+
if (this.options.boatApiKey) {
|
|
98
|
+
this.setPluginStatus('Started (old plugins cleaned up)');
|
|
99
|
+
}
|
|
100
|
+
}
|
|
101
|
+
})
|
|
102
|
+
.catch(err => {
|
|
103
|
+
this.app.debug('Error in cleanupOldPlugin:', err.message);
|
|
104
|
+
});
|
|
326
105
|
|
|
327
|
-
//
|
|
328
|
-
|
|
329
|
-
|
|
106
|
+
// 7. Migrate old track files
|
|
107
|
+
this.trackMigration = new TrackMigration(this.app, this.options.trackDir);
|
|
108
|
+
await this.trackMigration.migrate();
|
|
330
109
|
|
|
331
|
-
|
|
332
|
-
|
|
333
|
-
|
|
334
|
-
|
|
335
|
-
this.app.debug('✓ Configuration migrated successfully');
|
|
336
|
-
}
|
|
110
|
+
// 8. Initialize modules
|
|
111
|
+
this.trackLogger = new TrackLogger(this.app, this.options, this.options.trackDir);
|
|
112
|
+
this.trackSender = new TrackSender(this.app, this.options, this.options.trackDir);
|
|
113
|
+
this.healthMonitor = new HealthMonitor(this.app, this.options);
|
|
337
114
|
|
|
338
|
-
//
|
|
339
|
-
|
|
340
|
-
|
|
341
|
-
{ dir: path.join(configDir, 'node_modules', 'signalk-to-nfl'), name: 'signalk-to-nfl' }
|
|
342
|
-
];
|
|
115
|
+
// 9. Update startup time and randomize CRON
|
|
116
|
+
this.upSince = new Date().getTime();
|
|
117
|
+
this.options = this.configManager.randomizeCron(this.options);
|
|
343
118
|
|
|
344
|
-
|
|
119
|
+
this.app.debug('Setting CRON to', this.options.apiCron);
|
|
120
|
+
this.app.debug('trackFrequency is set to', this.options.trackFrequency, 'seconds');
|
|
121
|
+
this.app.debug('track logger started, now logging to', this.options.trackDir);
|
|
345
122
|
|
|
346
|
-
|
|
347
|
-
|
|
348
|
-
|
|
349
|
-
|
|
350
|
-
this.app.debug(`Old plugin(s) detected: ${pluginNames}`);
|
|
351
|
-
this.app.setPluginError(
|
|
352
|
-
`Old plugin(s) ${pluginNames} still installed. ` +
|
|
353
|
-
`Please uninstall manually: cd ${configDir} && npm uninstall ${uninstallCmd}`
|
|
354
|
-
);
|
|
355
|
-
|
|
356
|
-
// Try to remove them after a delay (non-blocking)
|
|
357
|
-
setTimeout(async () => {
|
|
358
|
-
let anyRemoved = false;
|
|
359
|
-
let anyFailed = false;
|
|
360
|
-
|
|
361
|
-
for (const plugin of foundOldPlugins) {
|
|
362
|
-
try {
|
|
363
|
-
this.app.debug(`Attempting to remove old plugin directory: ${plugin.name}...`);
|
|
364
|
-
await fs.remove(plugin.dir);
|
|
365
|
-
this.app.debug(`✓ Old plugin "${plugin.name}" directory removed`);
|
|
366
|
-
anyRemoved = true;
|
|
367
|
-
} catch (err) {
|
|
368
|
-
this.app.debug(`Could not automatically remove old plugin "${plugin.name}":`, err.message);
|
|
369
|
-
anyFailed = true;
|
|
370
|
-
}
|
|
371
|
-
}
|
|
372
|
-
|
|
373
|
-
if (anyRemoved && !anyFailed) {
|
|
374
|
-
this.setPluginStatus('Started (old plugins cleaned up)');
|
|
375
|
-
} else if (anyFailed) {
|
|
376
|
-
const remainingPlugins = foundOldPlugins.map(p => p.name).join(' ');
|
|
377
|
-
this.app.debug(`Please manually run: cd ${configDir} && npm uninstall ${remainingPlugins}`);
|
|
378
|
-
}
|
|
379
|
-
}, 5000); // 5 seconds wait for SignalK to fully start
|
|
380
|
-
}
|
|
123
|
+
// 10. Start logging
|
|
124
|
+
this.trackLogger.startLogging((lastPosition) => {
|
|
125
|
+
this.handleSavePoint(lastPosition);
|
|
126
|
+
});
|
|
381
127
|
|
|
382
|
-
|
|
383
|
-
this.
|
|
384
|
-
|
|
385
|
-
}
|
|
386
|
-
|
|
387
|
-
async migrateOldTrackFile() {
|
|
388
|
-
const oldTrackFile = path.join(this.options.trackDir, 'nfl-track.jsonl');
|
|
389
|
-
const oldPendingFile = path.join(this.options.trackDir, 'nfl-track-pending.jsonl');
|
|
390
|
-
const oldSentFile = path.join(this.options.trackDir, 'nfl-track-sent.jsonl');
|
|
391
|
-
const newPendingFile = path.join(this.options.trackDir, routeSaveName);
|
|
392
|
-
const newSentFile = path.join(this.options.trackDir, routeSentName);
|
|
393
|
-
|
|
394
|
-
try {
|
|
395
|
-
// Migrate old track file
|
|
396
|
-
if (await fs.pathExists(oldTrackFile) && !(await fs.pathExists(newPendingFile))) {
|
|
397
|
-
this.app.debug('Migrating old track file to new naming scheme...');
|
|
398
|
-
await fs.move(oldTrackFile, newPendingFile);
|
|
399
|
-
this.app.debug('Successfully migrated old track file to:', routeSaveName);
|
|
400
|
-
}
|
|
128
|
+
// 11. Start CRON job for sending data
|
|
129
|
+
this.cron = new CronJob(this.options.apiCron, this.interval.bind(this));
|
|
130
|
+
this.cron.start();
|
|
401
131
|
|
|
402
|
-
//
|
|
403
|
-
|
|
404
|
-
this.
|
|
405
|
-
|
|
406
|
-
this.
|
|
407
|
-
|
|
132
|
+
// 12. Start health monitoring
|
|
133
|
+
this.healthMonitor.start(
|
|
134
|
+
() => this.trackLogger.getLastPositionReceived(),
|
|
135
|
+
() => this.trackLogger.getAutoSelectedSource(),
|
|
136
|
+
(errorMsg) => this.setPluginError(errorMsg),
|
|
137
|
+
() => this.handleHealthy()
|
|
138
|
+
);
|
|
408
139
|
|
|
409
|
-
//
|
|
410
|
-
|
|
411
|
-
this.app.debug('Migrating old sent file to new naming scheme...');
|
|
412
|
-
await fs.move(oldSentFile, newSentFile);
|
|
413
|
-
this.app.debug('Successfully migrated old sent file to:', routeSentName);
|
|
414
|
-
}
|
|
140
|
+
// 13. Set plugin status
|
|
141
|
+
this.setPluginStatus(`Started${migrated ? ' (config migrated)' : ''}`);
|
|
415
142
|
|
|
416
|
-
// Check old plugin directory location
|
|
417
|
-
const oldPluginTrackDir = path.join(__dirname, 'track');
|
|
418
|
-
if (await fs.pathExists(oldPluginTrackDir)) {
|
|
419
|
-
this.app.debug('Found old track directory in plugin folder, migrating to new location...');
|
|
420
|
-
|
|
421
|
-
const oldFiles = [
|
|
422
|
-
'nfl-track.jsonl',
|
|
423
|
-
'nfl-track-pending.jsonl',
|
|
424
|
-
routeSaveName
|
|
425
|
-
];
|
|
426
|
-
|
|
427
|
-
for (const oldFile of oldFiles) {
|
|
428
|
-
const oldPath = path.join(oldPluginTrackDir, oldFile);
|
|
429
|
-
if (await fs.pathExists(oldPath) && !(await fs.pathExists(newPendingFile))) {
|
|
430
|
-
await fs.move(oldPath, newPendingFile);
|
|
431
|
-
this.app.debug('Migrated pending track file from old plugin location');
|
|
432
|
-
break;
|
|
433
|
-
}
|
|
434
|
-
}
|
|
435
|
-
|
|
436
|
-
// Migrate sent archive
|
|
437
|
-
const oldSentFiles = [routeSentName, 'nfl-track-sent.jsonl'];
|
|
438
|
-
for (const oldFile of oldSentFiles) {
|
|
439
|
-
const oldPath = path.join(oldPluginTrackDir, oldFile);
|
|
440
|
-
if (await fs.pathExists(oldPath) && !(await fs.pathExists(newSentFile))) {
|
|
441
|
-
await fs.move(oldPath, newSentFile);
|
|
442
|
-
this.app.debug('Migrated sent track archive from old plugin location');
|
|
443
|
-
break;
|
|
444
|
-
}
|
|
445
|
-
}
|
|
446
|
-
|
|
447
|
-
// Try to remove old directory if empty
|
|
448
|
-
try {
|
|
449
|
-
const remainingFiles = await fs.readdir(oldPluginTrackDir);
|
|
450
|
-
if (remainingFiles.length === 0) {
|
|
451
|
-
await fs.rmdir(oldPluginTrackDir);
|
|
452
|
-
this.app.debug('Removed empty old track directory');
|
|
453
|
-
}
|
|
454
|
-
} catch (err) {
|
|
455
|
-
this.app.debug('Could not remove old track directory:', err.message);
|
|
456
|
-
}
|
|
457
|
-
}
|
|
458
143
|
} catch (err) {
|
|
459
|
-
this.app.debug('Error during
|
|
460
|
-
|
|
461
|
-
|
|
462
|
-
|
|
463
|
-
stop() {
|
|
464
|
-
this.app.debug('plugin stopped');
|
|
465
|
-
|
|
466
|
-
this.autoSelectedSource = null;
|
|
467
|
-
|
|
468
|
-
if (this.positionCheckInterval) {
|
|
469
|
-
clearInterval(this.positionCheckInterval);
|
|
470
|
-
this.positionCheckInterval = null;
|
|
471
|
-
}
|
|
472
|
-
|
|
473
|
-
if (this.cron) {
|
|
474
|
-
this.cron.stop();
|
|
475
|
-
this.cron = undefined;
|
|
476
|
-
}
|
|
477
|
-
|
|
478
|
-
this.unsubscribesControl.forEach(f => f());
|
|
479
|
-
this.unsubscribesControl = [];
|
|
480
|
-
this.unsubscribes.forEach(f => f());
|
|
481
|
-
this.unsubscribes = [];
|
|
482
|
-
this.app.setPluginStatus('Plugin stopped');
|
|
483
|
-
}
|
|
484
|
-
|
|
485
|
-
doLogging() {
|
|
486
|
-
let shouldDoLog = true;
|
|
487
|
-
|
|
488
|
-
this.app.subscriptionmanager.subscribe({
|
|
489
|
-
context: 'vessels.self',
|
|
490
|
-
subscribe: [{
|
|
491
|
-
path: 'navigation.position',
|
|
492
|
-
format: 'delta',
|
|
493
|
-
policy: 'instant',
|
|
494
|
-
minPeriod: this.options.trackFrequency ? this.options.trackFrequency * 1000 : 0
|
|
495
|
-
}]
|
|
496
|
-
}, this.unsubscribes, (subscriptionError) => {
|
|
497
|
-
this.app.debug('Error subscription to data:' + subscriptionError);
|
|
498
|
-
this.setPluginError('Error subscription to data:' + subscriptionError.message);
|
|
499
|
-
}, this.doOnValue.bind(this, () => shouldDoLog, newShould => { shouldDoLog = newShould; }));
|
|
500
|
-
|
|
501
|
-
// Subscribe for speed
|
|
502
|
-
if (this.options.minSpeed) {
|
|
503
|
-
this.app.subscriptionmanager.subscribe({
|
|
504
|
-
context: 'vessels.self',
|
|
505
|
-
subscribe: [{
|
|
506
|
-
path: 'navigation.speedOverGround',
|
|
507
|
-
format: 'delta',
|
|
508
|
-
policy: 'instant'
|
|
509
|
-
}]
|
|
510
|
-
}, this.unsubscribes, (subscriptionError) => {
|
|
511
|
-
this.app.debug('Error subscription to data:' + subscriptionError);
|
|
512
|
-
this.setPluginError('Error subscription to data:' + subscriptionError.message);
|
|
513
|
-
}, (delta) => {
|
|
514
|
-
delta.updates.forEach(update => {
|
|
515
|
-
if (this.options.filterSource && update.$source !== this.options.filterSource) {
|
|
516
|
-
return;
|
|
517
|
-
}
|
|
518
|
-
update.values.forEach(value => {
|
|
519
|
-
const speedInKnots = value.value * 1.94384;
|
|
520
|
-
if (!shouldDoLog && this.options.minSpeed < speedInKnots) {
|
|
521
|
-
this.app.debug('setting shouldDoLog to true, speed:', speedInKnots.toFixed(2), 'knots');
|
|
522
|
-
shouldDoLog = true;
|
|
523
|
-
}
|
|
524
|
-
});
|
|
525
|
-
});
|
|
526
|
-
});
|
|
527
|
-
}
|
|
528
|
-
}
|
|
529
|
-
|
|
530
|
-
// FIXED: Use continue instead of return to handle multiple updates properly
|
|
531
|
-
async doOnValue(getShouldDoLog, setShouldDoLog, delta) {
|
|
532
|
-
for (const update of delta.updates) {
|
|
533
|
-
// Auto-select source logic
|
|
534
|
-
if (!this.options.filterSource) {
|
|
535
|
-
const timeSinceLastPosition = this.lastPositionReceived
|
|
536
|
-
? (new Date().getTime() - this.lastPositionReceived) / 1000
|
|
537
|
-
: null;
|
|
538
|
-
|
|
539
|
-
if (!this.autoSelectedSource) {
|
|
540
|
-
this.autoSelectedSource = update.$source;
|
|
541
|
-
this.lastPositionReceived = new Date().getTime();
|
|
542
|
-
this.app.debug(`Auto-selected GPS source: '${this.autoSelectedSource}'`);
|
|
543
|
-
} else if (update.$source !== this.autoSelectedSource) {
|
|
544
|
-
if (timeSinceLastPosition && timeSinceLastPosition > 300) {
|
|
545
|
-
this.app.debug(`Switching from stale source '${this.autoSelectedSource}' to '${update.$source}' (no data for ${timeSinceLastPosition.toFixed(0)}s)`);
|
|
546
|
-
this.autoSelectedSource = update.$source;
|
|
547
|
-
this.lastPositionReceived = new Date().getTime();
|
|
548
|
-
} else {
|
|
549
|
-
this.app.debug(`Ignoring position from '${update.$source}', using auto-selected source '${this.autoSelectedSource}'`);
|
|
550
|
-
continue;
|
|
551
|
-
}
|
|
552
|
-
} else {
|
|
553
|
-
this.lastPositionReceived = new Date().getTime();
|
|
554
|
-
}
|
|
555
|
-
} else if (update.$source !== this.options.filterSource) {
|
|
556
|
-
this.app.debug(`Ignoring position from '${update.$source}', filterSource is set to '${this.options.filterSource}'`);
|
|
557
|
-
continue;
|
|
558
|
-
} else {
|
|
559
|
-
this.lastPositionReceived = new Date().getTime();
|
|
560
|
-
}
|
|
561
|
-
|
|
562
|
-
const timestamp = update.timestamp;
|
|
563
|
-
for (const value of update.values) {
|
|
564
|
-
// Validation: GPS near (0,0)
|
|
565
|
-
if (Math.abs(value.value.latitude) <= 0.01 && Math.abs(value.value.longitude) <= 0.01) {
|
|
566
|
-
this.app.debug('GPS coordinates near (0,0), ignoring point to avoid invalid data logging.');
|
|
567
|
-
continue;
|
|
568
|
-
}
|
|
569
|
-
|
|
570
|
-
// Validate lat/lon
|
|
571
|
-
if (!this.isValidLatitude(value.value.latitude) || !this.isValidLongitude(value.value.longitude)) {
|
|
572
|
-
this.app.debug('got invalid position, ignoring...', value.value);
|
|
573
|
-
continue;
|
|
574
|
-
}
|
|
575
|
-
|
|
576
|
-
// 24h ping check
|
|
577
|
-
let force24hSave = false;
|
|
578
|
-
if (this.options.ping_api_every_24h && this.lastPosition) {
|
|
579
|
-
const timeSinceLastPoint = (new Date().getTime() - this.lastPosition.currentTime);
|
|
580
|
-
if (timeSinceLastPoint >= 24 * 60 * 60 * 1000) {
|
|
581
|
-
this.app.debug('24h since last point, forcing save of point to keep boat active on NFL');
|
|
582
|
-
force24hSave = true;
|
|
583
|
-
}
|
|
584
|
-
}
|
|
585
|
-
|
|
586
|
-
// Check if we should log
|
|
587
|
-
if (!force24hSave && !getShouldDoLog()) {
|
|
588
|
-
this.app.debug('shouldDoLog is false, not logging position');
|
|
589
|
-
continue;
|
|
590
|
-
}
|
|
591
|
-
|
|
592
|
-
// Check timestamp and distance
|
|
593
|
-
if (this.lastPosition && !force24hSave) {
|
|
594
|
-
if (new Date(this.lastPosition.timestamp).getTime() > new Date(timestamp).getTime()) {
|
|
595
|
-
this.app.debug('got error in timestamp:', timestamp, 'is earlier than previous:', this.lastPosition.timestamp);
|
|
596
|
-
continue;
|
|
597
|
-
}
|
|
598
|
-
|
|
599
|
-
const distance = this.equirectangularDistance(this.lastPosition.pos, value.value);
|
|
600
|
-
if (this.options.minMove && distance < this.options.minMove) {
|
|
601
|
-
this.app.debug('Distance', distance.toFixed(2), 'm is less than minMove', this.options.minMove, 'm - skipping');
|
|
602
|
-
continue;
|
|
603
|
-
}
|
|
604
|
-
|
|
605
|
-
this.app.debug('Distance', distance.toFixed(2), 'm is greater than minMove', this.options.minMove, 'm - logging');
|
|
606
|
-
}
|
|
607
|
-
|
|
608
|
-
// Save point
|
|
609
|
-
this.app.debug('Saving position from source:', update.$source, 'lat:', value.value.latitude, 'lon:', value.value.longitude);
|
|
610
|
-
this.lastPosition = { pos: value.value, timestamp, currentTime: new Date().getTime() };
|
|
611
|
-
await this.savePoint(this.lastPosition);
|
|
612
|
-
|
|
613
|
-
// Reset shouldDoLog if minSpeed is active
|
|
614
|
-
if (this.options.minSpeed) {
|
|
615
|
-
this.app.debug('options.minSpeed - setting shouldDoLog to false');
|
|
616
|
-
setShouldDoLog(false);
|
|
617
|
-
}
|
|
618
|
-
}
|
|
144
|
+
this.app.debug('Error during plugin start:', err.message);
|
|
145
|
+
this.setPluginError(`Failed to start: ${err.message}`);
|
|
146
|
+
this.stop();
|
|
619
147
|
}
|
|
620
148
|
}
|
|
621
149
|
|
|
622
|
-
|
|
623
|
-
|
|
624
|
-
|
|
625
|
-
|
|
626
|
-
t: point.timestamp
|
|
627
|
-
};
|
|
628
|
-
this.app.debug(`save data point:`, obj);
|
|
629
|
-
await fs.appendFile(path.join(this.options.trackDir, routeSaveName), JSON.stringify(obj) + EOL);
|
|
630
|
-
|
|
150
|
+
/**
|
|
151
|
+
* Handle savepoint event
|
|
152
|
+
*/
|
|
153
|
+
handleSavePoint(lastPosition) {
|
|
631
154
|
const now = new Date();
|
|
632
|
-
this.
|
|
633
|
-
this.emitDelta('noforeignland.savepoint_local', now.toLocaleString());
|
|
155
|
+
this.dataPathEmitter.emitSavepoint();
|
|
634
156
|
|
|
635
|
-
//
|
|
636
|
-
const activeSource = this.options.filterSource || this.
|
|
157
|
+
// Update plugin status
|
|
158
|
+
const activeSource = this.options.filterSource || this.trackLogger.getAutoSelectedSource() || '';
|
|
637
159
|
const sourcePrefix = activeSource ? `${activeSource} | ` : '';
|
|
638
160
|
const saveTime = now.toISOString();
|
|
639
|
-
const transferTime = this.lastSuccessfulTransfer
|
|
640
|
-
|
|
161
|
+
const transferTime = this.lastSuccessfulTransfer
|
|
162
|
+
? this.lastSuccessfulTransfer.toISOString()
|
|
163
|
+
: 'None since start';
|
|
164
|
+
|
|
641
165
|
this.setPluginStatus(`Save: ${saveTime} | Transfer: ${transferTime} | ${sourcePrefix}`);
|
|
642
166
|
}
|
|
643
167
|
|
|
644
|
-
|
|
645
|
-
|
|
646
|
-
|
|
647
|
-
|
|
648
|
-
|
|
649
|
-
|
|
650
|
-
|
|
651
|
-
|
|
652
|
-
|
|
653
|
-
|
|
654
|
-
|
|
655
|
-
|
|
656
|
-
|
|
657
|
-
|
|
658
|
-
|
|
659
|
-
|
|
660
|
-
|
|
661
|
-
|
|
662
|
-
const x = Δλ * Math.cos((φ1 + φ2) / 2);
|
|
663
|
-
const y = (φ2 - φ1);
|
|
664
|
-
const d = Math.sqrt(x * x + y * y) * R;
|
|
665
|
-
return d;
|
|
168
|
+
/**
|
|
169
|
+
* Handle healthy status from health monitor
|
|
170
|
+
*/
|
|
171
|
+
handleHealthy() {
|
|
172
|
+
// Clear error if position health is OK
|
|
173
|
+
if (this.dataPathEmitter.getError()) {
|
|
174
|
+
const lastPosition = this.trackLogger.getLastPosition();
|
|
175
|
+
const activeSource = this.options.filterSource || this.trackLogger.getAutoSelectedSource() || '';
|
|
176
|
+
const sourcePrefix = activeSource ? `${activeSource} | ` : '';
|
|
177
|
+
const saveTime = lastPosition
|
|
178
|
+
? new Date(lastPosition.currentTime).toISOString()
|
|
179
|
+
: 'None since start';
|
|
180
|
+
const transferTime = this.lastSuccessfulTransfer
|
|
181
|
+
? this.lastSuccessfulTransfer.toISOString()
|
|
182
|
+
: 'None since start';
|
|
183
|
+
|
|
184
|
+
this.setPluginStatus(`Save: ${saveTime} | Transfer: ${transferTime} | ${sourcePrefix}`);
|
|
185
|
+
}
|
|
666
186
|
}
|
|
667
187
|
|
|
668
|
-
|
|
669
|
-
|
|
670
|
-
|
|
671
|
-
|
|
672
|
-
|
|
673
|
-
|
|
674
|
-
|
|
675
|
-
|
|
676
|
-
|
|
188
|
+
/**
|
|
189
|
+
* CRON interval - check and send data
|
|
190
|
+
*/
|
|
191
|
+
async interval() {
|
|
192
|
+
try {
|
|
193
|
+
// Check if boat is moving
|
|
194
|
+
const lastPosition = this.trackLogger.getLastPosition();
|
|
195
|
+
const boatMoving = this.trackSender.isBoatMoving(lastPosition, this.upSince);
|
|
196
|
+
if (!boatMoving) {
|
|
197
|
+
return;
|
|
677
198
|
}
|
|
678
|
-
|
|
679
|
-
|
|
680
|
-
|
|
681
|
-
|
|
682
|
-
|
|
683
|
-
case 'EACCES':
|
|
684
|
-
case 'EPERM':
|
|
685
|
-
this.app.debug(`Failed to create ${dir} by Permission denied`);
|
|
686
|
-
this.setPluginError(`Failed to create ${dir} by Permission denied`);
|
|
687
|
-
res = false;
|
|
688
|
-
break;
|
|
689
|
-
case 'ETIMEDOUT':
|
|
690
|
-
this.app.debug(`Failed to create ${dir} by Operation timed out`);
|
|
691
|
-
this.setPluginError(`Failed to create ${dir} by Operation timed out`);
|
|
692
|
-
res = false;
|
|
693
|
-
break;
|
|
694
|
-
default:
|
|
695
|
-
this.app.debug(`Error creating directory ${dir}: ${error.message}`);
|
|
696
|
-
this.setPluginError(`Error creating directory ${dir}: ${error.message}`);
|
|
697
|
-
res = false;
|
|
698
|
-
}
|
|
199
|
+
|
|
200
|
+
// Check if we have track data
|
|
201
|
+
const hasTrack = await this.trackSender.hasTrackData();
|
|
202
|
+
if (!hasTrack) {
|
|
203
|
+
return;
|
|
699
204
|
}
|
|
700
|
-
}
|
|
701
|
-
return res;
|
|
702
|
-
}
|
|
703
205
|
|
|
704
|
-
|
|
705
|
-
|
|
706
|
-
const now = new Date().getTime();
|
|
707
|
-
const timeSinceLastPosition = this.lastPositionReceived
|
|
708
|
-
? (now - this.lastPositionReceived) / 1000
|
|
709
|
-
: null;
|
|
206
|
+
// Send track data (has built-in retry logic)
|
|
207
|
+
const success = await this.trackSender.sendTrack();
|
|
710
208
|
|
|
711
|
-
|
|
712
|
-
|
|
713
|
-
|
|
714
|
-
if (!this.lastPositionReceived) {
|
|
715
|
-
const errorMsg = this.options.filterSource
|
|
716
|
-
? `No GPS position data received from filtered source '${this.options.filterSource}'. Check Expert Settings > Position source device, or leave empty to use any GPS source.`
|
|
717
|
-
: 'No GPS position data received. Check that your GPS is connected and SignalK is receiving navigation.position data.';
|
|
718
|
-
this.setPluginError(errorMsg);
|
|
719
|
-
this.app.debug('Position health check: No position data ever received' + filterMsg);
|
|
720
|
-
} else if (timeSinceLastPosition > 300) {
|
|
721
|
-
const errorMsg = this.options.filterSource
|
|
722
|
-
? `No GPS position data${filterMsg} for ${Math.floor(timeSinceLastPosition / 60)} minutes. Check that source '${this.options.filterSource}' is active, or change/clear Position source device in Expert Settings.`
|
|
723
|
-
: `No GPS position data${filterMsg} for ${Math.floor(timeSinceLastPosition / 60)} minutes. Check your GPS connection.`;
|
|
724
|
-
this.setPluginError(errorMsg);
|
|
725
|
-
this.app.debug(`Position health check: No position for ${timeSinceLastPosition.toFixed(0)} seconds` + filterMsg);
|
|
726
|
-
} else {
|
|
727
|
-
this.app.debug(`Position health check: OK (last position ${timeSinceLastPosition.toFixed(0)} seconds ago${filterMsg})`);
|
|
209
|
+
if (success) {
|
|
210
|
+
this.lastSuccessfulTransfer = new Date();
|
|
211
|
+
this.dataPathEmitter.emitApiTransfer(this.lastSuccessfulTransfer);
|
|
728
212
|
|
|
729
|
-
//
|
|
730
|
-
|
|
731
|
-
|
|
732
|
-
|
|
733
|
-
|
|
734
|
-
|
|
735
|
-
|
|
736
|
-
|
|
737
|
-
|
|
738
|
-
}, 5 * 60 * 1000);
|
|
739
|
-
|
|
740
|
-
// Initial check after 2 minutes of startup
|
|
741
|
-
setTimeout(() => {
|
|
742
|
-
if (!this.lastPositionReceived) {
|
|
743
|
-
const activeSource = this.options.filterSource || this.autoSelectedSource || 'any';
|
|
744
|
-
const errorMsg = this.options.filterSource
|
|
745
|
-
? `No GPS position data received after 2 minutes from filtered source '${this.options.filterSource}'. Check Expert Settings > Position source device. You may need to leave it empty to use any available GPS source.`
|
|
746
|
-
: 'No GPS position data received after 2 minutes. Check that your GPS is connected and SignalK is receiving navigation.position data.';
|
|
747
|
-
this.setPluginError(errorMsg);
|
|
748
|
-
this.app.debug('Initial position check: No position data received' + (activeSource !== 'any' ? ` from source '${activeSource}'` : ''));
|
|
213
|
+
// Update status
|
|
214
|
+
const activeSource = this.options.filterSource || this.trackLogger.getAutoSelectedSource() || '';
|
|
215
|
+
const sourcePrefix = activeSource ? `${activeSource} | ` : '';
|
|
216
|
+
const saveTime = lastPosition
|
|
217
|
+
? new Date(lastPosition.currentTime).toISOString()
|
|
218
|
+
: 'None since start';
|
|
219
|
+
const transferTime = this.lastSuccessfulTransfer.toISOString();
|
|
220
|
+
|
|
221
|
+
this.setPluginStatus(`Save: ${saveTime} | Transfer: ${transferTime} | ${sourcePrefix}`);
|
|
749
222
|
}
|
|
750
|
-
|
|
223
|
+
|
|
224
|
+
} catch (err) {
|
|
225
|
+
this.app.debug('Error during send interval:', err.message);
|
|
226
|
+
this.setPluginError(`Failed to send track - ${err.message}`);
|
|
227
|
+
}
|
|
751
228
|
}
|
|
752
229
|
|
|
753
|
-
|
|
754
|
-
|
|
755
|
-
|
|
756
|
-
|
|
230
|
+
/**
|
|
231
|
+
* Stop the plugin
|
|
232
|
+
*/
|
|
233
|
+
stop() {
|
|
234
|
+
this.app.debug('plugin stopped');
|
|
235
|
+
|
|
236
|
+
// Stop CRON job
|
|
237
|
+
if (this.cron) {
|
|
238
|
+
this.cron.stop();
|
|
239
|
+
this.cron = undefined;
|
|
757
240
|
}
|
|
758
241
|
|
|
759
|
-
|
|
760
|
-
if (
|
|
761
|
-
|
|
242
|
+
// Stop track logger
|
|
243
|
+
if (this.trackLogger) {
|
|
244
|
+
this.trackLogger.stop();
|
|
762
245
|
}
|
|
763
246
|
|
|
764
|
-
|
|
765
|
-
if (
|
|
766
|
-
|
|
767
|
-
this.app.debug(errorMsg);
|
|
768
|
-
this.setPluginError(errorMsg);
|
|
769
|
-
return;
|
|
247
|
+
// Stop health monitor
|
|
248
|
+
if (this.healthMonitor) {
|
|
249
|
+
this.healthMonitor.stop();
|
|
770
250
|
}
|
|
771
251
|
|
|
772
|
-
|
|
773
|
-
}
|
|
774
|
-
|
|
775
|
-
checkBoatMoving() {
|
|
776
|
-
if (!this.options.trackFrequency) {
|
|
777
|
-
return true;
|
|
778
|
-
}
|
|
779
|
-
const time = this.lastPosition ? this.lastPosition.currentTime : this.upSince;
|
|
780
|
-
const secsSinceLastPoint = (new Date().getTime() - time) / 1000;
|
|
781
|
-
const isMoving = secsSinceLastPoint <= (this.options.trackFrequency * 2);
|
|
782
|
-
if (isMoving) {
|
|
783
|
-
this.app.debug('Boat is still moving, last move', secsSinceLastPoint, 'seconds ago');
|
|
784
|
-
return this.options.sendWhileMoving;
|
|
785
|
-
} else {
|
|
786
|
-
this.app.debug('Boat stopped moving, last move at least', secsSinceLastPoint, 'seconds ago');
|
|
787
|
-
return true;
|
|
788
|
-
}
|
|
252
|
+
this.app.setPluginStatus('Plugin stopped');
|
|
789
253
|
}
|
|
790
254
|
|
|
791
|
-
|
|
792
|
-
|
|
793
|
-
|
|
794
|
-
|
|
795
|
-
|
|
796
|
-
|
|
797
|
-
this.app.debug(`Using internet test timeout: ${timeoutMs}ms`);
|
|
798
|
-
|
|
799
|
-
const dnsServers = [
|
|
800
|
-
{ name: 'Google DNS', ip: '8.8.8.8' },
|
|
801
|
-
{ name: 'Cloudflare DNS', ip: '1.1.1.1' }
|
|
802
|
-
];
|
|
255
|
+
/**
|
|
256
|
+
* Set plugin status and update data paths
|
|
257
|
+
*/
|
|
258
|
+
setPluginStatus(status) {
|
|
259
|
+
this.dataPathEmitter.clearError();
|
|
260
|
+
this.app.setPluginStatus(status);
|
|
803
261
|
|
|
804
|
-
|
|
805
|
-
|
|
806
|
-
const startTime = Date.now();
|
|
807
|
-
const result = await Promise.race([
|
|
808
|
-
dns.reverse(server.ip),
|
|
809
|
-
new Promise((_, reject) =>
|
|
810
|
-
setTimeout(() => reject(new Error('DNS timeout')), timeoutMs)
|
|
811
|
-
)
|
|
812
|
-
]);
|
|
813
|
-
const elapsed = Date.now() - startTime;
|
|
814
|
-
|
|
815
|
-
this.app.debug(`internet connection = true, ${server.name} (${server.ip}) is reachable (took ${elapsed}ms)`);
|
|
816
|
-
return true;
|
|
817
|
-
} catch (err) {
|
|
818
|
-
this.app.debug(`${server.name} (${server.ip}) not reachable:`, err.message);
|
|
819
|
-
}
|
|
820
|
-
}
|
|
262
|
+
const lastPosition = this.trackLogger ? this.trackLogger.getLastPosition() : null;
|
|
263
|
+
const autoSelectedSource = this.trackLogger ? this.trackLogger.getAutoSelectedSource() : null;
|
|
821
264
|
|
|
822
|
-
this.
|
|
823
|
-
|
|
265
|
+
this.dataPathEmitter.updateStatusPaths(
|
|
266
|
+
this.options,
|
|
267
|
+
lastPosition,
|
|
268
|
+
this.lastSuccessfulTransfer,
|
|
269
|
+
autoSelectedSource
|
|
270
|
+
);
|
|
824
271
|
}
|
|
825
272
|
|
|
826
|
-
|
|
827
|
-
|
|
828
|
-
|
|
829
|
-
|
|
830
|
-
|
|
831
|
-
this.app.
|
|
832
|
-
return size > 0;
|
|
833
|
-
}
|
|
834
|
-
|
|
835
|
-
async sendData() {
|
|
836
|
-
if (this.options.boatApiKey) {
|
|
837
|
-
await this.sendApiData();
|
|
838
|
-
} else {
|
|
839
|
-
this.app.debug('Failed to send track - no boat API key set in plugin settings.');
|
|
840
|
-
this.setPluginError(`Failed to send track - no boat API key set in plugin settings.`);
|
|
841
|
-
}
|
|
842
|
-
}
|
|
843
|
-
|
|
844
|
-
async sendApiData() {
|
|
845
|
-
this.app.debug('sending the data');
|
|
846
|
-
const pendingFile = path.join(this.options.trackDir, routeSaveName);
|
|
847
|
-
const trackData = await this.createTrack(pendingFile);
|
|
848
|
-
if (!trackData) {
|
|
849
|
-
this.app.debug('Recorded track did not contain any valid track points, aborting sending.');
|
|
850
|
-
this.setPluginError(`Failed to send track - Recorded track did not contain any valid track points, aborting sending.`);
|
|
851
|
-
return;
|
|
852
|
-
}
|
|
853
|
-
this.app.debug('created track data with timestamp:', new Date(trackData.timestamp));
|
|
854
|
-
const params = new URLSearchParams();
|
|
855
|
-
params.append('timestamp', trackData.timestamp);
|
|
856
|
-
params.append('track', JSON.stringify(trackData.track));
|
|
857
|
-
params.append('boatApiKey', this.options.boatApiKey);
|
|
858
|
-
const headers = { 'X-NFL-API-Key': pluginApiKey };
|
|
859
|
-
this.app.debug('sending track to API');
|
|
860
|
-
|
|
861
|
-
const maxRetries = 3;
|
|
862
|
-
const baseTimeout = (this.options.apiTimeout || 30) * 1000;
|
|
273
|
+
/**
|
|
274
|
+
* Set plugin error and update data paths
|
|
275
|
+
*/
|
|
276
|
+
setPluginError(error) {
|
|
277
|
+
this.dataPathEmitter.setError(error);
|
|
278
|
+
this.app.setPluginError(error);
|
|
863
279
|
|
|
864
|
-
|
|
865
|
-
|
|
866
|
-
const currentTimeout = baseTimeout * attempt;
|
|
867
|
-
this.app.debug(`Attempt ${attempt}/${maxRetries} with ${currentTimeout}ms timeout`);
|
|
868
|
-
|
|
869
|
-
const controller = new AbortController();
|
|
870
|
-
const timeoutId = setTimeout(() => controller.abort(), currentTimeout);
|
|
871
|
-
|
|
872
|
-
const response = await fetch(apiUrl, {
|
|
873
|
-
method: 'POST',
|
|
874
|
-
body: params,
|
|
875
|
-
headers: new fetch.Headers(headers),
|
|
876
|
-
signal: controller.signal
|
|
877
|
-
});
|
|
878
|
-
|
|
879
|
-
clearTimeout(timeoutId);
|
|
880
|
-
|
|
881
|
-
if (response.ok) {
|
|
882
|
-
const responseBody = await response.json();
|
|
883
|
-
if (responseBody.status === 'ok') {
|
|
884
|
-
this.lastSuccessfulTransfer = new Date();
|
|
885
|
-
|
|
886
|
-
this.emitDelta('noforeignland.sent_to_api', this.lastSuccessfulTransfer.toISOString());
|
|
887
|
-
this.emitDelta('noforeignland.sent_to_api_local', this.lastSuccessfulTransfer.toLocaleString());
|
|
888
|
-
|
|
889
|
-
this.app.debug('Track successfully sent to API');
|
|
890
|
-
|
|
891
|
-
// ISO8601 format for Dashboard
|
|
892
|
-
const activeSource = this.options.filterSource || this.autoSelectedSource || '';
|
|
893
|
-
const sourcePrefix = activeSource ? `${activeSource} | ` : '';
|
|
894
|
-
const saveTime = this.lastPosition ? new Date(this.lastPosition.currentTime).toISOString() : 'None since start';
|
|
895
|
-
const transferTime = this.lastSuccessfulTransfer.toISOString();
|
|
896
|
-
this.setPluginStatus(`Save: ${saveTime} | Transfer: ${transferTime} | ${sourcePrefix}`);
|
|
897
|
-
|
|
898
|
-
await this.handleSuccessfulSend(pendingFile);
|
|
899
|
-
return;
|
|
900
|
-
} else {
|
|
901
|
-
this.app.debug('Could not send track to API, returned response json:', responseBody);
|
|
902
|
-
this.setPluginError(`Failed to send track - API returned error.`);
|
|
903
|
-
return;
|
|
904
|
-
}
|
|
905
|
-
} else {
|
|
906
|
-
this.app.debug('Could not send track to API, returned response code:', response.status, response.statusText);
|
|
907
|
-
if (response.status >= 400 && response.status < 500) {
|
|
908
|
-
this.setPluginError(`Failed to send track - HTTP ${response.status}.`);
|
|
909
|
-
return;
|
|
910
|
-
}
|
|
911
|
-
throw new Error(`HTTP ${response.status}`);
|
|
912
|
-
}
|
|
913
|
-
} catch (err) {
|
|
914
|
-
this.app.debug(`Attempt ${attempt} failed:`, err.message);
|
|
915
|
-
|
|
916
|
-
if (attempt === maxRetries) {
|
|
917
|
-
this.app.debug('Could not send track to API after', maxRetries, 'attempts:', err);
|
|
918
|
-
this.setPluginError(`Failed to send track after ${maxRetries} attempts - check logs for details.`);
|
|
919
|
-
} else {
|
|
920
|
-
const waitTime = 2000 * attempt;
|
|
921
|
-
this.app.debug(`Waiting ${waitTime}ms before retry...`);
|
|
922
|
-
await new Promise(resolve => setTimeout(resolve, waitTime));
|
|
923
|
-
}
|
|
924
|
-
}
|
|
925
|
-
}
|
|
926
|
-
}
|
|
927
|
-
|
|
928
|
-
async handleSuccessfulSend(pendingFile) {
|
|
929
|
-
const sentFile = path.join(this.options.trackDir, routeSentName);
|
|
280
|
+
const lastPosition = this.trackLogger ? this.trackLogger.getLastPosition() : null;
|
|
281
|
+
const autoSelectedSource = this.trackLogger ? this.trackLogger.getAutoSelectedSource() : null;
|
|
930
282
|
|
|
931
|
-
|
|
932
|
-
|
|
933
|
-
|
|
934
|
-
|
|
935
|
-
|
|
936
|
-
|
|
937
|
-
} else {
|
|
938
|
-
this.app.debug('keepFiles disabled, will delete pending file');
|
|
939
|
-
}
|
|
940
|
-
|
|
941
|
-
this.app.debug('Deleting pending track file');
|
|
942
|
-
await fs.remove(pendingFile);
|
|
943
|
-
this.app.debug('Successfully processed track files after send');
|
|
944
|
-
|
|
945
|
-
} catch (err) {
|
|
946
|
-
this.app.debug('Error handling files after successful send:', err.message);
|
|
947
|
-
}
|
|
948
|
-
}
|
|
949
|
-
|
|
950
|
-
async createTrack(inputPath) {
|
|
951
|
-
const fileStream = fs.createReadStream(inputPath);
|
|
952
|
-
const rl = readline.createInterface({ input: fileStream, crlfDelay: Infinity });
|
|
953
|
-
const track = [];
|
|
954
|
-
let lastTimestamp;
|
|
955
|
-
for await (const line of rl) {
|
|
956
|
-
if (line) {
|
|
957
|
-
try {
|
|
958
|
-
const point = JSON.parse(line);
|
|
959
|
-
const timestamp = new Date(point.t).getTime();
|
|
960
|
-
if (!isNaN(timestamp) && this.isValidLatitude(point.lat) && this.isValidLongitude(point.lon)) {
|
|
961
|
-
track.push([timestamp, point.lat, point.lon]);
|
|
962
|
-
lastTimestamp = timestamp;
|
|
963
|
-
}
|
|
964
|
-
} catch (error) {
|
|
965
|
-
this.app.debug('could not parse line from track file:', line);
|
|
966
|
-
this.setPluginError(`Failed could not parse line from track file - check logs for details.`);
|
|
967
|
-
}
|
|
968
|
-
}
|
|
969
|
-
}
|
|
970
|
-
if (track.length > 0) {
|
|
971
|
-
return { timestamp: new Date(lastTimestamp).getTime(), track };
|
|
972
|
-
}
|
|
973
|
-
return null;
|
|
283
|
+
this.dataPathEmitter.updateStatusPaths(
|
|
284
|
+
this.options,
|
|
285
|
+
lastPosition,
|
|
286
|
+
this.lastSuccessfulTransfer,
|
|
287
|
+
autoSelectedSource
|
|
288
|
+
);
|
|
974
289
|
}
|
|
975
290
|
}
|
|
976
291
|
|