@shrub/core 0.5.26

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2019 jjvainav
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,151 @@
+# Description
+
+Shrub is a simple framework for building modular server-side applications and front-end components. The Core package provides a basic API for defining and loading modules.
+
+## Creating a Module
+
+A module can be defined as a class that implements the IModule interface or as a JSON object that satisfies the IModule interface.
+
+```typescript
+export class FooModule implements IModule {
+    readonly name = "foo";
+}
+```
+
+```typescript
+const fooModule: IModule = {
+    name: "foo"
+};
+```
+
+There are a few methods a module can define that allow it to configure functionality provided by the module and each method is invoked in the following order.
+
+### 1. `initialize(init: IModuleInitializer): void`
+
+Allows a module the ability to perform pre-initialization that needs to happen before any modules or services are configured. Such tasks include binding settings or registering a configuration interface that is exposed to other modules.
+
+### 2. `configureServices(registration: IServiceRegistration): void`
+
+Register services with a service collection.
+
+### 3. `configure(configurator: IModuleConfigurator): void | Promise<void>`
+
+Allows a module to perform additional configuration, such as configure a dependency module. This method supports async operations which can be useful if data needs to be fetched from a remote service during configuration.
+
+## Dependencies
+
+Module depenedencies are specified by defining a `dependencies` property on a module and lifecycle methods get invoked on the dependency before they are invoked on the dependent.
+
+```typescript
+export class FooModule implements IModule {
+    readonly name = "foo";
+    readonly dependencies = [BarModule];
+}
+```
+
+## Configuration
+
+```typescript
+export const IBarModuleConfiguration = createConfig<IBarModuleConfiguration>();
+export interface IBarModuleConfiguration {
+    registerWidget(widget: IWidget): void;
+}
+
+export class BarModule implements IModule {
+    readonly name = "bar";
+
+    initialize({ config }: IModuleInitializer): void {
+        config(IBarModuleConfiguration).register(() => ({
+            registerWidget: widget => {}
+        }));
+    }
+}
+
+export class FooModule implements IModule {
+    readonly name = "foo";
+    readonly dependencies = [BarModule];
+
+    configure({ config }: IModuleConfigurator): void {
+        config.get(IBarModuleConfiguration).registerWidget({});
+    }
+}
+```
+
+## Settings and Options
+
+While Dependency Configuration is a way for one module to configure another at load time. Settings provide a way to provide settings/configuration externally, such as from a config file.
+
+Module Settings are provided as a simple object keyed by a module's name; for example, the below is an example settings object that defines settings for the 'foo' module:
+
+```typescript
+const settings = {
+    foo: {
+        key: value
+    }
+};
+```
+
+A module can access these settings directly from the `configure` method:
+
+```typescript
+export class FooModule implements IModule {
+    readonly name = "foo";
+
+    configure({ settings }: IModuleConfigurator): void {
+        const keyValue = settings.key;
+    }
+}
+```
+
+Sometimes it's useful to pass settings to service instances and this can be done via Service Options.
+
+```typescript
+export const IFooOptions = createOptions<IFooOptions>("foo-options");
+export interface IFooOptions {
+    readonly value: string;
+}
+
+export class FooModule implements IModule {
+    readonly name = "foo";
+
+    initialize({ settings }: IModuleInitializer): void {
+        settings.bindToOptions(IFooOptions);
+    }
+
+    configureServices(registration: IServiceRegistration): void {
+        registration.registerTransient(IFooService, FooService);
+    }
+}
+
+export class FooService implements IFooService {
+    constructor(@IFooOptions private readonly options: IFooOptions) {
+    }
+}
+```
+
+## Loading Modules
+
+Modules are loaded using the `ModuleLoader` class by simply invoking `ModuleLoader.load`.
+
+```typescript
+await ModuleLoader.load([
+    FooModule,
+    BarModule
+]);
+```
+
+Note: If a module has any dependencies not specified when calling `ModuleLoader.load` those dependencies will automatically get loaded.
+
+If you want a little more control the module loader provides additional methods for configuring the service collection or settings.
+
+```typescript
+await ModuleLoader()
+    .useModules([
+        FooModule,
+        BarModule
+    ])
+    .useSettings({
+        foo: { value: "Hello!" }
+    })
+    .load();
+```

package/dist/esm/index.js

@@ -0,0 +1,3 @@
+export * from "./module";
+export * from "./service-collection";
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsY0FBYyxVQUFVLENBQUM7QUFDekIsY0FBYyxzQkFBc0IsQ0FBQyJ9

package/dist/esm/module.js

@@ -0,0 +1,247 @@
+import { ServiceMap } from "./service-collection";
+/** Creates a module configuration used to configure a module. */
+export function createConfig() {
+    return { key: Symbol() };
+}
+export class ModuleLoadError extends Error {
+    constructor(message) {
+        super(message);
+        Object.setPrototypeOf(this, ModuleLoadError.prototype);
+    }
+}
+/** Handles initializing and loading modules. */
+export class ModuleLoader {
+    constructor() {
+        this.services = new 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;
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibW9kdWxlLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL21vZHVsZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQXNELFVBQVUsRUFBRSxNQUFNLHNCQUFzQixDQUFDO0FBcUZ0RyxpRUFBaUU7QUFDakUsTUFBTSxVQUFVLFlBQVk7SUFDeEIsT0FBTyxFQUFFLEdBQUcsRUFBRSxNQUFNLEVBQUUsRUFBRSxDQUFDO0FBQzdCLENBQUM7QUFFRCxNQUFNLE9BQU8sZUFBZ0IsU0FBUSxLQUFLO0lBQ3RDLFlBQVksT0FBZTtRQUN2QixLQUFLLENBQUMsT0FBTyxDQUFDLENBQUM7UUFDZixNQUFNLENBQUMsY0FBYyxDQUFDLElBQUksRUFBRSxlQUFlLENBQUMsU0FBUyxDQUFDLENBQUM7SUFDM0QsQ0FBQztDQUNKO0FBRUQsZ0RBQWdEO0FBQ2hELE1BQU0sT0FBTyxZQUFZO0lBQXpCO1FBQ3FCLGFBQVEsR0FBRyxJQUFJLFVBQVUsRUFBRSxDQUFDO1FBQzVCLFlBQU8sR0FBa0MsRUFBRSxDQUFDO1FBQ3JELGFBQVEsR0FBOEIsRUFBRSxDQUFDO0lBb1JyRCxDQUFDO0lBL1FHLE1BQU0sQ0FBQyxJQUFJLENBQUMsZ0JBQThEO1FBQ3RFLE1BQU0sT0FBTyxHQUFHLEtBQUssQ0FBQyxPQUFPLENBQUMsZ0JBQWdCLENBQUMsQ0FBQyxDQUFDLENBQUMsRUFBRSxPQUFPLEVBQUUsZ0JBQWdCLEVBQUUsQ0FBQyxDQUFDLENBQUMsZ0JBQWdCLENBQUM7UUFDbkcsTUFBTSxNQUFNLEdBQUcsSUFBSSxZQUFZLEVBQUUsQ0FBQztRQUVsQyxJQUFJLE9BQU8sQ0FBQyxRQUFRLEVBQUU7WUFDbEIsTUFBTSxDQUFDLFdBQVcsQ0FBQyxPQUFPLENBQUMsUUFBUSxDQUFDLENBQUM7U0FDeEM7UUFFRCxPQUFPLE1BQU0sQ0FBQyxVQUFVLENBQUMsT0FBTyxDQUFDLE9BQU8sQ0FBQyxDQUFDLElBQUksRUFBRSxDQUFDO0lBQ3JELENBQUM7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