x-m32-mcp-server 2.1.0

package/dist/esm/services/x32-connection.d.ts

@@ -0,0 +1,87 @@
+import { EventEmitter } from 'events';
+import { X32ConnectionConfig, X32InfoResponse, X32StatusResponse, OscMessage } from '../types/index.js';
+/**
+ * X32 Connection Manager
+ * Manages UDP connection to X32/M32 mixer
+ */
+export declare class X32Connection extends EventEmitter {
+    private udpPort;
+    private config;
+    private isConnected;
+    private messageQueue;
+    private readonly DEFAULT_TIMEOUT;
+    constructor();
+    /**
+     * Connect to X32/M32 mixer
+     */
+    connect(config: X32ConnectionConfig): Promise<void>;
+    /**
+     * Disconnect from X32/M32 mixer
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Send OSC message and wait for response
+     */
+    sendMessage(address: string, args?: unknown[], waitForReply?: boolean): Promise<OscMessage | null>;
+    /**
+     * Get X32/M32 info
+     */
+    getInfo(): Promise<X32InfoResponse>;
+    /**
+     * Get X32/M32 status
+     */
+    getStatus(): Promise<X32StatusResponse>;
+    /**
+     * Check if connected
+     */
+    get connected(): boolean;
+    /**
+     * Get connection config
+     */
+    getConfig(): X32ConnectionConfig | null;
+    /**
+     * Get parameter value from X32/M32
+     * @param address OSC address pattern (e.g., '/ch/01/mix/fader')
+     * @returns Parameter value
+     */
+    getParameter<T = unknown>(address: string): Promise<T>;
+    /**
+     * Set parameter value on X32/M32
+     * @param address OSC address pattern
+     * @param value Value to set (string, number, or buffer)
+     */
+    setParameter(address: string, value: unknown): Promise<void>;
+    /**
+     * Get channel parameter
+     * @param channel Channel number (1-32)
+     * @param param Parameter path (e.g., 'config/name', 'mix/fader')
+     * @returns Parameter value
+     */
+    getChannelParameter<T = unknown>(channel: number, param: string): Promise<T>;
+    /**
+     * Set channel parameter
+     * @param channel Channel number (1-32)
+     * @param param Parameter path (e.g., 'config/name', 'mix/fader')
+     * @param value Value to set
+     */
+    setChannelParameter(channel: number, param: string, value: unknown): Promise<void>;
+    /**
+     * Get bus parameter
+     * @param bus Bus number (1-16)
+     * @param param Parameter path (e.g., 'mix/fader', 'mix/on')
+     * @returns Parameter value
+     */
+    getBusParameter<T = unknown>(bus: number, param: string): Promise<T>;
+    /**
+     * Set bus parameter
+     * @param bus Bus number (1-16)
+     * @param param Parameter path (e.g., 'mix/fader', 'mix/on')
+     * @param value Value to set
+     */
+    setBusParameter(bus: number, param: string, value: unknown): Promise<void>;
+    /**
+     * Handle incoming OSC message
+     */
+    private handleIncomingMessage;
+}
+//# sourceMappingURL=x32-connection.d.ts.map

package/dist/esm/services/x32-connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"x32-connection.d.ts","sourceRoot":"","sources":["../../../src/services/x32-connection.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,iBAAiB,EAAE,UAAU,EAAW,MAAM,mBAAmB,CAAC;AAEjH;;;GAGG;AACH,qBAAa,aAAc,SAAQ,YAAY;IAC3C,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,MAAM,CAAoC;IAClD,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,YAAY,CAA2F;IAC/G,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAQ;;IAMxC;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IA6CzD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAkBjC;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,OAAO,EAAO,EAAE,YAAY,GAAE,OAAc,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IA6DlH;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,eAAe,CAAC;IAoBzC;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAmB7C;;OAEG;IACH,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;OAEG;IACH,SAAS,IAAI,mBAAmB,GAAG,IAAI;IAIvC;;;;OAIG;IACG,YAAY,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAQ5D;;;;OAIG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlE;;;;;OAKG;IACG,mBAAmB,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAQlF;;;;;OAKG;IACG,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAQxF;;;;;OAKG;IACG,eAAe,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAQ1E;;;;;OAKG;IACG,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAQhF;;OAEG;IACH,OAAO,CAAC,qBAAqB;CAchC"}

package/dist/esm/services/x32-connection.js

@@ -0,0 +1,280 @@
+// @ts-expect-error: OSC module lacks type definitions
+import osc from 'osc';
+import { EventEmitter } from 'events';
+/**
+ * X32 Connection Manager
+ * Manages UDP connection to X32/M32 mixer
+ */
+export class X32Connection extends EventEmitter {
+    constructor() {
+        super();
+        this.udpPort = null;
+        this.config = null;
+        this.isConnected = false;
+        this.messageQueue = new Map();
+        this.DEFAULT_TIMEOUT = 5000; // 5 seconds
+    }
+    /**
+     * Connect to X32/M32 mixer
+     */
+    async connect(config) {
+        if (this.isConnected) {
+            throw new Error('Already connected to X32/M32');
+        }
+        this.config = config;
+        return new Promise((resolve, reject) => {
+            this.udpPort = new osc.UDPPort({
+                localAddress: '0.0.0.0',
+                localPort: 0, // Let OS assign a random port
+                remoteAddress: config.host,
+                remotePort: config.port,
+                metadata: true
+            });
+            this.udpPort.on('ready', () => {
+                this.isConnected = true;
+                this.emit('connected');
+                resolve();
+            });
+            this.udpPort.on('error', (err) => {
+                this.emit('error', err);
+                if (!this.isConnected) {
+                    reject(err);
+                }
+            });
+            this.udpPort.on('message', (oscMsg) => {
+                this.handleIncomingMessage(oscMsg);
+            });
+            try {
+                if (this.udpPort) {
+                    this.udpPort.open();
+                }
+                else {
+                    reject(new Error('Failed to create UDP port'));
+                }
+            }
+            catch (error) {
+                reject(error);
+            }
+        });
+    }
+    /**
+     * Disconnect from X32/M32 mixer
+     */
+    async disconnect() {
+        if (!this.isConnected || !this.udpPort) {
+            return;
+        }
+        return new Promise(resolve => {
+            if (this.udpPort) {
+                this.udpPort.close();
+                this.isConnected = false;
+                this.udpPort = null;
+                this.emit('disconnected');
+                resolve();
+            }
+            else {
+                resolve();
+            }
+        });
+    }
+    /**
+     * Send OSC message and wait for response
+     */
+    async sendMessage(address, args = [], waitForReply = true) {
+        if (!this.isConnected || !this.udpPort) {
+            throw new Error('Not connected to X32/M32');
+        }
+        return new Promise((resolve, reject) => {
+            if (!this.udpPort) {
+                reject(new Error('UDP port not initialized'));
+                return;
+            }
+            if (waitForReply) {
+                const timeout = setTimeout(() => {
+                    this.messageQueue.delete(address);
+                    reject(new Error(`Timeout waiting for response from ${address}`));
+                }, this.DEFAULT_TIMEOUT);
+                this.messageQueue.set(address, {
+                    resolve: (msg) => {
+                        clearTimeout(timeout);
+                        this.messageQueue.delete(address);
+                        resolve(msg);
+                    },
+                    timeout
+                });
+            }
+            try {
+                this.udpPort.send({
+                    address,
+                    args: args.map(arg => {
+                        if (typeof arg === 'number') {
+                            if (Number.isInteger(arg)) {
+                                return { type: 'i', value: arg };
+                            }
+                            return { type: 'f', value: arg };
+                        }
+                        else if (typeof arg === 'string') {
+                            return { type: 's', value: arg };
+                        }
+                        else if (Buffer.isBuffer(arg)) {
+                            return { type: 'b', value: arg };
+                        }
+                        return { type: 's', value: String(arg) };
+                    })
+                });
+                if (!waitForReply) {
+                    resolve(null);
+                }
+            }
+            catch (err) {
+                if (waitForReply) {
+                    const queueItem = this.messageQueue.get(address);
+                    if (queueItem) {
+                        clearTimeout(queueItem.timeout);
+                        this.messageQueue.delete(address);
+                    }
+                }
+                reject(err);
+            }
+        });
+    }
+    /**
+     * Get X32/M32 info
+     */
+    async getInfo() {
+        const response = await this.sendMessage('/info');
+        if (!response) {
+            throw new Error('No response from /info');
+        }
+        // Parse response: /info,ssss~V2.05~osc-server~X32~2.12
+        const args = response.args;
+        if (args.length < 4) {
+            throw new Error('Invalid /info response format');
+        }
+        return {
+            serverVersion: String(args[0].value),
+            serverName: String(args[1].value),
+            consoleModel: String(args[2].value),
+            consoleVersion: String(args[3].value)
+        };
+    }
+    /**
+     * Get X32/M32 status
+     */
+    async getStatus() {
+        const response = await this.sendMessage('/status');
+        if (!response) {
+            throw new Error('No response from /status');
+        }
+        // Parse response: /status,sss~active~192.168.0.64~osc-server
+        const args = response.args;
+        if (args.length < 3) {
+            throw new Error('Invalid /status response format');
+        }
+        return {
+            state: String(args[0].value),
+            ipAddress: String(args[1].value),
+            serverName: String(args[2].value)
+        };
+    }
+    /**
+     * Check if connected
+     */
+    get connected() {
+        return this.isConnected;
+    }
+    /**
+     * Get connection config
+     */
+    getConfig() {
+        return this.config;
+    }
+    /**
+     * Get parameter value from X32/M32
+     * @param address OSC address pattern (e.g., '/ch/01/mix/fader')
+     * @returns Parameter value
+     */
+    async getParameter(address) {
+        const response = await this.sendMessage(address);
+        if (!response || !response.args || response.args.length === 0) {
+            throw new Error(`No value returned from ${address}`);
+        }
+        return response.args[0].value;
+    }
+    /**
+     * Set parameter value on X32/M32
+     * @param address OSC address pattern
+     * @param value Value to set (string, number, or buffer)
+     */
+    async setParameter(address, value) {
+        await this.sendMessage(address, [value], false);
+    }
+    /**
+     * Get channel parameter
+     * @param channel Channel number (1-32)
+     * @param param Parameter path (e.g., 'config/name', 'mix/fader')
+     * @returns Parameter value
+     */
+    async getChannelParameter(channel, param) {
+        if (channel < 1 || channel > 32) {
+            throw new Error('Channel must be between 1 and 32');
+        }
+        const ch = channel.toString().padStart(2, '0');
+        return this.getParameter(`/ch/${ch}/${param}`);
+    }
+    /**
+     * Set channel parameter
+     * @param channel Channel number (1-32)
+     * @param param Parameter path (e.g., 'config/name', 'mix/fader')
+     * @param value Value to set
+     */
+    async setChannelParameter(channel, param, value) {
+        if (channel < 1 || channel > 32) {
+            throw new Error('Channel must be between 1 and 32');
+        }
+        const ch = channel.toString().padStart(2, '0');
+        await this.setParameter(`/ch/${ch}/${param}`, value);
+    }
+    /**
+     * Get bus parameter
+     * @param bus Bus number (1-16)
+     * @param param Parameter path (e.g., 'mix/fader', 'mix/on')
+     * @returns Parameter value
+     */
+    async getBusParameter(bus, param) {
+        if (bus < 1 || bus > 16) {
+            throw new Error('Bus must be between 1 and 16');
+        }
+        const busNum = bus.toString().padStart(2, '0');
+        return this.getParameter(`/bus/${busNum}/${param}`);
+    }
+    /**
+     * Set bus parameter
+     * @param bus Bus number (1-16)
+     * @param param Parameter path (e.g., 'mix/fader', 'mix/on')
+     * @param value Value to set
+     */
+    async setBusParameter(bus, param, value) {
+        if (bus < 1 || bus > 16) {
+            throw new Error('Bus must be between 1 and 16');
+        }
+        const busNum = bus.toString().padStart(2, '0');
+        await this.setParameter(`/bus/${busNum}/${param}`, value);
+    }
+    /**
+     * Handle incoming OSC message
+     */
+    handleIncomingMessage(oscMsg) {
+        const message = {
+            address: oscMsg.address,
+            args: oscMsg.args || []
+        };
+        this.emit('message', message);
+        // Check if there's a pending request for this address
+        const queueItem = this.messageQueue.get(message.address);
+        if (queueItem) {
+            queueItem.resolve(message);
+        }
+    }
+}
+//# sourceMappingURL=x32-connection.js.map

package/dist/esm/services/x32-connection.js.map

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

package/dist/esm/shared/auth-utils.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Utilities for handling OAuth resource URIs.
+ */
+/**
+ * Converts a server URL to a resource URL by removing the fragment.
+ * RFC 8707 section 2 states that resource URIs "MUST NOT include a fragment component".
+ * Keeps everything else unchanged (scheme, domain, port, path, query).
+ */
+export declare function resourceUrlFromServerUrl(url: URL | string): URL;
+/**
+ * Checks if a requested resource URL matches a configured resource URL.
+ * A requested resource matches if it has the same scheme, domain, port,
+ * and its path starts with the configured resource's path.
+ *
+ * @param requestedResource The resource URL being requested
+ * @param configuredResource The resource URL that has been configured
+ * @returns true if the requested resource matches the configured resource, false otherwise
+ */
+export declare function checkResourceAllowed({ requestedResource, configuredResource }: {
+    requestedResource: URL | string;
+    configuredResource: URL | string;
+}): boolean;
+//# sourceMappingURL=auth-utils.d.ts.map

package/dist/esm/shared/auth-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-utils.d.ts","sourceRoot":"","sources":["../../../src/shared/auth-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,GAAG,GAAG,CAI/D;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,EACjC,iBAAiB,EACjB,kBAAkB,EACrB,EAAE;IACC,iBAAiB,EAAE,GAAG,GAAG,MAAM,CAAC;IAChC,kBAAkB,EAAE,GAAG,GAAG,MAAM,CAAC;CACpC,GAAG,OAAO,CAwBV"}

package/dist/esm/shared/auth-utils.js

@@ -0,0 +1,44 @@
+/**
+ * Utilities for handling OAuth resource URIs.
+ */
+/**
+ * Converts a server URL to a resource URL by removing the fragment.
+ * RFC 8707 section 2 states that resource URIs "MUST NOT include a fragment component".
+ * Keeps everything else unchanged (scheme, domain, port, path, query).
+ */
+export function resourceUrlFromServerUrl(url) {
+    const resourceURL = typeof url === 'string' ? new URL(url) : new URL(url.href);
+    resourceURL.hash = ''; // Remove fragment
+    return resourceURL;
+}
+/**
+ * Checks if a requested resource URL matches a configured resource URL.
+ * A requested resource matches if it has the same scheme, domain, port,
+ * and its path starts with the configured resource's path.
+ *
+ * @param requestedResource The resource URL being requested
+ * @param configuredResource The resource URL that has been configured
+ * @returns true if the requested resource matches the configured resource, false otherwise
+ */
+export function checkResourceAllowed({ requestedResource, configuredResource }) {
+    const requested = typeof requestedResource === 'string' ? new URL(requestedResource) : new URL(requestedResource.href);
+    const configured = typeof configuredResource === 'string' ? new URL(configuredResource) : new URL(configuredResource.href);
+    // Compare the origin (scheme, domain, and port)
+    if (requested.origin !== configured.origin) {
+        return false;
+    }
+    // Handle cases like requested=/foo and configured=/foo/
+    if (requested.pathname.length < configured.pathname.length) {
+        return false;
+    }
+    // Check if the requested path starts with the configured path
+    // Ensure both paths end with / for proper comparison
+    // This ensures that if we have paths like "/api" and "/api/users",
+    // we properly detect that "/api/users" is a subpath of "/api"
+    // By adding a trailing slash if missing, we avoid false positives
+    // where paths like "/api123" would incorrectly match "/api"
+    const requestedPath = requested.pathname.endsWith('/') ? requested.pathname : requested.pathname + '/';
+    const configuredPath = configured.pathname.endsWith('/') ? configured.pathname : configured.pathname + '/';
+    return requestedPath.startsWith(configuredPath);
+}
+//# sourceMappingURL=auth-utils.js.map

package/dist/esm/shared/auth-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-utils.js","sourceRoot":"","sources":["../../../src/shared/auth-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,GAAiB;IACtD,MAAM,WAAW,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/E,WAAW,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC,kBAAkB;IACzC,OAAO,WAAW,CAAC;AACvB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAAC,EACjC,iBAAiB,EACjB,kBAAkB,EAIrB;IACG,MAAM,SAAS,GAAG,OAAO,iBAAiB,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACvH,MAAM,UAAU,GAAG,OAAO,kBAAkB,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAE3H,gDAAgD;IAChD,IAAI,SAAS,CAAC,MAAM,KAAK,UAAU,CAAC,MAAM,EAAE,CAAC;QACzC,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,wDAAwD;IACxD,IAAI,SAAS,CAAC,QAAQ,CAAC,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;QACzD,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,8DAA8D;IAC9D,qDAAqD;IACrD,mEAAmE;IACnE,8DAA8D;IAC9D,kEAAkE;IAClE,4DAA4D;IAC5D,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,GAAG,GAAG,CAAC;IACvG,MAAM,cAAc,GAAG,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,GAAG,GAAG,CAAC;IAE3G,OAAO,aAAa,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;AACpD,CAAC"}