[WIP] Update Manager Refactor

[jaxwilko]

Me and Luke are working on a little refactor of how the UpdateManager works...

It also includes some components from my old composer PR found here: #967

The core idea of this is that there should be consistent interfaces to interact with different things built on top of Winter (i.e. modules, plugins & themes). Each of these elements will now have their class (i.e. Theme, PluginBase, ModuleServiceProvider) will now extend WinterExtension which will allow them to all interact with the update manager and other system functions directly.

In addition PluginManager, ThemeManager & ModuleManager (new) will all implement the ExtensionManager interface, which will allow for a consistant way to interact with all Winter extensions.

I.e. You will be able to call PluginManager::instance()->update($plugin) or ThemeManager::instance()->update($theme).

This also allows us to do some cool stuff like (only support for plugin installing is currently functional)

(new ExtensionSource(
    ExtensionSource::SOURCE_COMPOSER,
    ExtensionSource::TYPE_PLUGIN,
    composerPackage: 'jaxwilko/datamigrator'
))->install();

(new ExtensionSource(
    ExtensionSource::SOURCE_COMPOSER,
    ExtensionSource::TYPE_THEME,
    composerPackage: 'jaxwilko/custom-theme'
))->install();

(new ExtensionSource(
    ExtensionSource::SOURCE_LOCAL,
    ExtensionSource::TYPE_PLUGIN,
    code: 'winter.demo'
))->install();

(new ExtensionSource(
    ExtensionSource::SOURCE_LOCAL,
    ExtensionSource::TYPE_PLUGIN,
    path: 'plugins/winter/demo'
))->install();

By the end of the PR, the UpdateManager as is may no longer exist as is, instead each ExtensionManager will be responsible for it's existing functionality.

Requires storm branch: https://github.com/wintercms/storm/tree/wip/support-uploading-packages-update-manager-changes

[mjauvin]

called method might return null, we need to use ?bool return type hint

[mjauvin]

@jaxwilko @LukeTowers should we add localization strings afterward or in this PR for info/warning/error messages ?

[mjauvin]

@jaxwilko requestUpdateList() does not exist anymore in UpdateManager class but is still being called in check() method.

[mjauvin]

Also getting this error when clicking "install themes" from the Updates & Plugins page:

[jaxwilko]

@jaxwilko @LukeTowers should we add localization strings afterward or in this PR for info/warning/error messages ?

100%

All the strings in output atm are just placeholders

[jaxwilko]

@jaxwilko requestUpdateList() does not exist anymore in UpdateManager class but is still being called in check() method.

Yeah, I've not finished fully migrating the backend yet, check for updates should work (but only supports composer packages) and interacting with plugins should work

[jaxwilko]

Also getting this error when clicking "install themes" from the Updates & Plugins page:

Luke broke it, it's from his PR this one is based off... I'll look into it when i do more on the backend stuff :)

[jaxwilko]

@bennothommo plz need sexy help!

[LukeTowers]

We should probably add the license as well

[jaxwilko]

Sure, it'll have to come from the marketplace tho as the packagist api does not provide it

[LukeTowers]

For future reference, @jaxwilko's JS for the event stream handling

const response = await fetch(window.location.href, {
                method: 'POST',
                headers: {
                    'Accept': 'text/event-stream',
                    'X-Requested-With': 'XMLHttpRequest',
                    'X-WINTER-REQUEST-HANDLER': 'onInstallPlugin',
                    'X-WINTER-REQUEST-PARTIALS': '',
                    'X-CSRF-TOKEN': document.querySelector('meta[name="csrf-token"]').getAttribute('content')
                },
                body: data,
                redirect: 'follow',
                mode: 'same-origin',
            });

            if (response.status !== 200) {
                console.log('BAD');
                this.installing = false;
                return;
            }

            $.popup({
                size: 'installer-popup',
                content: `
                    <div class="modal-header">
                        <button type="button" class="close" data-dismiss="modal" aria-hidden="true">&times;</button>
                        <h4 class="modal-title">Installing ${this.product.name}</h4>
                    </div>
                    <div class="modal-body"></div>
                    <div class="modal-footer">
                        <button type="button" class="btn btn-default" data-dismiss="modal">Blue Pill</button>
                        <button type="button" class="btn btn-primary" data-dismiss="modal">Red Pill</button>
                    </div>
                `
            });

            const popup = document.querySelector('.size-installer-popup');

            const chunk = async (response) => {
                const reader = response.body.getReader();
                const decoder = new TextDecoder();

                const parse = (str) => str.split("\n").filter((line) => !!line).map((line) => ({
                    type: line.substring(0, line.indexOf(': ')),
                    value: line.substring(line.indexOf(': ') + 2)
                }));

                const prepareMessage = (str) => {
                    ['INFO', 'ERROR'].forEach((status) => {
                        if (str.indexOf(status) === 0) {
                            str = `<span class="message-${status.toLowerCase()}">${status}</span> <pre>${str.substring(status.length + 1)}</pre>`;
                        }
                    });
                    return `<div class="install-message">${str}</div>`;
                };

                let done, value, message;
                while (!done) {
                    ({value, done} = await reader.read());
                    if (done) {
                        return;
                    }

                    message = parse(decoder.decode(value));

                    if (message[0].value === 'message') {
                        popup.querySelector('.modal-body').innerHTML += prepareMessage(message[1].value);
                    }

                    if (message[0].value === 'error') {
                        alert(message[1].value);
                    }
                }
            };

            await chunk(response);
            this.installing = false;

[LukeTowers]

Any way for this to be loaded via the ASSET_URL?