mqtt-scenario-sim 1.0.0

package/dist/config.js

@@ -0,0 +1,77 @@
+"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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveTopicTemplate = resolveTopicTemplate;
+exports.loadConfig = loadConfig;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const yaml = __importStar(require("js-yaml"));
+function resolveTopicTemplate(template, labels) {
+    return template.replace(/\{(\w+)\}/g, (_, key) => labels[key] ?? key);
+}
+function loadConfig(configPath) {
+    const filePath = configPath ?? path.join(__dirname, '..', 'examples', 'minimal.yaml');
+    const raw = fs.readFileSync(filePath, 'utf-8');
+    const cfg = yaml.load(raw);
+    const mqtt = {
+        host: process.env['MQTT_HOST'] ?? cfg.mqtt?.host ?? 'localhost',
+        port: process.env['MQTT_PORT']
+            ? parseInt(process.env['MQTT_PORT'], 10)
+            : (cfg.mqtt?.port ?? 1883),
+    };
+    const publishIntervalMs = process.env['PUBLISH_INTERVAL_MS']
+        ? parseInt(process.env['PUBLISH_INTERVAL_MS'], 10)
+        : (cfg.publishIntervalMs ?? 5000);
+    const encodingType = (process.env['ENCODING'] ?? cfg.encoding?.type ?? 'json');
+    const encoding = {
+        type: encodingType,
+        protoFile: process.env['PROTO_FILE'] ?? cfg.encoding?.protoFile,
+        messageType: process.env['PROTO_MESSAGE_TYPE'] ?? cfg.encoding?.messageType,
+        fieldMap: process.env['PROTO_FIELD_MAP']
+            ? JSON.parse(process.env['PROTO_FIELD_MAP'])
+            : cfg.encoding?.fieldMap,
+    };
+    const sources = (cfg.sources ?? []).map((s) => ({
+        labels: s.labels ?? {},
+        topic: s.topic ?? '',
+        metrics: s.metrics ?? [],
+        effects: s.effects,
+    }));
+    if (sources.length === 0) {
+        throw new Error('Config must define at least one source.');
+    }
+    return { mqtt, publishIntervalMs, encoding, sources };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4CS,oDAAoB;AAE7B,gCAsCC;AApFD,uCAAyB;AACzB,2CAA6B;AAC7B,8CAAgC;AAsChC,SAAS,oBAAoB,CAAC,QAAgB,EAAE,MAA8B;IAC5E,OAAO,QAAQ,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC;AACxE,CAAC;AAID,SAAgB,UAAU,CAAC,UAAmB;IAC5C,MAAM,QAAQ,GAAG,UAAU,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,cAAc,CAAC,CAAC;IACtF,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAA6B,CAAC;IAEvD,MAAM,IAAI,GAAG;QACX,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,IAAI,IAAI,WAAW;QAC/D,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;YAC5B,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,EAAE,CAAC;YACxC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,IAAI,IAAI,CAAC;KAC7B,CAAC;IAEF,MAAM,iBAAiB,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC;QAC1D,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,EAAE,EAAE,CAAC;QAClD,CAAC,CAAC,CAAC,GAAG,CAAC,iBAAiB,IAAI,IAAI,CAAC,CAAC;IAEpC,MAAM,YAAY,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,GAAG,CAAC,QAAQ,EAAE,IAAI,IAAI,MAAM,CAAwB,CAAC;IACtG,MAAM,QAAQ,GAAmB;QAC/B,IAAI,EAAE,YAAY;QAClB,SAAS,EAAI,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,IAAY,GAAG,CAAC,QAAQ,EAAE,SAAS;QACzE,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,IAAI,GAAG,CAAC,QAAQ,EAAE,WAAW;QAC3E,QAAQ,EAAK,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;YACzC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;YAC5C,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ;KAC3B,CAAC;IAEF,MAAM,OAAO,GAAmB,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC9D,MAAM,EAAG,CAAC,CAAC,MAAM,IAAI,EAAE;QACvB,KAAK,EAAI,CAAC,CAAC,KAAK,IAAI,EAAE;QACtB,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,EAAE;QACxB,OAAO,EAAE,CAAC,CAAC,OAAO;KACnB,CAAC,CAAC,CAAC;IAEJ,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;AACxD,CAAC"}

package/dist/effects.d.ts

@@ -0,0 +1,12 @@
+export interface EffectConfig {
+    name: string;
+    effects: Record<string, number>;
+}
+export type EffectState = Record<string, boolean>;
+export declare function computeBias(effectConfigs: EffectConfig[], activeEffects: EffectState, metric: string, span: number): number;
+export declare function parseEffectCommand(raw: unknown): {
+    effect: string;
+    state: boolean;
+} | null;
+export declare function applyEffect(state: EffectState, effect: string, on: boolean): EffectState;
+//# sourceMappingURL=effects.d.ts.map

package/dist/effects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effects.d.ts","sourceRoot":"","sources":["../src/effects.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAElD,wBAAgB,WAAW,CACzB,aAAa,EAAE,YAAY,EAAE,EAC7B,aAAa,EAAE,WAAW,EAC1B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,GACX,MAAM,CAQR;AAED,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,OAAO,GACX;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAM3C;AAED,wBAAgB,WAAW,CACzB,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,OAAO,GACV,WAAW,CAEb"}

package/dist/effects.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeBias = computeBias;
+exports.parseEffectCommand = parseEffectCommand;
+exports.applyEffect = applyEffect;
+function computeBias(effectConfigs, activeEffects, metric, span) {
+    let bias = 0;
+    for (const cfg of effectConfigs) {
+        if (activeEffects[cfg.name] && cfg.effects[metric] !== undefined) {
+            bias += cfg.effects[metric] * span;
+        }
+    }
+    return bias;
+}
+function parseEffectCommand(raw) {
+    if (typeof raw !== 'object' || raw === null)
+        return null;
+    const msg = raw;
+    if (typeof msg['effect'] !== 'string')
+        return null;
+    if (typeof msg['state'] !== 'boolean')
+        return null;
+    return { effect: msg['effect'], state: msg['state'] };
+}
+function applyEffect(state, effect, on) {
+    return { ...state, [effect]: on };
+}
+//# sourceMappingURL=effects.js.map

package/dist/effects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"effects.js","sourceRoot":"","sources":["../src/effects.ts"],"names":[],"mappings":";;AAOA,kCAaC;AAED,gDAQC;AAED,kCAMC;AA/BD,SAAgB,WAAW,CACzB,aAA6B,EAC7B,aAA0B,EAC1B,MAAc,EACd,IAAY;IAEZ,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;QAChC,IAAI,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,SAAS,EAAE,CAAC;YACjE,IAAI,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,CAAE,GAAG,IAAI,CAAC;QACtC,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAgB,kBAAkB,CAChC,GAAY;IAEZ,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACzD,MAAM,GAAG,GAAG,GAA8B,CAAC;IAC3C,IAAI,OAAO,GAAG,CAAC,QAAQ,CAAC,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACnD,IAAI,OAAO,GAAG,CAAC,OAAO,CAAC,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACnD,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAW,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,CAAY,EAAE,CAAC;AAC7E,CAAC;AAED,SAAgB,WAAW,CACzB,KAAkB,EAClB,MAAc,EACd,EAAW;IAEX,OAAO,EAAE,GAAG,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC;AACpC,CAAC"}

package/dist/encoder.d.ts

@@ -0,0 +1,17 @@
+export interface Reading {
+    labels: Record<string, string>;
+    metric: string;
+    value: number;
+    units: string;
+    timestamp: number;
+}
+export type EncodeFunction = (reading: Reading) => Buffer | Promise<Buffer>;
+export interface EncodingConfig {
+    type: 'json' | 'protobuf';
+    protoFile?: string;
+    messageType?: string;
+    fieldMap?: Record<string, string>;
+}
+export declare function buildEncoder(config: EncodingConfig): EncodeFunction;
+export declare const jsonEncoder: EncodeFunction;
+//# sourceMappingURL=encoder.d.ts.map

package/dist/encoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoder.d.ts","sourceRoot":"","sources":["../src/encoder.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;AAE5E,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAuBD,wBAAgB,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,CA4BnE;AAED,eAAO,MAAM,WAAW,EAAE,cACsC,CAAC"}

package/dist/encoder.js

@@ -0,0 +1,86 @@
+"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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.jsonEncoder = void 0;
+exports.buildEncoder = buildEncoder;
+const path = __importStar(require("path"));
+const protobuf = __importStar(require("protobufjs"));
+function applyFieldMap(reading, fieldMap) {
+    if (!fieldMap) {
+        return { ...reading.labels, ...reading };
+    }
+    const flat = { ...reading.labels, ...reading };
+    const mapped = {};
+    for (const [from, to] of Object.entries(fieldMap)) {
+        if (flat[from] !== undefined) {
+            mapped[to] = flat[from];
+        }
+    }
+    // Pass through unmapped fields
+    for (const [k, v] of Object.entries(flat)) {
+        if (!fieldMap[k])
+            mapped[k] = v;
+    }
+    return mapped;
+}
+function buildEncoder(config) {
+    if (config.type === 'json') {
+        return (reading) => Buffer.from(JSON.stringify(applyFieldMap(reading, config.fieldMap)));
+    }
+    if (!config.protoFile) {
+        throw new Error('encoding.protoFile is required when encoding.type is "protobuf"');
+    }
+    if (!config.messageType) {
+        throw new Error('encoding.messageType is required when encoding.type is "protobuf"');
+    }
+    const protoFile = path.resolve(config.protoFile);
+    const messageType = config.messageType;
+    const fieldMap = config.fieldMap;
+    let cachedType = null;
+    return async (reading) => {
+        if (!cachedType) {
+            const root = await protobuf.load(protoFile);
+            cachedType = root.lookupType(messageType);
+        }
+        const msg = applyFieldMap(reading, fieldMap);
+        const errMsg = cachedType.verify(msg);
+        if (errMsg)
+            throw new Error(`Protobuf verify failed: ${errMsg}`);
+        return Buffer.from(cachedType.encode(cachedType.create(msg)).finish());
+    };
+}
+const jsonEncoder = (reading) => Buffer.from(JSON.stringify({ ...reading.labels, ...reading }));
+exports.jsonEncoder = jsonEncoder;
+//# sourceMappingURL=encoder.js.map

package/dist/encoder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoder.js","sourceRoot":"","sources":["../src/encoder.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyCA,oCA4BC;AArED,2CAA6B;AAC7B,qDAAuC;AAmBvC,SAAS,aAAa,CACpB,OAAgB,EAChB,QAA4C;IAE5C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,OAAO,EAAE,CAAC;IAC3C,CAAC;IACD,MAAM,IAAI,GAA4B,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,OAAO,EAAE,CAAC;IACxE,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAClD,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;YAC7B,MAAM,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IACD,+BAA+B;IAC/B,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1C,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;YAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAgB,YAAY,CAAC,MAAsB;IACjD,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC3B,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC3F,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;IACrF,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAC;IACvF,CAAC;IAED,MAAM,SAAS,GAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,MAAM,WAAW,GAAI,MAAM,CAAC,WAAW,CAAC;IACxC,MAAM,QAAQ,GAAO,MAAM,CAAC,QAAQ,CAAC;IAErC,IAAI,UAAU,GAAyB,IAAI,CAAC;IAE5C,OAAO,KAAK,EAAE,OAAO,EAAE,EAAE;QACvB,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC5C,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QAC5C,CAAC;QACD,MAAM,GAAG,GAAM,aAAa,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACtC,IAAI,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,MAAM,EAAE,CAAC,CAAC;QACjE,OAAO,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IACzE,CAAC,CAAC;AACJ,CAAC;AAEM,MAAM,WAAW,GAAmB,CAAC,OAAO,EAAE,EAAE,CACrD,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC,CAAC;AADpD,QAAA,WAAW,eACyC"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export { startSimulator } from './simulator';
+export type { Simulator, StateSnapshot, MetricSnapshot, PublishEvent } from './simulator';
+export { buildEncoder, jsonEncoder } from './encoder';
+export type { EncodeFunction, EncodingConfig, Reading } from './encoder';
+export { loadConfig } from './config';
+export type { SimulatorConfig, SourceConfig, MetricConfig } from './config';
+export type { EffectConfig, EffectState } from './effects';
+export type { ScenarioId } from './scenarios';
+export { SCENARIO_KEYS, SCENARIO_LABELS, SCENARIO_DETAIL } from './scenarios';
+export type { SensorMode, SensorRange } from './sensors';
+export { logger } from './logger';
+export type { LogLevel } from './logger';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC1F,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACtD,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzE,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC5E,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC3D,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9E,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,YAAY,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = exports.SCENARIO_DETAIL = exports.SCENARIO_LABELS = exports.SCENARIO_KEYS = exports.loadConfig = exports.jsonEncoder = exports.buildEncoder = exports.startSimulator = void 0;
+var simulator_1 = require("./simulator");
+Object.defineProperty(exports, "startSimulator", { enumerable: true, get: function () { return simulator_1.startSimulator; } });
+var encoder_1 = require("./encoder");
+Object.defineProperty(exports, "buildEncoder", { enumerable: true, get: function () { return encoder_1.buildEncoder; } });
+Object.defineProperty(exports, "jsonEncoder", { enumerable: true, get: function () { return encoder_1.jsonEncoder; } });
+var config_1 = require("./config");
+Object.defineProperty(exports, "loadConfig", { enumerable: true, get: function () { return config_1.loadConfig; } });
+var scenarios_1 = require("./scenarios");
+Object.defineProperty(exports, "SCENARIO_KEYS", { enumerable: true, get: function () { return scenarios_1.SCENARIO_KEYS; } });
+Object.defineProperty(exports, "SCENARIO_LABELS", { enumerable: true, get: function () { return scenarios_1.SCENARIO_LABELS; } });
+Object.defineProperty(exports, "SCENARIO_DETAIL", { enumerable: true, get: function () { return scenarios_1.SCENARIO_DETAIL; } });
+var logger_1 = require("./logger");
+Object.defineProperty(exports, "logger", { enumerable: true, get: function () { return logger_1.logger; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,yCAA6C;AAApC,2GAAA,cAAc,OAAA;AAEvB,qCAAsD;AAA7C,uGAAA,YAAY,OAAA;AAAE,sGAAA,WAAW,OAAA;AAElC,mCAAsC;AAA7B,oGAAA,UAAU,OAAA;AAInB,yCAA8E;AAArE,0GAAA,aAAa,OAAA;AAAE,4GAAA,eAAe,OAAA;AAAE,4GAAA,eAAe,OAAA;AAExD,mCAAkC;AAAzB,gGAAA,MAAM,OAAA"}

package/dist/logger.d.ts

@@ -0,0 +1,9 @@
+export type LogLevel = 'silent' | 'error' | 'warn' | 'info' | 'debug';
+export declare const logger: {
+    setLevel(level: string): void;
+    debug(...args: unknown[]): void;
+    info(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    error(...args: unknown[]): void;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AActE,eAAO,MAAM,MAAM;oBACD,MAAM,GAAG,IAAI;mBASd,OAAO,EAAE,GAAG,IAAI;kBACjB,OAAO,EAAE,GAAG,IAAI;kBAChB,OAAO,EAAE,GAAG,IAAI;mBACf,OAAO,EAAE,GAAG,IAAI;CAChC,CAAC"}

package/dist/logger.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = void 0;
+const LEVELS = {
+    silent: 0,
+    error: 1,
+    warn: 2,
+    info: 3,
+    debug: 4,
+};
+const VALID_LEVELS = Object.keys(LEVELS);
+let current = LEVELS['info'];
+exports.logger = {
+    setLevel(level) {
+        const l = level.toLowerCase();
+        if (!VALID_LEVELS.includes(l)) {
+            console.warn(`[logger] unknown level "${level}", using "info". Valid: ${VALID_LEVELS.join(', ')}`);
+            return;
+        }
+        current = LEVELS[l];
+    },
+    debug(...args) { if (current >= 4)
+        console.log(...args); },
+    info(...args) { if (current >= 3)
+        console.log(...args); },
+    warn(...args) { if (current >= 2)
+        console.warn(...args); },
+    error(...args) { if (current >= 1)
+        console.error(...args); },
+};
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":";;;AAEA,MAAM,MAAM,GAA6B;IACvC,MAAM,EAAE,CAAC;IACT,KAAK,EAAG,CAAC;IACT,IAAI,EAAI,CAAC;IACT,IAAI,EAAI,CAAC;IACT,KAAK,EAAG,CAAC;CACV,CAAC;AAEF,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAe,CAAC;AAEvD,IAAI,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;AAEhB,QAAA,MAAM,GAAG;IACpB,QAAQ,CAAC,KAAa;QACpB,MAAM,CAAC,GAAG,KAAK,CAAC,WAAW,EAAc,CAAC;QAC1C,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9B,OAAO,CAAC,IAAI,CAAC,2BAA2B,KAAK,2BAA2B,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACnG,OAAO;QACT,CAAC;QACD,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,GAAG,IAAe,IAAU,IAAI,OAAO,IAAI,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAC3E,IAAI,CAAC,GAAG,IAAe,IAAW,IAAI,OAAO,IAAI,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAC3E,IAAI,CAAC,GAAG,IAAe,IAAW,IAAI,OAAO,IAAI,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAC5E,KAAK,CAAC,GAAG,IAAe,IAAU,IAAI,OAAO,IAAI,CAAC;QAAE,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;CAC9E,CAAC"}

package/dist/scenarios.d.ts

@@ -0,0 +1,7 @@
+import { ResolvedRange } from './sensors';
+export type ScenarioId = 'normal' | 'out_of_range' | 'trending_to_breach' | 'stable_healthy' | 'recovery' | 'oscillating';
+export declare const SCENARIO_KEYS: Record<string, ScenarioId>;
+export declare const SCENARIO_LABELS: Record<ScenarioId, string>;
+export declare const SCENARIO_DETAIL: Record<ScenarioId, string>;
+export declare function scenarioValue(id: ScenarioId, resolved: ResolvedRange, tick: number, rand: number): number | null;
+//# sourceMappingURL=scenarios.d.ts.map

package/dist/scenarios.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenarios.d.ts","sourceRoot":"","sources":["../src/scenarios.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,MAAM,UAAU,GAClB,QAAQ,GACR,cAAc,GACd,oBAAoB,GACpB,gBAAgB,GAChB,UAAU,GACV,aAAa,CAAC;AAElB,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAcpD,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAOtD,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAgBtD,CAAC;AAEF,wBAAgB,aAAa,CAC3B,EAAE,EAAE,UAAU,EACd,QAAQ,EAAE,aAAa,EACvB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,MAAM,GAAG,IAAI,CAkCf"}

package/dist/scenarios.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SCENARIO_DETAIL = exports.SCENARIO_LABELS = exports.SCENARIO_KEYS = void 0;
+exports.scenarioValue = scenarioValue;
+exports.SCENARIO_KEYS = {
+    '0': 'normal',
+    'n': 'normal',
+    'normal': 'normal',
+    '1': 'out_of_range',
+    'out_of_range': 'out_of_range',
+    '2': 'trending_to_breach',
+    'trending_to_breach': 'trending_to_breach',
+    '3': 'stable_healthy',
+    'stable_healthy': 'stable_healthy',
+    '4': 'recovery',
+    'recovery': 'recovery',
+    '5': 'oscillating',
+    'oscillating': 'oscillating',
+};
+exports.SCENARIO_LABELS = {
+    normal: "0 / n  — Normal (uses each metric's configured mode)",
+    out_of_range: '1      — Out of range       (values 30% above max)',
+    trending_to_breach: '2      — Trending to breach  (rising toward max; visible after ~2 min)',
+    stable_healthy: '3      — Stable & healthy    (held at midpoint ideal)',
+    recovery: '4      — Recovery            (starts out-of-range, decays to ideal over ~5 min)',
+    oscillating: '5      — Oscillating         (±10% swing around ideal)',
+};
+exports.SCENARIO_DETAIL = {
+    normal: "Each metric runs its configured mode: sinusoidal, drift, normal, or spike.",
+    out_of_range: 'All metrics emit 30% above their max boundary. Tests threshold breach detection.',
+    trending_to_breach: 'Metrics rise from 70% toward 99% of max (0.5% of span per tick). ' +
+        'Tests early-warning alert logic. Allow ~2 min for analysis caches to fill.',
+    stable_healthy: 'All metrics held at their midpoint ideal (±0.3% noise). Tests steady-state handling.',
+    recovery: 'Starts 30% above max; decays linearly to midpoint ideal over ~5 min. ' +
+        'Tests resolved-alert and recovery detection.',
+    oscillating: 'Rapid ±10% oscillation around midpoint ideal (full cycle every 8 ticks). ' +
+        'Tests alert flapping suppression and jitter handling.',
+};
+function scenarioValue(id, resolved, tick, rand) {
+    if (id === 'normal')
+        return null;
+    const { min, max } = resolved;
+    const span = max - min;
+    const ideal = (min + max) / 2;
+    switch (id) {
+        case 'out_of_range':
+            return round2(max + span * 0.30);
+        case 'trending_to_breach': {
+            const start = min + span * 0.70;
+            const ceiling = min + span * 0.99;
+            const rising = Math.min(start + tick * span * 0.005, ceiling);
+            return round2(rising + (rand - 0.5) * span * 0.003);
+        }
+        case 'stable_healthy':
+            return round2(ideal + (rand - 0.5) * span * 0.003);
+        case 'recovery': {
+            const DECAY_TICKS = 60;
+            const start = max + span * 0.30;
+            const progress = Math.min(tick / DECAY_TICKS, 1);
+            return round2(start + (ideal - start) * progress + (rand - 0.5) * span * 0.003);
+        }
+        case 'oscillating': {
+            const amplitude = span * 0.10;
+            const wave = Math.sin((2 * Math.PI * tick) / 8) * amplitude;
+            return round2(ideal + wave + (rand - 0.5) * span * 0.005);
+        }
+    }
+}
+function round2(v) {
+    return Math.round(v * 100) / 100;
+}
+//# sourceMappingURL=scenarios.js.map

package/dist/scenarios.js.map

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

package/dist/sensors.d.ts

@@ -0,0 +1,52 @@
+export type SensorMode = 'sinusoidal' | 'normal' | 'drift' | 'spike';
+export interface SensorRange {
+    low: number;
+    high: number;
+}
+export interface ResolvedRange {
+    baseline: number;
+    amplitude: number;
+    min: number;
+    max: number;
+    driftRate: number;
+    spikeProbability: number;
+    spikeMagnitude: number;
+}
+export interface SensorState {
+    config: {
+        mode: SensorMode;
+        periodSeconds: number;
+        intervalMs: number;
+    };
+    resolved: ResolvedRange;
+    phase: number;
+    driftValue: number;
+    currentBias: number;
+    lastValue: number | null;
+    lastPublishedAt: number | null;
+}
+export declare function resolveRange(range: SensorRange, overrides?: {
+    baseline?: number;
+    amplitude?: number;
+    driftRate?: number;
+    spikeProbability?: number;
+    spikeMagnitude?: number;
+    min?: number;
+    max?: number;
+}): ResolvedRange;
+export declare function createSensorState(cfg: {
+    mode: SensorMode;
+    range: SensorRange;
+    baseline?: number;
+    amplitude?: number;
+    driftRate?: number;
+    spikeProbability?: number;
+    spikeMagnitude?: number;
+    min?: number;
+    max?: number;
+    periodSeconds?: number;
+    intervalMs: number;
+}): SensorState;
+export declare function nextValue(state: SensorState, bias?: number): number;
+export declare function advanceBias(state: SensorState, target: number): void;
+//# sourceMappingURL=sensors.d.ts.map

package/dist/sensors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sensors.d.ts","sourceRoot":"","sources":["../src/sensors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,YAAY,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAC;AAErE,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE;QACN,IAAI,EAAE,UAAU,CAAC;QACjB,aAAa,EAAE,MAAM,CAAC;QACtB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,QAAQ,EAAE,aAAa,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,wBAAgB,YAAY,CAC1B,KAAK,EAAE,WAAW,EAClB,SAAS,GAAE;IACT,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACT,GACL,aAAa,CAWf;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE;IACrC,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,WAAW,CAed;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,GAAE,MAAU,GAAG,MAAM,CAuCtE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAGpE"}

package/dist/sensors.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveRange = resolveRange;
+exports.createSensorState = createSensorState;
+exports.nextValue = nextValue;
+exports.advanceBias = advanceBias;
+function resolveRange(range, overrides = {}) {
+    const span = range.high - range.low;
+    return {
+        baseline: overrides.baseline ?? (range.low + range.high) / 2,
+        amplitude: overrides.amplitude ?? span / 2,
+        min: overrides.min ?? range.low,
+        max: overrides.max ?? range.high,
+        driftRate: overrides.driftRate ?? span * 0.002,
+        spikeProbability: overrides.spikeProbability ?? 0.03,
+        spikeMagnitude: overrides.spikeMagnitude ?? span * 0.25,
+    };
+}
+function createSensorState(cfg) {
+    const resolved = resolveRange(cfg.range, cfg);
+    return {
+        config: {
+            mode: cfg.mode,
+            periodSeconds: cfg.periodSeconds ?? 3600,
+            intervalMs: cfg.intervalMs,
+        },
+        resolved,
+        phase: Math.random() * 2 * Math.PI,
+        driftValue: resolved.baseline,
+        currentBias: 0,
+        lastValue: null,
+        lastPublishedAt: null,
+    };
+}
+function nextValue(state, bias = 0) {
+    const { resolved, config } = state;
+    const { baseline, amplitude, min, max } = resolved;
+    let raw;
+    switch (config.mode) {
+        case 'sinusoidal': {
+            const ticksPerPeriod = (config.periodSeconds * 1000) / config.intervalMs;
+            state.phase += (2 * Math.PI) / ticksPerPeriod;
+            raw = baseline + amplitude * Math.sin(state.phase);
+            break;
+        }
+        case 'normal': {
+            const u1 = Math.random(), u2 = Math.random();
+            const z = Math.sqrt(-2 * Math.log(u1)) * Math.cos(2 * Math.PI * u2);
+            raw = baseline + (amplitude * 0.3) * z;
+            break;
+        }
+        case 'drift': {
+            state.driftValue += resolved.driftRate * (Math.random() > 0.5 ? 1 : -1);
+            if (state.driftValue > max)
+                state.driftValue = max - resolved.driftRate;
+            if (state.driftValue < min)
+                state.driftValue = min + resolved.driftRate;
+            raw = state.driftValue;
+            break;
+        }
+        case 'spike': {
+            const spike = Math.random() < resolved.spikeProbability
+                ? (Math.random() > 0.5 ? 1 : -1) * resolved.spikeMagnitude
+                : 0;
+            const u1 = Math.random(), u2 = Math.random();
+            const z = Math.sqrt(-2 * Math.log(u1)) * Math.cos(2 * Math.PI * u2);
+            raw = baseline + (amplitude * 0.2) * z + spike;
+            break;
+        }
+    }
+    const clamped = Math.max(min, Math.min(max, raw + bias));
+    return Math.round(clamped * 100) / 100;
+}
+function advanceBias(state, target) {
+    const alpha = 0.2;
+    state.currentBias = state.currentBias + alpha * (target - state.currentBias);
+}
+//# sourceMappingURL=sensors.js.map

package/dist/sensors.js.map

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

package/dist/simulator.d.ts

@@ -0,0 +1,35 @@
+import * as mqtt from 'mqtt';
+import { SimulatorConfig } from './config';
+import { EncodeFunction } from './encoder';
+import { ScenarioId } from './scenarios';
+import { EffectState } from './effects';
+export interface MetricSnapshot {
+    labels: Record<string, string>;
+    metric: string;
+    units: string;
+    value: number | null;
+    lastPublishedAt: number | null;
+}
+export interface StateSnapshot {
+    scenario: ScenarioId;
+    metrics: MetricSnapshot[];
+}
+export interface PublishEvent {
+    labels: Record<string, string>;
+    topic: string;
+    metric: string;
+    units: string;
+    value: number;
+    scenario: ScenarioId;
+    timestamp: number;
+}
+export interface Simulator {
+    stop(): void;
+    setScenario(id: ScenarioId, sourceKey?: string, durationSeconds?: number): void;
+    getScenario(sourceKey?: string): ScenarioId;
+    getState(): StateSnapshot;
+    getEffectStates(): Record<string, EffectState>;
+    onPublish(listener: (event: PublishEvent) => void): () => void;
+}
+export declare function startSimulator(config: SimulatorConfig, client: mqtt.MqttClient, encode: EncodeFunction): Simulator;
+//# sourceMappingURL=simulator.d.ts.map

package/dist/simulator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simulator.d.ts","sourceRoot":"","sources":["../src/simulator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAoD,MAAM,UAAU,CAAC;AAE7F,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAkC,MAAM,aAAa,CAAC;AACzE,OAAO,EAAgB,WAAW,EAAgD,MAAM,WAAW,CAAC;AAGpG,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,UAAU,CAAC;IACrB,OAAO,EAAE,cAAc,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,UAAU,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,IAAI,IAAI,CAAC;IACb,WAAW,CAAC,EAAE,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChF,WAAW,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IAC5C,QAAQ,IAAI,aAAa,CAAC;IAC1B,eAAe,IAAI,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC/C,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CAChE;AAgBD,wBAAgB,cAAc,CAC5B,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,IAAI,CAAC,UAAU,EACvB,MAAM,EAAE,cAAc,GACrB,SAAS,CAoJX"}