node-red-contrib-tdn-eventsub 0.1.0

package/nodes/rest-item-status.js

@@ -0,0 +1,200 @@
+'use strict';
+const { OUT_RESPONSE, send, setStatus, reportError, storeName, nowIso } = require('../lib/outputs');
+
+/**
+ * Item status subscription (REST Server v8.30+, RESTStatus licence).
+ *
+ *   POST features.items.updates.href  {itemIds:[...]}  -> current status + next.href
+ *   loop: GET next.href (long poll, ~50 s server timeout)
+ *         -> updates (emit) or empty (timeout: just wait again)
+ *         -> always follow the new next.href
+ *   404  -> subscription dropped (>30 s gap or server restart): POST again
+ *   other errors -> back off and re-subscribe, forever, until stopped
+ *
+ * One trigger starts it; it then runs indefinitely. A new trigger with ids replaces
+ * the subscription; msg.payload "stop" (or msg.stop = true) ends it.
+ */
+
+const MAX_GAP_MS = 20000;      // the server drops a subscription if next.href isn't fetched within 30 s
+const LONG_POLL_MS = 120000;   // client-side timeout for the GET (server returns at ~50 s)
+
+function parseIds(msg) {
+    let v = msg.itemIds !== undefined ? msg.itemIds : msg.payload;
+    if (v && typeof v === 'object' && !Array.isArray(v) && v.itemIds !== undefined) v = v.itemIds;
+    if (typeof v === 'number') v = [v];
+    if (typeof v === 'string') v = v.split(/[\s,;]+/);
+    if (!Array.isArray(v)) return [];
+    const ids = [];
+    for (const x of v) {
+        const id = x && typeof x === 'object' ? (x.id !== undefined ? x.id : null) : x; // accept item objects too
+        if (id === null || id === undefined) continue;
+        const s = String(id).trim();
+        if (s && !ids.includes(s)) ids.push(s);
+    }
+    return ids;
+}
+
+function isStop(msg) {
+    return msg.stop === true || (typeof msg.payload === 'string' && msg.payload.trim().toLowerCase() === 'stop');
+}
+
+module.exports = function (RED) {
+    function RestItemStatusNode(config) {
+        RED.nodes.createNode(this, config);
+        const node = this;
+        node.name = config.name;
+        node.server = RED.nodes.getNode(config.server);
+        node.pollDelay = Math.min(Math.max(parseInt(config.pollDelay, 10) || 0, 0), MAX_GAP_MS);
+        node.retryDelay = Math.max(parseInt(config.retryDelay, 10) || 5000, 500);
+        node.maxRetryDelay = Math.max(parseInt(config.maxRetryDelay, 10) || 60000, node.retryDelay);
+        node.emitTimeouts = config.emitTimeouts === true;
+        node.contextKey = (config.contextKey || '').trim();
+        node.contextStore = config.contextStore || '';
+
+        let run = null; // { ctrl, ids }
+
+        function sleep(ms, signal) {
+            return new Promise((resolve) => {
+                if (signal.aborted) return resolve();
+                const t = setTimeout(() => { signal.removeEventListener('abort', onAbort); resolve(); }, ms);
+                const onAbort = () => { clearTimeout(t); resolve(); };
+                signal.addEventListener('abort', onAbort, { once: true });
+            });
+        }
+
+        function storeUpdates(updates) {
+            if (!node.contextKey || !Array.isArray(updates) || !updates.length) return;
+            const g = node.context().global;
+            const store = storeName(node.contextStore);
+            const map = Object.assign({}, g.get(node.contextKey, store) || {});
+            const t = nowIso();
+            for (const u of updates) if (u && u.id !== undefined) map[u.id] = Object.assign({}, u, { updated: t });
+            g.set(node.contextKey, map, store);
+        }
+
+        function emit(res, phase, ids, seq) {
+            const body = res.body || {};
+            storeUpdates(body.updates);
+            send(node, OUT_RESPONSE, {
+                topic: 'rest/items/updates',
+                payload: body,                              // full server response
+                updates: Array.isArray(body.updates) ? body.updates : [],
+                phase,                                      // 'subscribe' | 'update' | 'timeout'
+                seq,
+                itemIds: ids,
+                statusCode: res.statusCode,
+                url: res.url
+            });
+        }
+
+        async function loop(ids, ctrl) {
+            const signal = ctrl.signal;
+            let client;
+            try { client = node.server.getClient(); } catch (e) { reportError(node, e); return; }
+
+            let next = null;
+            let failures = 0;
+            let seq = 0;
+            while (!signal.aborted) {
+                try {
+                    if (!next) {
+                        setStatus(node, 'subscribing', `subscribing ${ids.length} item(s)`, { itemIds: ids });
+                        const href = await client.feature('items.updates', { signal });
+                        const res = await client.request('POST', href, { itemIds: ids }, { signal });
+                        if (signal.aborted) break;
+                        emit(res, 'subscribe', ids, ++seq);
+                        next = res.body && res.body.next && res.body.next.href;
+                        if (!next) throw new Error('Subscription response had no next.href');
+                        setStatus(node, 'subscribed', `subscribed ${ids.length} item(s)`, { itemIds: ids });
+                    } else {
+                        if (node.pollDelay) await sleep(node.pollDelay, signal);
+                        if (signal.aborted) break;
+                        // badge only - every long poll would otherwise flood the status output
+                        node.status({ fill: 'green', shape: 'ring', text: `waiting (${ids.length} item(s))` });
+                        const res = await client.request('GET', next, null, { signal, timeoutMs: LONG_POLL_MS });
+                        if (signal.aborted) break;
+                        const updates = res.body && Array.isArray(res.body.updates) ? res.body.updates : [];
+                        if (updates.length) {
+                            emit(res, 'update', ids, ++seq);
+                            setStatus(node, 'update', `${updates.length} update(s) @ ${new Date().toLocaleTimeString()}`, {
+                                count: updates.length,
+                                ids: updates.map((u) => u.id)
+                            });
+                        } else {
+                            // update-wait timed out with nothing new: send another update-wait.
+                            // Badge only - this happens every ~50 s and would flood the status output.
+                            if (node.emitTimeouts) emit(res, 'timeout', ids, ++seq);
+                            node.status({ fill: 'green', shape: 'ring', text: `wait timed out, re-waiting (${ids.length} item(s))` });
+                        }
+                        next = res.body && res.body.next && res.body.next.href;
+                        if (!next) {
+                            setStatus(node, 'resubscribing', 'no next link, re-subscribing');
+                        }
+                    }
+                    failures = 0;
+                } catch (err) {
+                    if (signal.aborted || err.aborted) break;
+                    next = null;
+                    if (err.statusCode === 404 && failures === 0) {
+                        // subscription expired (gap > 30 s or server restart) - re-POST straight away once
+                        setStatus(node, 'resubscribing', 'subscription expired (404), re-subscribing');
+                        failures++;
+                        continue;
+                    }
+                    failures++;
+                    const delay = Math.min(node.retryDelay * Math.pow(2, Math.min(failures - 1, 10)), node.maxRetryDelay);
+                    reportError(node, err, { itemIds: ids, attempt: failures, retryInMs: delay });
+                    setStatus(node, 'retrying', `retry ${failures} in ${Math.round(delay / 1000)} s`, { attempt: failures, retryInMs: delay, error: err.message });
+                    await sleep(delay, signal);
+                }
+            }
+        }
+
+        function stop(reason) {
+            if (run) {
+                run.ctrl.abort();
+                run = null;
+                setStatus(node, 'stopped', reason || 'stopped');
+            }
+        }
+
+        if (!node.server) setStatus(node, 'error', 'no server config');
+        else node.status({ fill: 'grey', shape: 'ring', text: 'idle' });
+
+        node.on('input', function (msg, sendFn, done) {
+            done = done || function () {};
+            if (isStop(msg)) {
+                if (run) stop('stopped by input');
+                else setStatus(node, 'stopped', 'not running');
+                return done();
+            }
+            if (!node.server) {
+                reportError(node, new Error('No REST server configured'));
+                return done();
+            }
+            const ids = parseIds(msg);
+            if (!ids.length) {
+                reportError(node, new Error('No item ids in msg.payload / msg.itemIds (string "508,526", array, or {itemIds:[...]})'));
+                return done();
+            }
+            if (run) stop('replaced by new subscription');
+            const ctrl = new AbortController();
+            run = { ctrl, ids };
+            loop(ids, ctrl).catch((e) => reportError(node, e)).finally(() => {
+                if (run && run.ctrl === ctrl) run = null;
+            });
+            done(); // the trigger message is handled; the subscription carries on by itself
+        });
+
+        node.on('close', function (removed, done) {
+            if (typeof removed === 'function') { done = removed; }
+            if (run) { run.ctrl.abort(); run = null; }
+            node.status({});
+            done();
+        });
+    }
+
+    RED.nodes.registerType('tdn-rest-item-status', RestItemStatusNode);
+};
+
+module.exports.parseIds = parseIds;

package/nodes/rest-lists.html

@@ -0,0 +1,268 @@
+<script type="text/javascript">
+(function () {
+    var defs = [{"type":"tdn-rest-access-groups","palette":"access groups","key":"rest_accessGroups","icon":"font-awesome/fa-users"},{"type":"tdn-rest-cardholders","palette":"cardholders","key":"rest_cardholders","icon":"font-awesome/fa-id-card"},{"type":"tdn-rest-items","palette":"items","key":"rest_items","icon":"font-awesome/fa-sitemap"}];
+    defs.forEach(function (d) {
+        RED.nodes.registerType(d.type, {
+            category: 'TDN REST',
+            color: '#E2D96E',
+            defaults: {
+                name: { value: '' },
+                server: { value: '', type: 'tdn-rest-server', required: true },
+                contextKey: { value: d.key },
+                contextStore: { value: '' },
+                top: { value: 1000, validate: RED.validators.number() },
+                sort: { value: 'id' },
+                fields: { value: '' },
+                query: { value: '' },
+                maxPages: { value: 0, validate: RED.validators.number() },
+                includePages: { value: true }
+            },
+            inputs: 1,
+            outputs: 3,
+            outputLabels: ['response', 'status', 'error'],
+            icon: d.icon,
+            label: function () { return this.name || ('get ' + d.palette); },
+            paletteLabel: 'get ' + d.palette,
+            oneditprepare: function () {
+                var sel = $('#node-input-contextStore');
+                var stores = (RED.settings.context && RED.settings.context.stores) || ['default'];
+                sel.empty();
+                sel.append($('<option>').val('').text('default'));
+                stores.forEach(function (s) { if (s !== 'default') sel.append($('<option>').val(s).text(s)); });
+                sel.val(this.contextStore || '');
+            }
+        });
+    });
+})();
+</script>
+
+<script type="text/html" data-template-name="tdn-rest-access-groups">
+    <div class="form-row">
+        <label for="node-input-name"><i class="fa fa-tag"></i> Name</label>
+        <input type="text" id="node-input-name" placeholder="get access groups">
+    </div>
+    <div class="form-row">
+        <label for="node-input-server"><i class="fa fa-server"></i> Server</label>
+        <input type="text" id="node-input-server">
+    </div>
+    <div class="form-row">
+        <label for="node-input-contextKey"><i class="fa fa-globe"></i> Global key</label>
+        <input type="text" id="node-input-contextKey" placeholder="rest_accessGroups">
+    </div>
+    <div class="form-row">
+        <label for="node-input-contextStore"><i class="fa fa-database"></i> Context store</label>
+        <select id="node-input-contextStore"></select>
+    </div>
+    <div class="form-row">
+        <label for="node-input-top">Page size (top)</label>
+        <input type="text" id="node-input-top" style="width:100px">
+    </div>
+    <div class="form-row">
+        <label for="node-input-sort">Sort</label>
+        <select id="node-input-sort" style="width:120px">
+            <option value="id">id</option><option value="-id">-id</option>
+            <option value="name">name</option><option value="-name">-name</option>
+        </select>
+    </div>
+    <div class="form-row">
+        <label for="node-input-fields">Fields</label>
+        <input type="text" id="node-input-fields" placeholder="server defaults, e.g. id,href,name,description,parent,division">
+    </div>
+    <div class="form-row">
+        <label for="node-input-query">Extra query</label>
+        <input type="text" id="node-input-query" placeholder="name=R%26D&amp;division=2">
+    </div>
+    <div class="form-row">
+        <label for="node-input-maxPages">Max pages</label>
+        <input type="text" id="node-input-maxPages" style="width:100px"> <span>0 = all</span>
+    </div>
+    <div class="form-row">
+        <label>&nbsp;</label>
+        <input type="checkbox" id="node-input-includePages" style="display:inline-block;width:auto;vertical-align:top">
+        <label for="node-input-includePages" style="width:auto">Include raw server pages in <code>msg.pages</code></label>
+    </div>
+</script>
+
+<script type="text/html" data-help-name="tdn-rest-access-groups">
+    <p>Downloads all access groups from the REST Server, following <code>next</code> links until done,
+       and stores the merged list in global context. Request/reply: one trigger, one response.</p>
+    <p>The URL comes from <code>features.accessGroups.accessGroups.href</code> in <code>GET /api</code> (needs RESTCardholders).</p>
+    <h3>Input</h3>
+    <dl class="message-properties">
+        <dt>any <span class="property-type">msg</span></dt><dd>Any message triggers a full download. A trigger while a download is running is ignored (reported on the status output).</dd>
+        <dt class="optional">query <span class="property-type">object | string</span></dt><dd>Extra query parameters, merged over the node's settings, e.g. <code>{"name":"smith"}</code>.</dd>
+        <dt class="optional">fields <span class="property-type">string</span></dt><dd>Overrides the <i>Fields</i> setting.</dd>
+        <dt class="optional">top / maxPages <span class="property-type">number</span></dt><dd>Override page size / page limit.</dd>
+        <dt class="optional">contextKey <span class="property-type">string</span></dt><dd>Overrides the global key.</dd>
+    </dl>
+    <h3>Outputs</h3>
+    <ol class="node-ports">
+        <li>Response
+            <dl class="message-properties">
+                <dt>payload.results <span class="property-type">array</span></dt><dd>All access groups, every page merged.</dd>
+                <dt>payload.count / payload.pageCount <span class="property-type">number</span></dt><dd></dd>
+                <dt>pages <span class="property-type">array</span></dt><dd>Each raw server response body, unmodified (if enabled).</dd>
+                <dt>request <span class="property-type">object</span></dt><dd>First-page href and parameters used.</dd>
+                <dt>contextKey <span class="property-type">string</span></dt><dd>Global key written.</dd>
+            </dl>
+        </li>
+        <li>Status &ndash; <code>payload.state</code>: <code>requesting</code>, <code>done</code>, <code>busy</code> with <code>text</code>, <code>time</code>, node id/name.</li>
+        <li>Error &ndash; <code>payload.message</code>, <code>statusCode</code>, <code>body</code>, <code>url</code>, <code>code</code>.</li>
+    </ol>
+    <h3>Global context</h3>
+    <p><code>global.&lt;key&gt;</code> holds the results array; <code>global.&lt;key&gt;_updated</code> holds the ISO time of the last successful download.</p>
+</script>
+
+<script type="text/html" data-template-name="tdn-rest-cardholders">
+    <div class="form-row">
+        <label for="node-input-name"><i class="fa fa-tag"></i> Name</label>
+        <input type="text" id="node-input-name" placeholder="get cardholders">
+    </div>
+    <div class="form-row">
+        <label for="node-input-server"><i class="fa fa-server"></i> Server</label>
+        <input type="text" id="node-input-server">
+    </div>
+    <div class="form-row">
+        <label for="node-input-contextKey"><i class="fa fa-globe"></i> Global key</label>
+        <input type="text" id="node-input-contextKey" placeholder="rest_cardholders">
+    </div>
+    <div class="form-row">
+        <label for="node-input-contextStore"><i class="fa fa-database"></i> Context store</label>
+        <select id="node-input-contextStore"></select>
+    </div>
+    <div class="form-row">
+        <label for="node-input-top">Page size (top)</label>
+        <input type="text" id="node-input-top" style="width:100px">
+    </div>
+    <div class="form-row">
+        <label for="node-input-sort">Sort</label>
+        <select id="node-input-sort" style="width:120px">
+            <option value="id">id</option><option value="-id">-id</option>
+            <option value="name">name</option><option value="-name">-name</option>
+        </select>
+    </div>
+    <div class="form-row">
+        <label for="node-input-fields">Fields</label>
+        <input type="text" id="node-input-fields" placeholder="server defaults, e.g. defaults,cards,accessGroups">
+    </div>
+    <div class="form-row">
+        <label for="node-input-query">Extra query</label>
+        <input type="text" id="node-input-query" placeholder="name=smith&amp;division=2">
+    </div>
+    <div class="form-row">
+        <label for="node-input-maxPages">Max pages</label>
+        <input type="text" id="node-input-maxPages" style="width:100px"> <span>0 = all</span>
+    </div>
+    <div class="form-row">
+        <label>&nbsp;</label>
+        <input type="checkbox" id="node-input-includePages" style="display:inline-block;width:auto;vertical-align:top">
+        <label for="node-input-includePages" style="width:auto">Include raw server pages in <code>msg.pages</code></label>
+    </div>
+</script>
+
+<script type="text/html" data-help-name="tdn-rest-cardholders">
+    <p>Downloads all cardholders from the REST Server, following <code>next</code> links until done,
+       and stores the merged list in global context. Request/reply: one trigger, one response.</p>
+    <p>The URL comes from <code>features.cardholders.cardholders.href</code> in <code>GET /api</code> (needs RESTCardholders).</p>
+    <h3>Input</h3>
+    <dl class="message-properties">
+        <dt>any <span class="property-type">msg</span></dt><dd>Any message triggers a full download. A trigger while a download is running is ignored (reported on the status output).</dd>
+        <dt class="optional">query <span class="property-type">object | string</span></dt><dd>Extra query parameters, merged over the node's settings, e.g. <code>{"name":"smith"}</code>.</dd>
+        <dt class="optional">fields <span class="property-type">string</span></dt><dd>Overrides the <i>Fields</i> setting.</dd>
+        <dt class="optional">top / maxPages <span class="property-type">number</span></dt><dd>Override page size / page limit.</dd>
+        <dt class="optional">contextKey <span class="property-type">string</span></dt><dd>Overrides the global key.</dd>
+    </dl>
+    <h3>Outputs</h3>
+    <ol class="node-ports">
+        <li>Response
+            <dl class="message-properties">
+                <dt>payload.results <span class="property-type">array</span></dt><dd>All cardholders, every page merged.</dd>
+                <dt>payload.count / payload.pageCount <span class="property-type">number</span></dt><dd></dd>
+                <dt>pages <span class="property-type">array</span></dt><dd>Each raw server response body, unmodified (if enabled).</dd>
+                <dt>request <span class="property-type">object</span></dt><dd>First-page href and parameters used.</dd>
+                <dt>contextKey <span class="property-type">string</span></dt><dd>Global key written.</dd>
+            </dl>
+        </li>
+        <li>Status &ndash; <code>payload.state</code>: <code>requesting</code>, <code>done</code>, <code>busy</code> with <code>text</code>, <code>time</code>, node id/name.</li>
+        <li>Error &ndash; <code>payload.message</code>, <code>statusCode</code>, <code>body</code>, <code>url</code>, <code>code</code>.</li>
+    </ol>
+    <h3>Global context</h3>
+    <p><code>global.&lt;key&gt;</code> holds the results array; <code>global.&lt;key&gt;_updated</code> holds the ISO time of the last successful download.</p>
+</script>
+
+<script type="text/html" data-template-name="tdn-rest-items">
+    <div class="form-row">
+        <label for="node-input-name"><i class="fa fa-tag"></i> Name</label>
+        <input type="text" id="node-input-name" placeholder="get items">
+    </div>
+    <div class="form-row">
+        <label for="node-input-server"><i class="fa fa-server"></i> Server</label>
+        <input type="text" id="node-input-server">
+    </div>
+    <div class="form-row">
+        <label for="node-input-contextKey"><i class="fa fa-globe"></i> Global key</label>
+        <input type="text" id="node-input-contextKey" placeholder="rest_items">
+    </div>
+    <div class="form-row">
+        <label for="node-input-contextStore"><i class="fa fa-database"></i> Context store</label>
+        <select id="node-input-contextStore"></select>
+    </div>
+    <div class="form-row">
+        <label for="node-input-top">Page size (top)</label>
+        <input type="text" id="node-input-top" style="width:100px">
+    </div>
+    <div class="form-row">
+        <label for="node-input-sort">Sort</label>
+        <select id="node-input-sort" style="width:120px">
+            <option value="id">id</option><option value="-id">-id</option>
+            <option value="name">name</option><option value="-name">-name</option>
+        </select>
+    </div>
+    <div class="form-row">
+        <label for="node-input-fields">Fields</label>
+        <input type="text" id="node-input-fields" placeholder="server defaults, e.g. defaults,division">
+    </div>
+    <div class="form-row">
+        <label for="node-input-query">Extra query</label>
+        <input type="text" id="node-input-query" placeholder="type=11,14&amp;division=2">
+    </div>
+    <div class="form-row">
+        <label for="node-input-maxPages">Max pages</label>
+        <input type="text" id="node-input-maxPages" style="width:100px"> <span>0 = all</span>
+    </div>
+    <div class="form-row">
+        <label>&nbsp;</label>
+        <input type="checkbox" id="node-input-includePages" style="display:inline-block;width:auto;vertical-align:top">
+        <label for="node-input-includePages" style="width:auto">Include raw server pages in <code>msg.pages</code></label>
+    </div>
+</script>
+
+<script type="text/html" data-help-name="tdn-rest-items">
+    <p>Downloads all items from the REST Server, following <code>next</code> links until done,
+       and stores the merged list in global context. Request/reply: one trigger, one response.</p>
+    <p>The URL comes from <code>features.items.items.href</code> in <code>GET /api</code> (needs any REST licence).</p>
+    <h3>Input</h3>
+    <dl class="message-properties">
+        <dt>any <span class="property-type">msg</span></dt><dd>Any message triggers a full download. A trigger while a download is running is ignored (reported on the status output).</dd>
+        <dt class="optional">query <span class="property-type">object | string</span></dt><dd>Extra query parameters, merged over the node's settings, e.g. <code>{"name":"smith"}</code>.</dd>
+        <dt class="optional">fields <span class="property-type">string</span></dt><dd>Overrides the <i>Fields</i> setting.</dd>
+        <dt class="optional">top / maxPages <span class="property-type">number</span></dt><dd>Override page size / page limit.</dd>
+        <dt class="optional">contextKey <span class="property-type">string</span></dt><dd>Overrides the global key.</dd>
+    </dl>
+    <h3>Outputs</h3>
+    <ol class="node-ports">
+        <li>Response
+            <dl class="message-properties">
+                <dt>payload.results <span class="property-type">array</span></dt><dd>All items, every page merged.</dd>
+                <dt>payload.count / payload.pageCount <span class="property-type">number</span></dt><dd></dd>
+                <dt>pages <span class="property-type">array</span></dt><dd>Each raw server response body, unmodified (if enabled).</dd>
+                <dt>request <span class="property-type">object</span></dt><dd>First-page href and parameters used.</dd>
+                <dt>contextKey <span class="property-type">string</span></dt><dd>Global key written.</dd>
+            </dl>
+        </li>
+        <li>Status &ndash; <code>payload.state</code>: <code>requesting</code>, <code>done</code>, <code>busy</code> with <code>text</code>, <code>time</code>, node id/name.</li>
+        <li>Error &ndash; <code>payload.message</code>, <code>statusCode</code>, <code>body</code>, <code>url</code>, <code>code</code>.</li>
+    </ol>
+    <h3>Global context</h3>
+    <p><code>global.&lt;key&gt;</code> holds the results array; <code>global.&lt;key&gt;_updated</code> holds the ISO time of the last successful download.</p>
+</script>

package/nodes/rest-lists.js

@@ -0,0 +1,115 @@
+'use strict';
+const { RestClient } = require('../lib/client');
+const { OUT_RESPONSE, send, setStatus, reportError, storeName, nowIso } = require('../lib/outputs');
+
+/**
+ * Request/reply "list" nodes. Each trigger:
+ *   GET /api -> features.<x>.<y>.href -> GET first page -> follow next.href
+ *   -> store merged results in global context -> output full response
+ */
+const LISTS = [
+    { type: 'tdn-rest-access-groups', feature: 'accessGroups.accessGroups', label: 'access groups', defaultKey: 'rest_accessGroups' },
+    { type: 'tdn-rest-cardholders', feature: 'cardholders.cardholders', label: 'cardholders', defaultKey: 'rest_cardholders' },
+    { type: 'tdn-rest-items', feature: 'items.items', label: 'items', defaultKey: 'rest_items' }
+];
+
+module.exports = function (RED) {
+    function makeListNode(def) {
+        return function RestListNode(config) {
+            RED.nodes.createNode(this, config);
+            const node = this;
+            node.name = config.name;
+            node.server = RED.nodes.getNode(config.server);
+            node.contextKey = (config.contextKey || '').trim();
+            node.contextStore = config.contextStore || '';
+            node.top = parseInt(config.top, 10) || 1000;
+            node.sort = config.sort || 'id';
+            node.fields = (config.fields || '').trim();
+            node.query = (config.query || '').trim();
+            node.maxPages = parseInt(config.maxPages, 10) || 0;
+            node.includePages = config.includePages !== false;
+
+            let running = null; // AbortController of in-flight run
+
+            if (!node.server) setStatus(node, 'error', 'no server config');
+            else node.status({ fill: 'grey', shape: 'ring', text: 'idle' });
+
+            node.on('input', async function (msg, sendFn, done) {
+                done = done || function (e) { if (e) node.error(e, msg); };
+                if (!node.server) {
+                    reportError(node, new Error('No REST server configured'));
+                    return done();
+                }
+                if (running) {
+                    setStatus(node, 'busy', 'busy - trigger ignored', { reason: 'request already in progress' });
+                    return done();
+                }
+                const ctrl = new AbortController();
+                running = ctrl;
+                const started = Date.now();
+                try {
+                    const client = node.server.getClient();
+                    setStatus(node, 'requesting', `requesting ${def.label}`);
+                    const firstHref = await client.feature(def.feature, { signal: ctrl.signal });
+
+                    // node config, then optional per-message overrides
+                    const params = Object.assign(
+                        { top: node.top, sort: node.sort, fields: node.fields },
+                        RestClient.parseQueryString(node.query)
+                    );
+                    if (msg.query) {
+                        Object.assign(params, typeof msg.query === 'string' ? RestClient.parseQueryString(msg.query) : msg.query);
+                    }
+                    if (msg.fields !== undefined) params.fields = msg.fields;
+                    if (msg.top !== undefined) params.top = msg.top;
+
+                    const href = RestClient.addQuery(firstHref, params);
+                    const out = await client.getAll(href, {
+                        signal: ctrl.signal,
+                        maxPages: msg.maxPages !== undefined ? msg.maxPages : node.maxPages,
+                        onPage: (body, i) => {
+                            const n = Array.isArray(body.results) ? body.results.length : 0;
+                            node.status({ fill: 'blue', shape: 'dot', text: `page ${i + 1} (+${n})` });
+                        }
+                    });
+
+                    const key = (msg.contextKey || node.contextKey || def.defaultKey);
+                    const store = storeName(node.contextStore);
+                    node.context().global.set(key, out.results, store);
+                    node.context().global.set(key + '_updated', nowIso(), store);
+
+                    msg.payload = {
+                        results: out.results,
+                        count: out.results.length,
+                        pageCount: out.pageCount
+                    };
+                    if (node.includePages) msg.pages = out.pages;
+                    msg.request = { href, params };
+                    msg.contextKey = key;
+                    msg.statusCode = 200;
+                    msg.topic = msg.topic || def.type.replace(/^tdn-/, '');
+                    send(node, OUT_RESPONSE, msg);
+                    setStatus(node, 'done', `${out.results.length} ${def.label} (${out.pageCount} pg)`, {
+                        count: out.results.length,
+                        pageCount: out.pageCount,
+                        contextKey: key,
+                        durationMs: Date.now() - started
+                    });
+                } catch (err) {
+                    if (!err.aborted) reportError(node, err, { feature: def.feature });
+                } finally {
+                    running = null;
+                    done();
+                }
+            });
+
+            node.on('close', function (done) {
+                if (running) running.abort();
+                running = null;
+                done();
+            });
+        };
+    }
+
+    for (const def of LISTS) RED.nodes.registerType(def.type, makeListNode(def));
+};