Media Sources

[goto-bus-stop]

Implements a simple, pluggable media source API.

Sources are registered using a source() method:

import ytSource from 'u-wave-source-youtube';
import scSource from 'u-wave-source-soundcloud';
uwave.source('youtube', ytSource, { key: 'API_KEY_HERE' });
uwave.source('soundcloud', scSource, { key: 'API_KEY_HERE' });

Then searches can be run like:

uwave.source('youtube').search('Query', pageToken);
uwave.source('soundcloud').search('Query', pageOffset);

The search pagination implementation is incomplete.

[goto-bus-stop]

Oh-- it might be useful to also pass the üWave core object and the current user to Sources, so that a Source could use the üWave Play History, or the current user's liked videos on YouTube, or use the current user's preferences to hide videos that are not available in their country.

Passing the üWave core object is fairly simple, but the current user would have to be passed to each method call.

[goto-bus-stop]

Although that might be over-engineering it.

[goto-bus-stop]

Took a few clues from Browserify's plugin() implementation, so this allows Sources to take a üWave object in their first parameter.

[goto-bus-stop]

A "current user's playlists" source cannot yet be implemented with this, but I'll merge this now to get a cleaner api-v1 repo, anyway.