@alterior/runtime 3.13.3 → 3.13.4

package/dist/app-options.d.ts

@@ -1,66 +1,66 @@
-import { Annotation } from '@alterior/annotations';
-import { Injector, Provider } from '@alterior/di';
-export interface ApplicationOptions {
-    /**
-     * Specify a human readable name for your application.
-     */
-    name?: string;
-    /**
-     * Version of the service
-     */
-    version?: string;
-    /**
-     * The computer-readable name for your application. Should match your NPM package name.
-     */
-    packageName?: string;
-    /**
-     * A long-form description for your application, when necessary. If you implement only one,
-     * implement summary instead.
-     */
-    description?: string;
-    /**
-     * A shorter-form description for your application, when necessary. If you implement only one,
-     * implement this instead of description.
-     */
-    summary?: string;
-    /**
-     * A set of string tags related to your application.
-     */
-    tags?: string[];
-    group?: string;
-    /**
-     * Enable verbose console logging for Alterior
-     */
-    verbose?: boolean;
-    /**
-     * Whether to start the service immediately on startup.
-     * Defaults to true.
-     */
-    autostart?: boolean;
-    /**
-     * Turn off all console output
-     */
-    silent?: boolean;
-    /**
-     * Additional dependency injection providers to include in the application's injector.
-     */
-    providers?: Provider[];
-    /**
-     * An injector to use as the parent of the application injector. Optional, useful when doing more complex
-     * application bootstrapping.
-     */
-    parentInjector?: Injector;
-}
-/**
- * Used to attach an ApplicationOptions object onto a class definition.
- */
-export declare class AppOptionsAnnotation extends Annotation {
-    readonly options?: ApplicationOptions;
-    constructor(options?: ApplicationOptions);
-}
-/**
- * Use this decorator to define the options for your application,
- * either on the entry module, or service class when using `@alterior/web-server`.
- */
-export declare const AppOptions: (options?: ApplicationOptions) => ClassDecorator;
+import { Annotation } from '@alterior/annotations';
+import { Injector, Provider } from '@alterior/di';
+export interface ApplicationOptions {
+    /**
+     * Specify a human readable name for your application.
+     */
+    name?: string;
+    /**
+     * Version of the service
+     */
+    version?: string;
+    /**
+     * The computer-readable name for your application. Should match your NPM package name.
+     */
+    packageName?: string;
+    /**
+     * A long-form description for your application, when necessary. If you implement only one,
+     * implement summary instead.
+     */
+    description?: string;
+    /**
+     * A shorter-form description for your application, when necessary. If you implement only one,
+     * implement this instead of description.
+     */
+    summary?: string;
+    /**
+     * A set of string tags related to your application.
+     */
+    tags?: string[];
+    group?: string;
+    /**
+     * Enable verbose console logging for Alterior
+     */
+    verbose?: boolean;
+    /**
+     * Whether to start the service immediately on startup.
+     * Defaults to true.
+     */
+    autostart?: boolean;
+    /**
+     * Turn off all console output
+     */
+    silent?: boolean;
+    /**
+     * Additional dependency injection providers to include in the application's injector.
+     */
+    providers?: Provider[];
+    /**
+     * An injector to use as the parent of the application injector. Optional, useful when doing more complex
+     * application bootstrapping.
+     */
+    parentInjector?: Injector;
+}
+/**
+ * Used to attach an ApplicationOptions object onto a class definition.
+ */
+export declare class AppOptionsAnnotation extends Annotation {
+    readonly options?: ApplicationOptions;
+    constructor(options?: ApplicationOptions);
+}
+/**
+ * Use this decorator to define the options for your application,
+ * either on the entry module, or service class when using `@alterior/web-server`.
+ */
+export declare const AppOptions: (options?: ApplicationOptions) => ClassDecorator;
 //# sourceMappingURL=app-options.d.ts.map

package/dist/app-options.js

@@ -1,27 +1,27 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AppOptions = exports.AppOptionsAnnotation = void 0;
-const tslib_1 = require("tslib");
-const annotations_1 = require("@alterior/annotations");
-/**
- * Used to attach an ApplicationOptions object onto a class definition.
- */
-let AppOptionsAnnotation = class AppOptionsAnnotation extends annotations_1.Annotation {
-    constructor(options) {
-        super();
-        this.options = options;
-    }
-};
-AppOptionsAnnotation = tslib_1.__decorate([
-    (0, annotations_1.MetadataName)('@alterior/di:Application'),
-    tslib_1.__metadata("design:paramtypes", [Object])
-], AppOptionsAnnotation);
-exports.AppOptionsAnnotation = AppOptionsAnnotation;
-/**
- * Use this decorator to define the options for your application,
- * either on the entry module, or service class when using `@alterior/web-server`.
- */
-exports.AppOptions = AppOptionsAnnotation.decorator({
-    validTargets: ['class']
-});
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppOptions = exports.AppOptionsAnnotation = void 0;
+const tslib_1 = require("tslib");
+const annotations_1 = require("@alterior/annotations");
+/**
+ * Used to attach an ApplicationOptions object onto a class definition.
+ */
+let AppOptionsAnnotation = class AppOptionsAnnotation extends annotations_1.Annotation {
+    constructor(options) {
+        super();
+        this.options = options;
+    }
+};
+exports.AppOptionsAnnotation = AppOptionsAnnotation;
+exports.AppOptionsAnnotation = AppOptionsAnnotation = tslib_1.__decorate([
+    (0, annotations_1.MetadataName)('@alterior/di:Application'),
+    tslib_1.__metadata("design:paramtypes", [Object])
+], AppOptionsAnnotation);
+/**
+ * Use this decorator to define the options for your application,
+ * either on the entry module, or service class when using `@alterior/web-server`.
+ */
+exports.AppOptions = AppOptionsAnnotation.decorator({
+    validTargets: ['class']
+});
 //# sourceMappingURL=app-options.js.map

package/dist/app-options.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-options.js","sourceRoot":"","sources":["../src/app-options.ts"],"names":[],"mappings":";;;;AAAA,uDAAsF;AAmEtF;;GAEG;AAEI,IAAM,oBAAoB,GAA1B,MAAM,oBAAqB,SAAQ,wBAAU;IACnD,YAAqB,OAA4B;QAChD,KAAK,EAAE,CAAC;QADY,YAAO,GAAP,OAAO,CAAqB;IAEjD,CAAC;CACD,CAAA;AAJY,oBAAoB;IADhC,IAAA,0BAAY,EAAC,0BAA0B,CAAC;;GAC5B,oBAAoB,CAIhC;AAJY,oDAAoB;AAMjC;;;GAGG;AACU,QAAA,UAAU,GAAG,oBAAoB,CAAC,SAAS,CAAC;IACxD,YAAY,EAAE,CAAC,OAAO,CAAC;CACvB,CAAC,CAAC"}
+{"version":3,"file":"app-options.js","sourceRoot":"","sources":["../src/app-options.ts"],"names":[],"mappings":";;;;AAAA,uDAAsF;AAmEtF;;GAEG;AAEI,IAAM,oBAAoB,GAA1B,MAAM,oBAAqB,SAAQ,wBAAU;IACnD,YAAqB,OAA4B;QAChD,KAAK,EAAE,CAAC;QADY,YAAO,GAAP,OAAO,CAAqB;IAEjD,CAAC;CACD,CAAA;AAJY,oDAAoB;+BAApB,oBAAoB;IADhC,IAAA,0BAAY,EAAC,0BAA0B,CAAC;;GAC5B,oBAAoB,CAIhC;AAED;;;GAGG;AACU,QAAA,UAAU,GAAG,oBAAoB,CAAC,SAAS,CAAC;IACxD,YAAY,EAAE,CAAC,OAAO,CAAC;CACvB,CAAC,CAAC"}

package/dist/application.d.ts

@@ -1,53 +1,53 @@
-import 'reflect-metadata';
-import { ApplicationOptions } from './app-options';
-import { Runtime } from './modules';
-export declare class ApplicationOptionsRef {
-    constructor(options: ApplicationOptions);
-    readonly options: ApplicationOptions;
-}
-/**
- * Represents the current runtime execution context.
- * This is exposed via a zone-local variable, and the Runtime
- * populates it with useful information as it becomes available.
- */
-export declare class ExecutionContext {
-    /**
-     * Retrieve the Alterior application which is currently being executed.
-     * If an application has not been bootstrapped yet, the value is null.
-     */
-    application: Application;
-    static readonly ZONE_LOCAL_NAME = "@alterior/runtime:ExecutionContext";
-    /**
-     * Get the current execution context, if any.
-     */
-    static get current(): ExecutionContext;
-    /**
-     * Execute the given function in a new zone which has
-     * this ExecutionContext instance as the current execution context.
-     */
-    run<T>(callback: () => Promise<T>): Promise<T>;
-    runSync<T>(callback: () => T): T;
-}
-/**
- * Handles bootstrapping the application.
- */
-export declare class Application {
-    readonly runtime: Runtime;
-    private _optionsRef;
-    private _args;
-    start(): void;
-    stop(): void;
-    get injector(): import("@alterior/di").Injector;
-    inject<T>(ctor: {
-        new (...args: any[]): T;
-    }, notFoundValue?: T): T;
-    get args(): string[];
-    get options(): ApplicationOptions;
-    private static loadOptions;
-    private static validateEntryModule;
-    /**
-     * Bootstrap an Alterior application.
-     */
-    static bootstrap(entryModule: Function, options?: ApplicationOptions): Application;
-}
+import 'reflect-metadata';
+import { ApplicationOptions } from './app-options';
+import { Runtime } from './modules';
+export declare class ApplicationOptionsRef {
+    constructor(options: ApplicationOptions);
+    readonly options: ApplicationOptions;
+}
+/**
+ * Represents the current runtime execution context.
+ * This is exposed via a zone-local variable, and the Runtime
+ * populates it with useful information as it becomes available.
+ */
+export declare class ExecutionContext {
+    /**
+     * Retrieve the Alterior application which is currently being executed.
+     * If an application has not been bootstrapped yet, the value is null.
+     */
+    application: Application;
+    static readonly ZONE_LOCAL_NAME = "@alterior/runtime:ExecutionContext";
+    /**
+     * Get the current execution context, if any.
+     */
+    static get current(): ExecutionContext;
+    /**
+     * Execute the given function in a new zone which has
+     * this ExecutionContext instance as the current execution context.
+     */
+    run<T>(callback: () => Promise<T>): Promise<T>;
+    runSync<T>(callback: () => T): T;
+}
+/**
+ * Handles bootstrapping the application.
+ */
+export declare class Application {
+    readonly runtime: Runtime;
+    private _optionsRef;
+    private _args;
+    start(): void;
+    stop(): void;
+    get injector(): import("@alterior/di").Injector;
+    inject<T>(ctor: {
+        new (...args: any[]): T;
+    }, notFoundValue?: T): T;
+    get args(): string[];
+    get options(): ApplicationOptions;
+    private static loadOptions;
+    private static validateEntryModule;
+    /**
+     * Bootstrap an Alterior application.
+     */
+    static bootstrap(entryModule: Function, options?: ApplicationOptions): Application;
+}
 //# sourceMappingURL=application.d.ts.map

package/dist/application.js

@@ -1,172 +1,173 @@
-"use strict";
-var Application_1;
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Application = exports.ExecutionContext = exports.ApplicationOptionsRef = void 0;
-const tslib_1 = require("tslib");
-require("reflect-metadata");
-const common_1 = require("@alterior/common");
-const di_1 = require("@alterior/di");
-const app_options_1 = require("./app-options");
-const args_1 = require("./args");
-const modules_1 = require("./modules");
-const roles_service_1 = require("./roles.service");
-class ApplicationOptionsRef {
-    constructor(options) {
-        this.options = Object.assign({}, options);
-    }
-}
-exports.ApplicationOptionsRef = ApplicationOptionsRef;
-/**
- * Represents the current runtime execution context.
- * This is exposed via a zone-local variable, and the Runtime
- * populates it with useful information as it becomes available.
- */
-class ExecutionContext {
-    constructor() {
-        /**
-         * Retrieve the Alterior application which is currently being executed.
-         * If an application has not been bootstrapped yet, the value is null.
-         */
-        this.application = null;
-    }
-    /**
-     * Get the current execution context, if any.
-     */
-    static get current() {
-        return Zone.current.get(ExecutionContext.ZONE_LOCAL_NAME);
-    }
-    /**
-     * Execute the given function in a new zone which has
-     * this ExecutionContext instance as the current execution context.
-     */
-    run(callback) {
-        return tslib_1.__awaiter(this, void 0, void 0, function* () {
-            let zone = Zone.current.fork({
-                name: `AlteriorExecutionContext`,
-                properties: {
-                    [ExecutionContext.ZONE_LOCAL_NAME]: this
-                }
-            });
-            return yield zone.run(() => callback());
-        });
-    }
-    runSync(callback) {
-        let zone = Zone.current.fork({
-            name: `AlteriorExecutionContext`,
-            properties: {
-                [ExecutionContext.ZONE_LOCAL_NAME]: this
-            }
-        });
-        return zone.run(() => callback());
-    }
-}
-exports.ExecutionContext = ExecutionContext;
-ExecutionContext.ZONE_LOCAL_NAME = '@alterior/runtime:ExecutionContext';
-/**
- * Handles bootstrapping the application.
- */
-let Application = Application_1 = class Application {
-    constructor() {
-        this.runtime = (0, di_1.inject)(modules_1.Runtime);
-        this._optionsRef = (0, di_1.inject)(ApplicationOptionsRef);
-        this._args = (0, di_1.inject)(args_1.ApplicationArgs);
-    }
-    start() {
-        this.runtime.start();
-    }
-    stop() {
-        this.runtime.stop();
-    }
-    get injector() {
-        return this.runtime.injector;
-    }
-    inject(ctor, notFoundValue) {
-        return this.injector.get(ctor, notFoundValue);
-    }
-    get args() {
-        return this._args.get();
-    }
-    get options() {
-        return this._optionsRef.options;
-    }
-    static loadOptions(entryModule, bootstrapOptions) {
-        // Read an @AppOptions() decorator if any, and merge providers from it 
-        // into the bootstrapped providers
-        let appOptionsAnnotation = app_options_1.AppOptionsAnnotation.getForClass(entryModule);
-        let appProvidedOptions = appOptionsAnnotation ? appOptionsAnnotation.options : {} || {};
-        return Object.assign({
-            version: '0.0.0',
-            verbose: false,
-            silent: false,
-            autostart: true,
-            providers: []
-        }, appProvidedOptions, bootstrapOptions);
-    }
-    static validateEntryModule(module) {
-        if (typeof module !== 'function') {
-            throw new Error(`You must pass a Module class as the first parameter `
-                + `to bootstrap(). You provided: `
-                + `${typeof module} with value '${module}'`);
-        }
-        let moduleMetadata = di_1.ModuleAnnotation.getForClass(module);
-        if (!moduleMetadata)
-            throw new Error(`You must pass a module class decorated by @Module()`);
-    }
-    /**
-     * Bootstrap an Alterior application.
-     */
-    static bootstrap(entryModule, options) {
-        let executionContext = new ExecutionContext();
-        return executionContext.runSync(() => {
-            var _a;
-            this.validateEntryModule(entryModule);
-            options = this.loadOptions(entryModule, options);
-            let runtime = new modules_1.Runtime(entryModule);
-            let providers = [
-                args_1.ApplicationArgs,
-                roles_service_1.RolesService,
-                common_1.Environment,
-                common_1.Time
-            ];
-            runtime.contributeProviders(providers);
-            providers.push({
-                provide: ApplicationOptionsRef,
-                useValue: new ApplicationOptionsRef(options)
-            });
-            providers.push(Application_1);
-            providers.push((_a = options.providers) !== null && _a !== void 0 ? _a : []);
-            runtime.providers = providers;
-            let injector;
-            try {
-                injector = di_1.ReflectiveInjector.resolveAndCreate(providers, options.parentInjector);
-            }
-            catch (e) {
-                console.error(`Failed to resolve injector:`);
-                console.error(e);
-                console.error(`Providers:`);
-                console.dir(providers);
-                console.error(`Modules:`);
-                console.dir(runtime.definitions);
-                throw e;
-            }
-            injector.get(roles_service_1.RolesService).silent = options.silent;
-            runtime.load(injector);
-            executionContext.application = runtime.getService(Application_1);
-            runtime.fireEvent('OnInit');
-            runtime.configure();
-            if (runtime.selfTest) {
-                console.log(`[Self Test] ✔ Looks good!`);
-                process.exit(0);
-            }
-            if (options.autostart)
-                runtime.start();
-            runtime.fireEvent('AfterStart');
-            return executionContext.application;
-        });
-    }
-};
-Application = Application_1 = tslib_1.__decorate([
-    (0, di_1.Injectable)()
-], Application);
-exports.Application = Application;
+"use strict";
+var Application_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Application = exports.ExecutionContext = exports.ApplicationOptionsRef = void 0;
+const tslib_1 = require("tslib");
+require("reflect-metadata");
+const common_1 = require("@alterior/common");
+const di_1 = require("@alterior/di");
+const app_options_1 = require("./app-options");
+const args_1 = require("./args");
+const modules_1 = require("./modules");
+const roles_service_1 = require("./roles.service");
+class ApplicationOptionsRef {
+    constructor(options) {
+        this.options = Object.assign({}, options);
+    }
+}
+exports.ApplicationOptionsRef = ApplicationOptionsRef;
+/**
+ * Represents the current runtime execution context.
+ * This is exposed via a zone-local variable, and the Runtime
+ * populates it with useful information as it becomes available.
+ */
+class ExecutionContext {
+    constructor() {
+        /**
+         * Retrieve the Alterior application which is currently being executed.
+         * If an application has not been bootstrapped yet, the value is null.
+         */
+        this.application = null;
+    }
+    /**
+     * Get the current execution context, if any.
+     */
+    static get current() {
+        return Zone.current.get(ExecutionContext.ZONE_LOCAL_NAME);
+    }
+    /**
+     * Execute the given function in a new zone which has
+     * this ExecutionContext instance as the current execution context.
+     */
+    run(callback) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            let zone = Zone.current.fork({
+                name: `AlteriorExecutionContext`,
+                properties: {
+                    [ExecutionContext.ZONE_LOCAL_NAME]: this
+                }
+            });
+            return yield zone.run(() => callback());
+        });
+    }
+    runSync(callback) {
+        let zone = Zone.current.fork({
+            name: `AlteriorExecutionContext`,
+            properties: {
+                [ExecutionContext.ZONE_LOCAL_NAME]: this
+            }
+        });
+        return zone.run(() => callback());
+    }
+}
+exports.ExecutionContext = ExecutionContext;
+ExecutionContext.ZONE_LOCAL_NAME = '@alterior/runtime:ExecutionContext';
+/**
+ * Handles bootstrapping the application.
+ */
+let Application = Application_1 = class Application {
+    constructor() {
+        this.runtime = (0, di_1.inject)(modules_1.Runtime);
+        this._optionsRef = (0, di_1.inject)(ApplicationOptionsRef);
+        this._args = (0, di_1.inject)(args_1.ApplicationArgs);
+    }
+    start() {
+        this.runtime.start();
+    }
+    stop() {
+        this.runtime.stop();
+    }
+    get injector() {
+        return this.runtime.injector;
+    }
+    inject(ctor, notFoundValue) {
+        return this.injector.get(ctor, notFoundValue);
+    }
+    get args() {
+        return this._args.get();
+    }
+    get options() {
+        return this._optionsRef.options;
+    }
+    static loadOptions(entryModule, bootstrapOptions) {
+        // Read an @AppOptions() decorator if any, and merge providers from it 
+        // into the bootstrapped providers
+        var _a;
+        let appOptionsAnnotation = app_options_1.AppOptionsAnnotation.getForClass(entryModule);
+        let appProvidedOptions = (_a = appOptionsAnnotation === null || appOptionsAnnotation === void 0 ? void 0 : appOptionsAnnotation.options) !== null && _a !== void 0 ? _a : {};
+        return Object.assign({
+            version: '0.0.0',
+            verbose: false,
+            silent: false,
+            autostart: true,
+            providers: []
+        }, appProvidedOptions, bootstrapOptions);
+    }
+    static validateEntryModule(module) {
+        if (typeof module !== 'function') {
+            throw new Error(`You must pass a Module class as the first parameter `
+                + `to bootstrap(). You provided: `
+                + `${typeof module} with value '${module}'`);
+        }
+        let moduleMetadata = di_1.ModuleAnnotation.getForClass(module);
+        if (!moduleMetadata)
+            throw new Error(`You must pass a module class decorated by @Module()`);
+    }
+    /**
+     * Bootstrap an Alterior application.
+     */
+    static bootstrap(entryModule, options) {
+        let executionContext = new ExecutionContext();
+        return executionContext.runSync(() => {
+            var _a;
+            this.validateEntryModule(entryModule);
+            options = this.loadOptions(entryModule, options);
+            let runtime = new modules_1.Runtime(entryModule);
+            let providers = [
+                args_1.ApplicationArgs,
+                roles_service_1.RolesService,
+                common_1.Environment,
+                common_1.Time
+            ];
+            runtime.contributeProviders(providers);
+            providers.push({
+                provide: ApplicationOptionsRef,
+                useValue: new ApplicationOptionsRef(options)
+            });
+            providers.push(Application_1);
+            providers.push((_a = options.providers) !== null && _a !== void 0 ? _a : []);
+            runtime.providers = providers;
+            let injector;
+            try {
+                injector = di_1.ReflectiveInjector.resolveAndCreate(providers, options.parentInjector);
+            }
+            catch (e) {
+                console.error(`Failed to resolve injector:`);
+                console.error(e);
+                console.error(`Providers:`);
+                console.dir(providers);
+                console.error(`Modules:`);
+                console.dir(runtime.definitions);
+                throw e;
+            }
+            injector.get(roles_service_1.RolesService).silent = options.silent;
+            runtime.load(injector);
+            executionContext.application = runtime.getService(Application_1);
+            runtime.fireEvent('OnInit');
+            runtime.configure();
+            if (runtime.selfTest) {
+                console.log(`[Self Test] ✔ Looks good!`);
+                process.exit(0);
+            }
+            if (options.autostart)
+                runtime.start();
+            runtime.fireEvent('AfterStart');
+            return executionContext.application;
+        });
+    }
+};
+exports.Application = Application;
+exports.Application = Application = Application_1 = tslib_1.__decorate([
+    (0, di_1.Injectable)()
+], Application);
 //# sourceMappingURL=application.js.map