@djodjonx/x32-simulator 0.0.3 → 0.0.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (74) hide show
  1. package/CHANGELOG.md +2 -0
  2. package/package.json +5 -1
  3. package/.commitlintrc.json +0 -3
  4. package/.github/workflows/publish.yml +0 -38
  5. package/.husky/commit-msg +0 -1
  6. package/.husky/pre-commit +0 -1
  7. package/.oxlintrc.json +0 -56
  8. package/INSTALL.md +0 -107
  9. package/docs/OSC-Communication.md +0 -184
  10. package/docs/X32-INTERNAL.md +0 -262
  11. package/docs/X32-OSC.pdf +0 -0
  12. package/docs/behringer-x32-x32-osc-remote-protocol-en-44463.pdf +0 -0
  13. package/src/application/use-cases/BroadcastUpdatesUseCase.ts +0 -120
  14. package/src/application/use-cases/ManageSessionsUseCase.ts +0 -9
  15. package/src/application/use-cases/ProcessPacketUseCase.ts +0 -26
  16. package/src/application/use-cases/SimulationService.ts +0 -146
  17. package/src/domain/entities/SubscriptionManager.ts +0 -126
  18. package/src/domain/entities/X32State.ts +0 -78
  19. package/src/domain/models/MeterConfig.ts +0 -22
  20. package/src/domain/models/MeterData.ts +0 -59
  21. package/src/domain/models/OscMessage.ts +0 -93
  22. package/src/domain/models/X32Address.ts +0 -72
  23. package/src/domain/models/X32Node.ts +0 -43
  24. package/src/domain/models/types.ts +0 -86
  25. package/src/domain/ports/ILogger.ts +0 -27
  26. package/src/domain/ports/INetworkGateway.ts +0 -8
  27. package/src/domain/ports/IStateRepository.ts +0 -16
  28. package/src/domain/services/MeterService.ts +0 -46
  29. package/src/domain/services/OscMessageHandler.ts +0 -88
  30. package/src/domain/services/SchemaFactory.ts +0 -308
  31. package/src/domain/services/SchemaRegistry.ts +0 -67
  32. package/src/domain/services/StaticResponseService.ts +0 -52
  33. package/src/domain/services/strategies/BatchStrategy.ts +0 -74
  34. package/src/domain/services/strategies/MeterStrategy.ts +0 -45
  35. package/src/domain/services/strategies/NodeDiscoveryStrategy.ts +0 -36
  36. package/src/domain/services/strategies/OscCommandStrategy.ts +0 -22
  37. package/src/domain/services/strategies/StateAccessStrategy.ts +0 -71
  38. package/src/domain/services/strategies/StaticResponseStrategy.ts +0 -42
  39. package/src/domain/services/strategies/SubscriptionStrategy.ts +0 -56
  40. package/src/infrastructure/mappers/OscCodec.ts +0 -54
  41. package/src/infrastructure/repositories/InMemoryStateRepository.ts +0 -37
  42. package/src/infrastructure/services/ConsoleLogger.ts +0 -177
  43. package/src/infrastructure/services/UdpNetworkGateway.ts +0 -100
  44. package/src/presentation/cli/server.ts +0 -194
  45. package/src/presentation/library/library.ts +0 -139
  46. package/tests/application/use-cases/BroadcastUpdatesUseCase.test.ts +0 -104
  47. package/tests/application/use-cases/ManageSessionsUseCase.test.ts +0 -12
  48. package/tests/application/use-cases/ProcessPacketUseCase.test.ts +0 -49
  49. package/tests/application/use-cases/SimulationService.test.ts +0 -77
  50. package/tests/domain/entities/SubscriptionManager.test.ts +0 -50
  51. package/tests/domain/entities/X32State.test.ts +0 -52
  52. package/tests/domain/models/MeterData.test.ts +0 -23
  53. package/tests/domain/models/OscMessage.test.ts +0 -38
  54. package/tests/domain/models/X32Address.test.ts +0 -30
  55. package/tests/domain/models/X32Node.test.ts +0 -30
  56. package/tests/domain/services/MeterService.test.ts +0 -27
  57. package/tests/domain/services/OscMessageHandler.test.ts +0 -51
  58. package/tests/domain/services/SchemaRegistry.test.ts +0 -47
  59. package/tests/domain/services/StaticResponseService.test.ts +0 -15
  60. package/tests/domain/services/strategies/BatchStrategy.test.ts +0 -41
  61. package/tests/domain/services/strategies/MeterStrategy.test.ts +0 -19
  62. package/tests/domain/services/strategies/NodeDiscoveryStrategy.test.ts +0 -22
  63. package/tests/domain/services/strategies/StateAccessStrategy.test.ts +0 -49
  64. package/tests/domain/services/strategies/StaticResponseStrategy.test.ts +0 -15
  65. package/tests/domain/services/strategies/SubscriptionStrategy.test.ts +0 -45
  66. package/tests/infrastructure/mappers/OscCodec.test.ts +0 -41
  67. package/tests/infrastructure/repositories/InMemoryStateRepository.test.ts +0 -29
  68. package/tests/infrastructure/services/ConsoleLogger.test.ts +0 -74
  69. package/tests/infrastructure/services/UdpNetworkGateway.test.ts +0 -61
  70. package/tests/presentation/cli/server.test.ts +0 -178
  71. package/tests/presentation/library/library.test.ts +0 -13
  72. package/tsconfig.json +0 -21
  73. package/tsdown.config.ts +0 -15
  74. package/vitest.config.ts +0 -9
@@ -1,61 +0,0 @@
1
- import { describe, it, expect, vi, beforeEach } from 'vitest';
2
- import { UdpNetworkGateway } from '../../../src/infrastructure/services/UdpNetworkGateway';
3
- import { ILogger } from '../../../src/domain/ports/ILogger';
4
- import { OscCodec } from '../../../src/infrastructure/mappers/OscCodec';
5
- import * as dgram from 'dgram';
6
-
7
- let messageCallback: Function;
8
-
9
- vi.mock('dgram', () => ({
10
- createSocket: vi.fn(() => ({
11
- bind: vi.fn((port, ip, cb) => cb && cb()),
12
- on: vi.fn((event, cb) => {
13
- if (event === 'message') messageCallback = cb;
14
- }),
15
- send: vi.fn(),
16
- close: vi.fn((cb) => cb && cb()),
17
- }))
18
- }));
19
-
20
- describe('UdpNetworkGateway', () => {
21
- let gateway: UdpNetworkGateway;
22
- let logger: ILogger;
23
- let codec: OscCodec;
24
-
25
- beforeEach(() => {
26
- logger = { debug: vi.fn(), info: vi.fn(), warn: vi.fn(), error: vi.fn() };
27
- codec = {
28
- encode: vi.fn().mockReturnValue(Buffer.from('encoded')),
29
- decode: vi.fn().mockReturnValue({ address: '/decoded', args: [] })
30
- } as unknown as OscCodec;
31
- gateway = new UdpNetworkGateway(logger, codec);
32
- });
33
-
34
- it('should start and bind socket', async () => {
35
- await gateway.start(10023, '0.0.0.0');
36
- expect(dgram.createSocket).toHaveBeenCalledWith('udp4');
37
- });
38
-
39
- it('should send packets', async () => {
40
- await gateway.start(10023, '0.0.0.0');
41
- gateway.send({ address: '1.2.3.4', port: 1234 }, '/test', [1]);
42
- expect(codec.encode).toHaveBeenCalledWith('/test', [1]);
43
- });
44
-
45
- it('should receive and decode packets', async () => {
46
- const spy = vi.fn();
47
- gateway.onPacket(spy);
48
- await gateway.start(10023, '0.0.0.0');
49
-
50
- // Simulate incoming message
51
- messageCallback(Buffer.from('raw'), { address: '5.6.7.8', port: 5678 });
52
-
53
- expect(codec.decode).toHaveBeenCalled();
54
- expect(spy).toHaveBeenCalledWith(expect.anything(), expect.objectContaining({ address: '5.6.7.8' }));
55
- });
56
-
57
- it('should stop', async () => {
58
- await gateway.start(10023, '0.0.0.0');
59
- await gateway.stop();
60
- });
61
- });
@@ -1,178 +0,0 @@
1
- import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
2
- import * as fs from 'fs';
3
-
4
- const mocks = vi.hoisted(() => ({
5
- serviceInstance: {
6
- start: vi.fn().mockResolvedValue(undefined),
7
- stop: vi.fn().mockResolvedValue(undefined),
8
- resetState: vi.fn()
9
- },
10
- rl: {
11
- on: vi.fn(),
12
- close: vi.fn()
13
- }
14
- }));
15
-
16
- // Mock fs
17
- vi.mock('fs', () => ({
18
- existsSync: vi.fn(),
19
- readFileSync: vi.fn()
20
- }));
21
-
22
- // Mock SimulationService
23
- vi.mock('../../../src/application/use-cases/SimulationService', () => {
24
- const MockService = vi.fn();
25
- MockService.prototype.start = mocks.serviceInstance.start;
26
- MockService.prototype.stop = mocks.serviceInstance.stop;
27
- MockService.prototype.resetState = mocks.serviceInstance.resetState;
28
- return {
29
- SimulationService: MockService
30
- };
31
- });
32
-
33
- // Mock ConsoleLogger
34
- vi.mock('../../../src/infrastructure/services/ConsoleLogger', () => ({
35
- ConsoleLogger: {
36
- getInstance: vi.fn().mockReturnValue({ setLevel: vi.fn() })
37
- },
38
- LogLevel: { DEBUG: 0 }
39
- }));
40
-
41
- // Mock readline
42
- vi.mock('readline', () => ({
43
- createInterface: vi.fn().mockReturnValue(mocks.rl)
44
- }));
45
-
46
- import * as Server from '../../../src/presentation/cli/server';
47
- import { SimulationService } from '../../../src/application/use-cases/SimulationService';
48
-
49
- describe('CLI Server', () => {
50
- beforeEach(() => {
51
- vi.clearAllMocks();
52
- vi.spyOn(console, 'log').mockImplementation(() => {});
53
- vi.spyOn(console, 'error').mockImplementation(() => {});
54
- vi.spyOn(console, 'warn').mockImplementation(() => {});
55
- vi.spyOn(process, 'exit').mockImplementation(() => undefined as never);
56
- vi.spyOn(process, 'on').mockImplementation(() => process);
57
-
58
- // Reset specific mock implementations if needed
59
- mocks.serviceInstance.start.mockResolvedValue(undefined);
60
- });
61
-
62
- afterEach(() => {
63
- vi.restoreAllMocks();
64
- });
65
-
66
- describe('parseArgs', () => {
67
- it('should parse port and host flags', () => {
68
- const args = ['node', 'server.ts', '--port', '1234', '--host', '1.2.3.4'];
69
- const result = Server.parseArgs(args);
70
- expect(result.PORT).toBe(1234);
71
- expect(result.HOST).toBe('1.2.3.4');
72
- });
73
-
74
- it('should parse short flags', () => {
75
- const args = ['node', 'server.ts', '-p', '1234', '-h', '1.2.3.4'];
76
- const result = Server.parseArgs(args);
77
- expect(result.PORT).toBe(1234);
78
- expect(result.HOST).toBe('1.2.3.4');
79
- });
80
-
81
- it('should parse positional arguments', () => {
82
- const args = ['node', 'server.ts', '1.2.3.4', '1234'];
83
- const result = Server.parseArgs(args);
84
- expect(result.PORT).toBe(1234);
85
- expect(result.HOST).toBe('1.2.3.4');
86
- });
87
-
88
- it('should use defaults', () => {
89
- const args = ['node', 'server.ts'];
90
- const result = Server.parseArgs(args);
91
- expect(result.PORT).toBe(10023);
92
- expect(result.HOST).toBe('0.0.0.0');
93
- });
94
- });
95
-
96
- describe('loadEnv', () => {
97
- it('should load .env file', () => {
98
- vi.mocked(fs.existsSync).mockReturnValue(true);
99
- vi.mocked(fs.readFileSync).mockReturnValue('X32_PORT=9999\nX32_IP=10.0.0.1');
100
-
101
- Server.loadEnv();
102
-
103
- expect(process.env.X32_PORT).toBe('9999');
104
- expect(process.env.X32_IP).toBe('10.0.0.1');
105
-
106
- delete process.env.X32_PORT;
107
- delete process.env.X32_IP;
108
- });
109
-
110
- it('should handle errors gracefully', () => {
111
- vi.mocked(fs.existsSync).mockReturnValue(true);
112
- vi.mocked(fs.readFileSync).mockImplementation(() => { throw new Error('Fail'); });
113
-
114
- Server.loadEnv();
115
-
116
- expect(console.warn).toHaveBeenCalledWith(expect.stringContaining('Failed to load'), expect.any(String));
117
- });
118
- });
119
-
120
- describe('bootstrap', () => {
121
- it('should start simulation service', async () => {
122
- await Server.bootstrap();
123
- expect(SimulationService).toHaveBeenCalled();
124
- expect(console.log).toHaveBeenCalledWith(expect.stringContaining('X32 SIMULATION SERVER ACTIVE'));
125
- });
126
-
127
- it('should handle EADDRNOTAVAIL error', async () => {
128
- const error = new Error('Bind failed');
129
- (error as any).code = 'EADDRNOTAVAIL';
130
- mocks.serviceInstance.start.mockRejectedValueOnce(error);
131
-
132
- // Mock platform
133
- Object.defineProperty(process, 'platform', { value: 'darwin', configurable: true });
134
-
135
- await Server.bootstrap();
136
- expect(console.error).toHaveBeenCalledWith(expect.stringContaining('FAILED TO BIND'));
137
- expect(process.exit).toHaveBeenCalledWith(1);
138
- });
139
-
140
- it('should handle generic startup errors', async () => {
141
- mocks.serviceInstance.start.mockRejectedValueOnce(new Error('Generic fail'));
142
- await Server.bootstrap();
143
- expect(console.error).toHaveBeenCalledWith('Failed to start server:', expect.any(Error));
144
- expect(process.exit).toHaveBeenCalledWith(1);
145
- });
146
-
147
- it('should handle CLI commands', async () => {
148
- await Server.bootstrap();
149
-
150
- const lineHandler = mocks.rl.on.mock.calls.find(call => call[0] === 'line')?.[1];
151
- expect(lineHandler).toBeDefined();
152
-
153
- await lineHandler('reset');
154
- expect(mocks.serviceInstance.resetState).toHaveBeenCalled();
155
-
156
- await lineHandler('stop');
157
- expect(mocks.serviceInstance.stop).toHaveBeenCalled();
158
- expect(process.exit).toHaveBeenCalledWith(0);
159
- });
160
-
161
- it('should handle unknown CLI commands', async () => {
162
- await Server.bootstrap();
163
- const lineHandler = mocks.rl.on.mock.calls.find(call => call[0] === 'line')?.[1];
164
- await lineHandler('unknown');
165
- expect(console.log).toHaveBeenCalledWith(expect.stringContaining('Unknown command'));
166
- });
167
-
168
- it('should handle SIGINT', async () => {
169
- await Server.bootstrap();
170
- const sigintHandler = vi.mocked(process.on).mock.calls.find(call => call[0] === 'SIGINT')?.[1] as Function;
171
- expect(sigintHandler).toBeDefined();
172
-
173
- await sigintHandler();
174
- expect(mocks.serviceInstance.stop).toHaveBeenCalled();
175
- expect(process.exit).toHaveBeenCalledWith(0);
176
- });
177
- });
178
- });
@@ -1,13 +0,0 @@
1
- import { describe, it, expect } from 'vitest';
2
- import * as Lib from '../../../src/presentation/library/library';
3
-
4
- describe('Library Entry', () => {
5
- it('should export all public members', () => {
6
- expect(Lib.SimulationService).toBeDefined();
7
- expect(Lib.ConsoleLogger).toBeDefined();
8
- expect(Lib.UdpNetworkGateway).toBeDefined();
9
- expect(Lib.InMemoryStateRepository).toBeDefined();
10
- expect(Lib.LogCategory).toBeDefined();
11
- // Types aren't runtime values, so we can't check them with toBeDefined(), but the import * works.
12
- });
13
- });
package/tsconfig.json DELETED
@@ -1,21 +0,0 @@
1
- {
2
- "compilerOptions": {
3
- "target": "ESNext",
4
- "module": "ESNext",
5
- "moduleResolution": "Bundler",
6
- "lib": ["ESNext", "DOM"],
7
- "strict": true,
8
- "declaration": true,
9
- "removeComments": true,
10
- "esModuleInterop": true,
11
- "skipLibCheck": true,
12
- "forceConsistentCasingInFileNames": true,
13
- "outDir": "dist",
14
- "baseUrl": ".",
15
- "paths": {
16
- "@/*": ["src/*"]
17
- }
18
- },
19
- "include": ["src/**/*", "tests/**/*"],
20
- "exclude": ["node_modules", "dist"]
21
- }
package/tsdown.config.ts DELETED
@@ -1,15 +0,0 @@
1
- import { defineConfig } from 'tsdown';
2
-
3
- export default defineConfig({
4
- clean: true,
5
- dts: true,
6
- entry: {
7
- index: 'src/presentation/library/library.ts',
8
- server: 'src/presentation/cli/server.ts',
9
- },
10
- format: ['cjs', 'esm'],
11
- platform: 'node',
12
- // Bundle all dependencies
13
- // @ts-ignore
14
- noExternal: [/(.*)/],
15
- });
package/vitest.config.ts DELETED
@@ -1,9 +0,0 @@
1
- import { defineConfig } from 'vitest/config';
2
-
3
- export default defineConfig({
4
- test: {
5
- environment: 'node',
6
- globals: true,
7
- include: ['tests/**/*.test.ts'],
8
- },
9
- });