fix: allow plugins to register put handlers for specific sources

SERVERPLUGINS.md

@@ -579,7 +579,7 @@ Example use:
 var myFile = require('path').join(app.getDataDirPath(), 'somefile.ext')
 ```
 
-### `app.registerPutHandler(context, path, source, callback)`
+### `app.registerPutHandler(context, path, callback, source)`
 
 If a plugin wants to respond to [`PUT`](http://signalk.org/specification/1.3.0/doc/put.html) requests for a specific path, it can register an action handler.
 

src/interfaces/plugins.ts

@@ -93,12 +93,14 @@ export interface ServerAPI {
   registerPutHandler: (
     context: string,
     path: string,
-    callback: () => void
+    callback: () => void,
+    source: string
   ) => void
   registerActionHandler: (
     context: string,
     path: string,
-    callback: () => void
+    callback: () => void,
+    source: string
   ) => void
   registerHistoryProvider: (provider: {
     hasAnydata: (options: object, cb: (hasResults: boolean) => void) => void
@@ -461,9 +463,9 @@ module.exports = (theApp: any) => {
     }
     appCopy.getDataDirPath = () => dirForPluginId(plugin.id)
 
-    appCopy.registerPutHandler = (context, aPath, callback) => {
+    appCopy.registerPutHandler = (context, aPath, callback, source) => {
       onStopHandlers[plugin.id].push(
-        app.registerActionHandler(context, aPath, plugin.id, callback)
+        app.registerActionHandler(context, aPath, source || plugin.id, callback)
       )
     }
     appCopy.registerActionHandler = appCopy.registerPutHandler

src/put.js

@@ -184,7 +184,7 @@ function putPath(app, context, path, body, req, requestId, updateCb) {
 }
 
 function registerActionHandler(context, path, source, callback) {
-  debug(`registered action handler for ${context} ${path}`)
+  debug(`registered action handler for ${context} ${path} ${source}`)
 
   if (_.isUndefined(actionHandlers[context])) {
     actionHandlers[context] = {}