@djodjonx/x32-simulator 0.0.1

package/.commitlintrc.json

@@ -0,0 +1,3 @@
+{
+  "extends": ["@commitlint/config-conventional"]
+}

package/.github/workflows/publish.yml

@@ -0,0 +1,38 @@
+name: Publish Package to npmjs
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+permissions:
+  id-token: write  # Required for OIDC
+  contents: write  # Required to create GitHub Releases
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20.x'
+          registry-url: 'https://registry.npmjs.org'
+
+      # Ensure npm is up-to-date
+      - name: Update npm
+        run: npm install -g npm@latest
+
+      - run: npm ci
+      - run: npm run build
+      - run: npm test
+      - run: npm publish --provenance --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          generate_release_notes: true
+          make_latest: true

package/.husky/commit-msg

@@ -0,0 +1 @@
+npx --no -- commitlint --edit $1

package/.husky/pre-commit

@@ -0,0 +1 @@
+npx lint-staged

package/.oxlintrc.json

@@ -0,0 +1,56 @@
+{
+  "$schema": "./node_modules/oxlint/configuration_schema.json",
+  "plugins": [
+    "typescript",
+    "vitest",
+    "unicorn",
+    "oxc",
+    "import",
+    "jsdoc"
+  ],
+  "categories": {
+    "correctness": "error",
+    "suspicious": "error",
+    "pedantic": "off",
+    "style": "off",
+    "perf": "warn"
+  },
+  "rules": {
+    "import/prefer-default-export": "off",
+    "import/no-named-export": "off",
+    "unicorn/filename-case": "off",
+    "eslint/no-magic-numbers": "off",
+    "eslint/max-lines-per-function": "off",
+    "eslint/max-statements": "off",
+    "eslint/max-params": "off",
+    "eslint/max-lines": "off",
+    "unicorn/no-zero-fractions": "off",
+    "eslint/sort-keys": "off",
+    "eslint/sort-imports": "off",
+    "typescript/consistent-type-imports": "off",
+    "jsdoc/require-param-type": "off",
+    "jsdoc/require-returns-type": "off",
+    "jsdoc/require-returns": "off",
+    "typescript/no-inferrable-types": "off",
+    "unicorn/prefer-top-level-await": "off",
+    "unicorn/no-null": "off",
+    "unicorn/prevent-abbreviations": "off",
+    "eslint/id-length": "off"
+  },
+  "overrides": [
+    {
+      "files": ["tests/**/*.ts"],
+      "rules": {
+        "eslint/no-magic-numbers": "off"
+      }
+    }
+  ],
+  "settings": {
+    "vitest": {
+      "typecheck": true
+    }
+  },
+  "env": {
+    "builtin": true
+  }
+}

package/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Changelog
+
+All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
+
+### 0.0.1 (2026-01-08)
+
+
+### Features
+
+* implement x32 simulation logic ([2b40d1c](https://github.com/djodjonx/x32-simulator/commit/2b40d1c9173f4c0653097334ab3c0bd96e2cf966))
+* initial project scaffold ([a0552c1](https://github.com/djodjonx/x32-simulator/commit/a0552c1a47baa2e578fe816231c697cfa20f7f62))

package/INSTALL.md

@@ -0,0 +1,107 @@
+# Development Guide
+
+This guide is for developers who want to contribute to the `x32-simulator` project or build it from source.
+
+## 📋 Prerequisites
+
+*   **Node.js**: Version 20 or higher is required.
+    *   Verify with `node -v`
+*   **npm**: Comes bundled with Node.js.
+
+## 🛠️ Setup
+
+1.  **Clone the repository:**
+    ```bash
+    git clone https://github.com/djodjonx/x32-simulator.git
+    cd x32-simulator
+    ```
+
+2.  **Install dependencies:**
+    We use `npm ci` for reliable builds based on `package-lock.json`.
+    ```bash
+    npm ci
+    ```
+
+## 💻 Development Workflow
+
+### Running in Watch Mode
+For rapid development, use the dev script. It re-bundles the project on file changes.
+```bash
+npm run dev
+```
+
+### Running Tests
+We use **Vitest** for testing.
+
+*   **Run all tests:**
+    ```bash
+    npm test
+    ```
+*   **Run with coverage:**
+    ```bash
+    npm run test:coverage
+    ```
+*   **Watch mode (TDD):**
+    ```bash
+    npm run test:watch
+    ```
+
+### Code Quality
+Ensure your code meets the project standards before committing.
+
+*   **Linting (Oxlint):**
+    ```bash
+    npm run lint
+    ```
+*   **Type Checking:**
+    ```bash
+    npm run type-check
+    ```
+
+## 🏗️ Building
+
+To build the project for production distribution:
+
+```bash
+npm run build
+```
+
+This uses `tsdown` to bundle the code into the `dist/` directory:
+*   `dist/server.mjs`: The executable CLI.
+*   `dist/index.mjs` / `.cjs`: The library entry points.
+
+## 📂 Project Structure
+
+The project follows a **Clean Architecture** / **Hexagonal** structure:
+
+```
+src/
+├── application/       # Use Cases (Business Logic orchestration)
+├── domain/            # Core Business Logic (Entities, Models, Ports)
+├── infrastructure/    # External adapters (UDP, Logging, Repositories)
+└── presentation/      # Entry points
+    ├── cli/           # CLI Server implementation
+    └── library/       # Library exports
+```
+
+## 🚀 Releasing
+
+We use `standard-version` to automate versioning and changelog generation.
+
+1.  **Create a release:**
+    ```bash
+    npm run release
+    ```
+    This command will:
+    *   Bump the version in `package.json`.
+    *   Update `CHANGELOG.md`.
+    *   Commit these changes.
+    *   Create a git tag (e.g., `v1.1.0`).
+
+2.  **Push changes:**
+    ```bash
+    git push --follow-tags
+    ```
+
+3.  **Publish:**
+    The GitHub Action workflow will automatically detect the new tag, build the project, and publish it to NPM.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jonathan Moutier
+
+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,141 @@
+# X32 Digital Mixer Simulator
+
+[![npm version](https://img.shields.io/npm/v/@djodjonx/x32-simulator.svg)](https://www.npmjs.com/package/@djodjonx/x32-simulator)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+A fully functional **Behringer X32 / Midas M32 OSC Simulator**.
+
+This tool allows developers to build, test, and debug X32/M32 remote control applications without needing physical hardware. It accurately replicates the mixer's state management, OSC protocol quirks, and network behavior.
+
+---
+
+## 🚀 Features
+
+*   **Complete State Simulation**: Simulates ~4000+ OSC parameters including Channels, Buses, Matrices, FX, Routing, and Config.
+*   **Accurate OSC Protocol**: Supports `node-osc` based communication over UDP.
+*   **Subscription Management**: Handles `/xremote`, `/subscribe`, and `/renew` logic for client updates.
+*   **Meter Simulation**: Generates synthetic meter data for `/meters/0` through `/meters/15` endpoints.
+*   **Dual Mode**: Run as a **Standalone CLI Server** or embed as a **Library** in your Node.js tests.
+*   **Zero Dependencies** (runtime): The published package bundles everything needed.
+
+---
+
+## 📦 Installation
+
+### As a CLI Tool (Global)
+Install globally to run the simulator from anywhere in your terminal.
+
+```bash
+npm install -g @djodjonx/x32-simulator
+```
+
+### As a Library (Local)
+Install in your project to use it in integration tests.
+
+```bash
+npm install --save-dev @djodjonx/x32-simulator
+```
+
+---
+
+## 🖥️ CLI Usage
+
+Start the simulator server:
+
+```bash
+x32-simulator
+```
+
+### Options
+
+| Flag | Alias | Description | Default |
+|------|-------|-------------|---------|
+| `--port` | `-p` | UDP Port to listen on | `10023` |
+| `--host` | `-h` | IP Address to bind to | `0.0.0.0` |
+
+**Example:**
+```bash
+x32-simulator --port 5000 --host 127.0.0.1
+```
+
+### 🌐 Network Setup (IP Aliasing)
+
+If you need to simulate a specific console IP (e.g., `192.168.1.100`) that is not assigned to your machine, you must create a **Network Alias**. This allows the simulator to "own" that IP locally.
+
+| OS | Create Alias Command | Remove Alias Command |
+|----|----------------------|----------------------|
+| **macOS** | `sudo ifconfig lo0 alias <IP>` | `sudo ifconfig lo0 -alias <IP>` |
+| **Linux** | `sudo ip addr add <IP>/32 dev lo` | `sudo ip addr del <IP>/32 dev lo` |
+| **Windows** | `netsh interface ip add address "Loopback" <IP> 255.255.255.255` | `netsh interface ip delete address "Loopback" <IP>` |
+
+> **Note (Windows):** Requires the "Microsoft Loopback Adapter" to be installed and named "Loopback" in your Network Connections.
+
+### Interactive Commands
+Once running, the CLI accepts these commands:
+*   `reset`: Resets all faders and parameters to default values.
+*   `stop` / `exit`: Shuts down the server.
+
+---
+
+## 📚 Library Usage
+
+Perfect for integration testing your X32 client apps.
+
+```typescript
+import { SimulationService, UdpNetworkGateway, ConsoleLogger, InMemoryStateRepository, SchemaFactory, SchemaRegistry, OscCodec } from '@djodjonx/x32-simulator';
+
+// 1. Setup Dependencies
+const logger = ConsoleLogger.getInstance();
+const schemaRegistry = new SchemaRegistry(new SchemaFactory());
+const codec = new OscCodec(schemaRegistry);
+const gateway = new UdpNetworkGateway(logger, codec);
+const repository = new InMemoryStateRepository(logger, schemaRegistry);
+
+// 2. Initialize Service
+const simulator = new SimulationService(
+  gateway,
+  logger,
+  repository,
+  schemaRegistry,
+  10023,       // Port
+  '127.0.0.1'  // Host
+);
+
+// 3. Start & Stop
+await simulator.start();
+console.log('Simulator running...');
+
+// ... run your tests ...
+
+await simulator.stop();
+```
+
+---
+
+## 🎛️ Simulated OSC Map
+
+The simulator covers a vast majority of the X32 OSC command set:
+
+| Category | OSC Path Pattern | Description |
+|----------|------------------|-------------|
+| **Channels** | `/ch/{01..32}/...` | Config, Preamp, Gate, Dyn, EQ, Mix, Sends |
+| **Buses** | `/bus/{01..16}/...` | Config, Dyn, EQ, Mix, Sends |
+| **DCA** | `/dca/{1..8}/...` | Config, Fader, Mute |
+| **Matrix** | `/mtx/{01..06}/...` | Config, Dyn, EQ, Mix |
+| **Aux In** | `/auxin/{01..08}/...` | Config, Preamp, EQ, Mix |
+| **FX Returns** | `/fxrtn/{01..08}/...` | Config, EQ, Mix |
+| **Effects** | `/fx/{1..8}/...` | Type, Parameters, Source |
+| **Headamps** | `/headamp/{000..127}/...` | Gain, Phantom Power |
+| **Routing** | `/config/routing/...` | Input, Output, Card, AES50 Routing |
+| **Status** | `/-stat/...` | Selected Channel, Sends on Fader, Screen State |
+| **Meters** | `/meters/...` | Meter data blobs (simulated noise) |
+
+---
+
+## 🤝 Contributing
+
+We welcome contributions! Please see [INSTALL.md](./INSTALL.md) for development instructions.
+
+## 📄 License
+
+MIT © [Jonathan Moutier](https://github.com/djodjonx)