[udf] Unlock JavaScript for user-defined functions

[amotl]

Hi there,

after bouncing on and off on the idea to leverage the javascript package for data transformation purposes, in order to get rid of our PutsReq instance, which is a resource hog, and ceased to exist anyway, and while being unsure whether or how to also bring it to Kotori or LorryStream exactly, I am finally making a start on behalf of mqttwarn.

On the PutsReq instance I was referring to, we are running small snippets of JavaScript code like putsreq.hiveeyes.ttn_v3.js, in order to converge telemetry data packages received from TTN into a format digested by Kotori, effectively just unwrapping a few levels of JSON nestedness.

Following this idea, and annoyed about PutsReq itself, we've also explored the problem space on behalf of other projects like flow-heater already. At about the same time, Cloudflare Workers have been released, allowing to route and modify HTTP requests in different ways, using JavaScript or TypeScript. /cc @elbart

This patch essentially brings the same idea to mqttwarn, where all the routing and transforming machinery is already in place, and just needed a laughably small patch to achieve the same things with JavaScript without much further ado, thanks to the excellent JSPyBridge by @extremeheat. 💯

A highly configurable MQTT message router, where the routing targets are notification plugins, primarily written in Python.

By providing an alternative way of writing user-defined functions, the patch challenges the current slogan "primarily written in Python". I hope you will still like it, and I will be happy to hear back about your opinion about it.

Rest assured I am not a strong advocate of the JavaScript language, nor its paradigms and its NPM ecosystem ¹. But I recognize the value of the V8 runtime underneath Node.js, that it's an excellent and robust piece of software, and that people are doing many amazing things of their own kind with it.

The preview of the corresponding documentation can be inspected here:

• https://mqttwarn--667.org.readthedocs.build/en/667/configure/transformation.html#using-other-languages
• https://mqttwarn--667.org.readthedocs.build/en/667/examples/owntracks-ntfy/readme-variants.html#javascript

With kind regards,
Andreas.

NB: Next stop: Lua? Edit: See GH-669.
NB: Next stop: Java? See https://github.com/jpype-project/jpype and https://github.com/kivy/pyjnius.
NB: Next stop: Golang? See https://github.com/grumpyhome/grumpy.

Footnotes

1. https://www.destroyallsoftware.com/talks/wat ↩

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 49.96%. Comparing base (772f9f5) to head (8cd99f7).
⚠️ Report is 2 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #667      +/-   ##
==========================================
+ Coverage   49.75%   49.96%   +0.21%     
==========================================
  Files          81       81              
  Lines        4034     4051      +17     
==========================================
+ Hits         2007     2024      +17     
  Misses       2027     2027              

Flag	Coverage Δ
unittests	49.96% <100.00%> (+0.21%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[coderabbitai]

Important

Review skipped

Auto reviews are limited based on label configuration.

🏷️ Required labels (at least one) (1)

• coderabbit-review

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: e107457f-52a9-40de-91c9-76a47fa5cf73

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

_{Comment @coderabbitai help to get the list of available commands.}