@shrub/core 0.5.26

package/dist/module.js

@@ -0,0 +1,253 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModuleLoader = exports.ModuleLoadError = exports.createConfig = void 0;
+const service_collection_1 = require("./service-collection");
+/** Creates a module configuration used to configure a module. */
+function createConfig() {
+    return { key: Symbol() };
+}
+exports.createConfig = createConfig;
+class ModuleLoadError extends Error {
+    constructor(message) {
+        super(message);
+        Object.setPrototypeOf(this, ModuleLoadError.prototype);
+    }
+}
+exports.ModuleLoadError = ModuleLoadError;
+/** Handles initializing and loading modules. */
+class ModuleLoader {
+    constructor() {
+        this.services = new service_collection_1.ServiceMap();
+        this.modules = [];
+        this.settings = {};
+    }
+    static load(modulesOrOptions) {
+        const options = Array.isArray(modulesOrOptions) ? { modules: modulesOrOptions } : modulesOrOptions;
+        const loader = new ModuleLoader();
+        if (options.settings) {
+            loader.useSettings(options.settings);
+        }
+        return loader.useModules(options.modules).load();
+    }
+    static configureServices(callback) {
+        return new ModuleLoader().configureServices(callback);
+    }
+    static useModules(modules) {
+        return new ModuleLoader().useModules(modules);
+    }
+    static useSettings(settings) {
+        return new ModuleLoader().useSettings(settings);
+    }
+    /**
+     * 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
+     */
+    async load() {
+        this.ensureNotLoaded();
+        this.isLoaded = true;
+        // get all modules and sort by dependencies
+        const loadedModules = await this.expandAndSortModules();
+        // initialize discovered modules
+        const loader = this;
+        const configs = new Map();
+        loadedModules.forEach(module => {
+            if (module.initialize) {
+                module.initialize({
+                    config: type => ({
+                        register: callback => configs.set(type.key, { callback, module })
+                    }),
+                    get settings() {
+                        return {
+                            bindToOptions: (options, sectionName) => {
+                                loader.services.addOptionsProvider({
+                                    tryGet: (opt) => {
+                                        if (options === opt) {
+                                            const settings = loader.getSettingsForModule(module);
+                                            return sectionName ? settings[sectionName] : settings;
+                                        }
+                                        return undefined;
+                                    }
+                                });
+                            }
+                        };
+                    }
+                });
+            }
+        });
+        // configure the module services
+        for (const module of loadedModules) {
+            if (module.configureServices) {
+                module.configureServices(this.services);
+            }
+        }
+        this.services.freeze();
+        // lastly, configure the modules
+        const iterator = loadedModules[Symbol.iterator]();
+        const next = async () => {
+            for (const module of iterator) {
+                await configure(module);
+            }
+        };
+        const self = this;
+        const configure = (module) => module.configure && module.configure({
+            services: this.services,
+            settings: this.getSettingsForModule(module),
+            get options() {
+                return {
+                    get: (options) => self.services.getOptions(options)
+                };
+            },
+            get config() {
+                return {
+                    get: (type) => {
+                        const item = configs.get(type.key);
+                        if (!item) {
+                            throw new Error(`Config ${type.key.toString()} not found`);
+                        }
+                        return item.callback({
+                            ...this,
+                            // need to grab the module's settings that is being configured
+                            settings: loader.getSettingsForModule(item.module)
+                        });
+                    }
+                };
+            },
+            next
+        });
+        // invoke the iterator to start configuring the modules
+        return next().then(() => ({
+            services: this.services,
+            getInstance: (ctor) => {
+                const result = loadedModules.find(module => module instanceof ctor);
+                if (!result) {
+                    throw new Error("Module instance not found");
+                }
+                return result;
+            }
+        }));
+    }
+    configureServices(callback) {
+        this.ensureNotLoaded();
+        callback(this.services);
+        return this;
+    }
+    useModules(modules) {
+        this.ensureNotLoaded();
+        this.modules.push(...modules);
+        return this;
+    }
+    useSettings(settings) {
+        this.ensureNotLoaded();
+        this.settings = this.merge(settings, this.settings);
+        return this;
+    }
+    ensureNotLoaded() {
+        if (this.isLoaded) {
+            throw new Error("Modules have already been loaded.");
+        }
+    }
+    getSettingsForModule(module) {
+        return this.settings[module.name] || {};
+    }
+    async expandAndSortModules() {
+        const instances = new Map();
+        const sorted = [];
+        const visited = {};
+        const getInstance = async (dependency) => {
+            if (typeof dependency === "function") {
+                let instance = instances.get(dependency);
+                if (!instance) {
+                    try {
+                        instance = new dependency();
+                        if (instance.constructor === dependency) {
+                            // save the instance if the dependency is a constructor
+                            instances.set(dependency, instance);
+                        }
+                    }
+                    catch {
+                        // the dependency is a non-constructble function so invoke and assume the return will be a promise and use Promise.resolve to resolve it
+                        const instanceOrCtor = await Promise.resolve(dependency());
+                        instance = await getInstance(instanceOrCtor);
+                    }
+                }
+                // resolve incase the dependency is a function that returned a promise
+                return instance;
+            }
+            if (typeof dependency === "object") {
+                if (!this.isModule(dependency)) {
+                    throw new ModuleLoadError(`Object (${dependency.constructor.name}) is not a module.`);
+                }
+                const ctor = dependency.constructor;
+                if (ctor !== Object.prototype.constructor) {
+                    if (instances.has(ctor)) {
+                        throw new ModuleLoadError(`Duplicate module instances ${dependency.name}.`);
+                    }
+                    instances.set(ctor, dependency);
+                }
+                return dependency;
+            }
+            throw new ModuleLoadError(`Invalid dependency type (${typeof dependency}).`);
+        };
+        const visit = async (dependency, ancestors) => {
+            const module = await getInstance(dependency);
+            if (visited[module.name]) {
+                return;
+            }
+            if (!ancestors) {
+                ancestors = {};
+            }
+            if (ancestors[module.name]) {
+                throw new ModuleLoadError(`Circular dependency has been detected with module ${module.name}`);
+            }
+            ancestors[module.name] = true;
+            if (module.dependencies) {
+                for (const dependency of module.dependencies) {
+                    await visit(dependency, ancestors);
+                }
+            }
+            visited[module.name] = true;
+            // this performs a depth-first topological sort but instead of inserting
+            // to the front, push the module to the back of the list so that dependencies
+            // come first
+            sorted.push(module);
+        };
+        for (const module of this.modules) {
+            await visit(module);
+        }
+        return sorted;
+    }
+    merge(source, target) {
+        if (this.isObject(source) && this.isObject(target)) {
+            for (const key in source) {
+                if (source[key] === undefined) {
+                    // do not merge if the source value is undefined
+                    continue;
+                }
+                target = {
+                    ...target,
+                    [key]: this.isObject(source[key]) ? this.merge(source[key], target[key] || {}) : source[key]
+                };
+            }
+        }
+        return target;
+    }
+    isObject(obj) {
+        return typeof obj === "object" && !Array.isArray(obj);
+    }
+    isModule(obj) {
+        // a module only requires a name so that's all we can really check for
+        return typeof obj === "object" && obj.name !== undefined;
+    }
+}
+exports.ModuleLoader = ModuleLoader;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibW9kdWxlLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL21vZHVsZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFBQSw2REFBc0c7QUFxRnRHLGlFQUFpRTtBQUNqRSxTQUFnQixZQUFZO0lBQ3hCLE9BQU8sRUFBRSxHQUFHLEVBQUUsTUFBTSxFQUFFLEVBQUUsQ0FBQztBQUM3QixDQUFDO0FBRkQsb0NBRUM7QUFFRCxNQUFhLGVBQWdCLFNBQVEsS0FBSztJQUN0QyxZQUFZLE9BQWU7UUFDdkIsS0FBSyxDQUFDLE9BQU8sQ0FBQyxDQUFDO1FBQ2YsTUFBTSxDQUFDLGNBQWMsQ0FBQyxJQUFJLEVBQUUsZUFBZSxDQUFDLFNBQVMsQ0FBQyxDQUFDO0lBQzNELENBQUM7Q0FDSjtBQUxELDBDQUtDO0FBRUQsZ0RBQWdEO0FBQ2hELE1BQWEsWUFBWTtJQUF6QjtRQUNxQixhQUFRLEdBQUcsSUFBSSwrQkFBVSxFQUFFLENBQUM7UUFDNUIsWUFBTyxHQUFrQyxFQUFFLENBQUM7UUFDckQsYUFBUSxHQUE4QixFQUFFLENBQUM7SUFvUnJELENBQUM7SUEvUUcsTUFBTSxDQUFDLElBQUksQ0FBQyxnQkFBOEQ7UUFDdEUsTUFBTSxPQUFPLEdBQUcsS0FBSyxDQUFDLE9BQU8sQ0FBQyxnQkFBZ0IsQ0FBQyxDQUFDLENBQUMsQ0FBQyxFQUFFLE9BQU8sRUFBRSxnQkFBZ0IsRUFBRSxDQUFDLENBQUMsQ0FBQyxnQkFBZ0IsQ0FBQztRQUNuRyxNQUFNLE1BQU0sR0FBRyxJQUFJLFlBQVksRUFBRSxDQUFDO1FBRWxDLElBQUksT0FBTyxDQUFDLFFBQVEsRUFBRTtZQUNsQixNQUFNLENBQUMsV0FBVyxDQUFDLE9BQU8sQ0FBQyxRQUFRLENBQUMsQ0FBQztTQUN4QztRQUVELE9BQU8sTUFBTSxDQUFDLFVBQVUsQ0FBQyxPQUFPLENBQUMsT0FBTyxDQUFDLENBQUMsSUFBSSxFQUFFLENBQUM7SUFDckQsQ0FBQztJQUVELE1BQU0sQ0FBQyxpQkFBaUIs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

package/dist/service-collection.d.ts

@@ -0,0 +1,146 @@
+export declare type ValidateOptionsCallback<T> = (obj: T, invalid: (err: OptionsValidationError) => void) => void;
+export declare type ValidateOptionsFailCallback = (err: OptionsValidationError) => void;
+declare type Constructor<T> = {
+    new (...args: any[]): T;
+};
+declare type NonOptionalKeys<T> = {
+    [K in keyof T]-?: undefined extends T[K] ? never : K;
+}[keyof T];
+/** Defines an object that supports a dispose function; scoped service instances that implement dispose will get invoked when the scoped container is cleaned up. */
+export interface IDisposable {
+    dispose(): void;
+}
+export interface IInjectable<T> {
+    readonly key: string;
+    readonly factory?: (services: IServiceCollection) => T;
+    (...args: any[]): void;
+}
+export interface IInjectableOptions<T> {
+    readonly key: string;
+    readonly factory?: (services: IServiceCollection) => T;
+}
+export interface IOptions<T> extends IInjectable<T> {
+    readonly defaultOptions?: T;
+    readonly register: (callback: ValidateOptionsCallback<T>) => void;
+    readonly require: (...props: NonOptionalKeys<T>[]) => void;
+    readonly validate: (obj: T, fail: ValidateOptionsFailCallback) => boolean;
+}
+export interface IService<T> extends IInjectable<T> {
+}
+export interface IInstantiationService {
+    createInstance<T>(ctor: Constructor<T>): T;
+}
+export interface IOptionsService {
+    /** Adds an options provider to the service. */
+    addOptionsProvider(provider: IOptionsProvider): void;
+    /** Registers a callback that gets invoked to configure/modify an options instance when one has been requested. */
+    configureOptions<T>(options: IOptions<T>, callback: (options: T) => T): void;
+    /** Gets an instance of the specified options. */
+    getOptions<T>(options: IOptions<T>): T;
+}
+export interface IOptionsProvider {
+    tryGet<T>(id: IOptions<T>): T | undefined;
+}
+export interface IServiceRegistration {
+    /** Registers a service using its required scope. Note: a service class must define a required scope decorator. */
+    register<T, TInstance extends T>(service: IService<T>, ctor: Constructor<TInstance>): void;
+    /** Registers a singleton instance that lives within the collection and is available to all child scopes. Note: if the instance implements IDisposable it will not be disposed automatically. */
+    registerInstance<T, TInstance extends T>(service: IService<T>, instance: TInstance): void;
+    /** Registers a service that gets created once per service collection scope. */
+    registerScoped<T, TInstance extends T>(service: IService<T>, ctorOrFactory: Constructor<TInstance> | IServiceFactory<TInstance>): void;
+    /** Registers a service that gets created once and is available to all child scopes. */
+    registerSingleton<T, TInstance extends T>(service: IService<T>, ctorOrFactory: Constructor<TInstance> | IServiceFactory<TInstance>): void;
+    /** Registers a service that gets created each time the service is requested from a collection. */
+    registerTransient<T, TInstance extends T>(service: IService<T>, ctorOrFactory: Constructor<TInstance> | IServiceFactory<TInstance>): void;
+    /** Attempts to register a service using its required scope but only if a service has not already been registered. Note: a service class must define a required scope decorator. */
+    tryRegister<T, TInstance extends T>(service: IService<T>, ctor: Constructor<TInstance>): boolean;
+    /** Attempts to register a singleton instance that lives within the collection and is available to all child scopes. Note: if the instance implements IDisposable it will not be disposed automatically. */
+    tryRegisterInstance<T, TInstance extends T>(service: IService<T>, instance: TInstance): boolean;
+    /** Attempts to register a service that gets created once per service collection scope. */
+    tryRegisterScoped<T, TInstance extends T>(service: IService<T>, ctorOrFactory: Constructor<TInstance> | IServiceFactory<TInstance>): boolean;
+    /** Attempts to register a service that gets created once and is available to all child scopes. */
+    tryRegisterSingleton<T, TInstance extends T>(service: IService<T>, ctorOrFactory: Constructor<TInstance> | IServiceFactory<TInstance>): boolean;
+    /** Attempts to register a service that gets created each time the service is requested from a collection. */
+    tryRegisterTransient<T, TInstance extends T>(service: IService<T>, ctorOrFactory: Constructor<TInstance> | IServiceFactory<TInstance>): boolean;
+}
+export interface IServiceCollection {
+    /** Creates a scoped collection. */
+    createScope(): IScopedServiceCollection;
+    /** Gets an instance of the registered service. */
+    get<T>(serviceOrKey: IService<T> | string): T;
+    /** True if a service has been registered. */
+    has<T>(serviceOrKey: IService<T> | string): boolean;
+    /** Gets an instance of the specified service if one has been registered or undefined if not. */
+    tryGet<T>(serviceOrKey: IService<T> | string): T | undefined;
+}
+export interface IServiceFactory<T> {
+    create(services: IServiceCollection): T;
+}
+export interface IScopedServiceCollection extends IServiceCollection, IDisposable {
+}
+export declare const IInstantiationService: IService<IInstantiationService>;
+export declare const IOptionsService: IService<IOptionsService>;
+export declare const IServiceCollection: IService<IServiceCollection>;
+/** Class decorator identifying the required scope for a service as 'scoped'. */
+export declare function Scoped(ctor: any): void;
+/** Class decorator identifying the required scope for a service as 'singleton'. */
+export declare function Singleton(ctor: any): void;
+/** Class decorator identifying the required scope for a service as 'transient'. */
+export declare function Transient(ctor: any): void;
+export declare function createInjectable<T>(key: string): IInjectable<T>;
+export declare function createInjectable<T>(options: IInjectableOptions<T>): IInjectable<T>;
+export declare function createOptions<T>(key: string, defaultOptions?: T): IOptions<T>;
+export declare function createService<T>(key: string): IService<T>;
+/** Represents an error that has occurred while trying to create an object instance. */
+export declare class ObjectCreateError extends Error {
+    readonly inner: Error;
+    constructor(message: string, inner: Error);
+}
+/**
+ *  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 declare class SingletonServiceFactory<T> implements IServiceFactory<T> {
+    private readonly ctorOrFactory;
+    private instance?;
+    constructor(ctorOrFactory: Constructor<T> | IServiceFactory<T>);
+    create(services: IServiceCollection): T;
+}
+export declare class ServiceMap implements IServiceRegistration, IServiceCollection, IOptionsService, IInstantiationService {
+    private readonly services;
+    private isFrozen?;
+    constructor();
+    addOptionsProvider(provider: IOptionsProvider): void;
+    configureOptions<T>(options: IOptions<T>, callback: (options: T) => T): void;
+    createInstance<T>(ctor: Constructor<T>): T;
+    createScope(): IScopedServiceCollection;
+    getOptions<T>(options: IOptions<T>): T;
+    register<T, TInstance extends T>(service: IService<T>, ctor: Constructor<TInstance>): void;
+    registerInstance<T, TInstance extends T>(service: IService<T>, instance: TInstance): void;
+    registerScoped<T, TInstance extends T>(service: IService<T>, ctorOrFactory: Constructor<TInstance> | IServiceFactory<TInstance>): void;
+    registerSingleton<T, TInstance extends T>(service: IService<T>, ctorOrFactory: Constructor<TInstance> | IServiceFactory<TInstance>): void;
+    registerTransient<T, TInstance extends T>(service: IService<T>, ctorOrFactory: Constructor<TInstance> | IServiceFactory<TInstance>): void;
+    tryRegister<T, TInstance extends T>(service: IService<T>, ctor: Constructor<TInstance>): boolean;
+    tryRegisterInstance<T, TInstance extends T>(service: IService<T>, instance: TInstance): boolean;
+    tryRegisterScoped<T, TInstance extends T>(service: IService<T>, ctorOrFactory: Constructor<TInstance> | IServiceFactory<TInstance>): boolean;
+    tryRegisterSingleton<T, TInstance extends T>(service: IService<T>, ctorOrFactory: Constructor<TInstance> | IServiceFactory<TInstance>): boolean;
+    tryRegisterTransient<T, TInstance extends T>(service: IService<T>, ctorOrFactory: Constructor<TInstance> | IServiceFactory<TInstance>): boolean;
+    get<T>(serviceOrKey: IService<T> | string): T;
+    has<T>(serviceOrKey: IService<T> | string): boolean;
+    tryGet<T>(serviceOrKey: IService<T> | string): T | undefined;
+    /** Prevents items from being registered with the serivce map. */
+    freeze(): void;
+    private registerService;
+    private registerEntry;
+    private checkFactoryInstance;
+    private checkInstanceScope;
+    private getOrCreateServiceInstance;
+    private getOrCreateInjectable;
+    private createServiceInstance;
+    private createObjectInstance;
+}
+/** Represents an error for an options object instance that failed validation. */
+export declare class OptionsValidationError extends Error {
+    constructor(message: string);
+}
+export {};