mqtt-scenario-sim 1.0.0

package/dist/simulator.js

@@ -0,0 +1,199 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startSimulator = startSimulator;
+const config_1 = require("./config");
+const sensors_1 = require("./sensors");
+const scenarios_1 = require("./scenarios");
+const effects_1 = require("./effects");
+const logger_1 = require("./logger");
+function startSimulator(config, client, encode) {
+    const timers = [];
+    const revertTimers = new Map();
+    const publishListeners = new Set();
+    const entries = new Map();
+    for (const source of config.sources) {
+        const key = JSON.stringify(source.labels);
+        const topic = (0, config_1.resolveTopicTemplate)(source.topic, source.labels);
+        const states = source.metrics.map((m) => (0, sensors_1.createSensorState)({ ...m, intervalMs: m.intervalMs ?? config.publishIntervalMs }));
+        entries.set(key, {
+            config: source,
+            states,
+            effectConfigs: source.effects ?? [],
+            effectState: {},
+            scenario: { active: 'normal', ticks: new Array(source.metrics.length).fill(0) },
+            topic,
+        });
+        // Subscribe to inbound commands on the reverse topic: topic + "/cmd"
+        const cmdTopic = `${topic}/cmd`;
+        client.subscribe(cmdTopic, (err) => {
+            if (err)
+                logger_1.logger.error(`[sim] subscribe error ${cmdTopic}:`, err);
+        });
+    }
+    // Handle inbound MQTT command messages
+    client.on('message', (topic, payload) => {
+        if (!topic.endsWith('/cmd'))
+            return;
+        const baseTopic = topic.slice(0, -'/cmd'.length);
+        let raw;
+        try {
+            raw = JSON.parse(payload.toString());
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries.values()) {
+            if (entry.topic === baseTopic) {
+                const cmd = (0, effects_1.parseEffectCommand)(raw);
+                if (cmd) {
+                    entry.effectState = (0, effects_1.applyEffect)(entry.effectState, cmd.effect, cmd.state);
+                    logger_1.logger.info(`[effect] ${baseTopic} "${cmd.effect}" → ${cmd.state}`);
+                }
+                return;
+            }
+        }
+    });
+    // Schedule publish intervals for each metric in each source
+    for (const entry of entries.values()) {
+        for (let i = 0; i < entry.states.length; i++) {
+            const state = entry.states[i];
+            const metricCfg = entry.config.metrics[i];
+            const intervalMs = state.config.intervalMs;
+            const timer = setInterval(() => publishMetric(entry, i, metricCfg, state, client, encode, publishListeners), intervalMs);
+            timers.push(timer);
+        }
+    }
+    const sourceCount = entries.size;
+    const metricCount = [...entries.values()].reduce((n, e) => n + e.states.length, 0);
+    logger_1.logger.info(`[sim] started ${metricCount} metric(s) across ${sourceCount} source(s) | scenario: normal`);
+    function applyScenario(id, sourceKey, durationSeconds) {
+        const targets = sourceKey ? [sourceKey] : [...entries.keys()];
+        for (const key of targets) {
+            const entry = entries.get(key);
+            if (!entry)
+                continue;
+            const sc = entry.scenario;
+            if (id === sc.active && !durationSeconds)
+                continue;
+            sc.active = id;
+            sc.ticks.fill(0);
+            const existing = revertTimers.get(key);
+            if (existing) {
+                clearTimeout(existing);
+                revertTimers.delete(key);
+            }
+            logger_1.logger.info(`\n[scenario:${entry.topic}] → ${id}`);
+            logger_1.logger.info(`               ${scenarios_1.SCENARIO_DETAIL[id]}`);
+            if (durationSeconds && durationSeconds > 0) {
+                logger_1.logger.info(`               Auto-reverts in ${durationSeconds}s\n`);
+                const t = setTimeout(() => {
+                    revertTimers.delete(key);
+                    applyScenario('normal', key);
+                    logger_1.logger.info(`[scenario:${entry.topic}] auto-reverted to normal\n`);
+                }, durationSeconds * 1000);
+                revertTimers.set(key, t);
+            }
+            else {
+                logger_1.logger.info('');
+            }
+        }
+    }
+    return {
+        stop() {
+            for (const t of timers)
+                clearInterval(t);
+            for (const t of revertTimers.values())
+                clearTimeout(t);
+            logger_1.logger.info('[sim] stopped');
+        },
+        setScenario(id, sourceKey, durationSeconds) {
+            applyScenario(id, sourceKey, durationSeconds);
+        },
+        getScenario(sourceKey) {
+            if (sourceKey)
+                return entries.get(sourceKey)?.scenario.active ?? 'normal';
+            const actives = [...entries.values()].map((e) => e.scenario.active);
+            return actives.every((a) => a === actives[0]) ? (actives[0] ?? 'normal') : 'normal';
+        },
+        getState() {
+            const firstScenario = [...entries.values()][0]?.scenario.active ?? 'normal';
+            const metrics = [];
+            for (const entry of entries.values()) {
+                for (let i = 0; i < entry.states.length; i++) {
+                    const s = entry.states[i];
+                    metrics.push({
+                        labels: entry.config.labels,
+                        metric: entry.config.metrics[i].name,
+                        units: entry.config.metrics[i].units,
+                        value: s.lastValue,
+                        lastPublishedAt: s.lastPublishedAt,
+                    });
+                }
+            }
+            return { scenario: firstScenario, metrics };
+        },
+        getEffectStates() {
+            const out = {};
+            for (const entry of entries.values()) {
+                out[entry.topic] = entry.effectState;
+            }
+            return out;
+        },
+        onPublish(listener) {
+            publishListeners.add(listener);
+            return () => publishListeners.delete(listener);
+        },
+    };
+}
+async function publishMetric(entry, metricIndex, metricCfg, state, client, encode, listeners) {
+    const span = state.resolved.max - state.resolved.min;
+    const targetBias = (0, effects_1.computeBias)(entry.effectConfigs, entry.effectState, metricCfg.name, span);
+    (0, sensors_1.advanceBias)(state, targetBias);
+    const sc = entry.scenario;
+    const tick = sc.ticks[metricIndex] ?? 0;
+    const override = (0, scenarios_1.scenarioValue)(sc.active, state.resolved, tick, Math.random());
+    let value;
+    if (override !== null) {
+        value = Math.round((override + state.currentBias) * 100) / 100;
+    }
+    else {
+        value = (0, sensors_1.nextValue)(state, state.currentBias);
+    }
+    if (sc.active !== 'normal') {
+        sc.ticks[metricIndex] = tick + 1;
+    }
+    state.lastValue = value;
+    state.lastPublishedAt = Date.now();
+    try {
+        const buf = await encode({
+            labels: entry.config.labels,
+            metric: metricCfg.name,
+            value,
+            units: metricCfg.units,
+            timestamp: state.lastPublishedAt,
+        });
+        await client.publishAsync(entry.topic, buf, { qos: 0 });
+        if (listeners.size > 0) {
+            const event = {
+                labels: entry.config.labels,
+                topic: entry.topic,
+                metric: metricCfg.name,
+                units: metricCfg.units,
+                value,
+                scenario: sc.active,
+                timestamp: state.lastPublishedAt,
+            };
+            for (const fn of listeners)
+                fn(event);
+        }
+        const scenarioTag = sc.active !== 'normal' ? ` [${sc.active}]` : '';
+        const biasTag = state.currentBias !== 0
+            ? ` (bias ${state.currentBias > 0 ? '+' : ''}${state.currentBias.toFixed(2)})`
+            : '';
+        logger_1.logger.debug(`[${metricCfg.name}] ${value.toFixed(2)} ${metricCfg.units} → ${entry.topic}${scenarioTag}${biasTag}`);
+    }
+    catch (err) {
+        logger_1.logger.error(`[sim] publish error for ${metricCfg.name}:`, err);
+    }
+}
+//# sourceMappingURL=simulator.js.map

package/dist/simulator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"simulator.js","sourceRoot":"","sources":["../src/simulator.ts"],"names":[],"mappings":"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"}

package/examples/custom-proto.yaml

@@ -0,0 +1,46 @@
+mqtt:
+  host: localhost
+  port: 1883
+
+publishIntervalMs: 5000
+
+encoding:
+  type: protobuf
+  protoFile: ./my.proto          # path to your .proto file
+  messageType: myapp.SensorReading
+  # fieldMap: remap internal Reading fields to your proto field names (optional)
+  # If your proto field names match the defaults below, fieldMap is not needed.
+  #
+  # Internal fields available for mapping:
+  #   labels.*   — any label key (e.g. labels.room → room)
+  #   metric     — metric name string
+  #   value      — float reading
+  #   units      — units string
+  #   timestamp  — epoch ms
+  #
+  fieldMap:
+    metric: sensor_name
+    value: reading_value
+    units: reading_units
+    timestamp: recorded_at
+
+sources:
+  - labels:
+      building: hq
+      floor: "3"
+      zone: east
+    topic: "{building}/{floor}/{zone}/data"
+    metrics:
+      - name: temperature
+        units: "°C"
+        mode: sinusoidal
+        range: { low: 18, high: 26 }
+      - name: co2
+        units: ppm
+        mode: drift
+        range: { low: 400, high: 1000 }
+    effects:
+      - name: hvac
+        effects:
+          temperature: -0.30
+          co2: -0.25

package/examples/greenhouse.yaml

@@ -0,0 +1,139 @@
+mqtt:
+  host: localhost
+  port: 1883
+
+publishIntervalMs: 5000
+
+encoding:
+  type: json
+
+sources:
+  - labels:
+      org: demo-org
+      device: esp32-sim-1
+      variety: cherry-tomato
+    topic: "{org}/{device}/metrics"
+    metrics:
+      - name: temperature
+        units: "°C"
+        mode: sinusoidal
+        range: { low: 20, high: 30 }
+        periodSeconds: 7200
+      - name: humidity
+        units: "%"
+        mode: sinusoidal
+        range: { low: 60, high: 80 }
+        periodSeconds: 7200
+      - name: co2
+        units: ppm
+        mode: drift
+        range: { low: 400, high: 1200 }
+      - name: light
+        units: lux
+        mode: sinusoidal
+        range: { low: 0, high: 50000 }
+        periodSeconds: 86400
+      - name: nitrogen
+        units: "mg/L"
+        mode: normal
+        range: { low: 150, high: 250 }
+      - name: phosphorus
+        units: "mg/L"
+        mode: normal
+        range: { low: 30, high: 60 }
+      - name: potassium
+        units: "mg/L"
+        mode: normal
+        range: { low: 200, high: 400 }
+      - name: waterLevel
+        units: "%"
+        mode: drift
+        range: { low: 20, high: 95 }
+      - name: flowRate
+        units: "L/min"
+        mode: normal
+        range: { low: 0.5, high: 3.0 }
+    effects:
+      - name: fan
+        effects:
+          temperature: -0.40
+          humidity: -0.30
+          co2: -0.40
+      - name: heater
+        effects:
+          temperature: +0.30
+      - name: solenoid
+        effects:
+          humidity: +0.35
+      - name: lights
+        effects:
+          light: +0.80
+      - name: pump
+        effects:
+          waterLevel: +0.35
+          flowRate: +0.50
+
+  - labels:
+      org: demo-org
+      device: esp32-sim-2
+      variety: butterhead-lettuce
+    topic: "{org}/{device}/metrics"
+    metrics:
+      - name: temperature
+        units: "°C"
+        mode: sinusoidal
+        range: { low: 18, high: 24 }
+        periodSeconds: 7200
+      - name: humidity
+        units: "%"
+        mode: sinusoidal
+        range: { low: 55, high: 75 }
+        periodSeconds: 7200
+      - name: co2
+        units: ppm
+        mode: drift
+        range: { low: 400, high: 1000 }
+      - name: light
+        units: lux
+        mode: sinusoidal
+        range: { low: 0, high: 40000 }
+        periodSeconds: 86400
+      - name: nitrogen
+        units: "mg/L"
+        mode: normal
+        range: { low: 100, high: 200 }
+      - name: phosphorus
+        units: "mg/L"
+        mode: normal
+        range: { low: 20, high: 50 }
+      - name: potassium
+        units: "mg/L"
+        mode: normal
+        range: { low: 150, high: 300 }
+      - name: waterLevel
+        units: "%"
+        mode: drift
+        range: { low: 20, high: 95 }
+      - name: flowRate
+        units: "L/min"
+        mode: normal
+        range: { low: 0.3, high: 2.0 }
+    effects:
+      - name: fan
+        effects:
+          temperature: -0.40
+          humidity: -0.30
+          co2: -0.40
+      - name: heater
+        effects:
+          temperature: +0.30
+      - name: solenoid
+        effects:
+          humidity: +0.35
+      - name: lights
+        effects:
+          light: +0.80
+      - name: pump
+        effects:
+          waterLevel: +0.35
+          flowRate: +0.50

package/examples/minimal.yaml

@@ -0,0 +1,19 @@
+mqtt:
+  host: localhost
+  port: 1883
+
+publishIntervalMs: 5000
+
+# encoding defaults to JSON — no configuration needed
+encoding:
+  type: json
+
+sources:
+  - labels:
+      id: sensor-1
+    topic: "{id}/metrics"
+    metrics:
+      - name: temperature
+        units: "°C"
+        mode: sinusoidal
+        range: { low: 18, high: 28 }

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "mqtt-scenario-sim",
+  "version": "1.0.0",
+  "description": "Configurable MQTT sensor simulator with built-in test scenarios. Publish synthetic sensor data over MQTT — as JSON or protobuf — without real hardware.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "mqtt-scenario-sim": "dist/cli.js"
+  },
+  "files": [
+    "dist/",
+    "examples/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "ts-node src/cli.ts",
+    "test": "c8 mocha",
+    "test:ci": "c8 --reporter=lcov --reporter=text mocha",
+    "lint": "eslint src test"
+  },
+  "keywords": [
+    "mqtt",
+    "iot",
+    "sensor",
+    "simulator",
+    "testing",
+    "mock",
+    "scenario",
+    "protobuf"
+  ],
+  "license": "MIT",
+  "author": "dislev",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dislev/mqtt-scenario-sim.git"
+  },
+  "homepage": "https://github.com/dislev/mqtt-scenario-sim#readme",
+  "bugs": {
+    "url": "https://github.com/dislev/mqtt-scenario-sim/issues"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "dependencies": {
+    "express": "^5.2.1",
+    "js-yaml": "^4.1.0",
+    "mqtt": "^5.15.1",
+    "protobufjs": "^8.3.0"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.0",
+    "@types/js-yaml": "^4.0.9",
+    "@types/mocha": "^10.0.10",
+    "@types/node": "^22.0.0",
+    "c8": "^10.1.3",
+    "chai": "^5.2.0",
+    "eslint": "^9.0.0",
+    "mocha": "^12.0.0-beta-9.4",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.8.3",
+    "typescript-eslint": "^8.59.3"
+  }
+}