@nent/core
Version:
90 lines (89 loc) • 3.08 kB
JavaScript
/*!
* NENT 2022
*/
import { eventBus } from '../actions';
import { debounce, debugIf, EventEmitter, requireValue, } from '../common';
import { DATA_EVENTS } from './interfaces';
import { dataState } from './state';
const disposers = {};
const NEW_PROVIDER_ADDED = 'new-provider-added';
const emitter = new EventEmitter();
/**
* It adds a data provider to the data state
* @param {string} name - The name of the provider.
* @param {IDataProvider} provider - IDataProvider - This is the data provider that we're adding.
*/
export function addDataProvider(name, provider) {
var _a;
requireValue(name, 'provider name');
if (typeof provider.get !== 'function') {
throw new TypeError(`The provider ${name} is missing the get(key) function.`);
}
const debouncedChanges = debounce(1000, (...args) => {
eventBus.emit(DATA_EVENTS.DataChanged, {
provider: name,
data: args,
});
}, false);
const dispose = (_a = provider.changed) === null || _a === void 0 ? void 0 : _a.on('*', (...args) => {
debouncedChanges(args);
});
disposers[name] = dispose;
dataState.providers[name.toLowerCase()] = provider;
emitter.emit(NEW_PROVIDER_ADDED, name.toLocaleLowerCase());
debugIf(dataState.debug && name !== 'data', `data-provider: ${name} registered`);
}
/**
* It returns a promise that resolves to the data provider with the given name, or null if the provider
* is not found
* @param {string} name - The name of the provider to get.
* @returns A promise that resolves to an IDataProvider or null.
*/
export async function getDataProvider(name) {
const key = name.toLowerCase();
requireValue(name, 'provider name');
if (Object.keys(dataState.providers).includes(key))
return dataState.providers[key];
return new Promise(resolve => {
const timeout = setTimeout(() => {
resolve(null);
}, dataState.providerTimeout * 1000);
const dispose = emitter.on(NEW_PROVIDER_ADDED, (registered) => {
if (name == registered) {
clearTimeout(timeout);
dispose();
resolve(dataState.providers[key]);
}
});
});
}
/**
* `getDataProviders()` returns the `providers` property of the `dataState` object
* @returns The dataState.providers object
*/
export function getDataProviders() {
return dataState.providers;
}
/**
* It removes a data provider from the data state, calls the disposer function, and then deletes the
* disposer function
* @param {string} name - The name of the data provider.
*/
export function removeDataProvider(name) {
var _a;
delete dataState.providers[name];
(_a = disposers[name]) === null || _a === void 0 ? void 0 : _a.call(this);
delete disposers[name];
}
/**
* It loops through all the data providers, calls their disposer function, and then deletes them from
* the dataState object
*/
export function clearDataProviders() {
Object.keys(dataState.providers).forEach(key => {
var _a;
(_a = disposers[key]) === null || _a === void 0 ? void 0 : _a.call(this);
delete disposers[key];
delete dataState.providers[key];
});
}