1.0.6

.gitea/workflows/default_nottags.yaml

@@ -0,0 +1,66 @@
+name: Default (not tags)
+
+on:
+  push:
+    tags-ignore:
+      - '**'
+
+env:
+  IMAGE: registry.gitlab.com/hosttoday/ht-docker-node:npmci
+  NPMCI_COMPUTED_REPOURL: https://${{gitea.repository_owner}}:${{secrets.GITEA_TOKEN}}@gitea.lossless.digital/${{gitea.repository}}.git
+  NPMCI_TOKEN_NPM: ${{secrets.NPMCI_TOKEN_NPM}}
+  NPMCI_TOKEN_NPM2: ${{secrets.NPMCI_TOKEN_NPM2}}
+  NPMCI_GIT_GITHUBTOKEN: ${{secrets.NPMCI_GIT_GITHUBTOKEN}}
+  NPMCI_URL_CLOUDLY: ${{secrets.NPMCI_URL_CLOUDLY}}
+
+jobs:
+  security:
+    runs-on: ubuntu-latest
+    continue-on-error: true
+    container:
+      image: ${{ env.IMAGE }}
+
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: Install pnpm and npmci
+        run: |
+          pnpm install -g pnpm
+          pnpm install -g @shipzone/npmci
+
+      - name: Run npm prepare
+        run: npmci npm prepare
+
+      - name: Audit production dependencies
+        run: |
+          npmci command npm config set registry https://registry.npmjs.org
+          npmci command pnpm audit --audit-level=high --prod
+        continue-on-error: true
+
+      - name: Audit development dependencies
+        run: |
+          npmci command npm config set registry https://registry.npmjs.org
+          npmci command pnpm audit --audit-level=high --dev
+        continue-on-error: true
+
+  test:
+    if: ${{ always() }}
+    needs: security
+    runs-on: ubuntu-latest
+    container:
+      image: ${{ env.IMAGE }}
+
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: Test stable
+        run: |
+          npmci node install stable
+          npmci npm install
+          npmci npm test
+
+      - name: Test build
+        run: |
+          npmci node install stable
+          npmci npm install
+          npmci npm build

.gitea/workflows/default_tags.yaml

@@ -0,0 +1,124 @@
+name: Default (tags)
+
+on:
+  push:
+    tags:
+      - '*'
+
+env:
+  IMAGE: registry.gitlab.com/hosttoday/ht-docker-node:npmci
+  NPMCI_COMPUTED_REPOURL: https://${{gitea.repository_owner}}:${{secrets.GITEA_TOKEN}}@gitea.lossless.digital/${{gitea.repository}}.git
+  NPMCI_TOKEN_NPM: ${{secrets.NPMCI_TOKEN_NPM}}
+  NPMCI_TOKEN_NPM2: ${{secrets.NPMCI_TOKEN_NPM2}}
+  NPMCI_GIT_GITHUBTOKEN: ${{secrets.NPMCI_GIT_GITHUBTOKEN}}
+  NPMCI_URL_CLOUDLY: ${{secrets.NPMCI_URL_CLOUDLY}}
+
+jobs:
+  security:
+    runs-on: ubuntu-latest
+    continue-on-error: true
+    container:
+      image: ${{ env.IMAGE }}
+
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: Prepare
+        run: |
+          pnpm install -g pnpm
+          pnpm install -g @shipzone/npmci
+          npmci npm prepare
+
+      - name: Audit production dependencies
+        run: |
+          npmci command npm config set registry https://registry.npmjs.org
+          npmci command pnpm audit --audit-level=high --prod
+        continue-on-error: true
+
+      - name: Audit development dependencies
+        run: |
+          npmci command npm config set registry https://registry.npmjs.org
+          npmci command pnpm audit --audit-level=high --dev
+        continue-on-error: true
+
+  test:
+    if: ${{ always() }}
+    needs: security
+    runs-on: ubuntu-latest
+    container:
+      image: ${{ env.IMAGE }}
+
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: Prepare
+        run: |
+          pnpm install -g pnpm
+          pnpm install -g @shipzone/npmci
+          npmci npm prepare
+
+      - name: Test stable
+        run: |
+          npmci node install stable
+          npmci npm install
+          npmci npm test
+
+      - name: Test build
+        run: |
+          npmci node install stable
+          npmci npm install
+          npmci npm build
+
+  release:
+    needs: test
+    if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/')
+    runs-on: ubuntu-latest
+    container:
+      image: ${{ env.IMAGE }}
+
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: Prepare
+        run: |
+          pnpm install -g pnpm
+          pnpm install -g @shipzone/npmci
+          npmci npm prepare
+
+      - name: Release
+        run: |
+          npmci node install stable
+          npmci npm publish
+
+  metadata:
+    needs: test
+    if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/')
+    runs-on: ubuntu-latest
+    container:
+      image: ${{ env.IMAGE }}
+    continue-on-error: true
+
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: Prepare
+        run: |
+          pnpm install -g pnpm
+          pnpm install -g @shipzone/npmci
+          npmci npm prepare
+
+      - name: Code quality
+        run: |
+          npmci command npm install -g typescript
+          npmci npm install
+
+      - name: Trigger
+        run: npmci trigger
+
+      - name: Build docs and upload artifacts
+        run: |
+          npmci node install stable
+          npmci npm install
+          pnpm install -g @git.zone/tsdoc
+          npmci command tsdoc
+        continue-on-error: true

.gitignore

@@ -0,0 +1,20 @@
+.nogit/
+
+# artifacts
+coverage/
+public/
+pages/
+
+# installs
+node_modules/
+
+# caches
+.yarn/
+.cache/
+.rpt2_cache
+
+# builds
+dist/
+dist_*/
+
+# custom

.vscode/launch.json

@@ -0,0 +1,11 @@
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "command": "npm test",
+      "name": "Run npm test",
+      "request": "launch",
+      "type": "node-terminal"
+    }
+  ]
+}

.vscode/settings.json

@@ -0,0 +1,26 @@
+{
+  "json.schemas": [
+    {
+      "fileMatch": ["/npmextra.json"],
+      "schema": {
+        "type": "object",
+        "properties": {
+          "npmci": {
+            "type": "object",
+            "description": "settings for npmci"
+          },
+          "gitzone": {
+            "type": "object",
+            "description": "settings for gitzone",
+            "properties": {
+              "projectType": {
+                "type": "string",
+                "enum": ["website", "element", "service", "npm", "wcc"]
+              }
+            }
+          }
+        }
+      }
+    }
+  ]
+}

docs/index.md

@@ -1 +0,0 @@
-Hello there.

mkdocs/docs/index.md

@@ -0,0 +1,45 @@
+# foss.global documentation
+
+!!! note "Welcome to the foss.global documentation!"
+    This documentation is the combined, searchable and SEO optimized documentation for all [foss.global](https://foss.global) projects. Modules might sometimes be overlapping. Combining all documentation is the best way, to have have AI answer your questions, and to find exactly what you need within the foss.global ecosystem.
+
+## What is foss.global?
+foss.global was created by task.vc as a **super scope for all task.vc open source projects**. The main theme for the Open Source projects is to simplify the life of developers and to provide a better developer experience. We share our efforts as Open Source since it became apparent to us, that it is the best way to work on, improve and benefit together from shared knowledge and solutions within our portfolio companies and the FOSS community.
+
+## The benefits for task.vc
+
+Often times companies get it wrong why being an Open Source first company is a stellar approach for progress. Here is how we as task.vc benefit from doing things in the open:
+
+* a common and open way to think about technical problems
+* fix once, fix everywhere
+* accelerted growth due to symbiotically shared techical solutions within our portfolio
+* no special contracts needed, FOSS is FOSS.
+* demonstrated competence for investors and our portfolio alike
+* new business & investments opportunities based on a shared technical understanding and stack.
+
+
+## foss.global Projects
+
+* **[apiclient.xyz](https://apiclient.xyz/)**  
+  simplified TypeScript API clients for third party services
+* **[compute.cloud](https://compute.cloud)**  
+  simplified cloud computing
+* **[push.rocks](https://push.rocks/)**  
+  solving scoped problems as well maintained TypeScript modules
+* **[uptime.link](https://uptime.link/)**  
+  status monitoring for websites and services
+* **[lossless.com](https://lossless.com/)**  
+  321 backups for your complete IT operations
+* **[social.io](https://social.io/)**  
+  customer support platform
+* **[serve.zone](https://social.io/)**  
+  scalable, simplified container management
+
+!!! tip "There is more"
+    foss.global is only one of our initiatives. We also have [workspace.global](https://workspace.global), [idp.global](https://idp.global) and [api.global](https://api.global). To learn more about them, visit their respective documentations.
+
+    foss.global projects are free to use for everyone. The other initiatives are only meant for task.vc portfolio companies only right now. We want to open them up for everybody in the long term.
+
+*[idp.global]: a unified identity provider for task.vc portfolio companies.
+*[api.global]: a unified API gateway for task.vc portfolio companies.
+*[workspace.global]: a unified SaaS workspace for task.vc portfolio companies.

mkdocs/mkdocs.yml

@@ -9,9 +9,10 @@ site_description: >-
 # Repository
 repo_name: foss.global/docs.foss.global
 repo_url: https://code.foss.global/foss.global/docs.foss.global
+edit_uri: _edit/master/mkdocs/docs/
 
 # Copyright
-copyright: "Copyright © since 2014: Task Venture Capital GmbH"
+copyright: "Copyright &copy; since 2014: <a href='https://task.vc/'>Task Venture Capital GmbH</a><br><a href='https://legal.task.vc/'>Legal Info / Impressum</a>"
 
 # Configuration
 theme:
@@ -85,16 +86,12 @@ extra:
     new: Recently added
     deprecated: Deprecated
   social:
-    - icon: fontawesome/brands/github
-      link: https://github.com/squidfunk
+    - icon: fontawesome/solid/code
+      link: https://code.foss.global/
     - icon: fontawesome/brands/docker
-      link: https://hub.docker.com/r/squidfunk/mkdocs-material/
-    - icon: fontawesome/brands/python
-      link: https://pypi.org/project/mkdocs-material/
+      link: https://registry.foss.global/
     - icon: fontawesome/brands/mastodon
-      link: https://fosstodon.org/@squidfunk
-    - icon: fontawesome/brands/twitter
-      link: https://twitter.com/squidfunk
+      link: https://mtd.task.vc/@foss_global
 
 # Extensions
 markdown_extensions:

npmextra.json

@@ -0,0 +1,29 @@
+{
+  "gitzone": {
+    "projectType": "npm",
+    "module": {
+      "githost": "code.foss.global",
+      "gitscope": "foss.global",
+      "gitrepo": "docs.foss.global",
+      "description": "Documentation and tooling setup for foss.global project.",
+      "npmPackagename": "docs.foss.global",
+      "license": "UNLICENSED",
+      "projectDomain": "docs.foss.global",
+      "keywords": [
+        "documentation",
+        "TypeScript",
+        "docker",
+        "npm package",
+        "code quality",
+        "continuous integration",
+        "version control",
+        "open source",
+        "software development"
+      ]
+    }
+  },
+  "npmci": {
+    "npmGlobalTools": [],
+    "npmAccessLevel": "private"
+  }
+}

package.json

@@ -1,14 +1,60 @@
 {
   "name": "docs.foss.global",
-  "version": "1.0.1",
-  "description": "the documentation for foss.global",
-  "main": "index.js",
-  "directories": {
-    "doc": "docs"
-  },
-  "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
-  },
+  "version": "1.0.6",
+  "private": false,
+  "description": "Documentation and tooling setup for foss.global project.",
+  "main": "dist_ts/index.js",
+  "typings": "dist_ts/index.d.ts",
+  "type": "module",
   "author": "Task Venture Capital GmbH",
-  "license": "MIT"
+  "license": "UNLICENSED",
+  "scripts": {
+    "test": "(tstest test/ --web)",
+    "build": "(tsbuild --web --allowimplicitany)",
+    "mkdocs": "(cd mkdocs && docker run --rm -it -p 8000:8000 -v ${PWD}:/docs squidfunk/mkdocs-material)",
+    "start": "(tsdoc)"
+  },
+  "devDependencies": {
+    "@git.zone/tsbuild": "^2.1.25",
+    "@git.zone/tsbundle": "^2.0.5",
+    "@git.zone/tsrun": "^1.2.46",
+    "@git.zone/tstest": "^1.0.44",
+    "@push.rocks/tapbundle": "^5.0.15",
+    "@types/node": "^20.8.7"
+  },
+  "dependencies": {},
+  "repository": {
+    "type": "git",
+    "url": "git+https://code.foss.global/foss.global/docs.foss.global.git"
+  },
+  "bugs": {
+    "url": "https://code.foss.global/foss.global/docs.foss.global/issues"
+  },
+  "homepage": "https://code.foss.global/foss.global/docs.foss.global#readme",
+  "browserslist": [
+    "last 1 chrome versions"
+  ],
+  "files": [
+    "ts/**/*",
+    "ts_web/**/*",
+    "dist/**/*",
+    "dist_*/**/*",
+    "dist_ts/**/*",
+    "dist_ts_web/**/*",
+    "assets/**/*",
+    "cli.js",
+    "npmextra.json",
+    "readme.md"
+  ],
+  "keywords": [
+    "documentation",
+    "TypeScript",
+    "docker",
+    "npm package",
+    "code quality",
+    "continuous integration",
+    "version control",
+    "open source",
+    "software development"
+  ]
 }

readme.md

@@ -0,0 +1,7 @@
+# @foss.global/docs.foss.global
+
+> the docs for foss.global! Not more, not less.
+
+## Legal
+> UNLICENSED licensed | **©** [Task Venture Capital GmbH](https://task.vc)
+| By using this npm module you agree to our [privacy policy](https://lossless.gmbH/privacy)

test/test.ts

@@ -0,0 +1,8 @@
+import { expect, expectAsync, tap } from '@push.rocks/tapbundle';
+import * as fg_docs from '../ts/index.js'
+
+tap.test('first test', async () => {
+  console.log(fg_docs)
+})
+
+tap.start()

ts/00_commitinfo_data.ts

@@ -0,0 +1,8 @@
+/**
+ * autocreated commitinfo by @pushrocks/commitinfo
+ */
+export const commitinfo = {
+  name: 'docs.foss.global',
+  version: '1.0.6',
+  description: 'Documentation and tooling setup for foss.global project.'
+}

ts/fg_docs.plugins.ts

@@ -0,0 +1,4 @@
+const removeme = {};
+export {
+  removeme
+}

ts/index.ts

@@ -0,0 +1,3 @@
+import * as plugins from './fg_docs.plugins.js';
+
+export let demoExport = 'Hi there! :) This is an exported string';

tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "experimentalDecorators": true,
+    "useDefineForClassFields": false,
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "esModuleInterop": true,
+    "verbatimModuleSyntax": true
+  },
+  "exclude": [
+    "dist_*/**/*.d.ts"
+  ]
+}