@djodjonx/x32-simulator 0.0.6 → 0.0.7

package/dist/server.cjs

@@ -1,12 +1,164 @@
 #!/usr/bin/env node
-const require_SchemaRegistry = require('./SchemaRegistry-DE6iObDv.cjs');
+const require_SchemaRegistry = require('./SchemaRegistry-Ddy5AEKs.cjs');
 let node_readline = require("node:readline");
 node_readline = require_SchemaRegistry.__toESM(node_readline);
 let node_fs = require("node:fs");
 node_fs = require_SchemaRegistry.__toESM(node_fs);
 let node_path = require("node:path");
 node_path = require_SchemaRegistry.__toESM(node_path);
+let node_fs_promises = require("node:fs/promises");
 
+//#region src/infrastructure/repositories/JsonFileStateRepository.ts
+/**
+* JSON file-based state repository.
+* Persists state to a JSON file on disk.
+* Supports auto-save and manual flush.
+*/
+var JsonFileStateRepository = class {
+	state = /* @__PURE__ */ new Map();
+	dirty = false;
+	autoSaveTimer = null;
+	saving = false;
+	/**
+	* Creates a new JSON file repository.
+	* @param filePath - Path to the JSON file.
+	* @param autoSaveInterval - Auto-save interval in ms (0 = disabled).
+	*/
+	constructor(filePath, autoSaveInterval = 5e3) {
+		this.filePath = filePath;
+		this.autoSaveInterval = autoSaveInterval;
+		if (this.autoSaveInterval > 0) this.startAutoSave();
+	}
+	/**
+	* Starts the auto-save timer.
+	*/
+	startAutoSave() {
+		this.autoSaveTimer = setInterval(async () => {
+			if (this.dirty && !this.saving) await this.flush();
+		}, this.autoSaveInterval);
+		this.autoSaveTimer.unref();
+	}
+	/**
+	* Stops the auto-save timer.
+	*/
+	stopAutoSave() {
+		if (this.autoSaveTimer) {
+			clearInterval(this.autoSaveTimer);
+			this.autoSaveTimer = null;
+		}
+	}
+	/**
+	* Checks if the file exists.
+	*/
+	async fileExists() {
+		try {
+			await (0, node_fs_promises.access)(this.filePath, node_fs.constants.F_OK);
+			return true;
+		} catch {
+			return false;
+		}
+	}
+	/**
+	* Loads state from JSON file.
+	*/
+	async load() {
+		if (await this.fileExists()) try {
+			const content = await (0, node_fs_promises.readFile)(this.filePath, "utf-8");
+			const data = JSON.parse(content);
+			this.state.clear();
+			for (const [key, value] of Object.entries(data)) this.state.set(key, value);
+			this.dirty = false;
+			return data;
+		} catch (error) {
+			console.error(`[JsonFileStateRepository] Failed to load state from ${this.filePath}:`, error);
+			return {};
+		}
+		return {};
+	}
+	/**
+	* Saves complete state to JSON file.
+	*/
+	async save(state) {
+		this.state.clear();
+		for (const [key, value] of Object.entries(state)) this.state.set(key, value);
+		this.dirty = true;
+		await this.flush();
+	}
+	/**
+	* Gets a single value.
+	*/
+	get(address) {
+		return this.state.get(address);
+	}
+	/**
+	* Sets a single value and marks as dirty.
+	*/
+	set(address, value) {
+		this.state.set(address, value);
+		this.dirty = true;
+	}
+	/**
+	* Gets all entries.
+	*/
+	getAll() {
+		const result = {};
+		this.state.forEach((value, key) => {
+			result[key] = value;
+		});
+		return result;
+	}
+	/**
+	* Resets state to defaults and marks as dirty.
+	*/
+	reset(defaults) {
+		this.state.clear();
+		for (const [key, value] of Object.entries(defaults)) this.state.set(key, value);
+		this.dirty = true;
+	}
+	/**
+	* Writes state to JSON file if dirty.
+	*/
+	async flush() {
+		if (!this.dirty || this.saving) return;
+		this.saving = true;
+		try {
+			const data = this.getAll();
+			const json = JSON.stringify(data, null, 2);
+			await (0, node_fs_promises.writeFile)(this.filePath, json, "utf-8");
+			this.dirty = false;
+		} catch (error) {
+			console.error(`[JsonFileStateRepository] Failed to save state to ${this.filePath}:`, error);
+		} finally {
+			this.saving = false;
+		}
+	}
+	/**
+	* Cleanup: stop auto-save and flush pending changes.
+	*/
+	async dispose() {
+		this.stopAutoSave();
+		await this.flush();
+	}
+};
+
+//#endregion
+//#region src/infrastructure/repositories/StateRepositoryFactory.ts
+/**
+* Creates a state repository based on configuration.
+* @param config - Repository configuration.
+* @returns The configured state repository.
+*/
+function createStateRepository(config) {
+	switch (config.type) {
+		case "json":
+			if (!config.filePath) throw new Error("JSON repository requires a filePath");
+			return new JsonFileStateRepository(config.filePath, config.autoSaveInterval ?? 5e3);
+		case "memory":
+		default: return new require_SchemaRegistry.InMemoryStateRepository();
+	}
+}
+
+//#endregion
 //#region src/presentation/cli/server.ts
 const loadEnv = () => {
 	try {
@@ -28,6 +180,8 @@ const parseArgs = (argv) => {
 	const args = argv.slice(2);
 	let cliPort;
 	let cliHost;
+	let storageType = "memory";
+	let stateFilePath;
 	for (let i = 0; i < args.length; i++) {
 		const arg = args[i];
 		if (arg === "--port" || arg === "-p") {
@@ -46,29 +200,64 @@ const parseArgs = (argv) => {
 				continue;
 			}
 		}
-		if (!cliHost && /^\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}$/.test(arg)) {
-			cliHost = arg;
-			continue;
+		if (arg === "--storage" || arg === "-s") {
+			const next = args[i + 1];
+			if (next && (next === "memory" || next === "json")) {
+				storageType = next;
+				i++;
+			}
 		}
-		if (!cliPort && /^\d+$/.test(arg)) {
-			cliPort = parseInt(arg, 10);
-			continue;
+		if (arg === "--state-file" || arg === "-f") {
+			const next = args[i + 1];
+			if (next) {
+				stateFilePath = next;
+				storageType = "json";
+				i++;
+			}
+		}
+		if (arg === "--help") {
+			console.log(`
+X32 Simulator - Usage:
+  x32-simulator [options]
+
+Options:
+  -p, --port <port>       UDP port to listen on (default: 10023)
+  -h, --host <ip>         IP address to bind to (default: 0.0.0.0)
+  -s, --storage <type>    Storage type: 'memory' or 'json' (default: memory)
+  -f, --state-file <file> Path to JSON state file (implies --storage json)
+  --help                  Show this help message
+
+Examples:
+  x32-simulator --port 10023 --host 192.168.1.100
+  x32-simulator --storage json --state-file ./x32-state.json
+  x32-simulator -p 10023 -f ./my-mixer-state.json
+            `);
+			process.exit(0);
 		}
+		if (!cliHost && /^\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}$/.test(arg)) cliHost = arg;
+		if (!cliPort && /^\d+$/.test(arg)) cliPort = parseInt(arg, 10);
 	}
 	return {
 		PORT: cliPort || parseInt(process.env.X32_PORT || "10023", 10),
-		HOST: cliHost || process.env.X32_IP || "0.0.0.0"
+		HOST: cliHost || process.env.X32_IP || "0.0.0.0",
+		storageType,
+		stateFilePath
 	};
 };
 const bootstrap = async () => {
 	loadEnv();
-	const { PORT, HOST } = parseArgs(process.argv);
+	const { PORT, HOST, storageType, stateFilePath } = parseArgs(process.argv);
 	const logger = require_SchemaRegistry.ConsoleLogger.getInstance();
 	logger.setLevel(require_SchemaRegistry.LogLevel.DEBUG);
 	const schemaRegistry = new require_SchemaRegistry.SchemaRegistry(new require_SchemaRegistry.SchemaFactory());
-	const service = new require_SchemaRegistry.SimulationService(new require_SchemaRegistry.UdpNetworkGateway(logger, new require_SchemaRegistry.OscCodec(schemaRegistry)), logger, new require_SchemaRegistry.InMemoryStateRepository(logger, schemaRegistry), schemaRegistry, PORT, HOST);
+	const service = new require_SchemaRegistry.SimulationService(new require_SchemaRegistry.UdpNetworkGateway(logger, new require_SchemaRegistry.OscCodec(schemaRegistry)), logger, createStateRepository({
+		type: storageType,
+		filePath: stateFilePath,
+		autoSaveInterval: 5e3
+	}), schemaRegistry, PORT, HOST);
 	try {
 		await service.start();
+		const storageInfo = storageType === "json" ? `JSON (${stateFilePath})` : "In-Memory";
 		console.log(`
 ╔════════════════════════════════════════╗
 ║    🚀 X32 SIMULATION SERVER ACTIVE     ║
@@ -76,10 +265,12 @@ const bootstrap = async () => {
 • IP: ${HOST}
 • Port: ${PORT}
 • Protocol: UDP (Strict X32 Schema)
+• Storage: ${storageInfo}
 • Logging: ENHANCED (DEBUG)
 
 👉 Type "exit" or "stop" to shut down.
 👉 Type "reset" to reset faders to default.
+👉 Type "save" to force save state (JSON mode).
             `);
 	} catch (err) {
 		if (err.code === "EADDRNOTAVAIL") {
@@ -121,6 +312,10 @@ const bootstrap = async () => {
 				service.resetState();
 				console.log("✨ Console state reset to defaults.");
 				break;
+			case "save":
+				await service.saveState();
+				console.log("💾 State saved to storage.");
+				break;
 			default:
 				if (command) console.log(`Unknown command: "${command}"`);
 				break;

package/dist/server.mjs

@@ -1,9 +1,162 @@
 #!/usr/bin/env node
-import { a as ConsoleLogger, i as UdpNetworkGateway, n as SchemaFactory, o as LogLevel, r as OscCodec, s as InMemoryStateRepository, t as SchemaRegistry, u as SimulationService } from "./SchemaRegistry-D4eIJord.mjs";
+import { a as ConsoleLogger, i as UdpNetworkGateway, l as SimulationService, n as SchemaFactory, o as LogLevel, r as OscCodec, s as InMemoryStateRepository, t as SchemaRegistry } from "./SchemaRegistry-BBzyicoy.mjs";
 import * as readline from "node:readline";
 import * as fs from "node:fs";
+import { constants } from "node:fs";
 import * as path from "node:path";
+import { access, readFile, writeFile } from "node:fs/promises";
 
+//#region src/infrastructure/repositories/JsonFileStateRepository.ts
+/**
+* JSON file-based state repository.
+* Persists state to a JSON file on disk.
+* Supports auto-save and manual flush.
+*/
+var JsonFileStateRepository = class {
+	state = /* @__PURE__ */ new Map();
+	dirty = false;
+	autoSaveTimer = null;
+	saving = false;
+	/**
+	* Creates a new JSON file repository.
+	* @param filePath - Path to the JSON file.
+	* @param autoSaveInterval - Auto-save interval in ms (0 = disabled).
+	*/
+	constructor(filePath, autoSaveInterval = 5e3) {
+		this.filePath = filePath;
+		this.autoSaveInterval = autoSaveInterval;
+		if (this.autoSaveInterval > 0) this.startAutoSave();
+	}
+	/**
+	* Starts the auto-save timer.
+	*/
+	startAutoSave() {
+		this.autoSaveTimer = setInterval(async () => {
+			if (this.dirty && !this.saving) await this.flush();
+		}, this.autoSaveInterval);
+		this.autoSaveTimer.unref();
+	}
+	/**
+	* Stops the auto-save timer.
+	*/
+	stopAutoSave() {
+		if (this.autoSaveTimer) {
+			clearInterval(this.autoSaveTimer);
+			this.autoSaveTimer = null;
+		}
+	}
+	/**
+	* Checks if the file exists.
+	*/
+	async fileExists() {
+		try {
+			await access(this.filePath, constants.F_OK);
+			return true;
+		} catch {
+			return false;
+		}
+	}
+	/**
+	* Loads state from JSON file.
+	*/
+	async load() {
+		if (await this.fileExists()) try {
+			const content = await readFile(this.filePath, "utf-8");
+			const data = JSON.parse(content);
+			this.state.clear();
+			for (const [key, value] of Object.entries(data)) this.state.set(key, value);
+			this.dirty = false;
+			return data;
+		} catch (error) {
+			console.error(`[JsonFileStateRepository] Failed to load state from ${this.filePath}:`, error);
+			return {};
+		}
+		return {};
+	}
+	/**
+	* Saves complete state to JSON file.
+	*/
+	async save(state) {
+		this.state.clear();
+		for (const [key, value] of Object.entries(state)) this.state.set(key, value);
+		this.dirty = true;
+		await this.flush();
+	}
+	/**
+	* Gets a single value.
+	*/
+	get(address) {
+		return this.state.get(address);
+	}
+	/**
+	* Sets a single value and marks as dirty.
+	*/
+	set(address, value) {
+		this.state.set(address, value);
+		this.dirty = true;
+	}
+	/**
+	* Gets all entries.
+	*/
+	getAll() {
+		const result = {};
+		this.state.forEach((value, key) => {
+			result[key] = value;
+		});
+		return result;
+	}
+	/**
+	* Resets state to defaults and marks as dirty.
+	*/
+	reset(defaults) {
+		this.state.clear();
+		for (const [key, value] of Object.entries(defaults)) this.state.set(key, value);
+		this.dirty = true;
+	}
+	/**
+	* Writes state to JSON file if dirty.
+	*/
+	async flush() {
+		if (!this.dirty || this.saving) return;
+		this.saving = true;
+		try {
+			const data = this.getAll();
+			const json = JSON.stringify(data, null, 2);
+			await writeFile(this.filePath, json, "utf-8");
+			this.dirty = false;
+		} catch (error) {
+			console.error(`[JsonFileStateRepository] Failed to save state to ${this.filePath}:`, error);
+		} finally {
+			this.saving = false;
+		}
+	}
+	/**
+	* Cleanup: stop auto-save and flush pending changes.
+	*/
+	async dispose() {
+		this.stopAutoSave();
+		await this.flush();
+	}
+};
+
+//#endregion
+//#region src/infrastructure/repositories/StateRepositoryFactory.ts
+/**
+* Creates a state repository based on configuration.
+* @param config - Repository configuration.
+* @returns The configured state repository.
+*/
+function createStateRepository(config) {
+	switch (config.type) {
+		case "json":
+			if (!config.filePath) throw new Error("JSON repository requires a filePath");
+			return new JsonFileStateRepository(config.filePath, config.autoSaveInterval ?? 5e3);
+		case "memory":
+		default: return new InMemoryStateRepository();
+	}
+}
+
+//#endregion
 //#region src/presentation/cli/server.ts
 const loadEnv = () => {
 	try {
@@ -25,6 +178,8 @@ const parseArgs = (argv) => {
 	const args = argv.slice(2);
 	let cliPort;
 	let cliHost;
+	let storageType = "memory";
+	let stateFilePath;
 	for (let i = 0; i < args.length; i++) {
 		const arg = args[i];
 		if (arg === "--port" || arg === "-p") {
@@ -43,29 +198,64 @@ const parseArgs = (argv) => {
 				continue;
 			}
 		}
-		if (!cliHost && /^\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}$/.test(arg)) {
-			cliHost = arg;
-			continue;
+		if (arg === "--storage" || arg === "-s") {
+			const next = args[i + 1];
+			if (next && (next === "memory" || next === "json")) {
+				storageType = next;
+				i++;
+			}
 		}
-		if (!cliPort && /^\d+$/.test(arg)) {
-			cliPort = parseInt(arg, 10);
-			continue;
+		if (arg === "--state-file" || arg === "-f") {
+			const next = args[i + 1];
+			if (next) {
+				stateFilePath = next;
+				storageType = "json";
+				i++;
+			}
+		}
+		if (arg === "--help") {
+			console.log(`
+X32 Simulator - Usage:
+  x32-simulator [options]
+
+Options:
+  -p, --port <port>       UDP port to listen on (default: 10023)
+  -h, --host <ip>         IP address to bind to (default: 0.0.0.0)
+  -s, --storage <type>    Storage type: 'memory' or 'json' (default: memory)
+  -f, --state-file <file> Path to JSON state file (implies --storage json)
+  --help                  Show this help message
+
+Examples:
+  x32-simulator --port 10023 --host 192.168.1.100
+  x32-simulator --storage json --state-file ./x32-state.json
+  x32-simulator -p 10023 -f ./my-mixer-state.json
+            `);
+			process.exit(0);
 		}
+		if (!cliHost && /^\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}$/.test(arg)) cliHost = arg;
+		if (!cliPort && /^\d+$/.test(arg)) cliPort = parseInt(arg, 10);
 	}
 	return {
 		PORT: cliPort || parseInt(process.env.X32_PORT || "10023", 10),
-		HOST: cliHost || process.env.X32_IP || "0.0.0.0"
+		HOST: cliHost || process.env.X32_IP || "0.0.0.0",
+		storageType,
+		stateFilePath
 	};
 };
 const bootstrap = async () => {
 	loadEnv();
-	const { PORT, HOST } = parseArgs(process.argv);
+	const { PORT, HOST, storageType, stateFilePath } = parseArgs(process.argv);
 	const logger = ConsoleLogger.getInstance();
 	logger.setLevel(LogLevel.DEBUG);
 	const schemaRegistry = new SchemaRegistry(new SchemaFactory());
-	const service = new SimulationService(new UdpNetworkGateway(logger, new OscCodec(schemaRegistry)), logger, new InMemoryStateRepository(logger, schemaRegistry), schemaRegistry, PORT, HOST);
+	const service = new SimulationService(new UdpNetworkGateway(logger, new OscCodec(schemaRegistry)), logger, createStateRepository({
+		type: storageType,
+		filePath: stateFilePath,
+		autoSaveInterval: 5e3
+	}), schemaRegistry, PORT, HOST);
 	try {
 		await service.start();
+		const storageInfo = storageType === "json" ? `JSON (${stateFilePath})` : "In-Memory";
 		console.log(`
 ╔════════════════════════════════════════╗
 ║    🚀 X32 SIMULATION SERVER ACTIVE     ║
@@ -73,10 +263,12 @@ const bootstrap = async () => {
 • IP: ${HOST}
 • Port: ${PORT}
 • Protocol: UDP (Strict X32 Schema)
+• Storage: ${storageInfo}
 • Logging: ENHANCED (DEBUG)
 
 👉 Type "exit" or "stop" to shut down.
 👉 Type "reset" to reset faders to default.
+👉 Type "save" to force save state (JSON mode).
             `);
 	} catch (err) {
 		if (err.code === "EADDRNOTAVAIL") {
@@ -118,6 +310,10 @@ const bootstrap = async () => {
 				service.resetState();
 				console.log("✨ Console state reset to defaults.");
 				break;
+			case "save":
+				await service.saveState();
+				console.log("💾 State saved to storage.");
+				break;
 			default:
 				if (command) console.log(`Unknown command: "${command}"`);
 				break;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@djodjonx/x32-simulator",
-  "version": "0.0.6",
+  "version": "0.0.7",
   "description": "X32 Simulator",
   "type": "module",
   "main": "./dist/index.cjs",