mqtt-scenario-sim 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 dislev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,264 @@
+<p align="center">
+  <img src="assets/logo.png" alt="mqtt-scenario-sim logo" width="160" />
+</p>
+
+# mqtt-scenario-sim
+
+[![CI](https://github.com/dislev/mqtt-scenario-sim/actions/workflows/ci.yml/badge.svg)](https://github.com/dislev/mqtt-scenario-sim/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/badge/npm-v1.0.0-blue)](https://www.npmjs.com/package/mqtt-scenario-sim)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![Node >=22](https://img.shields.io/badge/node-%3E%3D22-green)](package.json)
+[![codecov](https://codecov.io/gh/dislev/mqtt-scenario-sim/branch/main/graph/badge.svg)](https://codecov.io/gh/dislev/mqtt-scenario-sim)
+
+A configurable MQTT sensor simulator with built-in test scenarios. Publish synthetic sensor data over MQTT — as JSON or protobuf — without real hardware.
+
+Define your sources with any labels you want. Wire up any MQTT topic template. Switch between test scenarios over HTTP to drive your alert and pipeline logic.
+
+> **Maintenance:** This project is maintained on a best-effort basis. Bug reports and PRs are welcome — response times may vary.
+
+---
+
+## Quick start
+
+```bash
+npx mqtt-scenario-sim --config examples/minimal.yaml
+```
+
+Requires a running MQTT broker (e.g. `docker run -p 1883:1883 eclipse-mosquitto`).
+
+---
+
+## Scenarios
+
+The real differentiator. Switch your entire simulator into a controlled test state at any time — no restarts.
+
+| ID | Key | What it does |
+|---|---|---|
+| 0 | `normal` | Each metric runs its configured mode |
+| 1 | `out_of_range` | All metrics 30% above max — tests breach detection |
+| 2 | `trending_to_breach` | Rising toward max — tests early-warning alerts |
+| 3 | `stable_healthy` | Held at midpoint ideal — tests steady-state |
+| 4 | `recovery` | Starts out-of-range, decays to ideal over ~5 min |
+| 5 | `oscillating` | ±10% swing — tests flapping suppression |
+
+```bash
+# Activate a scenario
+curl -X POST http://localhost:4000/scenario/1
+
+# With auto-revert after 60 seconds
+curl -X POST "http://localhost:4000/scenario/4?durationSeconds=60"
+
+# Target a single source by its labels key
+curl -X POST "http://localhost:4000/scenario/2?sourceKey=%7B%22device%22%3A%22node-1%22%7D"
+
+# Check current scenario
+curl http://localhost:4000/scenario
+
+# Back to normal
+curl -X POST http://localhost:4000/scenario/0
+```
+
+---
+
+## YAML config
+
+```yaml
+mqtt:
+  host: localhost
+  port: 1883
+
+publishIntervalMs: 5000
+
+encoding:
+  type: json          # or "protobuf" (see Protobuf section)
+
+sources:
+  - labels:           # fully freeform — any keys you want
+      building: hq
+      floor: "3"
+      zone: east
+    topic: "{building}/{floor}/{zone}/metrics"   # template using label keys
+    metrics:
+      - name: temperature
+        units: "°C"
+        mode: sinusoidal       # sinusoidal | drift | normal | spike
+        range: { low: 18, high: 28 }
+        periodSeconds: 3600    # optional
+      - name: humidity
+        units: "%"
+        mode: drift
+        range: { low: 30, high: 70 }
+    effects:           # optional — external things that bias metric readings
+      - name: hvac
+        effects:
+          temperature: -0.40   # fraction of range span, negative = reduce
+          humidity: -0.20
+```
+
+### Sensor modes
+
+| Mode | Description |
+|---|---|
+| `sinusoidal` | Smooth oscillation over `periodSeconds` |
+| `normal` | Gaussian noise around baseline |
+| `drift` | Slow random walk that bounces at range edges |
+| `spike` | Normal noise with random anomaly spikes |
+
+### Effects
+
+Effects let you simulate external influences on metric readings. Send a command to `{topic}/cmd`:
+
+```json
+{ "effect": "hvac", "state": true }
+```
+
+Each effect's `effects` map specifies bias as a fraction of the metric's span. `-0.40` on temperature with a span of 10°C = -4°C bias.
+
+---
+
+## Protobuf
+
+```yaml
+encoding:
+  type: protobuf
+  protoFile: ./my.proto
+  messageType: myapp.SensorReading
+  fieldMap:                   # optional — remap internal fields to proto field names
+    metric: sensor_name
+    value: reading_value
+    timestamp: recorded_at
+```
+
+Internal fields available for mapping: `metric`, `value`, `units`, `timestamp`, plus any label key (e.g. `building`, `floor`).
+
+---
+
+## HTTP API
+
+| Method | Path | Description |
+|---|---|---|
+| `GET` | `/stream` | SSE stream — one event per metric publish |
+| `GET` | `/status` | Full snapshot: uptime, scenario, all readings, all effects |
+| `GET` | `/health` | Status, uptime, source/metric counts, active scenario |
+| `GET` | `/scenario` | Current scenario name + description |
+| `POST` | `/scenario/:id` | Activate scenario (0–5 or name). Query: `durationSeconds`, `sourceKey` |
+| `GET` | `/state` | Last published value per metric |
+| `GET` | `/effects` | Current effect state per source |
+
+### Live tailing with `/stream`
+
+`/stream` is a Server-Sent Events endpoint. It pushes one JSON event per metric publish and stays open until you disconnect.
+
+```bash
+curl -N http://localhost:4000/stream
+```
+
+```
+data: {"labels":{"building":"hq","floor":"3"},"topic":"hq/3/east/metrics","metric":"temperature","units":"°C","value":22.45,"scenario":"normal","timestamp":1747613001234}
+
+data: {"labels":{"building":"hq","floor":"3"},"topic":"hq/3/east/metrics","metric":"humidity","units":"%","value":58.1,"scenario":"normal","timestamp":1747613001235}
+```
+
+Multiple clients can connect simultaneously. The `scenario` field reflects the active scenario at publish time.
+
+### Full snapshot with `/status`
+
+```bash
+curl http://localhost:4000/status
+```
+
+```json
+{
+  "status": "ok",
+  "uptime": 142,
+  "sources": 1,
+  "metrics": 2,
+  "scenario": {
+    "id": "normal",
+    "label": "0 / n  — Normal (uses each metric's configured mode)",
+    "detail": "Each metric runs its configured mode: sinusoidal, drift, normal, or spike."
+  },
+  "readings": [
+    { "labels": { "building": "hq", "floor": "3" }, "metric": "temperature", "units": "°C", "value": 22.45, "lastPublishedAt": 1747613001234 },
+    { "labels": { "building": "hq", "floor": "3" }, "metric": "humidity", "units": "%", "value": 58.1, "lastPublishedAt": 1747613001235 }
+  ],
+  "effects": {
+    "hq/3/east/metrics": { "hvac": false }
+  }
+}
+```
+
+---
+
+## CLI args
+
+| Argument | Description |
+|---|---|
+| `--config <path>` | Path to YAML config file |
+| `--log-level <level>` | `silent` \| `error` \| `warn` \| `info` \| `debug` (default: `info`) |
+| `-h`, `--help` | Print help and exit |
+
+```bash
+# Verbose — see every metric publish
+npx mqtt-scenario-sim --config my.yaml --log-level debug
+
+# Quiet — errors only
+npx mqtt-scenario-sim --config my.yaml --log-level error
+
+# Help
+npx mqtt-scenario-sim --help
+```
+
+---
+
+## Env vars
+
+| Variable | Default | Description |
+|---|---|---|
+| `MQTT_HOST` | `localhost` | MQTT broker host |
+| `MQTT_PORT` | `1883` | MQTT broker port |
+| `PUBLISH_INTERVAL_MS` | `5000` | Default publish interval |
+| `ENCODING` | `json` | `json` or `protobuf` |
+| `PROTO_FILE` | — | Path to `.proto` file |
+| `PROTO_MESSAGE_TYPE` | — | Fully-qualified proto message type |
+| `PROTO_FIELD_MAP` | — | JSON string field map |
+| `CONFIG_PATH` | `examples/minimal.yaml` | Path to YAML config |
+| `PORT` | `4000` | HTTP control plane port |
+| `LOG_LEVEL` | `info` | `silent` \| `error` \| `warn` \| `info` \| `debug` |
+
+CLI args take precedence over env vars.
+
+---
+
+## Examples
+
+- [`examples/minimal.yaml`](examples/minimal.yaml) — 1 source, 1 metric, JSON
+- [`examples/greenhouse.yaml`](examples/greenhouse.yaml) — multi-source, multi-metric IoT example
+- [`examples/custom-proto.yaml`](examples/custom-proto.yaml) — protobuf with fieldMap
+
+---
+
+## Docker
+
+A [`Dockerfile`](Dockerfile) is included. Build and run with your own config:
+
+```bash
+docker build -t mqtt-scenario-sim .
+docker run --rm -e MQTT_HOST=host.docker.internal mqtt-scenario-sim
+```
+
+To use a custom config, mount it at runtime:
+
+```bash
+docker run --rm \
+  -v $(pwd)/my-config.yaml:/app/my-config.yaml \
+  -e CONFIG_PATH=/app/my-config.yaml \
+  -e MQTT_HOST=host.docker.internal \
+  mqtt-scenario-sim
+```
+
+---
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,265 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const readline = __importStar(require("readline"));
+const mqtt = __importStar(require("mqtt"));
+const path = __importStar(require("path"));
+const express_1 = __importDefault(require("express"));
+const config_1 = require("./config");
+const encoder_1 = require("./encoder");
+const simulator_1 = require("./simulator");
+const scenarios_1 = require("./scenarios");
+const logger_1 = require("./logger");
+const PORT = parseInt(process.env['PORT'] ?? '4000', 10);
+const logLevelArg = process.argv.find((a) => a.startsWith('--log-level='))?.slice('--log-level='.length)
+    ?? (process.argv.indexOf('--log-level') !== -1 ? process.argv[process.argv.indexOf('--log-level') + 1] : undefined)
+    ?? process.env['LOG_LEVEL'];
+if (logLevelArg)
+    logger_1.logger.setLevel(logLevelArg);
+if (process.argv.includes('--help') || process.argv.includes('-h')) {
+    console.log(`
+Usage: mqtt-scenario-sim [options]
+
+Options:
+  --config <path>       Path to YAML config file (default: examples/minimal.yaml)
+  --log-level <level>   Log verbosity: silent | error | warn | info | debug  (default: info)
+  -h, --help            Show this help message
+
+Env vars:
+  MQTT_HOST             MQTT broker host            (default: localhost)
+  MQTT_PORT             MQTT broker port            (default: 1883)
+  PUBLISH_INTERVAL_MS   Publish interval in ms      (default: 5000)
+  ENCODING              json | protobuf             (default: json)
+  PROTO_FILE            Path to .proto file
+  PROTO_MESSAGE_TYPE    Fully-qualified message type
+  PROTO_FIELD_MAP       JSON string field map
+  CONFIG_PATH           Path to YAML config file    (default: examples/minimal.yaml)
+  PORT                  HTTP control plane port     (default: 4000)
+  LOG_LEVEL             Log verbosity level         (default: info)
+
+HTTP API (default port 4000):
+  GET  /stream          SSE stream of live metric publishes
+  GET  /status          Full snapshot: uptime, scenario, readings, effects
+  GET  /health          Status, uptime, source/metric counts, scenario
+  GET  /scenario        Current scenario name + description
+  POST /scenario/:id    Activate scenario by ID (0–5) or name
+  GET  /state           Last published value per metric
+  GET  /effects         Current effect state per source
+
+Scenarios:
+  0 / normal              Each metric runs its configured mode
+  1 / out_of_range        All metrics 30% above max
+  2 / trending_to_breach  Rising toward max
+  3 / stable_healthy      Held at midpoint ideal
+  4 / recovery            Starts out-of-range, decays to ideal over ~5 min
+  5 / oscillating         ±10% swing around ideal
+
+Examples:
+  mqtt-scenario-sim --config examples/minimal.yaml
+  mqtt-scenario-sim --config my.yaml --log-level debug
+  `);
+    process.exit(0);
+}
+function printMenu() {
+    logger_1.logger.info('\n┌─ Scenario control ──────────────────────────────────────────┐');
+    for (const label of Object.values(scenarios_1.SCENARIO_LABELS)) {
+        logger_1.logger.info(`│  ${label.padEnd(61)}│`);
+    }
+    logger_1.logger.info('│                                                             │');
+    logger_1.logger.info('│  status / ?   show active scenario                         │');
+    logger_1.logger.info('│  help         re-print this menu                           │');
+    logger_1.logger.info('└─────────────────────────────────────────────────────────────┘\n');
+}
+function resolveScenarioId(input) {
+    return scenarios_1.SCENARIO_KEYS[input.trim().toLowerCase()] ?? null;
+}
+async function main() {
+    const configArg = process.argv.find((a) => a.startsWith('--config='))?.slice('--config='.length)
+        ?? process.argv[process.argv.indexOf('--config') + 1];
+    const configPath = configArg
+        ? path.resolve(configArg)
+        : process.env['CONFIG_PATH'];
+    const config = (0, config_1.loadConfig)(configPath);
+    const totalMetrics = config.sources.reduce((n, s) => n + s.metrics.length, 0);
+    logger_1.logger.info(`[init] ${config.sources.length} source(s) | ${totalMetrics} metric(s) | MQTT: ${config.mqtt.host}:${config.mqtt.port}`);
+    const encode = config.encoding.type === 'protobuf'
+        ? (0, encoder_1.buildEncoder)(config.encoding)
+        : encoder_1.jsonEncoder;
+    const brokerUrl = `mqtt://${config.mqtt.host}:${config.mqtt.port}`;
+    const client = mqtt.connect(brokerUrl, { reconnectPeriod: 2000 });
+    await new Promise((resolve, reject) => {
+        client.once('connect', () => resolve());
+        client.once('error', (err) => reject(err));
+    });
+    logger_1.logger.info(`[mqtt] connected to ${brokerUrl}`);
+    const sim = (0, simulator_1.startSimulator)(config, client, encode);
+    // ── HTTP control plane ────────────────────────────────────────────────────
+    const app = (0, express_1.default)();
+    const startTime = Date.now();
+    app.use(express_1.default.json());
+    app.get('/health', (_req, res) => {
+        res.json({
+            status: 'ok',
+            sources: config.sources.length,
+            metrics: totalMetrics,
+            uptime: Math.floor((Date.now() - startTime) / 1000),
+            scenario: sim.getScenario(),
+        });
+    });
+    app.get('/scenario', (_req, res) => {
+        const id = sim.getScenario();
+        res.json({ scenario: id, label: scenarios_1.SCENARIO_LABELS[id], detail: scenarios_1.SCENARIO_DETAIL[id] });
+    });
+    app.post('/scenario/:id', (req, res) => {
+        const id = resolveScenarioId(req.params['id'] ?? '');
+        if (!id) {
+            res.status(400).json({
+                error: `Unknown scenario "${req.params['id']}". Valid: ${Object.keys(scenarios_1.SCENARIO_KEYS).join(', ')}`,
+            });
+            return;
+        }
+        const rawDuration = req.query['durationSeconds'];
+        const rawSourceKey = req.query['sourceKey'];
+        const durationSeconds = typeof rawDuration === 'string' && rawDuration.length > 0
+            ? parseInt(rawDuration, 10)
+            : undefined;
+        const sourceKey = typeof rawSourceKey === 'string' && rawSourceKey.length > 0
+            ? rawSourceKey
+            : undefined;
+        sim.setScenario(id, sourceKey, durationSeconds && durationSeconds > 0 ? durationSeconds : undefined);
+        res.json({
+            ok: true,
+            scenario: id,
+            label: scenarios_1.SCENARIO_LABELS[id],
+            ...(sourceKey ? { sourceKey } : { appliedTo: 'all' }),
+            ...(durationSeconds && durationSeconds > 0 ? { autoRevertAfterSeconds: durationSeconds } : {}),
+        });
+    });
+    app.get('/state', (_req, res) => {
+        res.json(sim.getState());
+    });
+    app.get('/effects', (_req, res) => {
+        res.json(sim.getEffectStates());
+    });
+    app.get('/stream', (req, res) => {
+        res.setHeader('Content-Type', 'text/event-stream');
+        res.setHeader('Cache-Control', 'no-cache');
+        res.setHeader('Connection', 'keep-alive');
+        res.flushHeaders();
+        const unsub = sim.onPublish((event) => {
+            res.write(`data: ${JSON.stringify(event)}\n\n`);
+        });
+        req.on('close', unsub);
+    });
+    app.get('/status', (_req, res) => {
+        const scenarioId = sim.getScenario();
+        const state = sim.getState();
+        res.json({
+            status: 'ok',
+            uptime: Math.floor((Date.now() - startTime) / 1000),
+            sources: config.sources.length,
+            metrics: totalMetrics,
+            scenario: {
+                id: scenarioId,
+                label: scenarios_1.SCENARIO_LABELS[scenarioId],
+                detail: scenarios_1.SCENARIO_DETAIL[scenarioId],
+            },
+            readings: state.metrics,
+            effects: sim.getEffectStates(),
+        });
+    });
+    const server = app.listen(PORT, () => {
+        logger_1.logger.info(`[http] :${PORT}`);
+        logger_1.logger.info(`       GET  /health  GET  /scenario  POST /scenario/:id`);
+        logger_1.logger.info(`       GET  /state   GET  /effects`);
+    });
+    server.on('error', (err) => {
+        if (err.code === 'EADDRINUSE') {
+            logger_1.logger.warn(`[http] port ${PORT} in use — HTTP unavailable, sim still running`);
+        }
+        else {
+            logger_1.logger.error('[http] error:', err);
+        }
+    });
+    // ── Stdin REPL ─────────────────────────────────────────────────────────────
+    if (process.stdin.isTTY) {
+        printMenu();
+        const rl = readline.createInterface({ input: process.stdin, output: process.stdout, prompt: 'scenario> ' });
+        rl.prompt();
+        rl.on('line', (line) => {
+            const input = line.trim().toLowerCase();
+            if (!input) {
+                rl.prompt();
+                return;
+            }
+            if (input === 'help') {
+                printMenu();
+                rl.prompt();
+                return;
+            }
+            if (input === 'status' || input === '?') {
+                const id = sim.getScenario();
+                logger_1.logger.info(`[scenario] ${id} — ${scenarios_1.SCENARIO_DETAIL[id]}`);
+                rl.prompt();
+                return;
+            }
+            const id = resolveScenarioId(input);
+            if (id)
+                sim.setScenario(id);
+            else
+                logger_1.logger.info(`Unknown: "${input}". Type help for options.`);
+            rl.prompt();
+        });
+        rl.on('close', () => logger_1.logger.info('[repl] stdin closed'));
+    }
+    // ── Graceful shutdown ──────────────────────────────────────────────────────
+    const shutdown = () => {
+        logger_1.logger.info('[shutdown] stopping...');
+        sim.stop();
+        client.end();
+        server.close(() => process.exit(0));
+    };
+    process.on('SIGTERM', shutdown);
+    process.on('SIGINT', shutdown);
+}
+main().catch((err) => {
+    logger_1.logger.error('[fatal]', err);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,mDAAqC;AACrC,2CAA6B;AAC7B,2CAA6B;AAC7B,sDAA8B;AAC9B,qCAAsC;AACtC,uCAAsD;AACtD,2CAA0E;AAC1E,2CAA0F;AAC1F,qCAAkC;AAElC,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC;AAEzD,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC;OACnG,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;OAChH,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;AAC9B,IAAI,WAAW;IAAE,eAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AAE9C,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;IACnE,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCX,CAAC,CAAC;IACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,SAAS,SAAS;IAChB,eAAM,CAAC,IAAI,CAAC,mEAAmE,CAAC,CAAC;IACjF,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,2BAAe,CAAC,EAAE,CAAC;QACnD,eAAM,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IACzC,CAAC;IACD,eAAM,CAAC,IAAI,CAAC,iEAAiE,CAAC,CAAC;IAC/E,eAAM,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAC;IAC9E,eAAM,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAC;IAC9E,eAAM,CAAC,IAAI,CAAC,mEAAmE,CAAC,CAAC;AACnF,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAa;IACtC,OAAO,yBAAa,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,IAAI,IAAI,CAAC;AAC3D,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC;WAC3F,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;IAExD,MAAM,UAAU,GAAG,SAAS;QAC1B,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC;QACzB,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAE/B,MAAM,MAAM,GAAG,IAAA,mBAAU,EAAC,UAAU,CAAC,CAAC;IAEtC,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC9E,eAAM,CAAC,IAAI,CACT,UAAU,MAAM,CAAC,OAAO,CAAC,MAAM,gBAAgB,YAAY,sBAAsB,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CACxH,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAK,UAAU;QAChD,CAAC,CAAC,IAAA,sBAAY,EAAC,MAAM,CAAC,QAAQ,CAAC;QAC/B,CAAC,CAAC,qBAAW,CAAC;IAEhB,MAAM,SAAS,GAAG,UAAU,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IACnE,MAAM,MAAM,GAAM,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC;IAErE,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC1C,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;QACxC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IACH,eAAM,CAAC,IAAI,CAAC,uBAAuB,SAAS,EAAE,CAAC,CAAC;IAEhD,MAAM,GAAG,GAAG,IAAA,0BAAc,EAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAEnD,6EAA6E;IAC7E,MAAM,GAAG,GAAS,IAAA,iBAAO,GAAE,CAAC;IAC5B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,GAAG,CAAC,GAAG,CAAC,iBAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAExB,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;QAC/B,GAAG,CAAC,IAAI,CAAC;YACP,MAAM,EAAI,IAAI;YACd,OAAO,EAAG,MAAM,CAAC,OAAO,CAAC,MAAM;YAC/B,OAAO,EAAG,YAAY;YACtB,MAAM,EAAI,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC;YACrD,QAAQ,EAAE,GAAG,CAAC,WAAW,EAAE;SAC5B,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;QACjC,MAAM,EAAE,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;QAC7B,GAAG,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,2BAAe,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,2BAAe,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACtF,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QACrC,MAAM,EAAE,GAAG,iBAAiB,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACrD,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;gBACnB,KAAK,EAAE,qBAAqB,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,MAAM,CAAC,IAAI,CAAC,yBAAa,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;aACjG,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QACD,MAAM,WAAW,GAAI,GAAG,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QAClD,MAAM,YAAY,GAAG,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAC5C,MAAM,eAAe,GACnB,OAAO,WAAW,KAAK,QAAQ,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC;YACvD,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC;YAC3B,CAAC,CAAC,SAAS,CAAC;QAChB,MAAM,SAAS,GACb,OAAO,YAAY,KAAK,QAAQ,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC;YACzD,CAAC,CAAC,YAAY;YACd,CAAC,CAAC,SAAS,CAAC;QAEhB,GAAG,CAAC,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,eAAe,IAAI,eAAe,GAAG,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QACrG,GAAG,CAAC,IAAI,CAAC;YACP,EAAE,EAAE,IAAI;YACR,QAAQ,EAAE,EAAE;YACZ,KAAK,EAAE,2BAAe,CAAC,EAAE,CAAC;YAC1B,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;YACrD,GAAG,CAAC,eAAe,IAAI,eAAe,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,sBAAsB,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC/F,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;QAC9B,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAmB,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;QAChC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QAC9B,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,mBAAmB,CAAC,CAAC;QACnD,GAAG,CAAC,SAAS,CAAC,eAAe,EAAE,UAAU,CAAC,CAAC;QAC3C,GAAG,CAAC,SAAS,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;QAC1C,GAAG,CAAC,YAAY,EAAE,CAAC;QAEnB,MAAM,KAAK,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,KAAmB,EAAE,EAAE;YAClD,GAAG,CAAC,KAAK,CAAC,SAAS,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;QAEH,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACzB,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;QAC/B,MAAM,UAAU,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,KAAK,GAAQ,GAAG,CAAC,QAAQ,EAAmB,CAAC;QACnD,GAAG,CAAC,IAAI,CAAC;YACP,MAAM,EAAK,IAAI;YACf,MAAM,EAAK,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC;YACtD,OAAO,EAAI,MAAM,CAAC,OAAO,CAAC,MAAM;YAChC,OAAO,EAAI,YAAY;YACvB,QAAQ,EAAE;gBACR,EAAE,EAAM,UAAU;gBAClB,KAAK,EAAG,2BAAe,CAAC,UAAU,CAAC;gBACnC,MAAM,EAAE,2BAAe,CAAC,UAAU,CAAC;aACpC;YACD,QAAQ,EAAE,KAAK,CAAC,OAAO;YACvB,OAAO,EAAG,GAAG,CAAC,eAAe,EAAE;SAChC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE;QACnC,eAAM,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;QAC/B,eAAM,CAAC,IAAI,CAAC,yDAAyD,CAAC,CAAC;QACvE,eAAM,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAA0B,EAAE,EAAE;QAChD,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAC9B,eAAM,CAAC,IAAI,CAAC,eAAe,IAAI,+CAA+C,CAAC,CAAC;QAClF,CAAC;aAAM,CAAC;YACN,eAAM,CAAC,KAAK,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;QACrC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,8EAA8E;IAC9E,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACxB,SAAS,EAAE,CAAC;QACZ,MAAM,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;QAC5G,EAAE,CAAC,MAAM,EAAE,CAAC;QACZ,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YACrB,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YACxC,IAAI,CAAC,KAAK,EAA+B,CAAC;gBAAC,EAAE,CAAC,MAAM,EAAE,CAAC;gBAAC,OAAO;YAAC,CAAC;YACjE,IAAI,KAAK,KAAK,MAAM,EAAqB,CAAC;gBAAC,SAAS,EAAE,CAAC;gBAAC,EAAE,CAAC,MAAM,EAAE,CAAC;gBAAC,OAAO;YAAC,CAAC;YAC9E,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;gBACxC,MAAM,EAAE,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;gBAC7B,eAAM,CAAC,IAAI,CAAC,cAAc,EAAE,MAAM,2BAAe,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;gBACzD,EAAE,CAAC,MAAM,EAAE,CAAC;gBAAC,OAAO;YACtB,CAAC;YACD,MAAM,EAAE,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;YACpC,IAAI,EAAE;gBAAE,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;;gBACpB,eAAM,CAAC,IAAI,CAAC,aAAa,KAAK,2BAA2B,CAAC,CAAC;YACnE,EAAE,CAAC,MAAM,EAAE,CAAC;QACd,CAAC,CAAC,CAAC;QACH,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,eAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED,8EAA8E;IAC9E,MAAM,QAAQ,GAAG,GAAG,EAAE;QACpB,eAAM,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QACtC,GAAG,CAAC,IAAI,EAAE,CAAC;QACX,MAAM,CAAC,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACtC,CAAC,CAAC;IACF,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAG,QAAQ,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,eAAM,CAAC,KAAK,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IAC7B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,37 @@
+import { SensorMode, SensorRange } from './sensors';
+import { EffectConfig } from './effects';
+import { EncodingConfig } from './encoder';
+export interface MetricConfig {
+    name: string;
+    units: string;
+    mode: SensorMode;
+    range: SensorRange;
+    baseline?: number;
+    amplitude?: number;
+    periodSeconds?: number;
+    driftRate?: number;
+    min?: number;
+    max?: number;
+    intervalMs?: number;
+    spikeProbability?: number;
+    spikeMagnitude?: number;
+}
+export interface SourceConfig {
+    labels: Record<string, string>;
+    topic: string;
+    metrics: MetricConfig[];
+    effects?: EffectConfig[];
+}
+export interface SimulatorConfig {
+    mqtt: {
+        host: string;
+        port: number;
+    };
+    publishIntervalMs: number;
+    encoding: EncodingConfig;
+    sources: SourceConfig[];
+}
+declare function resolveTopicTemplate(template: string, labels: Record<string, string>): string;
+export { resolveTopicTemplate };
+export declare function loadConfig(configPath?: string): SimulatorConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE3C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,cAAc,CAAC;IACzB,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAED,iBAAS,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAEtF;AAED,OAAO,EAAE,oBAAoB,EAAE,CAAC;AAEhC,wBAAgB,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,eAAe,CAsC/D"}