@noforeignland/signalk-to-noforeignland 0.2.11 → 1.0.1-beta.1

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.
@@ -1,35 +1,35 @@
1
- name: Publish Package
2
-
3
- on:
4
- push:
5
- tags:
6
- - 'v*'
7
-
8
- permissions:
9
- id-token: write
10
- contents: read
11
-
12
- jobs:
13
- publish:
14
- runs-on: ubuntu-latest
15
-
16
- steps:
17
- - uses: actions/checkout@v4
18
-
19
- - name: Clean workspace
20
- run: git clean -xfd
21
-
22
- - uses: actions/setup-node@v4
23
- with:
24
- node-version: '20'
25
- registry-url: 'https://registry.npmjs.org'
26
-
27
- # Ensure npm 11.5.1 or later is installed
28
- - name: Update npm
29
- run: npm install -g npm@latest
30
- - run: npm install
31
-
32
- - run: npm test
33
-
34
- - name: Publish
1
+ name: Publish Package
2
+
3
+ on:
4
+ push:
5
+ tags:
6
+ - 'v*'
7
+
8
+ permissions:
9
+ id-token: write
10
+ contents: read
11
+
12
+ jobs:
13
+ publish:
14
+ runs-on: ubuntu-latest
15
+
16
+ steps:
17
+ - uses: actions/checkout@v4
18
+
19
+ - name: Clean workspace
20
+ run: git clean -xfd
21
+
22
+ - uses: actions/setup-node@v4
23
+ with:
24
+ node-version: '20'
25
+ registry-url: 'https://registry.npmjs.org'
26
+
27
+ # Ensure npm 11.5.1 or later is installed
28
+ - name: Update npm
29
+ run: npm install -g npm@latest
30
+ - run: npm install
31
+
32
+ - run: npm test
33
+
34
+ - name: Publish
35
35
  run: npm publish --provenance --access public
package/CHANGELOG.md CHANGED
@@ -1,122 +1,109 @@
1
- 0.2.2
2
- * CHANGE: Deployment via OIDC authentication
3
-
4
- 0.2.1
5
- * CHANGE: Deployment via OIDC authentication
6
-
7
- 0.2.0
8
- * CHANGE: Deployment via OIDC authentication
9
-
10
- 0.1.35
11
- * CHANGE: Deployment via OIDC authentication
12
-
13
- 0.1.34
14
- * CHANGE: Fix repository URL format
15
-
16
- 0.1.33
17
- * CHANGE: Deployment via OIDC authentication
18
-
19
- 0.1.32
20
- * CHANGE: Deployment via OIDC authentication
21
-
22
- 0.1.31
23
- * CHANGE: Deployment via OIDC authentication
24
-
25
- 0.1.30
26
- * CHANGE: Deployment via OIDC authentication
27
-
28
- 0.1.29
29
- * CHANGE: Removed unused dependency "is-reachable" in package.json
30
-
31
- 0.1.29-beta.2
32
- * NEW: setPluginError and error in data path if Internet Connection is not working.
33
-
34
- 0.1.29-beta.1
35
- * CHANGE: After talking to Treppo from Sugnal K core team we should use the data path "noforeignland.*", code and docs changed.
36
- * CHANGE: README.md info added and format optimized
37
- * CHANGE: GPS source at the end for setPluginStatus - Cerbo has a long source name and truncates it.
38
- * CHANGE: Use "npm install instead" of "npm ci" to push from Github to npmjs using OIDC authentication
39
- * CHANGE: Moved navigation.position source from path noforeignland.status to noforeignland.source
40
-
41
- 0.1.28
42
- * BUGFIX: No GPS data found - introduced in 0.1.27 - Thanks Piotr
43
-
44
- 0.1.28-beta.2
45
- * EXPERIMENTAL: Signal K data path to visualize the plugin behaviour or error in Node Red, KIP, etc. Using plugin.signalk-to-noforeignland.* for now. See README.md for details.
46
- * CHANGE: Using app.getDataDirPath() to store transient data, thanks Jeremy, they are now in "plugin-config-data/signalk-to-noforeignland/nfl-track" and renamed to pending.json1 and sent.json1
47
- * CHANGE: Optimize GPS detection if multiple navigation.position from different sources exist.
48
- * CHANGE: PluginStatus optimized for limited space available.
49
- * CHANGE: doc/beta_install.md changed for new file structure.
50
-
51
- 0.1.28-beta.1
52
- * CHANGE: By design SK deletes the track folder upon Pluging update via the Appstore, so we have to save the long term track in a different location, default folder: signalk-to-noforeignland-data
53
-
54
- 0.1.27
55
- * Final version after successful testing SV MOIN and SV KIAPA NUI
56
-
57
- 0.1.27-beta.1
58
- * NEW: NPMJS requires new method for publishing. The old tokens will expire Nov 19th, 2025, so moving to OIDC authentication.
59
- * NEW: Check the GPS status in navigation.position, else retry and throw PluginError on Dashboard
60
- * CHANGE: Keep track data on disk rewritten and migrate old files to new structure, so nfl-track-sent.jsonl becomes a continuous archive of all sent track data over time, when enabled. New Logic:
61
- * New points accumulate in nfl-track-pending.jsonl
62
- * Send succeeds API confirms receipt
63
- * If keepFiles=true: The content of pending file is appended to nfl-track-sent.jsonl (line 588)
64
- * Pending file is deleted
65
- * Next GPS points create a new pending file
66
- * Next successful send → appends again to the same nfl-track-sent.jsonl
67
-
68
- 0.1.26
69
- * Same as 0.1.26-beta.1
70
-
71
- 0.1.26-beta.1
72
- * CHANGE: PluginStatus last track sent "Not transfered since plugin start" gets truncated by the dashboard. Changed to "None since start"
73
-
74
- 0.1.25
75
- * CHANGE: Minimum boat move default increased from 50m to 80m
76
- * CHANGE: Updated the README.md
77
- * CHANGE: Use public ipv4 DNS instead of local with cache for testInternet()
78
- * Final version after successful testing SV MOIN and SV KIAPA NUI
79
-
80
- 0.1.25-beta.3
81
- * NEW: Check if boat key is set on startup, else report error to dashboard
82
- * CHANGE: Changing the order and label of the Plugin Settings to make it more clear for unexpierienced users and grouped to Mandatory, Advanced and Expert.
83
- * CHANGE: Migration of < 0.1.25 Plugin settings to new structure.
84
- * CHANGE: PluginStatus last track sent "Never" changed to "Not transfered since plugin start" to avoid confusions.
85
-
86
-
87
- 0.1.25-beta.2
88
- * CHANGE: Typo in pluginName fixed
89
- * CHANGE: Dates for SetPlugin now ISO8601 formated (https://github.com/noforeignland/nfl-signalk/issues/9)
90
-
91
- 0.1.25-beta.1
92
- * CHANGE: User mattzilla470 reported timout Issues on VE Cerbo with a small CPU and using 4G (https://github.com/noforeignland/nfl-signalk/issues/7). So added a timout option in the plugin config and a tripple retry while increasing the timeout for the API call.
93
-
94
- 0.1.24
95
- * CHANGE: testInternet() only uses ipv4 now, some users don't have ipv6 configured properly and where unable to reach the API, when testInternet returned false
96
- * NEW: PluginStatus on SK dashboard now shows last savePoint and last API transfer, so a user has more feedback what the app is doing without enabling the debug log and crawling though it.
97
- * CHANGE: Renamed CHANGELOG to CHANGELOG.md
98
- * CHANGE: CHANGELOG ORDER - newest on top.
99
- * Final version after successful testing SV MOIN and SV KIAPA NUI
100
-
101
- 0.1.23
102
- * Final version after successful testing SV MOIN and SV KIAPA NUI
103
-
104
- 0.1.23-beta.1
105
- * Renamed branch to follow the release versions.
106
- * CLEANUP - More debug info for the SK dashboard using this.app.setPluginError
107
- * CLEANUP - Removed CreateGPX, was only used for removed Email transmission of the track
108
-
109
- 0.1.22-beta.2
110
-
111
- * CLEANUP and move to Object Oriented Javascript
112
-
113
- 0.1.22-beta.1
114
-
115
- * CONFIG: Attempt sending location while moving - Default changed from false to true
116
- * CONFIG: Ping added for 24h ping if boat is not moved. - Default: true
117
- * Package.json - Nodemailer dependency removed
118
- * Marked for removal - Depricated "sendEmailData" function.
119
- * REMOVED - sendEmail.js
120
- * CLEANUP - Renamed emaiCron to apiCron
121
- * NEW: 24h api ping, when enabled, even if boat didn't move.
122
-
1
+ 1.0.0
2
+ * CHANGE: Package now released unter npmjs org noforeignland in version 1.0.0 due to deployment changes in npmjs and the need of trustworthy sources. All npmjs keys will be revoked Nov 19th, 2025.
3
+ Users of the old (depricated) 0.1.x versions need to install this new package once manually using the Signal K Appstore. The Plugin Configuration will be kept from the 0.1.x install.
4
+
5
+ 0.2.x
6
+ * CHANGE: Deployment via OIDC authentication
7
+ npmjs.org is revoking all deployment keys Nov 19th. The future deployment shall be via trusted publishers, so the workflow changes from publishing local -> npmjs to local -> github -> npmjs.
8
+ To fullfil this we had to deprecate the old package and deploy it under the scope of the org noforeignland in npmjs. This is the reason, why you don't see the old package anymore in the Appstore.
9
+
10
+ The "new" one has to be installed once manually, after that everything is back to normal and you are fine.
11
+
12
+ 0.1.3x
13
+ * CHANGE: Working on Deployment via OIDC authentication
14
+
15
+ 0.1.29
16
+ * CHANGE: Removed unused dependency "is-reachable" in package.json
17
+
18
+ 0.1.29-beta.2
19
+ * NEW: setPluginError and error in data path if Internet Connection is not working.
20
+
21
+ 0.1.29-beta.1
22
+ * CHANGE: After talking to Treppo from Sugnal K core team we should use the data path "noforeignland.*", code and docs changed.
23
+ * CHANGE: README.md info added and format optimized
24
+ * CHANGE: GPS source at the end for setPluginStatus - Cerbo has a long source name and truncates it.
25
+ * CHANGE: Use "npm install instead" of "npm ci" to push from Github to npmjs using OIDC authentication
26
+ * CHANGE: Moved navigation.position source from path noforeignland.status to noforeignland.source
27
+
28
+ 0.1.28
29
+ * BUGFIX: No GPS data found - introduced in 0.1.27 - Thanks Piotr
30
+
31
+ 0.1.28-beta.2
32
+ * EXPERIMENTAL: Signal K data path to visualize the plugin behaviour or error in Node Red, KIP, etc. Using plugin.signalk-to-noforeignland.* for now. See README.md for details.
33
+ * CHANGE: Using app.getDataDirPath() to store transient data, thanks Jeremy, they are now in "plugin-config-data/signalk-to-noforeignland/nfl-track" and renamed to pending.json1 and sent.json1
34
+ * CHANGE: Optimize GPS detection if multiple navigation.position from different sources exist.
35
+ * CHANGE: PluginStatus optimized for limited space available.
36
+ * CHANGE: doc/beta_install.md changed for new file structure.
37
+
38
+ 0.1.28-beta.1
39
+ * CHANGE: By design SK deletes the track folder upon Pluging update via the Appstore, so we have to save the long term track in a different location, default folder: signalk-to-noforeignland-data
40
+
41
+ 0.1.27
42
+ * Final version after successful testing SV MOIN and SV KIAPA NUI
43
+
44
+ 0.1.27-beta.1
45
+ * NEW: NPMJS requires new method for publishing. The old tokens will expire Nov 19th, 2025, so moving to OIDC authentication.
46
+ * NEW: Check the GPS status in navigation.position, else retry and throw PluginError on Dashboard
47
+ * CHANGE: Keep track data on disk rewritten and migrate old files to new structure, so nfl-track-sent.jsonl becomes a continuous archive of all sent track data over time, when enabled. New Logic:
48
+ * New points accumulate in nfl-track-pending.jsonl
49
+ * Send succeeds API confirms receipt
50
+ * If keepFiles=true: The content of pending file is appended to nfl-track-sent.jsonl (line 588)
51
+ * Pending file is deleted
52
+ * Next GPS points create a new pending file
53
+ * Next successful send → appends again to the same nfl-track-sent.jsonl
54
+
55
+ 0.1.26
56
+ * Same as 0.1.26-beta.1
57
+
58
+ 0.1.26-beta.1
59
+ * CHANGE: PluginStatus last track sent "Not transfered since plugin start" gets truncated by the dashboard. Changed to "None since start"
60
+
61
+ 0.1.25
62
+ * CHANGE: Minimum boat move default increased from 50m to 80m
63
+ * CHANGE: Updated the README.md
64
+ * CHANGE: Use public ipv4 DNS instead of local with cache for testInternet()
65
+ * Final version after successful testing SV MOIN and SV KIAPA NUI
66
+
67
+ 0.1.25-beta.3
68
+ * NEW: Check if boat key is set on startup, else report error to dashboard
69
+ * CHANGE: Changing the order and label of the Plugin Settings to make it more clear for unexpierienced users and grouped to Mandatory, Advanced and Expert.
70
+ * CHANGE: Migration of < 0.1.25 Plugin settings to new structure.
71
+ * CHANGE: PluginStatus last track sent "Never" changed to "Not transfered since plugin start" to avoid confusions.
72
+
73
+
74
+ 0.1.25-beta.2
75
+ * CHANGE: Typo in pluginName fixed
76
+ * CHANGE: Dates for SetPlugin now ISO8601 formated (https://github.com/noforeignland/nfl-signalk/issues/9)
77
+
78
+ 0.1.25-beta.1
79
+ * CHANGE: User mattzilla470 reported timout Issues on VE Cerbo with a small CPU and using 4G (https://github.com/noforeignland/nfl-signalk/issues/7). So added a timout option in the plugin config and a tripple retry while increasing the timeout for the API call.
80
+
81
+ 0.1.24
82
+ * CHANGE: testInternet() only uses ipv4 now, some users don't have ipv6 configured properly and where unable to reach the API, when testInternet returned false
83
+ * NEW: PluginStatus on SK dashboard now shows last savePoint and last API transfer, so a user has more feedback what the app is doing without enabling the debug log and crawling though it.
84
+ * CHANGE: Renamed CHANGELOG to CHANGELOG.md
85
+ * CHANGE: CHANGELOG ORDER - newest on top.
86
+ * Final version after successful testing SV MOIN and SV KIAPA NUI
87
+
88
+ 0.1.23
89
+ * Final version after successful testing SV MOIN and SV KIAPA NUI
90
+
91
+ 0.1.23-beta.1
92
+ * Renamed branch to follow the release versions.
93
+ * CLEANUP - More debug info for the SK dashboard using this.app.setPluginError
94
+ * CLEANUP - Removed CreateGPX, was only used for removed Email transmission of the track
95
+
96
+ 0.1.22-beta.2
97
+
98
+ * CLEANUP and move to Object Oriented Javascript
99
+
100
+ 0.1.22-beta.1
101
+
102
+ * CONFIG: Attempt sending location while moving - Default changed from false to true
103
+ * CONFIG: Ping added for 24h ping if boat is not moved. - Default: true
104
+ * Package.json - Nodemailer dependency removed
105
+ * Marked for removal - Depricated "sendEmailData" function.
106
+ * REMOVED - sendEmail.js
107
+ * CLEANUP - Renamed emaiCron to apiCron
108
+ * NEW: 24h api ping, when enabled, even if boat didn't move.
109
+
package/README.md CHANGED
@@ -1,42 +1,46 @@
1
- # Signal K To Noforeignland
2
- Effortlessly log your boat's movement to **noforeignland.com**
3
-
4
- ## Features
5
- * Automatically log your position to noforeignland.com
6
- * Send detailed tracks to log your entire trip and not just your final position
7
- * Can be used in near real time or cache and upload when stopped and data-connection is available
8
- * Sends 24h keepalive
9
- * Option to archive your track on the local disk
10
- * Detailed plugin information in the SK dashboard
11
- * SK data paths about the plugin status for your own dashboard or Node Red coding
12
-
13
- ## Issues
14
- * Server -> Plugin Config -> Signal K to Noforeignland -> Enable debug log (top right)
15
- * Report issues on GitHub (https://github.com/noforeignland/nfl-signalk/issues)
16
-
17
- ## Requirements
18
- * An internet connection is required in order to update noforeignland.com
19
- * A navigation.position data path inside Signal K for self, which is your current GPS position
20
- * A **noforeignland.com** account
21
- * Your Boat API Key from the **noforeignland.com** website:
22
- * Account > Settings > Boat tracking > API Key
23
-
24
- > Note your Boat API Key is not available in the app.
25
- > You must sign in to the **noforeignland.com** website (using the same authentication method you use for the app: Google. Facebook, Email).
26
-
27
- ## Configuration
28
- 1. Add your boat's API Key into the Server > Plugin Config > Signal K to Noforeignland > Boat API Key
29
- 2. Hit "Submit"
30
- 3. Restart the Signal K server
31
-
32
- ## Data paths created by this plugin
33
- ```
34
- noforeignland.savepoint - ISO8601 timestamp - when was last point saved to trackfile
35
- noforeignland.savepoint_local - locale timestamp - when was last point saved to trackfile
36
- noforeignland.sent_to_api - ISO8601 timestamp - last successful transfer to the API
37
- noforeignland.sent_to_api_local - locale timestamp - last successful transfer to the API
38
- noforeignland.status - string - Status & Error messages
39
- noforeignland.status_boolean - number - 0 = normal operation, 1 = error
40
- noforeignland.source - string - string - data source of navigation.position
41
- notifications.noforeignland.status_boolean - json object - auto created
1
+ # Signal K To Noforeignland
2
+ Effortlessly log your boat's movement to **noforeignland.com**
3
+
4
+ ## Important for 0.1.x users
5
+ Since 1.0.0 this package now released unter npmjs org noforeignland in version 1.0.0 due to deployment changes in npmjs and the need of trustworthy sources. All npmjs keys will be revoked Nov 19th, 2025.
6
+ Users of the old (depricated) 0.1.x versions need to install this new package once manually using the Signal K Appstore. The Plugin Configuration will be kept from the 0.1.x install.
7
+
8
+ ## Features
9
+ * Automatically log your position to noforeignland.com
10
+ * Send detailed tracks to log your entire trip and not just your final position
11
+ * Can be used in near real time or cache and upload when stopped and data-connection is available
12
+ * Sends 24h keepalive
13
+ * Option to archive your track on the local disk
14
+ * Detailed plugin information in the SK dashboard
15
+ * SK data paths about the plugin status for your own dashboard or Node Red coding
16
+
17
+ ## Issues
18
+ * Server -> Plugin Config -> Signal K to Noforeignland -> Enable debug log (top right)
19
+ * Report issues on GitHub (https://github.com/noforeignland/nfl-signalk/issues)
20
+
21
+ ## Requirements
22
+ * An internet connection is required in order to update noforeignland.com
23
+ * A navigation.position data path inside Signal K for self, which is your current GPS position
24
+ * A **noforeignland.com** account
25
+ * Your Boat API Key from the **noforeignland.com** website:
26
+ * Account > Settings > Boat tracking > API Key
27
+
28
+ > Note your Boat API Key is not available in the app.
29
+ > You must sign in to the **noforeignland.com** website (using the same authentication method you use for the app: Google. Facebook, Email).
30
+
31
+ ## Configuration
32
+ 1. Add your boat's API Key into the Server > Plugin Config > Signal K to Noforeignland > Boat API Key
33
+ 2. Hit "Submit"
34
+ 3. Restart the Signal K server
35
+
36
+ ## Data paths created by this plugin
37
+ ```
38
+ noforeignland.savepoint - ISO8601 timestamp - when was last point saved to trackfile
39
+ noforeignland.savepoint_local - locale timestamp - when was last point saved to trackfile
40
+ noforeignland.sent_to_api - ISO8601 timestamp - last successful transfer to the API
41
+ noforeignland.sent_to_api_local - locale timestamp - last successful transfer to the API
42
+ noforeignland.status - string - Status & Error messages
43
+ noforeignland.status_boolean - number - 0 = normal operation, 1 = error
44
+ noforeignland.source - string - string - data source of navigation.position
45
+ notifications.noforeignland.status_boolean - json object - auto created
42
46
  ```
@@ -1,60 +1,60 @@
1
- How-to install the latest beta on your device?
2
-
3
- This guide assumes you have a default install with default folders.
4
- This is written for a Cerbo GX or a RPI, jump to the section you need want to go to.
5
- It is recommended to enable the Debug Log for this plugin in Server -> Plugin Config before updating.
6
-
7
- **For Raspberry PI:**
8
-
9
- 1. Backup old data
10
-
11
- ```
12
- cd ~
13
- mkdir nfl-backup
14
- cp -a .signalk/node_modules/signalk-to-noforeignland/* nfl-backup/
15
- ```
16
-
17
- 2. Get new files from repo (main for latest)
18
-
19
- ```
20
- cd ~/.signalk/node_modules/signalk-to-noforeignland/
21
- rm -rf *
22
- wget https://github.com/noforeignland/nfl-signalk/archive/refs/heads/main.zip
23
- unzip main.zip
24
- cp -r nfl-signalk-main/* .
25
- rm main.zip
26
- rm -rf nfl-signalk-main/
27
- ```
28
-
29
- 3. Restart Server & Check logs
30
-
31
- ```
32
- sudo systemctl restart signalk.service && sudo journalctl -u signalk.service -f
33
- ```
34
-
35
-
36
- **For Cerbo GX with Image Large:**
37
- 1. Backup old data
38
-
39
- ```
40
- cd ~
41
- mkdir nfl-backup
42
- cp -a /data/conf/signalk/node_modules/signalk-to-noforeignland/* nfl-backup
43
- ```
44
-
45
- 2. Get new files from repo (main for latest)
46
-
47
- ```
48
- cd /data/conf/signalk/node_modules/signalk-to-noforeignland/
49
- rm -rf *
50
- wget https://github.com/noforeignland/nfl-signalk/archive/refs/heads/main.zip
51
- unzip main.zip
52
- cp -r nfl-signalk-main/* .
53
- rm main.zip
54
- rm -rf nfl-signalk-main/
55
- ```
56
-
57
- 3. Restart Server & Check logs
58
- ```
59
- Restart Server vom Webgui and check logs in Webgui
1
+ How-to install the latest beta on your device?
2
+
3
+ This guide assumes you have a default install with default folders.
4
+ This is written for a Cerbo GX or a RPI, jump to the section you need want to go to.
5
+ It is recommended to enable the Debug Log for this plugin in Server -> Plugin Config before updating.
6
+
7
+ **For Raspberry PI:**
8
+
9
+ 1. Backup old data
10
+
11
+ ```
12
+ cd ~
13
+ mkdir nfl-backup
14
+ cp -a .signalk/node_modules/signalk-to-noforeignland/* nfl-backup/
15
+ ```
16
+
17
+ 2. Get new files from repo (main for latest)
18
+
19
+ ```
20
+ cd ~/.signalk/node_modules/signalk-to-noforeignland/
21
+ rm -rf *
22
+ wget https://github.com/noforeignland/nfl-signalk/archive/refs/heads/main.zip
23
+ unzip main.zip
24
+ cp -r nfl-signalk-main/* .
25
+ rm main.zip
26
+ rm -rf nfl-signalk-main/
27
+ ```
28
+
29
+ 3. Restart Server & Check logs
30
+
31
+ ```
32
+ sudo systemctl restart signalk.service && sudo journalctl -u signalk.service -f
33
+ ```
34
+
35
+
36
+ **For Cerbo GX with Image Large:**
37
+ 1. Backup old data
38
+
39
+ ```
40
+ cd ~
41
+ mkdir nfl-backup
42
+ cp -a /data/conf/signalk/node_modules/signalk-to-noforeignland/* nfl-backup
43
+ ```
44
+
45
+ 2. Get new files from repo (main for latest)
46
+
47
+ ```
48
+ cd /data/conf/signalk/node_modules/signalk-to-noforeignland/
49
+ rm -rf *
50
+ wget https://github.com/noforeignland/nfl-signalk/archive/refs/heads/main.zip
51
+ unzip main.zip
52
+ cp -r nfl-signalk-main/* .
53
+ rm main.zip
54
+ rm -rf nfl-signalk-main/
55
+ ```
56
+
57
+ 3. Restart Server & Check logs
58
+ ```
59
+ Restart Server vom Webgui and check logs in Webgui
60
60
  ```