4.0.52

.gitlab-ci.yml

@@ -13,31 +13,24 @@ stages:
   - metadata
 
 before_script:
-  - npm install -g @shipzone/npmci
+  - pnpm install -g pnpm
+  - pnpm install -g @shipzone/npmci
+  - npmci npm prepare
 
 # ====================
 # security stage
 # ====================
-mirror:
-  stage: security
-  script:
-    - npmci git mirror
-  only:
-    - tags
-  tags:
-    - lossless
-    - docker
-    - notpriv
-
+# ====================
+# security stage
+# ====================
 auditProductionDependencies:
   image: registry.gitlab.com/hosttoday/ht-docker-node:npmci
   stage: security
   script:
-    - npmci npm prepare
-    - npmci command npm install --production --ignore-scripts
-    - npmci command npm config set registry https://registry.npmjs.org
-    - npmci command npm audit --audit-level=high --only=prod --production
+     - npmci command npm config set registry https://registry.npmjs.org
+     - npmci command pnpm audit --audit-level=high --prod
   tags:
+    - lossless
     - docker
   allow_failure: true
 
@@ -45,11 +38,10 @@ auditDevDependencies:
   image: registry.gitlab.com/hosttoday/ht-docker-node:npmci
   stage: security
   script:
-    - npmci npm prepare
-    - npmci command npm install --ignore-scripts
     - npmci command npm config set registry https://registry.npmjs.org
-    - npmci command npm audit --audit-level=high --only=dev
+    - npmci command pnpm audit --audit-level=high --dev
   tags:
+    - lossless
     - docker
   allow_failure: true
 
@@ -60,7 +52,6 @@ auditDevDependencies:
 testStable:
   stage: test
   script:
-    - npmci npm prepare
     - npmci node install stable
     - npmci npm install
     - npmci npm test
@@ -71,7 +62,6 @@ testStable:
 testBuild:
   stage: test
   script:
-    - npmci npm prepare
     - npmci node install stable
     - npmci npm install
     - npmci command npm run build
@@ -122,11 +112,9 @@ trigger:
 pages:
   stage: metadata
   script:
-    - npmci node install lts
-    - npmci command npm install -g @gitzone/tsdoc
-    - npmci npm prepare
+    - npmci node install stable
     - npmci npm install
-    - npmci command tsdoc
+    - npmci command npm run buildDocs
   tags:
     - lossless
     - docker

license

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 
+
+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.json

@@ -1,6 +1,6 @@
 {
   "name": "@tsclass/tsclass",
-  "version": "4.0.0",
+  "version": "4.0.52",
   "private": false,
   "description": "common classes for TypeScript",
   "main": "dist_ts/index.js",
@@ -8,7 +8,8 @@
   "type": "module",
   "scripts": {
     "test": "tstest test/",
-    "build": "(tsbuild --web)"
+    "build": "(tsbuild --web)",
+    "buildDocs": "tsdoc"
   },
   "repository": {
     "type": "git",
@@ -25,15 +26,14 @@
   },
   "homepage": "https://github.com/tsclass/tsclass#readme",
   "dependencies": {
-    "type-fest": "^2.9.0"
+    "type-fest": "^4.10.2"
   },
   "devDependencies": {
-    "@gitzone/tsbuild": "^2.1.61",
-    "@gitzone/tsrun": "^1.2.32",
-    "@gitzone/tstest": "^1.0.70",
-    "@pushrocks/tapbundle": "^3.2.15",
-    "tslint": "^6.1.3",
-    "tslint-config-prettier": "^1.18.0"
+    "@git.zone/tsbuild": "^2.1.72",
+    "@git.zone/tsrun": "^1.2.46",
+    "@git.zone/tstest": "^1.0.86",
+    "@push.rocks/tapbundle": "^5.0.15",
+    "@types/node": "^20.11.17"
   },
   "files": [
     "ts/**/*",

test/test.both.ts

@@ -1,4 +1,4 @@
-import { tap, expect } from '@pushrocks/tapbundle';
+import { tap, expect } from '@push.rocks/tapbundle';
 
 import * as tsclass from '../ts/index.js';
 

ts/00_commitinfo_data.ts

@@ -1,11 +1,8 @@
 /**
  * autocreated commitinfo by @pushrocks/commitinfo
  */
-export const name: string = '@tsclass/tsclass';
-export const version: string = '4.0.48';
-export const description: string = 'common classes for TypeScript'
 export const commitinfo = {
   name: '@tsclass/tsclass',
-  version: '4.0.48',
+  version: '4.0.52',
   description: 'common classes for TypeScript'
 }

ts/00helperfunctions.ts/finance.ts

@@ -0,0 +1,5 @@
+import { type IInvoice } from "../finance/invoice.js";
+
+export function createLetterFromInvoice(invoiceArg: IInvoice) {
+
+}

ts/00helperfunctions.ts/index.ts

@@ -0,0 +1 @@
+export * from './finance.js';

ts/authentication/processedclaim.ts

@@ -1,4 +1,4 @@
-import { IClaim } from './claim';
+import { type IClaim } from './claim.js';
 
 export interface IProcessedClaim {
   originalJWT: string;

ts/business/company.ts

@@ -10,6 +10,9 @@ export type TCompanyStatus = 'planed' | 'founding' | 'active' | 'liquidation' |
  */
 export interface ICompany {
   name: string;
+  slogan?: string;
+  description?: string;
+  logoLink?: string;
   foundedDate: general.IDate;
   closedDate: general.IDate;
   status: business.TCompanyStatus;

ts/business/contact.ts

@@ -1,3 +1,4 @@
+import { finance } from '../index.js';
 import { business } from '../index.js';
 
 export type TContactSalutation = 'Mr' | 'Ms' | 'Mrs';
@@ -33,8 +34,5 @@ export interface IContact {
   // financial
   // =========
   vatId?: string;
-  sepaConnection?: {
-    iban: string;
-    bic: string;
-  };
+  sepaConnection?: finance.ISepaConnection;
 }

ts/business/contract.ts

@@ -0,0 +1,20 @@
+import * as database from '../database/index.js';
+import { type IPerson } from './person.js';
+
+export interface IContract {
+  parties: {
+    signingOrder: number;
+    referencedAs: string;
+    person: IPerson;
+    role: 'signer' | 'cc';
+    signature: {
+      given: boolean;
+      timestamp?: number;
+      location?: string;
+      ip?: string;
+      verifications?: [];
+    };
+  }[];
+  contractTextMarkdown: string;
+  actions: database.IObjectAction[];
+}

ts/business/index.ts

@@ -1,5 +1,8 @@
 export * from './address.js';
 export * from './company.js';
 export * from './contact.js';
+export * from './job.js';
 export * from './letter.js';
+export * from './pdf.js';
 export * from './person.js';
+export * from './project.js';

ts/business/job.ts

@@ -0,0 +1,18 @@
+import * as finance from '../finance/index.js';
+import { type ICompany } from './company.js';
+import { type IContact } from './contact.js';
+export class IJob {
+  type: 'contract' | 'employment';
+  techTags?: string[];
+  qualificationTags?: string[];
+  languages?: {
+    name: string;
+    level: 'basic' | 'intermediate' | 'advanced' | 'native';
+  }[];
+  name: string;
+  description: string;
+  monthlyTotal: number;
+  currency: finance.TCurrency;
+  from: ICompany;
+  contact: IContact;
+}

ts/business/letter.ts

@@ -1,21 +1,35 @@
 import * as business from './index.js';
 import * as finance from '../finance/index.js';
+import * as database from '../database/index.js';
 export interface ILetter {
+  versionInfo: {
+    type: 'draft' | 'final';
+    /**
+     * should follow semVer
+     */
+    version: string;
+  };
   incidenceId: string;
+  type: 'invoice' | 'notice' | 'warning' | 'verification' | 'contract';
   date: number;
   from: business.IContact;
   to: business.IContact;
-  logoUrl: string;
-  accentColor: string;
-  subject: string;
-  text: string[];
-  invoiceData?: finance.IInvoice;
-  contractData?: {
-    id: string;
-    contractDate: number;
-  };
-  timesheetData: string;
-  pdfAttachments: Uint8Array[];
   legalContact: business.IContact;
+  logoUrl: string;
+  subject: string;
+  accentColor?: string;
+  needsCoverSheet: boolean;
+  content: {
+    textData: string[];
+    invoiceData?: finance.IInvoice;
+    contractData?: {
+      id: string;
+      contractDate: number;
+    };
+    timesheetData: string;
+  }
+  pdf?: business.IPdf;
+  pdfAttachments: business.IPdf[];
   language: string;
+  objectActions: database.IObjectAction[];
 }

ts/business/pdf.ts

@@ -0,0 +1,8 @@
+export interface IPdf {
+  name: string;
+  id: string;
+  metadata: {
+    textExtraction: string;
+  };
+  buffer: ArrayBufferLike;
+}

ts/business/person.ts

@@ -1,6 +1,12 @@
+import { type IContact } from './contact.js';
+
 export interface IPerson {
   title: string;
   name: string;
   surname: string;
   sex: 'male' | 'female' | 'queer';
+  legalProxyFor?: {
+    type: 'self' | 'other';
+    contact?: IContact;
+  };
 }

ts/business/project.ts

@@ -0,0 +1,18 @@
+export interface IProject {
+  active: boolean;
+  category: 'SaaS' | 'IaaS' | 'Media' | 'Blockchain' | 'Open Source' | 'Consulting' | 'internal' | 'partner';
+  branch?: null;
+  branchId? : string;
+  domain: string;
+  redirectDomains: string[];
+  gitlab: string;
+  name: string;
+  social: {
+    facebook?: string;
+    gitlab?: string;
+    github?: string;
+    twitter?: string;
+  };
+  tagLine: string;
+  tags: string[];
+}

ts/code/commitinfo.ts

@@ -0,0 +1,5 @@
+export interface ICommitInfo {
+  name: string;
+  version: string;
+  description: string;
+}

ts/code/index.ts

@@ -1 +1,2 @@
 export * from './commitinfo.js';
+export * from './statusobject.js';

ts/code/statusobject.ts

@@ -0,0 +1,13 @@
+export type TStatus = 'ok' | 'partly_ok' | 'not_ok';
+export interface IStatusObject {
+  id?: string;
+  name: string;
+  combinedStatus?: TStatus;
+  combinedStatusText: string;
+  details: Array<{
+    name: string;
+    value: string;
+    status: TStatus;
+    statusText: string;
+  }> 
+}

ts/content/article.ts

@@ -1,5 +1,11 @@
 import { content } from '../index.js';
 
+/**
+ * a general content article:
+ * * can be news
+ * * can be a productdescription,
+ * * can be anything that has text with a title
+ */
 export interface IArticle<T = any> {
   /**
    * the main url of an article

ts/content/author.ts

@@ -1,5 +1,8 @@
 import { general, content } from '../index.js';
 
+/**
+ * answers the question "Who wrote that?"
+ */
 export interface IAuthor {
   /**
    * the first name of an author

ts/content/documentationset.ts

@@ -0,0 +1,10 @@
+import { type IArticle } from './article.js';
+
+/**
+ * a set of articles that together form a body of documentation
+ */
+export interface IDocumentationSet {
+  id: string;
+  creationTimestamp: number;
+  articles: IArticle[];
+}

ts/content/index.ts

@@ -1,2 +1,3 @@
 export * from './article.js';
 export * from './author.js';
+export * from './documentationset.js';

ts/database/index.ts

@@ -0,0 +1,4 @@
+export * from './mongodescriptor.js';
+export * from './objectaction.js';
+export * from './objectstatus.js';
+export * from './wrappeddata.js';

ts/database/mongodescriptor.ts

@@ -0,0 +1,25 @@
+/**
+ * contains the complete info for how to connect to a mongodb database.
+ */
+export interface IMongoDescriptor {
+  /**
+   * the URL to connect to
+   */
+  mongoDbUrl: string;
+
+  /**
+   * the db to use for the project
+   */
+  mongoDbName?: string;
+
+  /**
+   * a username to use to connect to the database
+   */
+
+  mongoDbUser?: string;
+
+  /**
+   * an optional password that will be replace <PASSWORD> in the connection string
+   */
+  mongoDbPass?: string;
+}

ts/database/objectaction.ts

@@ -0,0 +1,8 @@
+export interface IObjectAction {
+  timestamp: number;
+  name: string;
+  userId: string;
+  data: any;
+  message: string;
+  privateMessage: string;
+}

ts/database/objectstatus.ts

@@ -0,0 +1,7 @@
+export interface IObjectStatus {
+  current: 'active' | 'inactive' | 'hidden' | 'markedForDeletion';
+  scheduledDeletion: number;
+  justForLooks: {
+    scheduledDeletionIso: string;
+  };
+}

ts/database/wrappeddata.ts

@@ -0,0 +1,3 @@
+export interface IWrappedData<T> {
+  data: T;
+}

ts/events/contractevent.ts

@@ -1,5 +1,5 @@
 /**
- * a constract event describes any kind of sale
+ * a contract event describes any kind of sale
  */
 export interface IEvent_Contract {
   contractId: string;

ts/finance/index.ts

@@ -2,4 +2,5 @@ export * from './checkingaccount.js';
 export * from './currency.js';
 export * from './expense.js';
 export * from './invoice.js';
+export * from './payment.js';
 export * from './transaction.js';

ts/finance/invoice.ts

@@ -1,4 +1,4 @@
-import { business } from '../index.js';
+import { business, finance } from '../index.js';
 
 export type TInvoiceStatus = 'draft' | 'invoice' | 'paid' | 'refunded';
 
@@ -34,4 +34,5 @@ export interface IInvoice {
       items: IInvoiceItem[];
     };
   };
+  paymentOptions?: finance.IPaymentOptionInfo;
 }

ts/finance/payment.ts

@@ -0,0 +1,14 @@
+export interface ISepaConnection {
+  institution?: string;
+  iban: string;
+  bic: string;
+}
+
+export interface IPayPalConnection {
+  email: string;
+}
+
+export interface IPaymentOptionInfo {
+  sepaConnection: ISepaConnection;
+  payPal: IPayPalConnection;
+}

ts/index.ts

@@ -1,15 +1,18 @@
 // Business
 import * as business from './business/index.js';
 
+// Code
+import * as code from './code/index.js';
+
 // Container
 import * as container from './container/index.js';
 
+// Database
+import * as database from './database/index.js';
+
 // Finance
 import * as finance from './finance/index.js';
 
-// Code
-import * as code from './code/index.js';
-
 // Content
 import * as content from './content/index.js';
 
@@ -22,8 +25,15 @@ import * as network from './network/index.js';
 // SaaS
 import * as saas from './saas/index.js';
 
-export { business, container, code, finance, content, general, network, saas };
+// Storage
+import * as storage from './storage/index.js';
+
+// Website
+import * as website from './website/index.js';
+
+export { business, container, code, database, finance, content, general, network, saas, storage, website };
 
 import type * as typeFest from 'type-fest';
+import * as typeFestOwn from './typefest.own.js';
 
-export { typeFest };
+export { type typeFest, type typeFestOwn };

ts/network/cname.ts

@@ -0,0 +1,29 @@
+import { type ICert } from "./cert.js";
+
+export class ICnameDescriptor {
+  /**
+   * the original domain that is being cnamed
+   */
+  cnamedDomain: string;
+
+  /**
+   * the cname proxy domain
+   * the domain that is used for the cname dns entry
+   */
+  cnameProxyDomain: string;
+
+  /**
+   * the internal target url
+   */
+  targetUrl: string;
+
+  /**
+   * a description
+   */
+  description: string;
+
+  /**
+   * the ssl certificate
+   */
+  sslCertificate?: ICert;
+};

ts/network/device.ts

@@ -0,0 +1,10 @@
+export interface IDevice {
+  id: string;
+  resolutionWidth?: number;
+  resolutionHeight?: number;
+  dpi?: number;
+  manufacturer?: string;
+  name?: string;
+  ipv4?: string;
+  ipv6?: string;
+}

ts/network/domaindelegation.ts

@@ -0,0 +1,31 @@
+export interface IDomainDelegation {
+  /**
+   * only if it applis: the origininating url
+   */
+  fullUrl: string;
+  /**
+   * the full domain name
+   */
+  fullDomain: string;
+  /**
+   * the domain, meaning whats usually considered a domain like google.com
+   */
+  domain: string;
+  /**
+   * the public suffix, meaning whats usually considered a public suffix like .com
+   */
+  publicSuffix: string;
+
+  /**
+   * the domain without the public suffix
+   */
+  domainWithoutSuffix: string;
+
+  /**
+   * the subdomain, meaning whats usually considered a subdomain like www
+   */
+  subdomain: string;
+
+  isIcann?: boolean;
+  dnsSecEnabled?: boolean;
+}

ts/network/index.ts

@@ -1,6 +1,11 @@
 export * from './cert.js';
+export * from './cname.js';
+export * from './device.js';
 export * from './dns.js';
 export * from './dnschallenge.js';
+export * from './domaindelegation.js';
+export * from './jwt.js';
 export * from './networknode.js';
 export * from './request.js';
 export * from './reverseproxy.js';
+export * from './ssh.js';

ts/network/jwt.ts

@@ -0,0 +1,4 @@
+export interface IJwtKeypair {
+  privatePem: string;
+  publicPem: string;
+}

ts/network/ssh.ts

@@ -0,0 +1,5 @@
+export interface ISshKey {
+  keyName: string;
+  public: string;
+  private?: string;
+}

ts/saas/product.ts

@@ -1 +1,14 @@
-export interface IProduct {}
+import { type ICompany } from "../business/company.js";
+
+export interface IProduct {
+  name: string;
+  slogan: string;
+  description: string;
+  os: 'web-based',
+  category: 'Business Application',
+  offers: any[];
+  landingPage: string;
+  appLink: string;
+  logoLink: string;
+  publisher?: ICompany;
+}

ts/saas/subscriptionplan.ts

@@ -1,4 +1,4 @@
-import { IProduct } from './product.js';
+import { type IProduct } from './product.js';
 
 export interface ISubscriptionPlan {
   name: string;

ts/storage/index.ts

@@ -0,0 +1,7 @@
+export interface IS3Descriptor {
+  endpoint: string;
+  port?: number;
+  useSsl?: boolean;
+  accessKey: string;
+  accessSecret: string;
+}

ts/typefest.own.ts

@@ -0,0 +1,8 @@
+type SecondArgument<T> = T extends (arg1: any, arg2: infer P, ...args: any[]) => any ? P : never;
+
+type ValueType<T> = T extends { [key: string]: infer U } ? U : never;
+
+export type {
+  SecondArgument,
+  ValueType
+}

ts/website/index.ts

@@ -0,0 +1 @@
+export * from './menuitem.js';

ts/website/menuitem.ts

@@ -0,0 +1,5 @@
+export interface IMenuItem<T = any, U = any> {
+  name: string;
+  iconName?: string;
+  action: (optionsArg?: T) => Promise<U>;
+}

tsconfig.json

@@ -4,6 +4,11 @@
     "useDefineForClassFields": false,
     "target": "ES2022",
     "module": "ES2022",
-    "moduleResolution": "nodenext"
-  }
+    "moduleResolution": "nodenext",
+    "esModuleInterop": true,
+    "verbatimModuleSyntax": true
+  },
+  "exclude": [
+    "dist_*/**/*.d.ts"
+  ]
 }

tslint.json

@@ -1,17 +0,0 @@
-{
-  "extends": ["tslint:latest", "tslint-config-prettier"],
-  "rules": {
-    "semicolon": [true, "always"],
-    "no-console": false,
-    "ordered-imports": false,
-    "object-literal-sort-keys": false,
-    "member-ordering": {
-      "options":{
-        "order": [
-          "static-method"
-        ]
-      }
-    }
-  },
-  "defaultSeverity": "warning"
-}