79 lines
2.8 KiB
JavaScript
79 lines
2.8 KiB
JavaScript
// Converse.js
|
|
// https://conversejs.org
|
|
//
|
|
// Copyright (c) 2020, the Converse.js contributors
|
|
// Licensed under the Mozilla Public License (MPLv2)
|
|
//
|
|
// Webpack entry file
|
|
//
|
|
// The purpose of this file is to provide an initial temporary public API
|
|
// (window.converse) for **before** the rest of converse.js is loaded so
|
|
// that we can set the __webpack_public_path__ global variable.
|
|
//
|
|
// Once the rest converse.js has been loaded, window.converse will be replaced
|
|
// with the full-fledged public API.
|
|
|
|
const plugins = {};
|
|
|
|
const converse = {
|
|
plugins: {
|
|
add (name, plugin) {
|
|
if (plugins[name] !== undefined) {
|
|
throw new TypeError(
|
|
`Error: plugin with name "${name}" has already been ` + 'registered!'
|
|
);
|
|
}
|
|
plugins[name] = plugin;
|
|
}
|
|
},
|
|
|
|
initialize (settings={}) {
|
|
return converse.load(settings).initialize(settings);
|
|
},
|
|
|
|
/**
|
|
* Public API method which explicitly loads Converse and allows you the
|
|
* possibility to pass in configuration settings which need to be defined
|
|
* before loading. Currently this is only the [assets_path](https://conversejs.org/docs/html/configuration.html#assets_path)
|
|
* setting.
|
|
*
|
|
* If not called explicitly, this method will be called implicitly once
|
|
* {@link converse.initialize} is called.
|
|
*
|
|
* In most cases, you probably don't need to explicitly call this method,
|
|
* however, until converse.js has been loaded you won't have access to the
|
|
* utility methods and globals exposed via {@link converse.env}. So if you
|
|
* need to access `converse.env` outside of any plugins and before
|
|
* `converse.initialize` has been called, then you need to call
|
|
* `converse.load` first.
|
|
*
|
|
* @memberOf converse
|
|
* @method load
|
|
* @param {object} settings A map of configuration-settings that are needed at load time.
|
|
* @example
|
|
* converse.load({assets_path: '/path/to/assets/'});
|
|
*/
|
|
load (settings={}) {
|
|
if (settings.assets_path) {
|
|
__webpack_public_path__ = settings.assets_path; // eslint-disable-line no-undef
|
|
}
|
|
require('./converse.js');
|
|
Object.keys(plugins).forEach(name => converse.plugins.add(name, plugins[name]));
|
|
return converse;
|
|
}
|
|
}
|
|
|
|
window.converse = converse;
|
|
|
|
/**
|
|
* Once Converse.js has loaded, it'll dispatch a custom event with the name `converse-loaded`.
|
|
* You can listen for this event in order to be informed as soon as converse.js has been
|
|
* loaded and parsed, which would mean it's safe to call `converse.initialize`.
|
|
* @event converse-loaded
|
|
* @example window.addEventListener('converse-loaded', () => converse.initialize());
|
|
*/
|
|
const ev = new CustomEvent('converse-loaded', {'detail': { converse }});
|
|
window.dispatchEvent(ev);
|
|
|
|
export default converse;
|