@yarkivaev/source-to-sink 1.2.7 → 1.3.0

package/index.js

@@ -11,6 +11,7 @@
  * - postgresSink: PostgreSQL sink (accepts URL)
  * - mqttSource: MQTT subscription source (accepts URL)
  * - stompSource: STOMP subscription source (accepts URL)
+ * - stompSend: one-shot STOMP publish (accepts URL)
  * - lokiSource: Loki polling source (accepts URL)
  * - modbusSource: Modbus TCP polling source (accepts host/port)
  * - mqttSink: MQTT publishing sink (accepts URL)
@@ -34,6 +35,7 @@ export { default as clickhouseSink } from './src/clickhouseSink.js';
 export { default as postgresSink } from './src/postgresSink.js';
 export { default as mqttSource } from './src/mqttSource.js';
 export { default as stompSource } from './src/stompSource.js';
+export { default as stompSend } from './src/stompSend.js';
 export { default as lokiSource } from './src/lokiSource.js';
 export { default as modbusSource } from './src/modbusSource.js';
 export { default as mqttSink } from './src/mqttSink.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yarkivaev/source-to-sink",
-  "version": "1.2.7",
+  "version": "1.3.0",
   "description": "Generic library for building data streaming pipelines",
   "repository": {
     "type": "git",

package/src/stompSend.js

@@ -0,0 +1,72 @@
+import stompit from 'stompit';
+
+/**
+ * Builds STOMP connect options from a URL.
+ *
+ * @param {URL} parsed - Parsed URL object
+ * @param {object} options - Connection options
+ * @returns {object} stompit connect parameters
+ */
+function connectParams(parsed, options) {
+    return {
+        host: parsed.hostname,
+        port: parseInt(parsed.port, 10) || 61613,
+        connectHeaders: {
+            host: options.host || parsed.hostname,
+            login: options.login || '',
+            passcode: options.passcode || ''
+        }
+    };
+}
+
+/**
+ * One-shot STOMP publish of a JSON payload to a destination.
+ *
+ * Connects, sends one MESSAGE frame, disconnects. For operator decisions
+ * and other low-volume outbound events.
+ *
+ * @example
+ * await stompSend('stomp://rabbitmq:61613', '/exchange/scada.user_decisions',
+ *   { machine: 'icht2', start: 1700000000, user: 'hmi', tags: ['heating'] },
+ *   { login: 'guest', passcode: 'guest', host: '/' });
+ *
+ * @param {string} url - STOMP broker URL
+ * @param {string} destination - STOMP destination
+ * @param {object|string} payload - JSON-serializable body or raw string
+ * @param {object} [options] - STOMP connection options
+ * @param {string} [options.login] - Login
+ * @param {string} [options.passcode] - Passcode
+ * @param {string} [options.host] - Virtual host header
+ * @returns {Promise<void>} Resolves when the frame is sent and client disconnects
+ */
+export default function stompSend(url, destination, payload, options = {}) {
+    if (typeof url !== 'string' || url.length === 0) {
+        throw new Error('URL must be a non-empty string');
+    }
+    if (typeof destination !== 'string' || destination.length === 0) {
+        throw new Error('Destination must be a non-empty string');
+    }
+    const parsed = new URL(url);
+    const params = connectParams(parsed, options);
+    const body = typeof payload === 'string' ? payload : JSON.stringify(payload);
+    return new Promise((resolve, reject) => {
+        stompit.connect(params, (error, client) => {
+            if (error) {
+                reject(error);
+                return;
+            }
+            const frame = client.send({
+                destination,
+                'content-type': 'application/json'
+            });
+            frame.end(body);
+            client.disconnect((disconnectError) => {
+                if (disconnectError) {
+                    reject(disconnectError);
+                    return;
+                }
+                resolve();
+            });
+        });
+    });
+}

package/test/test_stompSend.js

@@ -0,0 +1,35 @@
+import assert from 'node:assert';
+import { describe, it } from 'mocha';
+import stompSend from '../src/stompSend.js';
+
+describe('stompSend', () => {
+    it('throws on missing url', () => {
+        assert.throws(
+            () => {
+                stompSend(null, '/exchange/test', {});
+            },
+            /URL must be a non-empty string/u,
+            'Should reject missing url'
+        );
+    });
+
+    it('throws on empty destination', () => {
+        assert.throws(
+            () => {
+                stompSend('stomp://localhost:61613', '', {});
+            },
+            /Destination must be a non-empty string/u,
+            'Should reject empty destination'
+        );
+    });
+
+    it('returns a promise', () => {
+        const pending = stompSend(
+            `stomp://\u00e9${Math.random()}:61613`,
+            '/exchange/scada.user_decisions',
+            { machine: 'x', start: 1, user: 'u', tags: [] }
+        );
+        assert.strictEqual(typeof pending.then, 'function', 'Should return a promise');
+        pending.catch(() => {});
+    });
+});