util.mjs - MIDI utility functions Copyright (C) 2022 Strudel contributors - see https://codeberg.org/uzu/strudel/src/branch/main/packages/midi/midi.mjs This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details. You should have received a copy of the GNU Affero General Public License along with this program. If not, see https://www.gnu.org/licenses/.

7import { Input, Output } from 'webmidi';

Get a string listing device names for error messages. @param {Input[] | Output[]} devices @returns {string}

14export function getMidiDeviceNamesString(devices) {
15  return devices.map((o) => `'${o.name}'`).join(' | ');
16}

Look up a device by index or name. Otherwise return a default device, or fail if none are connected.

@param {string | number} indexOrName @param {Input[] | Output[]} devices @returns {Input | Output | undefined}

25export function getDevice(indexOrName, devices) {
26  if (typeof indexOrName === 'number') {
27    return devices[indexOrName];
28  }
29  const byName = (name) => devices.find((output) => output.name.includes(name));
30  if (typeof indexOrName === 'string') {
31    return byName(indexOrName);
32  }
33  // attempt to default to first IAC device if none is specified
34  const IACOutput = byName('IAC');
35  const device = IACOutput ?? devices[0];
36  if (!device) {
37    if (!devices.length) {
38      throw new Error(`🔌 No MIDI devices found. Connect a device or enable IAC Driver.`);
39    }
40    throw new Error(`🔌 Default MIDI device not found. Use one of ${getMidiDeviceNamesString(devices)}`);
41  }
42
43  return device;
44}