Added @kephas/commands to Angular 12 build system

Author: ioancrisan

src/angular.json

@@ -95,6 +95,37 @@
           }
         }
       }
+    },
+    "@kephas/commands": {
+      "projectType": "library",
+      "root": "projects/kephas/commands",
+      "sourceRoot": "projects/kephas/commands/src",
+      "prefix": "lib",
+      "architect": {
+        "build": {
+          "builder": "@angular-devkit/build-angular:ng-packagr",
+          "options": {
+            "project": "projects/kephas/commands/ng-package.json"
+          },
+          "configurations": {
+            "production": {
+              "tsConfig": "projects/kephas/commands/tsconfig.lib.prod.json"
+            },
+            "development": {
+              "tsConfig": "projects/kephas/commands/tsconfig.lib.json"
+            }
+          },
+          "defaultConfiguration": "production"
+        },
+        "test": {
+          "builder": "@angular-devkit/build-angular:karma",
+          "options": {
+            "main": "projects/kephas/commands/src/test.ts",
+            "tsConfig": "projects/kephas/commands/tsconfig.spec.json",
+            "karmaConfig": "projects/kephas/commands/karma.conf.js"
+          }
+        }
+      }
     }
   },
   "defaultProject": "@kephas/core"

src/package.json

@@ -7,7 +7,11 @@
     "build": "ng build",
     "test": "ng test",
     "lint": "ng lint",
-    "package": "ng build --project=@kephas/core && ng build --project=@kephas/reflection && ng build --project=@kephas/messaging"
+    "pack-core": "ng build --project=@kephas/core",
+    "pack-reflection": "ng build --project=@kephas/reflection",
+    "pack-messaging": "ng build --project=@kephas/messaging",
+    "pack-commands": "ng build --project=@kephas/commands",
+    "pack-all": "ng build --project=@kephas/core && ng build --project=@kephas/reflection && ng build --project=@kephas/messaging && ng build --project=@kephas/commands"
   },
   "private": true,
   "dependencies": {

src/projects/kephas/commands/README.md

@@ -0,0 +1,24 @@
+# Commands
+
+This library was generated with [Angular CLI](https://github.com/angular/angular-cli) version 12.2.0.
+
+## Code scaffolding
+
+Run `ng generate component component-name --project commands` to generate a new component. You can also use `ng generate directive|pipe|service|class|guard|interface|enum|module --project commands`.
+> Note: Don't forget to add `--project commands` or else it will be added to the default project in your `angular.json` file. 
+
+## Build
+
+Run `ng build commands` to build the project. The build artifacts will be stored in the `dist/` directory.
+
+## Publishing
+
+After building your library with `ng build commands`, go to the dist folder `cd dist/commands` and run `npm publish`.
+
+## Running unit tests
+
+Run `ng test commands` to execute the unit tests via [Karma](https://karma-runner.github.io).
+
+## Further help
+
+To get more help on the Angular CLI use `ng help` or go check out the [Angular CLI Overview and Command Reference](https://angular.io/cli) page.

src/projects/kephas/commands/karma.conf.js

@@ -0,0 +1,44 @@
+// Karma configuration file, see link for more information
+// https://karma-runner.github.io/1.0/config/configuration-file.html
+
+module.exports = function (config) {
+  config.set({
+    basePath: '',
+    frameworks: ['jasmine', '@angular-devkit/build-angular'],
+    plugins: [
+      require('karma-jasmine'),
+      require('karma-chrome-launcher'),
+      require('karma-jasmine-html-reporter'),
+      require('karma-coverage'),
+      require('@angular-devkit/build-angular/plugins/karma')
+    ],
+    client: {
+      jasmine: {
+        // you can add configuration options for Jasmine here
+        // the possible options are listed at https://jasmine.github.io/api/edge/Configuration.html
+        // for example, you can disable the random execution with `random: false`
+        // or set a specific seed with `seed: 4321`
+      },
+      clearContext: false // leave Jasmine Spec Runner output visible in browser
+    },
+    jasmineHtmlReporter: {
+      suppressAll: true // removes the duplicated traces
+    },
+    coverageReporter: {
+      dir: require('path').join(__dirname, '../../../coverage/kephas/commands'),
+      subdir: '.',
+      reporters: [
+        { type: 'html' },
+        { type: 'text-summary' }
+      ]
+    },
+    reporters: ['progress', 'kjhtml'],
+    port: 9876,
+    colors: true,
+    logLevel: config.LOG_INFO,
+    autoWatch: true,
+    browsers: ['Chrome'],
+    singleRun: false,
+    restartOnFileChange: true
+  });
+};

src/projects/kephas/commands/ng-package.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "../../../node_modules/ng-packagr/ng-package.schema.json",
+  "dest": "../../../dist/kephas/commands",
+  "lib": {
+    "entryFile": "src/public-api.ts",
+    "umdModuleIds": {
+      "@kephas/core": "@kephas/core",
+      "rxjs": "rxjs"
+    }
+  }
+}

src/projects/kephas/commands/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@kephas/commands",
+  "version": "1.0.0-preview.1",
+  "description": "Provides the commands infrastructure.",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kephas-software/kephas-js/tree/master/src/projects/kephas/commands"
+  },
+  "keywords": [
+    "kephas",
+    "commands"
+  ],
+  "author": {
+    "name": "Kephas Software SRL"
+  },
+  "license": "MIT",
+  "peerDependencies": {
+    "@kephas/core": "^1.0.0-preview.1",
+    "rxjs": "^6.5.3"
+  },
+  "dependencies": {
+    "tslib": "^2.3.0"
+  },
+  "devDependencies": {
+    "typescript": "4.2.4"
+  }
+}

src/projects/kephas/commands/src/lib/command.ts

@@ -0,0 +1,25 @@
+import { LogLevel, Expando } from '@kephas/core';
+
+/**
+ * The base command response.
+ *
+ * @export
+ * @interface CommandResponse
+ */
+export interface CommandResponse extends Expando {
+    /**
+     * The severity.
+     *
+     * @type {LogLevel}
+     * @memberof CommandResponse
+     */
+    severity: LogLevel;
+
+    /**
+     * The message.
+     *
+     * @type {string}
+     * @memberof CommandResponse
+     */
+    message?: string;
+}

src/projects/kephas/commands/src/lib/commandClientContext.ts

@@ -0,0 +1,33 @@
+import { Context } from '@kephas/core';
+
+/**
+ * Options for controlling the command execution.
+ *
+ * @export
+ * @interface CommandClientContext
+ */
+export interface CommandClientContext extends Context {
+    /**
+     * Indicates whether warnings should be notified. Default is true.
+     *
+     * @type {boolean}
+     * @memberof CommandClientContext
+     */
+    notifyWarnings?: boolean;
+
+    /**
+     * Indicates whether errors should be notified. Default is true.
+     *
+     * @type {boolean}
+     * @memberof CommandClientContext
+     */
+    notifyErrors?: boolean;
+
+    /**
+     * Indicates the number of retries if the operation fails. Default is none.
+     *
+     * @type {number}
+     * @memberof CommandClientContext
+     */
+    retries?: number;
+}

src/projects/kephas/commands/src/lib/commandError.ts

@@ -0,0 +1,20 @@
+import { CommandResponse } from "./command";
+
+/**
+ * Signals that a command error occurred.
+ *
+ * @export
+ * @class CommandError
+ * @extends {Error}
+ */
+export class CommandError extends Error {
+    /**
+     * Creates an instance of CommandError.
+     * @param {string} message The error message.
+     * @param {CommandResponse} [response] Optional. The command response.
+     * @memberof CommandError
+     */
+    constructor(message: string, public readonly response?: CommandResponse) {
+        super(message);
+    }
+}

src/projects/kephas/commands/src/lib/commandProcessorClient.spec.ts

@@ -0,0 +1,20 @@
+import { expect } from 'chai';
+import 'mocha';
+
+import { CommandProcessorClient } from '.';
+import { LiteCompositionContext } from '@kephas/core';
+
+describe('CommandProcessorClient.composition', () => {
+    it('should be available', () => {
+        const container = LiteCompositionContext.Instance;
+        const processor = container.get(CommandProcessorClient);
+        expect(processor).to.be.instanceOf(CommandProcessorClient);
+    });
+});
+
+describe('CommandProcessorClient.process', () => {
+    it('should fail', () => {
+        const processor = new CommandProcessorClient();
+        expect(() => processor.process('help')).to.throw();
+    });
+});