x-m32-mcp-server 2.1.0

package/dist/utils/color-converter.js

@@ -0,0 +1,79 @@
+/**
+ * X32/M32 channel color utilities
+ * Handles color mapping for channel strip colors
+ */
+/**
+ * X32 Color Map
+ * The X32 uses integer values 0-15 for channel colors
+ */
+export const X32_COLORS = {
+    OFF: 0, // Off/Black (no color)
+    RED: 1, // Red
+    GREEN: 2, // Green
+    YELLOW: 3, // Yellow
+    BLUE: 4, // Blue
+    MAGENTA: 5, // Magenta
+    CYAN: 6, // Cyan
+    WHITE: 7, // White
+    OFF_INV: 8, // Off Inverted
+    RED_INV: 9, // Red Inverted
+    GREEN_INV: 10, // Green Inverted
+    YELLOW_INV: 11, // Yellow Inverted
+    BLUE_INV: 12, // Blue Inverted
+    MAGENTA_INV: 13, // Magenta Inverted
+    CYAN_INV: 14, // Cyan Inverted
+    WHITE_INV: 15 // White Inverted
+};
+/**
+ * Get color value from name
+ * @param colorName - Color name (case-insensitive)
+ * @returns Color integer value (0-15) or null if invalid
+ */
+export function getColorValue(colorName) {
+    const upperName = colorName.toUpperCase().replace(/[\s-]/g, '_');
+    // Check direct match
+    if (upperName in X32_COLORS) {
+        return X32_COLORS[upperName];
+    }
+    // Check without _INV suffix for inverted colors
+    const invName = `${upperName}_INV`;
+    if (invName in X32_COLORS) {
+        return X32_COLORS[invName];
+    }
+    // Try parsing as number
+    const num = parseInt(colorName, 10);
+    if (!isNaN(num) && num >= 0 && num <= 15) {
+        return num;
+    }
+    return null;
+}
+/**
+ * Get color name from value
+ * @param value - Color integer value (0-15)
+ * @returns Color name or null if invalid
+ */
+export function getColorName(value) {
+    for (const [name, val] of Object.entries(X32_COLORS)) {
+        if (val === value) {
+            return name.toLowerCase().replace(/_/g, '-');
+        }
+    }
+    return null;
+}
+/**
+ * Get list of available color names
+ * @returns Array of color names
+ */
+export function getAvailableColors() {
+    return Object.keys(X32_COLORS).map(name => name.toLowerCase().replace(/_/g, '-'));
+}
+/**
+ * Format color for display
+ * @param value - Color integer value
+ * @returns Formatted color string
+ */
+export function formatColor(value) {
+    const name = getColorName(value);
+    return name || `Color ${value}`;
+}
+//# sourceMappingURL=color-converter.js.map

package/dist/utils/color-converter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-converter.js","sourceRoot":"","sources":["../../src/utils/color-converter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACtB,GAAG,EAAE,CAAC,EAAS,uBAAuB;IACtC,GAAG,EAAE,CAAC,EAAS,MAAM;IACrB,KAAK,EAAE,CAAC,EAAO,QAAQ;IACvB,MAAM,EAAE,CAAC,EAAM,SAAS;IACxB,IAAI,EAAE,CAAC,EAAQ,OAAO;IACtB,OAAO,EAAE,CAAC,EAAK,UAAU;IACzB,IAAI,EAAE,CAAC,EAAQ,OAAO;IACtB,KAAK,EAAE,CAAC,EAAO,QAAQ;IACvB,OAAO,EAAE,CAAC,EAAK,eAAe;IAC9B,OAAO,EAAE,CAAC,EAAK,eAAe;IAC9B,SAAS,EAAE,EAAE,EAAE,iBAAiB;IAChC,UAAU,EAAE,EAAE,EAAC,kBAAkB;IACjC,QAAQ,EAAE,EAAE,EAAG,gBAAgB;IAC/B,WAAW,EAAE,EAAE,EAAC,mBAAmB;IACnC,QAAQ,EAAE,EAAE,EAAG,gBAAgB;IAC/B,SAAS,EAAE,EAAE,CAAE,iBAAiB;CAC1B,CAAC;AAOX;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,SAAiB;IAC3C,MAAM,SAAS,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAEjE,qBAAqB;IACrB,IAAI,SAAS,IAAI,UAAU,EAAE,CAAC;QAC1B,OAAO,UAAU,CAAC,SAAsB,CAAC,CAAC;IAC9C,CAAC;IAED,gDAAgD;IAChD,MAAM,OAAO,GAAG,GAAG,SAAS,MAAM,CAAC;IACnC,IAAI,OAAO,IAAI,UAAU,EAAE,CAAC;QACxB,OAAO,UAAU,CAAC,OAAoB,CAAC,CAAC;IAC5C,CAAC;IAED,wBAAwB;IACxB,MAAM,GAAG,GAAG,QAAQ,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IACpC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,EAAE,EAAE,CAAC;QACvC,OAAO,GAAG,CAAC;IACf,CAAC;IAED,OAAO,IAAI,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa;IACtC,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QACnD,IAAI,GAAG,KAAK,KAAK,EAAE,CAAC;YAChB,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACjD,CAAC;IACL,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB;IAC9B,OAAO,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CACtC,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CACxC,CAAC;AACN,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa;IACrC,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IACjC,OAAO,IAAI,IAAI,SAAS,KAAK,EAAE,CAAC;AACpC,CAAC"}

package/dist/utils/db-converter.d.ts

@@ -0,0 +1,58 @@
+/**
+ * X32/M32 dB conversion utilities
+ * Handles conversion between linear fader values (0.0-1.0) and dB values
+ */
+/**
+ * Convert dB value to linear fader value (0.0-1.0)
+ * X32 fader range: -∞ dB to +10 dB
+ *
+ * Key points:
+ * - -∞ dB (off) = 0.0
+ * - -90 dB ≈ 0.0 (practical minimum)
+ * - 0 dB (unity) ≈ 0.75
+ * - +10 dB (max) = 1.0
+ *
+ * @param db - Decibel value (-90 to +10)
+ * @returns Linear fader value (0.0 to 1.0)
+ */
+export declare function dbToFader(db: number): number;
+/**
+ * Convert linear fader value (0.0-1.0) to dB value
+ *
+ * @param fader - Linear fader value (0.0 to 1.0)
+ * @returns Decibel value (-∞ to +10)
+ */
+export declare function faderToDb(fader: number): number;
+/**
+ * Common dB presets for quick access
+ */
+export declare const DB_PRESETS: {
+    OFF: number;
+    MINUS_90: number;
+    MINUS_60: number;
+    MINUS_30: number;
+    MINUS_20: number;
+    MINUS_10: number;
+    MINUS_6: number;
+    MINUS_3: number;
+    UNITY: number;
+    PLUS_3: number;
+    PLUS_6: number;
+    PLUS_10: number;
+};
+/**
+ * Format dB value for display
+ *
+ * @param db - Decibel value
+ * @returns Formatted string (e.g., "0.0 dB", "-∞ dB", "+6.0 dB")
+ */
+export declare function formatDb(db: number): string;
+/**
+ * Parse dB value from string input
+ * Accepts formats: "0", "0dB", "0 dB", "+6dB", "-10 dB", "-inf", "-∞"
+ *
+ * @param input - String representation of dB value
+ * @returns Parsed dB value or null if invalid
+ */
+export declare function parseDb(input: string): number | null;
+//# sourceMappingURL=db-converter.d.ts.map

package/dist/utils/db-converter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-converter.d.ts","sourceRoot":"","sources":["../../src/utils/db-converter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CA6B5C;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAsB/C;AAED;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;CAatB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAM3C;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAsBpD"}

package/dist/utils/db-converter.js

@@ -0,0 +1,143 @@
+/**
+ * X32/M32 dB conversion utilities
+ * Handles conversion between linear fader values (0.0-1.0) and dB values
+ */
+/**
+ * Convert dB value to linear fader value (0.0-1.0)
+ * X32 fader range: -∞ dB to +10 dB
+ *
+ * Key points:
+ * - -∞ dB (off) = 0.0
+ * - -90 dB ≈ 0.0 (practical minimum)
+ * - 0 dB (unity) ≈ 0.75
+ * - +10 dB (max) = 1.0
+ *
+ * @param db - Decibel value (-90 to +10)
+ * @returns Linear fader value (0.0 to 1.0)
+ */
+export function dbToFader(db) {
+    // Handle special cases
+    if (db <= -90)
+        return 0.0; // -∞ dB or below practical minimum
+    if (db >= 10)
+        return 1.0; // Maximum +10 dB
+    // X32 uses a specific logarithmic curve for fader values
+    // Approximation based on X32 fader behavior:
+    // -90 dB to -60 dB: 0.0 to 0.025 (very fine control at bottom)
+    // -60 dB to -30 dB: 0.025 to 0.137
+    // -30 dB to -10 dB: 0.137 to 0.397
+    // -10 dB to 0 dB: 0.397 to 0.75 (unity gain)
+    // 0 dB to +10 dB: 0.75 to 1.0
+    if (db <= -60) {
+        // -90 to -60 dB: linear mapping to 0.0-0.025
+        return ((db + 90) / 30) * 0.025;
+    }
+    else if (db <= -30) {
+        // -60 to -30 dB: linear mapping to 0.025-0.137
+        return 0.025 + ((db + 60) / 30) * 0.112;
+    }
+    else if (db <= -10) {
+        // -30 to -10 dB: linear mapping to 0.137-0.397
+        return 0.137 + ((db + 30) / 20) * 0.26;
+    }
+    else if (db <= 0) {
+        // -10 to 0 dB: linear mapping to 0.397-0.75
+        return 0.397 + ((db + 10) / 10) * 0.353;
+    }
+    else {
+        // 0 to +10 dB: linear mapping to 0.75-1.0
+        return 0.75 + (db / 10) * 0.25;
+    }
+}
+/**
+ * Convert linear fader value (0.0-1.0) to dB value
+ *
+ * @param fader - Linear fader value (0.0 to 1.0)
+ * @returns Decibel value (-∞ to +10)
+ */
+export function faderToDb(fader) {
+    // Clamp input
+    if (fader <= 0)
+        return -Infinity;
+    if (fader >= 1)
+        return 10;
+    // Inverse mapping of dbToFader
+    if (fader <= 0.025) {
+        // 0.0-0.025: -90 to -60 dB
+        return -90 + (fader / 0.025) * 30;
+    }
+    else if (fader <= 0.137) {
+        // 0.025-0.137: -60 to -30 dB
+        return -60 + ((fader - 0.025) / 0.112) * 30;
+    }
+    else if (fader <= 0.397) {
+        // 0.137-0.397: -30 to -10 dB
+        return -30 + ((fader - 0.137) / 0.26) * 20;
+    }
+    else if (fader <= 0.75) {
+        // 0.397-0.75: -10 to 0 dB
+        return -10 + ((fader - 0.397) / 0.353) * 10;
+    }
+    else {
+        // 0.75-1.0: 0 to +10 dB
+        return ((fader - 0.75) / 0.25) * 10;
+    }
+}
+/**
+ * Common dB presets for quick access
+ */
+export const DB_PRESETS = {
+    OFF: -Infinity, // Fader all the way down
+    MINUS_90: -90, // Practical minimum
+    MINUS_60: -60, // Very quiet
+    MINUS_30: -30, // Quiet
+    MINUS_20: -20, // Below nominal
+    MINUS_10: -10, // 10 dB below unity
+    MINUS_6: -6, // 6 dB below unity
+    MINUS_3: -3, // 3 dB below unity
+    UNITY: 0, // Unity gain (0 dB)
+    PLUS_3: 3, // 3 dB above unity
+    PLUS_6: 6, // 6 dB above unity
+    PLUS_10: 10, // Maximum
+};
+/**
+ * Format dB value for display
+ *
+ * @param db - Decibel value
+ * @returns Formatted string (e.g., "0.0 dB", "-∞ dB", "+6.0 dB")
+ */
+export function formatDb(db) {
+    if (db === -Infinity || db <= -90) {
+        return '-∞ dB';
+    }
+    const sign = db > 0 ? '+' : '';
+    return `${sign}${db.toFixed(1)} dB`;
+}
+/**
+ * Parse dB value from string input
+ * Accepts formats: "0", "0dB", "0 dB", "+6dB", "-10 dB", "-inf", "-∞"
+ *
+ * @param input - String representation of dB value
+ * @returns Parsed dB value or null if invalid
+ */
+export function parseDb(input) {
+    const normalized = input.trim().toLowerCase();
+    // Check for infinity
+    if (normalized === '-inf' || normalized === '-∞' || normalized === '-infinity') {
+        return -Infinity;
+    }
+    // Remove 'db' suffix and spaces
+    const cleaned = normalized.replace(/\s*db$/i, '').trim();
+    // Parse the number
+    const value = parseFloat(cleaned);
+    if (isNaN(value)) {
+        return null;
+    }
+    // Clamp to valid range
+    if (value <= -90)
+        return -Infinity;
+    if (value > 10)
+        return 10;
+    return value;
+}
+//# sourceMappingURL=db-converter.js.map

package/dist/utils/db-converter.js.map

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

package/dist/utils/pan-converter.d.ts

@@ -0,0 +1,56 @@
+/**
+ * X32/M32 pan (stereo positioning) utilities
+ * Handles conversion between linear pan values and percentage/LR notation
+ */
+/**
+ * Convert percentage pan value to linear (0.0-1.0)
+ * -100% (full left) = 0.0
+ * 0% (center) = 0.5
+ * +100% (full right) = 1.0
+ *
+ * @param percent - Pan percentage (-100 to +100)
+ * @returns Linear pan value (0.0 to 1.0)
+ */
+export declare function percentToPan(percent: number): number;
+/**
+ * Convert linear pan value (0.0-1.0) to percentage
+ *
+ * @param pan - Linear pan value (0.0 to 1.0)
+ * @returns Pan percentage (-100 to +100)
+ */
+export declare function panToPercent(pan: number): number;
+/**
+ * Convert LR notation to linear pan value
+ * L50 = 50% left = 0.25
+ * C = center = 0.5
+ * R50 = 50% right = 0.75
+ * L100 = full left = 0.0
+ * R100 = full right = 1.0
+ *
+ * @param lr - LR notation string (e.g., "L50", "C", "R100")
+ * @returns Linear pan value (0.0 to 1.0) or null if invalid
+ */
+export declare function lrToPan(lr: string): number | null;
+/**
+ * Convert linear pan value to LR notation
+ *
+ * @param pan - Linear pan value (0.0 to 1.0)
+ * @returns LR notation string
+ */
+export declare function panToLr(pan: number): string;
+/**
+ * Format pan value for display
+ *
+ * @param pan - Linear pan value (0.0 to 1.0)
+ * @returns Formatted string (e.g., "L50", "C", "R75")
+ */
+export declare function formatPan(pan: number): string;
+/**
+ * Parse pan value from various input formats
+ * Accepts: percentage (-100 to 100), LR notation ("L50", "R100"), or linear (0.0-1.0)
+ *
+ * @param input - Pan value in various formats
+ * @returns Linear pan value (0.0 to 1.0) or null if invalid
+ */
+export declare function parsePan(input: string | number): number | null;
+//# sourceMappingURL=pan-converter.d.ts.map

package/dist/utils/pan-converter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pan-converter.d.ts","sourceRoot":"","sources":["../../src/utils/pan-converter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAKpD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKhD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA4BjD;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAU3C;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CA2B9D"}

package/dist/utils/pan-converter.js

@@ -0,0 +1,127 @@
+/**
+ * X32/M32 pan (stereo positioning) utilities
+ * Handles conversion between linear pan values and percentage/LR notation
+ */
+/**
+ * Convert percentage pan value to linear (0.0-1.0)
+ * -100% (full left) = 0.0
+ * 0% (center) = 0.5
+ * +100% (full right) = 1.0
+ *
+ * @param percent - Pan percentage (-100 to +100)
+ * @returns Linear pan value (0.0 to 1.0)
+ */
+export function percentToPan(percent) {
+    // Clamp to valid range
+    const clamped = Math.max(-100, Math.min(100, percent));
+    // Convert: -100 to +100 => 0.0 to 1.0
+    return (clamped + 100) / 200;
+}
+/**
+ * Convert linear pan value (0.0-1.0) to percentage
+ *
+ * @param pan - Linear pan value (0.0 to 1.0)
+ * @returns Pan percentage (-100 to +100)
+ */
+export function panToPercent(pan) {
+    // Clamp to valid range
+    const clamped = Math.max(0, Math.min(1, pan));
+    // Convert: 0.0 to 1.0 => -100 to +100
+    return (clamped * 200) - 100;
+}
+/**
+ * Convert LR notation to linear pan value
+ * L50 = 50% left = 0.25
+ * C = center = 0.5
+ * R50 = 50% right = 0.75
+ * L100 = full left = 0.0
+ * R100 = full right = 1.0
+ *
+ * @param lr - LR notation string (e.g., "L50", "C", "R100")
+ * @returns Linear pan value (0.0 to 1.0) or null if invalid
+ */
+export function lrToPan(lr) {
+    const normalized = lr.toUpperCase().trim();
+    // Handle center
+    if (normalized === 'C' || normalized === 'CENTER') {
+        return 0.5;
+    }
+    // Handle L/R notation
+    const match = normalized.match(/^([LR])(\d+)?$/);
+    if (!match) {
+        return null;
+    }
+    const side = match[1];
+    const amount = match[2] ? parseInt(match[2], 10) : 100;
+    if (amount < 0 || amount > 100) {
+        return null;
+    }
+    if (side === 'L') {
+        // Left: L100 = 0.0, L50 = 0.25, L0 = 0.5
+        return 0.5 - (amount / 200);
+    }
+    else {
+        // Right: R0 = 0.5, R50 = 0.75, R100 = 1.0
+        return 0.5 + (amount / 200);
+    }
+}
+/**
+ * Convert linear pan value to LR notation
+ *
+ * @param pan - Linear pan value (0.0 to 1.0)
+ * @returns LR notation string
+ */
+export function panToLr(pan) {
+    const percent = panToPercent(pan);
+    if (Math.abs(percent) < 0.5) {
+        return 'C';
+    }
+    else if (percent < 0) {
+        return `L${Math.round(Math.abs(percent))}`;
+    }
+    else {
+        return `R${Math.round(percent)}`;
+    }
+}
+/**
+ * Format pan value for display
+ *
+ * @param pan - Linear pan value (0.0 to 1.0)
+ * @returns Formatted string (e.g., "L50", "C", "R75")
+ */
+export function formatPan(pan) {
+    return panToLr(pan);
+}
+/**
+ * Parse pan value from various input formats
+ * Accepts: percentage (-100 to 100), LR notation ("L50", "R100"), or linear (0.0-1.0)
+ *
+ * @param input - Pan value in various formats
+ * @returns Linear pan value (0.0 to 1.0) or null if invalid
+ */
+export function parsePan(input) {
+    if (typeof input === 'number') {
+        if (input >= -100 && input <= 100) {
+            // Assume percentage
+            return percentToPan(input);
+        }
+        else if (input >= 0 && input <= 1) {
+            // Assume linear
+            return input;
+        }
+        return null;
+    }
+    const str = input.trim();
+    // Try LR notation first
+    const lrValue = lrToPan(str);
+    if (lrValue !== null) {
+        return lrValue;
+    }
+    // Try parsing as number
+    const num = parseFloat(str);
+    if (!isNaN(num)) {
+        return parsePan(num);
+    }
+    return null;
+}
+//# sourceMappingURL=pan-converter.js.map

package/dist/utils/pan-converter.js.map

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

package/package.json

@@ -0,0 +1,145 @@
+{
+    "name": "x-m32-mcp-server",
+    "version": "2.1.0",
+    "description": "MCP server for controlling Behringer X32/M32 digital mixing consoles via OSC",
+    "license": "MIT",
+    "author": "Beomsu Koh",
+    "homepage": "https://github.com/GoBeromsu/X32-MCP",
+    "bugs": "https://github.com/GoBeromsu/X32-MCP/issues",
+    "type": "module",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/GoBeromsu/X32-MCP.git"
+    },
+    "main": "dist/index.js",
+    "bin": {
+        "x-m32-mcp-server": "dist/index.js"
+    },
+    "engines": {
+        "node": ">=18"
+    },
+    "keywords": [
+        "modelcontextprotocol",
+        "mcp",
+        "x32",
+        "m32",
+        "behringer",
+        "osc",
+        "mixer",
+        "audio",
+        "live-sound"
+    ],
+    "exports": {
+        ".": {
+            "import": "./dist/esm/index.js",
+            "require": "./dist/cjs/index.js"
+        },
+        "./client": {
+            "import": "./dist/esm/client/index.js",
+            "require": "./dist/cjs/client/index.js"
+        },
+        "./server": {
+            "import": "./dist/esm/server/index.js",
+            "require": "./dist/cjs/server/index.js"
+        },
+        "./validation": {
+            "import": "./dist/esm/validation/index.js",
+            "require": "./dist/cjs/validation/index.js"
+        },
+        "./validation/ajv": {
+            "import": "./dist/esm/validation/ajv-provider.js",
+            "require": "./dist/cjs/validation/ajv-provider.js"
+        },
+        "./validation/cfworker": {
+            "import": "./dist/esm/validation/cfworker-provider.js",
+            "require": "./dist/cjs/validation/cfworker-provider.js"
+        },
+        "./*": {
+            "import": "./dist/esm/*",
+            "require": "./dist/cjs/*"
+        }
+    },
+    "typesVersions": {
+        "*": {
+            "*": [
+                "./dist/esm/*"
+            ]
+        }
+    },
+    "files": [
+        "dist"
+    ],
+    "scripts": {
+        "fetch:spec-types": "tsx scripts/fetch-spec-types.ts",
+        "typecheck": "tsgo --noEmit",
+        "build": "npm run build:esm && npm run build:cjs",
+        "build:esm": "mkdir -p dist/esm && echo '{\"type\": \"module\"}' > dist/esm/package.json && tsc -p tsconfig.prod.json",
+        "build:esm:w": "npm run build:esm -- -w",
+        "build:cjs": "mkdir -p dist/cjs && echo '{\"type\": \"commonjs\"}' > dist/cjs/package.json && tsc -p tsconfig.cjs.json",
+        "build:cjs:w": "npm run build:cjs -- -w",
+        "examples:simple-server:w": "tsx --watch src/examples/server/simpleStreamableHttp.ts --oauth",
+        "prepack": "npm run build:esm && npm run build:cjs",
+        "lint": "eslint src/ && prettier --check .",
+        "lint:fix": "eslint src/ --fix && prettier --write .",
+        "check": "npm run typecheck && npm run lint",
+        "test": "jest",
+        "start": "npm run server",
+        "server": "tsx watch --clear-screen=false scripts/cli.ts server",
+        "client": "tsx scripts/cli.ts client",
+        "x32:server": "tsx src/x32-server/index.ts",
+        "x32:test": "tsx test/x32-connection.test.ts"
+    },
+    "dependencies": {
+        "ajv": "^8.17.1",
+        "ajv-formats": "^3.0.1",
+        "content-type": "^1.0.5",
+        "cors": "^2.8.5",
+        "cross-spawn": "^7.0.5",
+        "eventsource": "^3.0.2",
+        "eventsource-parser": "^3.0.0",
+        "express": "^5.0.1",
+        "express-rate-limit": "^7.5.0",
+        "osc": "^2.4.4",
+        "pkce-challenge": "^5.0.0",
+        "raw-body": "^3.0.0",
+        "zod": "^3.23.8",
+        "zod-to-json-schema": "^3.24.1"
+    },
+    "peerDependencies": {
+        "@cfworker/json-schema": "^4.1.1"
+    },
+    "peerDependenciesMeta": {
+        "@cfworker/json-schema": {
+            "optional": true
+        }
+    },
+    "devDependencies": {
+        "@cfworker/json-schema": "^4.1.1",
+        "@eslint/js": "^9.8.0",
+        "@jest-mock/express": "^3.0.0",
+        "@types/content-type": "^1.1.8",
+        "@types/cors": "^2.8.17",
+        "@types/cross-spawn": "^6.0.6",
+        "@types/eslint__js": "^8.42.3",
+        "@types/eventsource": "^1.1.15",
+        "@types/express": "^5.0.0",
+        "@types/jest": "^29.5.12",
+        "@types/node": "^22.0.2",
+        "@types/supertest": "^6.0.2",
+        "@types/ws": "^8.5.12",
+        "@typescript/native-preview": "^7.0.0-dev.20251103.1",
+        "eslint": "^9.8.0",
+        "eslint-config-prettier": "^10.1.8",
+        "jest": "^29.7.0",
+        "prettier": "3.6.2",
+        "supertest": "^7.0.0",
+        "ts-jest": "^29.2.4",
+        "tsx": "^4.16.5",
+        "typescript": "^5.5.4",
+        "typescript-eslint": "^8.0.0",
+        "ws": "^8.18.0"
+    },
+    "resolutions": {
+        "strip-ansi": "6.0.1"
+    }
+}