@shrub/core 0.5.26

package/dist/esm/service-collection.js

@@ -0,0 +1,382 @@
+export const IInstantiationService = createService("instantiation-service");
+export const IOptionsService = createService("options-service");
+export const IServiceCollection = createService("service-collection");
+const dependencies = "__dependencies";
+const scope = "__scope";
+/** Class decorator identifying the required scope for a service as 'scoped'. */
+export function Scoped(ctor) {
+    ctor[scope] = "scoped" /* scoped */;
+}
+/** Class decorator identifying the required scope for a service as 'singleton'. */
+export function Singleton(ctor) {
+    ctor[scope] = "singleton" /* singleton */;
+}
+/** Class decorator identifying the required scope for a service as 'transient'. */
+export function Transient(ctor) {
+    ctor[scope] = "transient" /* transient */;
+}
+export function createInjectable(keyOrOptions) {
+    const options = typeof keyOrOptions === "object" ? keyOrOptions : { key: keyOrOptions };
+    const injectable = function (target, propertyKey, parameterIndex) {
+        if (!isConstructor(target)) {
+            throw new Error("An injectable decorator only supports constructor parameters.");
+        }
+        captureDependency(injectable, target, parameterIndex);
+    };
+    injectable.key = options.key;
+    injectable.factory = options.factory;
+    injectable.toString = () => options.key;
+    return injectable;
+}
+export function createOptions(key, defaultOptions) {
+    const validation = [];
+    const options = createInjectable({
+        key,
+        factory: services => services.get(IOptionsService).getOptions(options)
+    });
+    options.defaultOptions = defaultOptions;
+    options.register = (callback) => validation.push(callback);
+    options.require = (...props) => {
+        options.register((obj, invalid) => {
+            for (const prop of props) {
+                if (obj[prop] === undefined) {
+                    invalid(new OptionsValidationError(`Options (${key}) property (${prop}) is required.`));
+                    break;
+                }
+            }
+        });
+    };
+    options.validate = (obj, fail) => {
+        let error;
+        for (let i = 0; i < validation.length && error === undefined; i++) {
+            validation[i](obj, err => error = err);
+        }
+        if (error) {
+            fail(error);
+        }
+        return error === undefined;
+    };
+    return options;
+}
+export function createService(key) {
+    return createInjectable(key);
+}
+function getDependencies(ctor) {
+    return ctor[dependencies] || {};
+}
+function getServiceScope(ctor) {
+    const value = ctor[scope];
+    if (!value) {
+        throw new Error(`Default scope not defined for service (${ctor.name})`);
+    }
+    return value;
+}
+function captureDependency(injectable, target, index) {
+    target[dependencies] = target[dependencies] || {};
+    target[dependencies][index] = injectable;
+}
+function isConstructor(target) {
+    return typeof target === "function" && target === target.prototype.constructor;
+}
+function isDisposable(obj) {
+    return obj.dispose !== undefined;
+}
+function isServiceFactory(target) {
+    return typeof target === "object" && target.create !== undefined;
+}
+/** Represents an error that has occurred while trying to create an object instance. */
+export class ObjectCreateError extends Error {
+    constructor(message, inner) {
+        super(message);
+        this.inner = inner;
+        Object.setPrototypeOf(this, ObjectCreateError.prototype);
+    }
+}
+/**
+ *  A service factory that will create a single instance and return the same instance everytime create is invoked.
+ *  This is useful for singleton services that implement multiple service interfaces.
+ */
+export class SingletonServiceFactory {
+    constructor(ctorOrFactory) {
+        this.ctorOrFactory = ctorOrFactory;
+    }
+    create(services) {
+        if (!this.instance) {
+            this.instance = isServiceFactory(this.ctorOrFactory)
+                ? this.ctorOrFactory.create(services)
+                : services.get(IInstantiationService).createInstance(this.ctorOrFactory);
+        }
+        return this.instance;
+    }
+}
+export class ServiceMap {
+    constructor() {
+        this.services = new Map();
+        // the thisFactory is necessary for scoped collections
+        const thisFactory = { create: () => this };
+        this.registerService(IInstantiationService, "scoped" /* scoped */, thisFactory);
+        this.registerService(IServiceCollection, "scoped" /* scoped */, thisFactory);
+        this.registerSingleton(IOptionsService, OptionsService);
+    }
+    addOptionsProvider(provider) {
+        return this.get(IOptionsService).addOptionsProvider(provider);
+    }
+    configureOptions(options, callback) {
+        this.get(IOptionsService).configureOptions(options, callback);
+    }
+    createInstance(ctor) {
+        return this.createObjectInstance(ctor);
+    }
+    createScope() {
+        const parent = this;
+        return new class extends ServiceMap {
+            constructor() {
+                super();
+                // The service map registers a few built-in services that need to be handled a little differently
+                // -- if the service is singleton/instance it gets copied from the parent
+                // -- if the service is scoped/transient do not overwrite the entry from the parent
+                for (const entry of parent.services.values()) {
+                    if (entry.scope === "singleton" /* singleton */ || entry.scope === "instance" /* instance */) {
+                        // copy the singleton entry directly to the scoped collection - it's possible the instance has not yet been created so the entire entry gets copied down
+                        this.registerEntry(entry);
+                    }
+                    else if (!this.services.has(entry.service.key)) {
+                        // create a new entry for scoped/transient services
+                        this.registerEntry({ ...entry, instance: undefined });
+                    }
+                }
+                this.freeze();
+            }
+            dispose() {
+                for (const service of this.services.values()) {
+                    // only dispose scoped service instances that were instantiated by the current service scope
+                    if (service.instance &&
+                        service.scope === "scoped" /* scoped */ &&
+                        isDisposable(service.instance)) {
+                        service.instance.dispose();
+                    }
+                }
+                this.services.clear();
+            }
+        };
+    }
+    getOptions(options) {
+        return this.get(IOptionsService).getOptions(options);
+    }
+    register(service, ctor) {
+        this.registerService(service, getServiceScope(ctor), ctor);
+    }
+    registerInstance(service, instance) {
+        if (instance === undefined) {
+            throw new Error("instance undefined");
+        }
+        // TODO: check if the instance constructor has a required scope - if so, verify its a singleton
+        this.services.set(service.key, {
+            service,
+            scope: "instance" /* instance */,
+            instance
+        });
+    }
+    registerScoped(service, ctorOrFactory) {
+        this.registerService(service, "scoped" /* scoped */, ctorOrFactory);
+    }
+    registerSingleton(service, ctorOrFactory) {
+        this.registerService(service, "singleton" /* singleton */, ctorOrFactory);
+    }
+    registerTransient(service, ctorOrFactory) {
+        this.registerService(service, "transient" /* transient */, ctorOrFactory);
+    }
+    tryRegister(service, ctor) {
+        if (!this.services.has(service.key)) {
+            this.register(service, ctor);
+            return true;
+        }
+        return false;
+    }
+    tryRegisterInstance(service, instance) {
+        if (!this.services.has(service.key)) {
+            this.registerInstance(service, instance);
+            return true;
+        }
+        return false;
+    }
+    tryRegisterScoped(service, ctorOrFactory) {
+        if (!this.services.has(service.key)) {
+            this.registerScoped(service, ctorOrFactory);
+            return true;
+        }
+        return false;
+    }
+    tryRegisterSingleton(service, ctorOrFactory) {
+        if (!this.services.has(service.key)) {
+            this.registerSingleton(service, ctorOrFactory);
+            return true;
+        }
+        return false;
+    }
+    tryRegisterTransient(service, ctorOrFactory) {
+        if (!this.services.has(service.key)) {
+            this.registerTransient(service, ctorOrFactory);
+            return true;
+        }
+        return false;
+    }
+    get(serviceOrKey) {
+        const key = typeof serviceOrKey === "string" ? serviceOrKey : serviceOrKey.key;
+        return this.getOrCreateServiceInstance(key);
+    }
+    has(serviceOrKey) {
+        const key = typeof serviceOrKey === "string" ? serviceOrKey : serviceOrKey.key;
+        return this.services.has(key);
+    }
+    tryGet(serviceOrKey) {
+        if (this.has(serviceOrKey)) {
+            return this.get(serviceOrKey);
+        }
+        return undefined;
+    }
+    /** Prevents items from being registered with the serivce map. */
+    freeze() {
+        this.isFrozen = true;
+    }
+    registerService(service, scope, ctorOrFactory) {
+        this.registerEntry({
+            service,
+            scope,
+            ctor: isConstructor(ctorOrFactory) ? ctorOrFactory : undefined,
+            factory: isServiceFactory(ctorOrFactory) ? ctorOrFactory : undefined
+        });
+    }
+    registerEntry(entry) {
+        if (this.isFrozen === true) {
+            throw new Error("Service collection is frozen");
+        }
+        if (entry.ctor) {
+            this.checkInstanceScope(entry.ctor, entry.scope);
+        }
+        this.services.set(entry.service.key, entry);
+    }
+    checkFactoryInstance(instance, scope) {
+        if (typeof instance !== "object" && typeof instance !== "function") {
+            throw new Error("Instance must be an object or function");
+        }
+        if (instance.constructor !== Object && instance.constructor !== Function) {
+            this.checkInstanceScope(instance.constructor, scope);
+        }
+    }
+    checkInstanceScope(ctor, scope) {
+        const requiredScope = ctor[scope];
+        if (requiredScope && requiredScope !== scope) {
+            throw new Error("Registered service scope is different than the instance required scope");
+        }
+    }
+    getOrCreateServiceInstance(key, ancestors) {
+        const entry = this.services.get(key);
+        if (!entry) {
+            throw new Error(`Service not registered for key '${key}'.`);
+        }
+        if (entry.instance) {
+            return entry.instance;
+        }
+        const instance = this.createServiceInstance(entry, ancestors);
+        if (entry.scope === "scoped" /* scoped */ || entry.scope === "singleton" /* singleton */) {
+            entry.instance = instance;
+        }
+        return instance;
+    }
+    getOrCreateInjectable(injectable, ancestors) {
+        if (this.services.has(injectable.key)) {
+            return this.getOrCreateServiceInstance(injectable.key, ancestors);
+        }
+        if (injectable.factory) {
+            return injectable.factory(this);
+        }
+        throw new Error(`Invalid injectable (${injectable.key}), either a service has not been registered or the injectable does not define a factory.`);
+    }
+    createServiceInstance(entry, ancestors) {
+        if (entry.factory) {
+            const instance = entry.factory.create(this);
+            // even though the scope cannot be verified until now it is still a good idea to check that the service instance is being properly scoped
+            this.checkFactoryInstance(instance, entry.scope);
+            return instance;
+        }
+        if (entry.ctor) {
+            return this.createObjectInstance(entry.ctor, ancestors);
+        }
+        throw new Error("Invalid service entry.");
+    }
+    createObjectInstance(ctor, ancestors) {
+        if (ancestors && ancestors.includes(ctor)) {
+            const path = [...ancestors.map(ctor => ctor.name), ctor.name].join(" -> ");
+            throw new Error("Circular dependency detected: " + path);
+        }
+        const dependencies = getDependencies(ctor);
+        const keys = Object.keys(dependencies);
+        if (ctor.length > keys.length) {
+            throw new Error(`Invalid constructor (${ctor.name}), all parameters must be injectable.`);
+        }
+        try {
+            ancestors = ancestors || [];
+            ancestors.push(ctor);
+            // create/get instances for all the object's constructor parameters
+            const args = keys.map(key => this.getOrCreateInjectable(dependencies[key], ancestors));
+            ancestors.splice(ancestors.indexOf(ctor), 1);
+            return new ctor(...args);
+        }
+        catch (err) {
+            throw new ObjectCreateError(`Failed to get dependencies for Constructor (${ctor.name}): ${err.message}`, err);
+        }
+    }
+}
+/** Represents an error for an options object instance that failed validation. */
+export class OptionsValidationError extends Error {
+    constructor(message) {
+        super(message);
+        Object.setPrototypeOf(this, OptionsValidationError.prototype);
+    }
+}
+class OptionsService {
+    constructor() {
+        this.options = new Map();
+        this.providers = [];
+    }
+    addOptionsProvider(provider) {
+        this.providers.unshift(provider);
+    }
+    configureOptions(options, callback) {
+        const configure = this.options.get(options.key);
+        this.options.set(options.key, options => callback(configure ? configure(options) : options));
+    }
+    getOptions(options) {
+        let result;
+        for (const provider of this.providers) {
+            const instance = provider.tryGet(options);
+            if (instance) {
+                result = instance;
+                break;
+            }
+        }
+        result = this.mergeWithDefaultOptions(result || {}, options.defaultOptions);
+        const configure = this.options.get(options.key);
+        result = configure ? configure(result) : result;
+        let error;
+        if (!options.validate(result, err => error = err)) {
+            throw error;
+        }
+        return result;
+    }
+    mergeWithDefaultOptions(options, defaultOptions) {
+        // this allows supporting partial options and will handle merging in any default values that were omitted
+        if (defaultOptions) {
+            // clone the options object and return a merged options instance
+            options = { ...options };
+            Object.keys(defaultOptions).forEach(key => {
+                if (options[key] === undefined) {
+                    options[key] = defaultOptions[key];
+                }
+            });
+        }
+        return options;
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2VydmljZS1jb2xsZWN0aW9uLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3NlcnZpY2UtY29sbGVjdGlvbi50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFzR0EsTUFBTSxDQUFDLE1BQU0scUJBQXFCLEdBQUcsYUFBYSxDQUF3Qix1QkFBdUIsQ0FBQyxDQUFDO0FBQ25HLE1BQU0sQ0FBQyxNQUFNLGVBQWUsR0FBRyxhQUFhLENBQWtCLGlCQUFpQixDQUFDLENBQUM7QUFDakYsTUFBTSxDQUFDLE1BQU0sa0JBQWtCLEdBQUcsYUFBYSxDQUFxQixvQkFBb0IsQ0FBQyxDQUFDO0FBRTFGLE1BQU0sWUFBWSxHQUFHLGdCQUFnQixDQUFDO0FBQ3RDLE1BQU0sS0FBSyxHQUFHLFNBQVMsQ0FBQztBQVN4QixnRkFBZ0Y7QUFDaEYsTUFBTSxVQUFVLE1BQU0sQ0FBQyxJQUFTO0lBQzVCLElBQUksQ0FBQyxLQUFLLENBQUMsd0JBQXNCLENBQUM7QUFDdEMsQ0FBQztBQUVELG1GQUFtRjtBQUNuRixNQUFNLFVBQVUsU0FBUyxDQUFDLElBQVM7SUFDL0IsSUFBSSxDQUFDLEtBQUssQ0FBQyw4QkFBeUIsQ0FBQztBQUN6QyxDQUFDO0FBRUQsbUZBQW1GO0FBQ25GLE1BQU0sVUFBVSxTQUFTLENBQUMsSUFBUztJQUMvQixJQUFJLENBQUMsS0FBSyxDQUFDLDhCQUF5QixDQUFDO0FBQ3pDLENBQUM7QUFJRCxNQUFNLFVBQVUsZ0JBQWdCLENBQUksWUFBNEM7SUFDNUUsTUFBTSxPQUFPLEdBQUcsT0FBTyxZQUFZLEtBQUssUUFBUSxDQUFDLENBQUMsQ0FBQyxZQUFZLENBQUMsQ0FBQyxDQUFDLEVBQUUsR0FBRyxFQUFFLFlBQVksRUFBRSxDQUFDO0lBQ3hGLE1BQU0sVUFBVSxHQUFRLFVBQVUsTUFBVyxFQUFFLFdBQW1CLEVBQUUsY0FBc0I7UUFDdEYsSUFBSSxDQUFDLGFBQWEsQ0FBQyxNQUFNLENBQUMsRUFBRTtZQUN4QixNQUFNLElBQUks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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./module";
+export * from "./service-collection";

package/dist/index.js

@@ -0,0 +1,15 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./module"), exports);
+__exportStar(require("./service-collection"), exports);
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7Ozs7O0FBQUEsMkNBQXlCO0FBQ3pCLHVEQUFxQyJ9

package/dist/module.d.ts

@@ -0,0 +1,110 @@
+import { IOptions, IServiceCollection, IServiceRegistration } from "./service-collection";
+export declare type ModuleConstructor<T extends IModule = IModule> = {
+    new (): T;
+};
+export declare type ModuleInstanceOrConstructor = IModule | ModuleConstructor;
+export declare type ModuleDependency = ModuleInstanceOrConstructor | (() => Promise<ModuleInstanceOrConstructor>);
+export declare type SettingsInitializer = {
+    /**
+     * Binds module settings to an options object; the options object gets bound to the settings path {module-name} or {module-name}/{section-name}.
+     * The section name parameter is optional and useful for binding to a section of the module's settings.
+     */
+    readonly bindToOptions: <T>(options: IOptions<T>, sectionName?: string) => void;
+};
+declare type ConfigurationInitializer<T> = {
+    readonly register: (callback: (configurator: IModuleConfigurator) => T) => void;
+};
+declare type OptionsProvider = {
+    /**
+     * A helper function for getting an option instance from the current module settings.
+     * It's expected that the module also use bindToOptions to bind to the module's settings.
+     */
+    readonly get: <T>(options: IOptions<T>) => T;
+};
+/** A collection of settings for one or more module keyed by the module name. */
+export interface IModuleSettingsCollection {
+    readonly [name: string]: IModuleSettings | undefined;
+}
+/** A set of key/value settings for a single module. */
+export interface IModuleSettings {
+    readonly [key: string]: any;
+}
+export interface IModule {
+    readonly name: string;
+    readonly dependencies?: ModuleDependency[];
+    initialize?(init: IModuleInitializer): void;
+    configureServices?(registration: IServiceRegistration): void;
+    configure?(configurator: IModuleConfigurator): void | Promise<void>;
+}
+export interface IModuleConfigurationType<T> {
+    readonly key: symbol;
+}
+export interface IModuleConfiguration {
+    get<T>(type: IModuleConfigurationType<T>): T;
+}
+export interface IModuleConfigurator {
+    readonly config: IModuleConfiguration;
+    readonly options: OptionsProvider;
+    readonly services: IServiceCollection;
+    readonly settings: IModuleSettings;
+    readonly next: () => Promise<void>;
+}
+export interface IModuleInitializer {
+    /** Gets a configuration initializer for a module configuration type. */
+    config<T>(type: IModuleConfigurationType<T>): ConfigurationInitializer<T>;
+    /** Gets a settings initializer for the current module. */
+    settings: SettingsInitializer;
+}
+/** A collection of loaded modules. */
+export interface IModuleCollection {
+    /** The collection of services for the host. */
+    readonly services: IServiceCollection;
+    /** Gets the loaded module instance for the specified module constructor. */
+    getInstance<T extends IModule>(ctor: ModuleConstructor<T>): T;
+}
+export interface ILoadOptions {
+    readonly modules: ModuleInstanceOrConstructor[];
+    readonly settings?: IModuleSettingsCollection;
+}
+/** Creates a module configuration used to configure a module. */
+export declare function createConfig<T>(): IModuleConfigurationType<T>;
+export declare class ModuleLoadError extends Error {
+    constructor(message: string);
+}
+/** Handles initializing and loading modules. */
+export declare class ModuleLoader {
+    private readonly services;
+    private readonly modules;
+    private settings;
+    private isLoaded?;
+    static load(modules: ModuleInstanceOrConstructor[]): Promise<IModuleCollection>;
+    static load(options: ILoadOptions): Promise<IModuleCollection>;
+    static configureServices(callback: (registration: IServiceRegistration) => void): ModuleLoader;
+    static useModules(modules: ModuleInstanceOrConstructor[]): ModuleLoader;
+    static useSettings(settings: IModuleSettingsCollection): ModuleLoader;
+    /**
+     * Loads the specified core modules into the manager. The load operation will discover
+     * the core module dependencies and then initialize/configure each module.
+     *
+     * This will first discover all dependent modules, create module instances, and sort the
+     * list of discovered modules by dependency (note: there is no guarantee of the order when creating
+     * module instances but each step against the discovered modules will execute against module dependents first).
+     *
+     * Module Steps:
+     *
+     * 1) Initialize
+     * 2) Configure Services
+     * 3) Configure
+     */
+    load(): Promise<IModuleCollection>;
+    configureServices(callback: (registration: IServiceRegistration) => void): this;
+    useModules(modules: ModuleInstanceOrConstructor[]): this;
+    useSettings(settings: IModuleSettingsCollection): this;
+    private ensureNotLoaded;
+    private getSettingsForModule;
+    private expandAndSortModules;
+    private merge;
+    private isObject;
+    private isModule;
+}
+export {};