1.0.25

.gitlab-ci.yml

@@ -3,69 +3,140 @@ image: hosttoday/ht-docker-node:npmci
 
 cache:
   paths:
-  - .yarn/
+  - .npmci_cache/
   key: "$CI_BUILD_STAGE"
 
 stages:
+- security
 - test
 - release
-- trigger
-- pages
+- metadata
 
+# ====================
+# security stage
+# ====================
+mirror:
+  stage: security
+  script:
+  - npmci git mirror
+  tags:
+  - docker
+  - notpriv
+
+snyk:
+  stage: security
+  script:
+    - npmci command npm install -g snyk
+    - npmci command npm install --ignore-scripts
+    - npmci command snyk test
+  tags:
+  - docker
+  - notpriv
+
+# ====================
+# test stage
+# ====================
 testLEGACY:
   stage: test
   script:
-    - npmci test legacy
+  - npmci node install legacy
+  - npmci npm install
+  - npmci npm test
   coverage: /\d+.?\d+?\%\s*coverage/
   tags:
-    - docker
+  - docker
+  - notpriv
   allow_failure: true
 
 testLTS:
   stage: test
   script:
-    - npmci test lts
+  - npmci node install lts
+  - npmci npm install
+  - npmci npm test
   coverage: /\d+.?\d+?\%\s*coverage/
   tags:
-    - docker
+  - docker
+  - notpriv
     
 testSTABLE:
   stage: test
   script:
-    - npmci test stable
+  - npmci node install stable
+  - npmci npm install
+  - npmci npm test
   coverage: /\d+.?\d+?\%\s*coverage/
   tags:
-    - docker
+  - docker
+  - notpriv
 
 release:
   stage: release
   script:
-    - npmci publish
+  - npmci node install stable
+  - npmci npm publish
   only:
-    - tags
+  - tags
   tags:
-    - docker
+  - docker
+  - notpriv
+
+# ====================
+# metadata stage
+# ====================
+codequality:
+  stage: metadata
+  image: docker:stable
+  allow_failure: true
+  services:
+    - docker:stable-dind
+  script:
+    - export SP_VERSION=$(echo "$CI_SERVER_VERSION" | sed 's/^\([0-9]*\)\.\([0-9]*\).*/\1-\2-stable/')
+    - docker run
+        --env SOURCE_CODE="$PWD"
+        --volume "$PWD":/code
+        --volume /var/run/docker.sock:/var/run/docker.sock
+        "registry.gitlab.com/gitlab-org/security-products/codequality:$SP_VERSION" /code
+  artifacts:
+    paths: [codeclimate.json]
+  tags:
+  - docker
+  - priv
 
 trigger:
-  stage: trigger
+  stage: metadata
   script:
-    - npmci trigger
+  - npmci trigger
   only:
-    - tags
+  - tags
   tags:
-    - docker
+  - docker
+  - notpriv
 
 pages:
   image: hosttoday/ht-docker-node:npmci
-  stage: pages
+  stage: metadata
   script:
-    - npmci command yarn global add npmpage
+    - npmci command npm install -g npmpage
     - npmci command npmpage
   tags:
     - docker
+    - notpriv
   only:
     - tags
   artifacts:
     expire_in: 1 week
     paths:
     - public
+  allow_failure: true
+
+windowsCompatibility:
+  image: stefanscherer/node-windows:10-build-tools
+  stage: metadata
+  script:
+  - npmci npm install
+  - npmci npm test
+  coverage: /\d+.?\d+?\%\s*coverage/
+  tags:
+  - windows
+  allow_failure: true

README.md

@@ -1,13 +1,16 @@
 # tsclass
+
 common classes for TypeScript
 
 ## Availabililty
+
 [![npm](https://tsclass.gitlab.io/assets/repo-button-npm.svg)](https://www.npmjs.com/package/tsclass)
 [![git](https://tsclass.gitlab.io/assets/repo-button-git.svg)](https://GitLab.com/tsclass/tsclass)
 [![git](https://tsclass.gitlab.io/assets/repo-button-mirror.svg)](https://github.com/tsclass/tsclass)
 [![docs](https://tsclass.gitlab.io/assets/repo-button-docs.svg)](https://tsclass.gitlab.io/tsclass/)
 
 ## Status for master
+
 [![build status](https://GitLab.com/tsclass/tsclass/badges/master/build.svg)](https://GitLab.com/tsclass/tsclass/commits/master)
 [![coverage report](https://GitLab.com/tsclass/tsclass/badges/master/coverage.svg)](https://GitLab.com/tsclass/tsclass/commits/master)
 [![npm downloads per month](https://img.shields.io/npm/dm/tsclass.svg)](https://www.npmjs.com/package/tsclass)
@@ -19,39 +22,41 @@ common classes for TypeScript
 [![JavaScript Style Guide](https://img.shields.io/badge/code%20style-standard-brightgreen.svg)](http://standardjs.com/)
 
 ## Usage
+
 Use TypeScript for best in class instellisense.
 
 tsclass exposes many commonly used objects as interface to implement (-> extends keyword) by individual implementations.
 They come complete with best in class intellisense and are easy to require.
 
 ```javascript
-import { IInvoice } from 'tsclass'
+import { IInvoice } from 'tsclass';
 
 class myOwnInvoice implements IInvoice {
-    constructor(){
-        super() // you need to call super() in the constructor
-    }
+  constructor() {
+    super(); // you need to call super() in the constructor
+  }
 }
-
 ```
 
 ### Time/Date
-* Date
-* Time
+
+- Date
+- Time
 
 ### Publications/Websites/Blogs
-* Article
-* Author
+
+- Article
+- Author
 
 ### Finance
-* Invoice
 
+- Invoice
 
 > The modules in bold letters exist as own modules and can be used seperately
 
 For further information read the linked docs at the top of this README.
 
 > MIT licensed | **©** [Lossless GmbH](https://lossless.gmbh)
-| By using this npm module you agree to our [privacy policy](https://lossless.gmbH/privacy.html)
+> | By using this npm module you agree to our [privacy policy](https://lossless.gmbH/privacy.html)
 
 [![repo-footer](https://tsclass.gitlab.io/assets/repo-footer.svg)](https://push.rocks)

dist/business/company.d.ts

@@ -1,14 +0,0 @@
-import { IDate } from '../index';
-/**
- * describes a company's lifecycle state
- */
-export declare type TCompanyStatus = 'planed' | 'founding' | 'active' | 'liquidation' | 'closed';
-/**
- * describes a company
- */
-export interface ICompany {
-    name: string;
-    foundedDate: IDate;
-    closedDate: IDate;
-    status: TCompanyStatus;
-}

dist/business/company.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29tcGFueS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzL2J1c2luZXNzL2NvbXBhbnkudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IiJ9

dist/business/invoice.d.ts

@@ -1,2 +0,0 @@
-export interface IInvoice {
-}

dist/business/invoice.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW52b2ljZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzL2J1c2luZXNzL2ludm9pY2UudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IiJ9

dist/cloud/dns.d.ts

@@ -1 +0,0 @@
-export declare type TDnsRecord = 'A' | 'AAAA' | 'CNAME' | 'TXT' | 'SRV' | 'LOC' | 'MX' | 'NS' | 'SPF';

dist/cloud/dns.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZG5zLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vdHMvY2xvdWQvZG5zLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiIifQ==

dist/content/article.d.ts

@@ -1,19 +0,0 @@
-import { IAuthor } from '../index';
-export interface IArticle {
-    /**
-     * the title of an article
-     */
-    title: string;
-    /**
-     * the Author of an article
-     */
-    author: IAuthor;
-    /**
-     * the content of an article
-     */
-    content: string;
-    /**
-     * the tags of an article
-     */
-    tags: string[];
-}

dist/content/article.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXJ0aWNsZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzL2NvbnRlbnQvYXJ0aWNsZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiIn0=

dist/content/author.d.ts

@@ -1,20 +0,0 @@
-import { IDate } from '../index';
-import { IArticle } from '../index';
-export interface IAuthor {
-    /**
-     * the first name of an author
-     */
-    firstName: string;
-    /**
-     * the surname of an author
-     */
-    surName: string;
-    /**
-     * the birthday of an author
-     */
-    birthday: IDate;
-    /**
-     * articles of an author
-     */
-    articles: IArticle[];
-}

dist/content/author.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXV0aG9yLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vdHMvY29udGVudC9hdXRob3IudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IiJ9

dist/general/date.d.ts

@@ -1,5 +0,0 @@
-export interface IDate {
-    day: number;
-    month: number;
-    year: number;
-}

dist/general/date.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZGF0ZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzL2dlbmVyYWwvZGF0ZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiIn0=

dist/general/time.d.ts

@@ -1,2 +0,0 @@
-export interface ITime {
-}

dist/general/time.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidGltZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzL2dlbmVyYWwvdGltZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiIn0=

dist/index.d.ts

@@ -1,7 +0,0 @@
-export * from './business/company';
-export * from './business/invoice';
-export * from './cloud/dns';
-export * from './content/article';
-export * from './content/author';
-export * from './general/date';
-export * from './general/time';

dist/index.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiIn0=

npmextra.json

@@ -1,7 +1,8 @@
 {
   "npmci": {
-    "globalNpmTools": [
+    "npmGlobalTools": [
       "npmts"
-    ]
+    ],
+    "npmAccessLevel": "public"
   }
 }

package-lock.json

@@ -0,0 +1,108 @@
+{
+  "name": "@tsclass/tsclass",
+  "version": "1.0.25",
+  "lockfileVersion": 1,
+  "requires": true,
+  "dependencies": {
+    "@gitzone/tsrun": {
+      "version": "1.0.5",
+      "resolved": "https://registry.npmjs.org/@gitzone/tsrun/-/tsrun-1.0.5.tgz",
+      "integrity": "sha512-zSiRnlvNAlBmrqknwH9B0gIRx7IEegPzmN+DZ4yN3f+L62WlVbKyPLeeV09SKE8BFiGo+0VIGiQW3EV/9mXMfw==",
+      "dev": true,
+      "requires": {
+        "ts-node": "^6.1.0",
+        "typescript": "^2.9.1"
+      }
+    },
+    "arrify": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/arrify/-/arrify-1.0.1.tgz",
+      "integrity": "sha1-iYUI2iIm84DfkEcoRWhJwVAaSw0=",
+      "dev": true
+    },
+    "buffer-from": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/buffer-from/-/buffer-from-1.1.0.tgz",
+      "integrity": "sha512-c5mRlguI/Pe2dSZmpER62rSCu0ryKmWddzRYsuXc50U2/g8jMOulc31VZMa4mYx31U5xsmSOpDCgH88Vl9cDGQ==",
+      "dev": true
+    },
+    "diff": {
+      "version": "3.5.0",
+      "resolved": "https://registry.npmjs.org/diff/-/diff-3.5.0.tgz",
+      "integrity": "sha512-A46qtFgd+g7pDZinpnwiRJtxbC1hpgf0uzP3iG89scHk0AUC7A1TGxf5OiiOUv/JMZR8GOt8hL900hV0bOy5xA==",
+      "dev": true
+    },
+    "make-error": {
+      "version": "1.3.4",
+      "resolved": "https://registry.npmjs.org/make-error/-/make-error-1.3.4.tgz",
+      "integrity": "sha512-0Dab5btKVPhibSalc9QGXb559ED7G7iLjFXBaj9Wq8O3vorueR5K5jaE3hkG6ZQINyhA/JgG6Qk4qdFQjsYV6g==",
+      "dev": true
+    },
+    "minimist": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/minimist/-/minimist-1.2.0.tgz",
+      "integrity": "sha1-o1AIsg9BOD7sH7kU9M1d95omQoQ=",
+      "dev": true
+    },
+    "mkdirp": {
+      "version": "0.5.1",
+      "resolved": "https://registry.npmjs.org/mkdirp/-/mkdirp-0.5.1.tgz",
+      "integrity": "sha1-MAV0OOrGz3+MR2fzhkjWaX11yQM=",
+      "dev": true,
+      "requires": {
+        "minimist": "0.0.8"
+      },
+      "dependencies": {
+        "minimist": {
+          "version": "0.0.8",
+          "resolved": "https://registry.npmjs.org/minimist/-/minimist-0.0.8.tgz",
+          "integrity": "sha1-hX/Kv8M5fSYluCKCYuhqp6ARsF0=",
+          "dev": true
+        }
+      }
+    },
+    "source-map": {
+      "version": "0.6.1",
+      "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.6.1.tgz",
+      "integrity": "sha512-UjgapumWlbMhkBgzT7Ykc5YXUT46F0iKu8SGXq0bcwP5dz/h0Plj6enJqjz1Zbq2l5WaqYnrVbwWOWMyF3F47g==",
+      "dev": true
+    },
+    "source-map-support": {
+      "version": "0.5.6",
+      "resolved": "https://registry.npmjs.org/source-map-support/-/source-map-support-0.5.6.tgz",
+      "integrity": "sha512-N4KXEz7jcKqPf2b2vZF11lQIz9W5ZMuUcIOGj243lduidkf2fjkVKJS9vNxVWn3u/uxX38AcE8U9nnH9FPcq+g==",
+      "dev": true,
+      "requires": {
+        "buffer-from": "^1.0.0",
+        "source-map": "^0.6.0"
+      }
+    },
+    "ts-node": {
+      "version": "6.1.1",
+      "resolved": "https://registry.npmjs.org/ts-node/-/ts-node-6.1.1.tgz",
+      "integrity": "sha512-79FnymLGDBd/nXoiak1L6w6fd9Zz9Ge/x8/Aglaeh31KkqRLDzbfT1vBGlO5dqc76WzufTlW4IYl7e01CVUF5A==",
+      "dev": true,
+      "requires": {
+        "arrify": "^1.0.0",
+        "diff": "^3.1.0",
+        "make-error": "^1.1.1",
+        "minimist": "^1.2.0",
+        "mkdirp": "^0.5.1",
+        "source-map-support": "^0.5.6",
+        "yn": "^2.0.0"
+      }
+    },
+    "typescript": {
+      "version": "2.9.2",
+      "resolved": "https://registry.npmjs.org/typescript/-/typescript-2.9.2.tgz",
+      "integrity": "sha512-Gr4p6nFNaoufRIY4NMdpQRNmgxVIGMs4Fcu/ujdYk3nAZqk7supzBE9idmvfZIlH/Cuj//dvi+019qEue9lV0w==",
+      "dev": true
+    },
+    "yn": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/yn/-/yn-2.0.0.tgz",
+      "integrity": "sha1-5a2ryKz0CPY4X8dklWhMiOavaJo=",
+      "dev": true
+    }
+  }
+}

package.json

@@ -1,11 +1,13 @@
 {
-  "name": "tsclass",
-  "version": "1.0.12",
+  "name": "@tsclass/tsclass",
+  "version": "1.0.25",
+  "private": false,
   "description": "common classes for TypeScript",
   "main": "dist/index.js",
   "typings": "dist/index.d.ts",
   "scripts": {
-    "test": "(npmts --notest)"
+    "test": "tsrun test/test.ts",
+    "build": "npmts --notest"
   },
   "repository": {
     "type": "git",
@@ -20,5 +22,9 @@
   "bugs": {
     "url": "https://github.com/tsclass/tsclass/issues"
   },
-  "homepage": "https://github.com/tsclass/tsclass#readme"
+  "homepage": "https://github.com/tsclass/tsclass#readme",
+  "dependencies": {},
+  "devDependencies": {
+    "@gitzone/tsrun": "^1.0.5"
+  }
 }

test/test.ts

@@ -0,0 +1,3 @@
+import * as tsclass from '../ts/index';
+
+let contact: tsclass.IContact;

ts/business/address.ts

@@ -0,0 +1,8 @@
+export interface IAddress {
+  name?: string;
+  streetName: string;
+  houseNumber: string;
+  postalCode: string;
+  city: string;
+  country: string;
+}

ts/business/company.ts

@@ -1,16 +1,17 @@
-import { IDate } from '../index'
+import { IContact } from '../index';
+import { IDate } from '../index';
 
 /**
  * describes a company's lifecycle state
  */
-export type TCompanyStatus = 'planed' | 'founding' | 'active' | 'liquidation' | 'closed'
+export type TCompanyStatus = 'planed' | 'founding' | 'active' | 'liquidation' | 'closed';
 
 /**
  * describes a company
  */
 export interface ICompany {
-  name: string
-  foundedDate: IDate
-  closedDate: IDate
-  status: TCompanyStatus
+  name: string;
+  foundedDate: IDate;
+  closedDate: IDate;
+  status: TCompanyStatus;
 }

ts/business/contact.ts

@@ -0,0 +1,28 @@
+import { IAddress } from '../index';
+
+export type TContactSalutation = 'Mr' | 'Ms' | 'Mrs';
+
+export type TContactType = 'person' | 'company';
+
+export type TContactTitle = 'Doctor' | 'Professor';
+
+export interface IContact {
+  // =======
+  // general
+  // =======
+  salutation?: TContactSalutation;
+  type: TContactType;
+  title: TContactTitle;
+  name: string;
+  surname?: string;
+  legalEntity?: string;
+  address: IAddress;
+  description: string;
+
+
+  // =========
+  // financial
+  // =========
+  vatId?: string;
+  bankAccountNumber?: string;
+}

ts/business/invoice.ts

@@ -1,3 +1,17 @@
-export interface IInvoice {
+import { IContact } from '../index';
 
+export type TInvoiceStatus = 'draft' | 'invoice' | 'paid' | 'refunded';
+
+export interface IInvoiceItem {
+  name: string;
+  unitType: string;
+  quantity: number;
+  vatPercentage: number;
+}
+
+export interface IInvoice {
+  billedBy: IContact;
+  billedTo: IContact;
+  status: TInvoiceStatus;
+  items: IInvoiceItem[];
 }

ts/cloud/dns.ts

@@ -1 +1 @@
-export type TDnsRecord = 'A' | 'AAAA' | 'CNAME' | 'TXT' | 'SRV' | 'LOC' | 'MX' | 'NS' | 'SPF'
+export type TDnsRecord = 'A' | 'AAAA' | 'CNAME' | 'TXT' | 'SRV' | 'LOC' | 'MX' | 'NS' | 'SPF';

ts/content/article.ts

@@ -1,23 +1,23 @@
-import { IAuthor } from '../index'
+import { IAuthor } from '../index';
 
 export interface IArticle {
   /**
    * the title of an article
    */
-  title: string
+  title: string;
 
   /**
    * the Author of an article
    */
-  author: IAuthor
+  author: IAuthor;
 
   /**
    * the content of an article
    */
-  content: string
+  content: string;
 
   /**
    * the tags of an article
    */
-  tags: string[]
+  tags: string[];
 }

ts/content/author.ts

@@ -1,25 +1,24 @@
-import { IDate } from '../index'
-import { IArticle } from '../index'
+import { IDate } from '../index';
+import { IArticle } from '../index';
 
 export interface IAuthor {
-
   /**
    * the first name of an author
    */
-  firstName: string
+  firstName: string;
 
   /**
    * the surname of an author
    */
-  surName: string
+  surName: string;
 
   /**
    * the birthday of an author
    */
-  birthday: IDate
+  birthday: IDate;
 
   /**
    * articles of an author
    */
-  articles: IArticle[]
+  articles: IArticle[];
 }

ts/general/date.ts

@@ -1,5 +1,5 @@
 export interface IDate {
-  day: number
-  month: number
-  year: number
+  day: number;
+  month: number;
+  year: number;
 }

ts/general/time.ts

@@ -1,3 +1 @@
-export interface ITime {
-
-}
+export interface ITime {}

ts/index.ts

@@ -1,14 +1,16 @@
 // Business
-export * from './business/company'
-export * from './business/invoice'
+export * from './business/address';
+export * from './business/company';
+export * from './business/contact';
+export * from './business/invoice';
 
 // Cloud
-export * from './cloud/dns'
+export * from './cloud/dns';
 
 // Content
-export * from './content/article'
-export * from './content/author'
+export * from './content/article';
+export * from './content/author';
 
 // General
-export * from './general/date'
-export * from './general/time'
+export * from './general/date';
+export * from './general/time';

yarn.lock

@@ -1,4 +0,0 @@
-# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY.
-# yarn lockfile v1
-
-