fix(documentation): update readme with comprehensive API documentation and hints file

- Updated readme.md with complete API reference and usage examples
- Added readme.hints.md with architecture and implementation details
- Improved documentation structure and clarity
- Version bump to 5.0.13

.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

@@ -1,14 +1,20 @@
-node_modules/
-.settings/
-.idea/
+.nogit/
+
+# artifacts
 coverage/
-docs/
+public/
+pages/
 
-#npm devug
-npm-debug.log
+# installs
+node_modules/
 
-ts/*.js
-ts/*.js.map
-ts/typings/
+# caches
+.yarn/
+.cache/
+.rpt2_cache
 
-test/browser/browserified/
+# builds
+dist/
+dist_*/
+
+# custom

.gitlab-ci.yml

@@ -1,59 +0,0 @@
-image: hosttoday/ht-docker-node:npmts
-
-stages:
-- test
-- release
-- trigger
-- pages
-
-testLEGACY:
-  stage: test
-  script:
-    - npmci test legacy
-  tags:
-    - docker
-  allow_failure: true
-
-testLTS:
-  stage: test
-  script:
-    - npmci test lts
-  tags:
-    - docker
-    
-testSTABLE:
-  stage: test
-  script:
-    - npmci test stable
-  tags:
-    - docker
-
-release:
-  stage: release
-  script:
-    - npmci publish
-  only:
-    - tags
-  tags:
-    - docker
-
-trigger:
-  stage: trigger
-  script:
-    - npmci trigger
-  only:
-    - tags
-  tags:
-    - docker
-
-pages:
-  image: hosttoday/ht-docker-node:npmpage
-  stage: pages
-  script:
-    - npmci command npmpage --host gitlab
-  only:
-    - tags
-  artifacts:
-    expire_in: 1 week
-    paths:
-    - public

.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"]
+              }
+            }
+          }
+        }
+      }
+    }
+  ]
+}

LICENSE

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2015 Push.Rocks
+Copyright (c) 2015 Lossless GmbH
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -1,39 +0,0 @@
-# smartenv
-store things about your environment and let them travel across modules
-
-## Availabililty
-[![npm](https://push.rocks/assets/repo-button-npm.svg)](https://www.npmjs.com/package/smartenv)
-[![git](https://push.rocks/assets/repo-button-git.svg)](https://gitlab.com/pushrocks/smartenv)
-[![git](https://push.rocks/assets/repo-button-mirror.svg)](https://github.com/pushrocks/smartenv)
-[![docs](https://push.rocks/assets/repo-button-docs.svg)](https://pushrocks.gitlab.io/smartenv/)
-
-## Status for master
-[![build status](https://gitlab.com/pushrocks/smartenv/badges/master/build.svg)](https://gitlab.com/pushrocks/smartenv/commits/master)
-[![coverage report](https://gitlab.com/pushrocks/smartenv/badges/master/coverage.svg)](https://gitlab.com/pushrocks/smartenv/commits/master)
-[![Dependency Status](https://david-dm.org/pushrocks/smartenv.svg)](https://david-dm.org/pushrocks/smartenv)
-[![bitHound Dependencies](https://www.bithound.io/github/pushrocks/smartenv/badges/dependencies.svg)](https://www.bithound.io/github/pushrocks/smartenv/master/dependencies/npm)
-[![bitHound Code](https://www.bithound.io/github/pushrocks/smartenv/badges/code.svg)](https://www.bithound.io/github/pushrocks/smartenv)
-[![TypeScript](https://img.shields.io/badge/TypeScript-2.x-blue.svg)](https://nodejs.org/dist/latest-v6.x/docs/api/)
-[![node](https://img.shields.io/badge/node->=%206.x.x-blue.svg)](https://nodejs.org/dist/latest-v6.x/docs/api/)
-[![JavaScript Style Guide](https://img.shields.io/badge/code%20style-standard-brightgreen.svg)](http://standardjs.com/)
-
-## Install
-Install the package through npm
-
-```
-npm install smartenv
-```
-
-## Usage
-
-```javascript
-var smartenv = require("smartenv");
-
-smartenv.info(); //prints an output about your current environment and registered objects
-smartenv.register({akey:"a text"},"somevalue"); // register a new object
-smartenv.makeGlobal() // make smartenv available from gobal.smartenv
-smartenv.get("somevalue").akey; // returns "a text"
-smartenv.items.somevalue.akey; // also returns "a text"
-```
-
-[![npm](https://push.rocks/assets/repo-header.svg)](https://push.rocks)

changelog.md

@@ -0,0 +1,8 @@
+# Changelog
+
+## [5.0.13] - 2025-07-28
+
+### Fixed
+- Updated readme.md with comprehensive documentation including API reference, core features, and usage examples
+- Added readme.hints.md with architecture and implementation details for future reference
+- Improved documentation structure and clarity

dist/index.d.ts

@@ -1,7 +0,0 @@
-import * as classes from './smartenv.classes';
-declare let smartenv: {
-    getEnv: () => classes.Environment;
-    printEnv: () => void;
-    obs: any;
-};
-export = smartenv;

dist/index.js

@@ -1,10 +0,0 @@
-"use strict";
-const SmartenvEnvironment = require("./smartenv.environment");
-const SmartenvObjectstorage = require("./smartenv.objectstorage");
-let smartenv = {
-    getEnv: SmartenvEnvironment.getEnv,
-    printEnv: SmartenvEnvironment.printEnv,
-    obs: SmartenvObjectstorage.obs
-}; // create smartenv object
-module.exports = smartenv;
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiO0FBRUEsOERBQTZEO0FBQzdELGtFQUFpRTtBQUVqRSxJQUFJLFFBQVEsR0FBRztJQUNYLE1BQU0sRUFBRSxtQkFBbUIsQ0FBQyxNQUFNO0lBQ2xDLFFBQVEsRUFBRSxtQkFBbUIsQ0FBQyxRQUFRO0lBQ3RDLEdBQUcsRUFBRSxxQkFBcUIsQ0FBQyxHQUFHO0NBQ2pDLENBQUEsQ0FBQyx5QkFBeUI7QUFFM0IsaUJBQVMsUUFBUSxDQUFBIn0=

dist/smartenv.classes.d.ts

@@ -1,11 +0,0 @@
-export declare class Environment {
-    runtimeEnv: string;
-    isBrowser: boolean;
-    userAgent: string;
-    isNode: boolean;
-    nodeVersion: string;
-    isCI: boolean;
-    isTravis: boolean;
-    isC9: boolean;
-    constructor();
-}

dist/smartenv.classes.helpers.d.ts

@@ -1,8 +0,0 @@
-export declare var getEnvString: () => string;
-export declare var getUserAgentString: () => string;
-export declare var isNode: () => boolean;
-export declare var getNodeVersion: () => string;
-export declare var isBrowser: () => boolean;
-export declare var isCI: () => boolean;
-export declare var isC9: () => boolean;
-export declare var isTravis: () => boolean;

dist/smartenv.classes.helpers.js

@@ -1,53 +0,0 @@
-"use strict";
-exports.getEnvString = function () {
-    if (typeof window !== 'undefined') {
-        return 'browser';
-    }
-    else if (typeof process !== 'undefined') {
-        return 'node';
-    }
-};
-exports.getUserAgentString = function () {
-    if (exports.isBrowser()) {
-        return navigator.userAgent;
-    }
-    else {
-        return undefined;
-    }
-};
-exports.isNode = function () {
-    return exports.getEnvString() === 'node';
-};
-exports.getNodeVersion = function () {
-    return process.version;
-};
-exports.isBrowser = function () {
-    return !exports.isNode();
-};
-exports.isCI = function () {
-    if (process.env.CI) {
-        return true;
-    }
-    else {
-        return false;
-    }
-    ;
-};
-exports.isC9 = function () {
-    if (process.env.C9_HOSTNAME) {
-        return true;
-    }
-    else {
-        return false;
-    }
-};
-exports.isTravis = function () {
-    if (process.env.TRAVIS) {
-        return true;
-    }
-    else {
-        return false;
-    }
-    ;
-};
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic21hcnRlbnYuY2xhc3Nlcy5oZWxwZXJzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvc21hcnRlbnYuY2xhc3Nlcy5oZWxwZXJzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7QUFBVyxRQUFBLFlBQVksR0FBRztJQUN0QixFQUFFLENBQUMsQ0FBQyxPQUFPLE1BQU0sS0FBSyxXQUFXLENBQUMsQ0FBQyxDQUFDO1FBQ2hDLE1BQU0sQ0FBQyxTQUFTLENBQUE7SUFDcEIsQ0FBQztJQUFDLElBQUksQ0FBQyxFQUFFLENBQUMsQ0FBQyxPQUFPLE9BQU8sS0FBSyxXQUFXLENBQUMsQ0FBQyxDQUFDO1FBQ3hDLE1BQU0sQ0FBQyxNQUFNLENBQUE7SUFDakIsQ0FBQztBQUNMLENBQUMsQ0FBQTtBQUVVLFFBQUEsa0JBQWtCLEdBQUc7SUFDNUIsRUFBRSxDQUFDLENBQUMsaUJBQVMsRUFBRSxDQUFDLENBQUMsQ0FBQztRQUNkLE1BQU0sQ0FBRSxTQUFTLENBQUMsU0FBUyxDQUFBO0lBQy9CLENBQUM7SUFBQyxJQUFJLENBQUMsQ0FBQztRQUNKLE1BQU0sQ0FBQyxTQUFTLENBQUE7SUFDcEIsQ0FBQztBQUNMLENBQUMsQ0FBQTtBQUVVLFFBQUEsTUFBTSxHQUFHO0lBQ2hCLE1BQU0sQ0FBQyxvQkFBWSxFQUFFLEtBQUssTUFBTSxDQUFBO0FBQ3BDLENBQUMsQ0FBQTtBQUVVLFFBQUEsY0FBYyxHQUFHO0lBQ3hCLE1BQU0sQ0FBQyxPQUFPLENBQUMsT0FBTyxDQUFBO0FBQzFCLENBQUMsQ0FBQTtBQUVVLFFBQUEsU0FBUyxHQUFHO0lBQ25CLE1BQU0sQ0FBQyxDQUFDLGNBQU0sRUFBRSxDQUFBO0FBQ3BCLENBQUMsQ0FBQTtBQUVVLFFBQUEsSUFBSSxHQUFHO0lBQ2QsRUFBRSxDQUFDLENBQUMsT0FBTyxDQUFDLEdBQUcsQ0FBQyxFQUFFLENBQUMsQ0FBQyxDQUFDO1FBQ2pCLE1BQU0sQ0FBQyxJQUFJLENBQUE7SUFDZixDQUFDO0lBQUMsSUFBSSxDQUFDLENBQUM7UUFDSixNQUFNLENBQUMsS0FBSyxDQUFBO0lBQ2hCLENBQUM7SUFBQSxDQUFDO0FBQ04sQ0FBQyxDQUFBO0FBRVUsUUFBQSxJQUFJLEdBQUc7SUFDZCxFQUFFLENBQUMsQ0FBQyxPQUFPLENBQUMsR0FBRyxDQUFDLFdBQVcsQ0FBQyxDQUFDLENBQUM7UUFDMUIsTUFBTSxDQUFDLElBQUksQ0FBQTtJQUNmLENBQUM7SUFBQyxJQUFJLENBQUMsQ0FBQztRQUNKLE1BQU0sQ0FBQyxLQUFLLENBQUE7SUFDaEIsQ0FBQztBQUNMLENBQUMsQ0FBQTtBQUVVLFFBQUEsUUFBUSxHQUFHO0lBQ2xCLEVBQUUsQ0FBQyxDQUFDLE9BQU8sQ0FBQyxHQUFHLENBQUMsTUFBTSxDQUFDLENBQUMsQ0FBQztRQUNyQixNQUFNLENBQUMsSUFBSSxDQUFBO0lBQ2YsQ0FBQztJQUFDLElBQUksQ0FBQyxDQUFDO1FBQ0osTUFBTSxDQUFDLEtBQUssQ0FBQTtJQUNoQixDQUFDO0lBQUEsQ0FBQztBQUNOLENBQUMsQ0FBQSJ9

dist/smartenv.classes.js

@@ -1,17 +0,0 @@
-"use strict";
-const helpers = require("./smartenv.classes.helpers");
-class Environment {
-    constructor() {
-        this.runtimeEnv = helpers.getEnvString();
-        this.isBrowser = helpers.isBrowser();
-        this.userAgent = helpers.getUserAgentString();
-        this.isNode = helpers.isNode();
-        this.nodeVersion = helpers.getNodeVersion();
-        this.isCI = helpers.isCI();
-        this.isTravis = helpers.isTravis();
-        this.isC9 = helpers.isC9();
-    }
-    ;
-}
-exports.Environment = Environment;
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic21hcnRlbnYuY2xhc3Nlcy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzL3NtYXJ0ZW52LmNsYXNzZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IjtBQUFBLHNEQUFzRDtBQUV0RDtJQVNJO1FBQ0ksSUFBSSxDQUFDLFVBQVUsR0FBRyxPQUFPLENBQUMsWUFBWSxFQUFFLENBQUE7UUFDeEMsSUFBSSxDQUFDLFNBQVMsR0FBRyxPQUFPLENBQUMsU0FBUyxFQUFFLENBQUE7UUFDcEMsSUFBSSxDQUFDLFNBQVMsR0FBRyxPQUFPLENBQUMsa0JBQWtCLEVBQUUsQ0FBQTtRQUM3QyxJQUFJLENBQUMsTUFBTSxHQUFHLE9BQU8sQ0FBQyxNQUFNLEVBQUUsQ0FBQTtRQUM5QixJQUFJLENBQUMsV0FBVyxHQUFHLE9BQU8sQ0FBQyxjQUFjLEVBQUUsQ0FBQTtRQUMzQyxJQUFJLENBQUMsSUFBSSxHQUFHLE9BQU8sQ0FBQyxJQUFJLEVBQUUsQ0FBQTtRQUMxQixJQUFJLENBQUMsUUFBUSxHQUFHLE9BQU8sQ0FBQyxRQUFRLEVBQUUsQ0FBQTtRQUNsQyxJQUFJLENBQUMsSUFBSSxHQUFHLE9BQU8sQ0FBQyxJQUFJLEVBQUUsQ0FBQTtJQUM5QixDQUFDO0lBQUEsQ0FBQztDQUNMO0FBbkJELGtDQW1CQyJ9

dist/smartenv.environment.d.ts

@@ -1,10 +0,0 @@
-import * as classes from './smartenv.classes';
-/**
- * returns the environment
- * @returns {Environment}
- */
-export declare var getEnv: () => classes.Environment;
-/**
- * prints the environment to console
- */
-export declare var printEnv: () => void;

dist/smartenv.environment.js

@@ -1,34 +0,0 @@
-"use strict";
-const classes = require("./smartenv.classes");
-const objectStorage = require("./smartenv.objectstorage");
-let environment;
-let envDetermined = false;
-/**
- * returns the environment
- * @returns {Environment}
- */
-exports.getEnv = function () {
-    if (!envDetermined) {
-        environment = new classes.Environment();
-        envDetermined = true; // ensure code above only runs once
-    }
-    ;
-    return environment;
-};
-/**
- * prints the environment to console
- */
-exports.printEnv = function () {
-    if (this.getEnv().isNode) {
-        console.log('running on NODE');
-        let smartenvVersion = require('../package.json').version;
-        console.log('node version is ' + this.getEnv().nodeVersion + ' and smartenv version is ' + smartenvVersion);
-    }
-    else {
-        console.log('running on BROWSER');
-        console.log('browser is ' + this.getEnv().userAgent);
-    }
-    console.log('the smartenv registration store currently holds the following properties:');
-    console.log(Object.getOwnPropertyNames(objectStorage.obs.getAll()));
-};
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic21hcnRlbnYuZW52aXJvbm1lbnQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9zbWFydGVudi5lbnZpcm9ubWVudC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiO0FBSUEsOENBQTZDO0FBQzdDLDBEQUF5RDtBQUd6RCxJQUFJLFdBQWdDLENBQUE7QUFDcEMsSUFBSSxhQUFhLEdBQVksS0FBSyxDQUFBO0FBRWxDOzs7R0FHRztBQUNRLFFBQUEsTUFBTSxHQUFHO0lBQ2hCLEVBQUUsQ0FBQyxDQUFDLENBQUMsYUFBYSxDQUFDLENBQUMsQ0FBQztRQUNqQixXQUFXLEdBQUcsSUFBSSxPQUFPLENBQUMsV0FBVyxFQUFFLENBQUE7UUFDdkMsYUFBYSxHQUFHLElBQUksQ0FBQSxDQUFDLG1DQUFtQztJQUM1RCxDQUFDO0lBQUEsQ0FBQztJQUNGLE1BQU0sQ0FBQyxXQUFXLENBQUE7QUFDdEIsQ0FBQyxDQUFBO0FBRUQ7O0dBRUc7QUFDUyxRQUFBLFFBQVEsR0FBRztJQUNuQixFQUFFLENBQUMsQ0FBQyxJQUFJLENBQUMsTUFBTSxFQUFFLENBQUMsTUFBTSxDQUFDLENBQUMsQ0FBQztRQUN2QixPQUFPLENBQUMsR0FBRyxDQUFDLGlCQUFpQixDQUFDLENBQUE7UUFDOUIsSUFBSSxlQUFlLEdBQUcsT0FBTyxDQUFDLGlCQUFpQixDQUFDLENBQUMsT0FBTyxDQUFBO1FBQ3hELE9BQU8sQ0FBQyxHQUFHLENBQUMsa0JBQWtCLEdBQUcsSUFBSSxDQUFDLE1BQU0sRUFBRSxDQUFDLFdBQVcsR0FBRywyQkFBMkIsR0FBRyxlQUFlLENBQUMsQ0FBQTtJQUMvRyxDQUFDO0lBQUMsSUFBSSxDQUFDLENBQUM7UUFDSixPQUFPLENBQUMsR0FBRyxDQUFDLG9CQUFvQixDQUFDLENBQUE7UUFDakMsT0FBTyxDQUFDLEdBQUcsQ0FBQyxhQUFhLEdBQUcsSUFBSSxDQUFDLE1BQU0sRUFBRSxDQUFDLFNBQVMsQ0FBQyxDQUFBO0lBQ3hELENBQUM7SUFDRCxPQUFPLENBQUMsR0FBRyxDQUFDLDJFQUEyRSxDQUFDLENBQUE7SUFDeEYsT0FBTyxDQUFDLEdBQUcsQ0FBQyxNQUFNLENBQUMsbUJBQW1CLENBQUMsYUFBYSxDQUFDLEdBQUcsQ0FBQyxNQUFNLEVBQUUsQ0FBQyxDQUFDLENBQUE7QUFDdkUsQ0FBQyxDQUFBIn0=

dist/smartenv.objectstorage.d.ts

@@ -1,2 +0,0 @@
-export declare var obs: any;
-export declare var obsItems: any;

dist/smartenv.objectstorage.js

@@ -1,43 +0,0 @@
-"use strict";
-const plugins = require("./smartenv.plugins");
-exports.obs = {
-    add: function (paramNameArg = 'undefined', objectArg = 'undefined') {
-        if (paramNameArg === 'undefined') {
-            console.log('paramName is undefined');
-            return;
-        }
-        if (objectArg === 'undefined') {
-            console.log('objectArg is undefined');
-        }
-        if (typeof exports.obsItems[paramNameArg] === 'undefined') {
-            exports.obsItems[paramNameArg] = objectArg;
-        }
-        else {
-            console.log('object is already present, so add operation has failed.');
-        }
-        return exports.obsItems[paramNameArg];
-    },
-    replace: function (paramNameArg, objectArg) {
-        exports.obsItems[paramNameArg] = objectArg;
-    },
-    merge: function (paramNameArg, objectArg) {
-        if (!(typeof exports.obsItems[paramNameArg] === 'undefined')) {
-            exports.obsItems[paramNameArg] = plugins._.assign(exports.obsItems[paramNameArg], objectArg);
-        }
-        else {
-            console.log('object is not present, so there is nothing to merge');
-        }
-    },
-    get: function (keyName) {
-        return exports.obsItems[keyName];
-    },
-    getAll: function () {
-        return exports.obsItems;
-    },
-    addComplete: function (itemsArg) {
-        exports.obsItems = plugins._.assign(exports.obsItems, itemsArg);
-        return exports.obsItems;
-    }
-};
-exports.obsItems = {};
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic21hcnRlbnYub2JqZWN0c3RvcmFnZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzL3NtYXJ0ZW52Lm9iamVjdHN0b3JhZ2UudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IjtBQUFBLDhDQUE4QztBQUNuQyxRQUFBLEdBQUcsR0FBUTtJQUNsQixHQUFHLEVBQUUsVUFBUyxZQUFZLEdBQUcsV0FBVyxFQUFDLFNBQVMsR0FBRyxXQUFXO1FBQzVELEVBQUUsQ0FBQyxDQUFDLFlBQVksS0FBSyxXQUFXLENBQUMsQ0FBQyxDQUFDO1lBQy9CLE9BQU8sQ0FBQyxHQUFHLENBQUMsd0JBQXdCLENBQUMsQ0FBQTtZQUNyQyxNQUFNLENBQUE7UUFDVixDQUFDO1FBQ0QsRUFBRSxDQUFDLENBQUMsU0FBUyxLQUFLLFdBQVcsQ0FBQyxDQUFDLENBQUM7WUFDNUIsT0FBTyxDQUFDLEdBQUcsQ0FBQyx3QkFBd0IsQ0FBQyxDQUFBO1FBQ3pDLENBQUM7UUFDRCxFQUFFLENBQUMsQ0FBQyxPQUFPLGdCQUFRLENBQUMsWUFBWSxDQUFDLEtBQUssV0FBVyxDQUFDLENBQUMsQ0FBQztZQUNoRCxnQkFBUSxDQUFDLFlBQVksQ0FBQyxHQUFHLFNBQVMsQ0FBQTtRQUN0QyxDQUFDO1FBQUMsSUFBSSxDQUFDLENBQUM7WUFDSixPQUFPLENBQUMsR0FBRyxDQUFDLHlEQUF5RCxDQUFDLENBQUE7UUFDMUUsQ0FBQztRQUNELE1BQU0sQ0FBQyxnQkFBUSxDQUFDLFlBQVksQ0FBQyxDQUFBO0lBQ2pDLENBQUM7SUFDRCxPQUFPLEVBQUUsVUFBUyxZQUFZLEVBQUMsU0FBUztRQUNwQyxnQkFBUSxDQUFDLFlBQVksQ0FBQyxHQUFHLFNBQVMsQ0FBQTtJQUN0QyxDQUFDO0lBQ0QsS0FBSyxFQUFFLFVBQVMsWUFBWSxFQUFDLFNBQVM7UUFDbEMsRUFBRSxDQUFDLENBQUMsQ0FBQyxDQUFDLE9BQU8sZ0JBQVEsQ0FBQyxZQUFZLENBQUMsS0FBSyxXQUFXLENBQUMsQ0FBQyxDQUFDLENBQUM7WUFDbkQsZ0JBQVEsQ0FBQyxZQUFZLENBQUMsR0FBRyxPQUFPLENBQUMsQ0FBQyxDQUFDLE1BQU0sQ0FBQyxnQkFBUSxDQUFDLFlBQVksQ0FBQyxFQUFDLFNBQVMsQ0FBQyxDQUFBO1FBQy9FLENBQUM7UUFBQyxJQUFJLENBQUMsQ0FBQztZQUNKLE9BQU8sQ0FBQyxHQUFHLENBQUMscURBQXFELENBQUMsQ0FBQTtRQUN0RSxDQUFDO0lBQ0wsQ0FBQztJQUNELEdBQUcsRUFBRSxVQUFTLE9BQU87UUFDakIsTUFBTSxDQUFDLGdCQUFRLENBQUMsT0FBTyxDQUFDLENBQUE7SUFDNUIsQ0FBQztJQUNELE1BQU0sRUFBRTtRQUNKLE1BQU0sQ0FBQyxnQkFBUSxDQUFBO0lBQ25CLENBQUM7SUFDRCxXQUFXLEVBQUUsVUFBUyxRQUFRO1FBQzFCLGdCQUFRLEdBQUcsT0FBTyxDQUFDLENBQUMsQ0FBQyxNQUFNLENBQUMsZ0JBQVEsRUFBQyxRQUFRLENBQUMsQ0FBQTtRQUM5QyxNQUFNLENBQUMsZ0JBQVEsQ0FBQTtJQUNuQixDQUFDO0NBQ0osQ0FBQTtBQUNVLFFBQUEsUUFBUSxHQUFRLEVBQUUsQ0FBQSJ9

dist/smartenv.plugins.d.ts

@@ -1,4 +0,0 @@
-import 'typings-global';
-import * as Q from 'q';
-import * as _ from 'lodash';
-export { Q, _ };

dist/smartenv.plugins.js

@@ -1,7 +0,0 @@
-"use strict";
-require("typings-global");
-const Q = require("q");
-exports.Q = Q;
-const _ = require("lodash");
-exports._ = _;
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic21hcnRlbnYucGx1Z2lucy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzL3NtYXJ0ZW52LnBsdWdpbnMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IjtBQUFBLDBCQUF1QjtBQUN2Qix1QkFBc0I7QUFJbEIsY0FBQztBQUhMLDRCQUEyQjtBQUl2QixjQUFDIn0=

npmextra.json

@@ -0,0 +1,32 @@
+{
+  "npmci": {
+    "npmGlobalTools": [],
+    "npmAccessLevel": "public"
+  },
+  "gitzone": {
+    "projectType": "npm",
+    "module": {
+      "githost": "code.foss.global",
+      "gitscope": "push.rocks",
+      "gitrepo": "smartenv",
+      "description": "A module for storing and accessing environment details across different platforms.",
+      "npmPackagename": "@push.rocks/smartenv",
+      "license": "MIT",
+      "keywords": [
+        "environment detection",
+        "cross-platform",
+        "node.js",
+        "browser",
+        "module loading",
+        "CI detection",
+        "OS detection",
+        "runtime environment",
+        "typescript",
+        "async"
+      ]
+    }
+  },
+  "tsdoc": {
+    "legal": "\n## License and Legal Information\n\nThis repository contains open-source code that is licensed under the MIT License. A copy of the MIT License can be found in the [license](license) file within this repository. \n\n**Please note:** The MIT License does not grant permission to use the trade names, trademarks, service marks, or product names of the project, except as required for reasonable and customary use in describing the origin of the work and reproducing the content of the NOTICE file.\n\n### Trademarks\n\nThis project is owned and maintained by Task Venture Capital GmbH. The names and logos associated with Task Venture Capital GmbH and any related products or services are trademarks of Task Venture Capital GmbH and are not included within the scope of the MIT license granted herein. Use of these trademarks must comply with Task Venture Capital GmbH's Trademark Guidelines, and any usage must be approved in writing by Task Venture Capital GmbH.\n\n### Company Information\n\nTask Venture Capital GmbH  \nRegistered at District court Bremen HRB 35230 HB, Germany\n\nFor any legal inquiries or if you require further information, please contact us via email at hello@task.vc.\n\nBy using this repository, you acknowledge that you have read this section, agree to comply with its terms, and understand that the licensing of the code does not imply endorsement by Task Venture Capital GmbH of any derivative works.\n"
+  }
+}

npmts.json

@@ -1,4 +0,0 @@
-{
-  "mode":"default",
-  "coverageTreshold":75
-}

package.json

@@ -1,35 +1,63 @@
 {
-  "name": "smartenv",
-  "version": "1.2.9",
-  "description": "store things about your environment and let them travel across modules",
-  "main": "dist/index.js",
-  "typings": "dist/index.d.ts",
+  "name": "@push.rocks/smartenv",
+  "version": "5.0.13",
+  "description": "A module for storing and accessing environment details across different platforms.",
+  "main": "dist_ts/index.js",
+  "typings": "dist_ts/index.d.ts",
+  "type": "module",
   "scripts": {
-    "test": "(npmts)",
-    "testbrowser": "(npm test) && (node testbrowser.js)"
+    "test": "(tstest test/ --web)",
+    "build": "(tsbuild --web --allowimplicitany && tsbundle npm)",
+    "testbrowser": "(npm test) && (node testbrowser.js)",
+    "buildDocs": "tsdoc"
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/pushrocks/smartenv.git"
+    "url": "https://code.foss.global/push.rocks/smartenv.git"
   },
   "keywords": [
-    "environment"
+    "environment detection",
+    "cross-platform",
+    "node.js",
+    "browser",
+    "module loading",
+    "CI detection",
+    "OS detection",
+    "runtime environment",
+    "typescript",
+    "async"
   ],
-  "author": "Smart Coordination GmbH <office@push.rocks> (https://push.rocks)",
+  "author": "Lossless GmbH <hello@lossless.support> (https://lossless.com)",
   "license": "MIT",
   "bugs": {
-    "url": "https://github.com/pushrocks/smartenv/issues"
+    "url": "https://gitlab.com/pushrocks/smartenv/issues"
   },
-  "homepage": "https://github.com/pushrocks/smartenv",
+  "homepage": "https://code.foss.global/push.rocks/smartenv",
   "dependencies": {
-    "@types/q": "0.x.x",
-    "lodash": "^4.17.2",
-    "q": "^1.4.1",
-    "typings-global": "^1.0.14"
+    "@push.rocks/smartpromise": "^4.0.2"
   },
   "devDependencies": {
-    "@types/should": "^8.1.30",
-    "beautylog": "^6.0.0",
-    "should": "^11.1.1"
-  }
+    "@git.zone/tsbuild": "^2.1.72",
+    "@git.zone/tsbundle": "^2.0.15",
+    "@git.zone/tsrun": "^1.2.44",
+    "@git.zone/tstest": "^2.3.2",
+    "@types/node": "^22.0.0"
+  },
+  "private": false,
+  "files": [
+    "ts/**/*",
+    "ts_web/**/*",
+    "dist/**/*",
+    "dist_*/**/*",
+    "dist_ts/**/*",
+    "dist_ts_web/**/*",
+    "assets/**/*",
+    "cli.js",
+    "npmextra.json",
+    "readme.md"
+  ],
+  "browserslist": [
+    "last 1 chrome versions"
+  ],
+  "packageManager": "pnpm@10.11.0+sha512.6540583f41cc5f628eb3d9773ecee802f4f9ef9923cc45b69890fb47991d4b092964694ec3a4f738a420c918a333062c8b925d312f42e4f0c263eb603551f977"
 }

readme.hints.md

@@ -0,0 +1,23 @@
+# SmartEnv Hints
+
+## Architecture Overview
+- Single main class `Smartenv` that provides all functionality
+- Uses dependency injection pattern with plugins imported from smartenv.plugins.ts
+- Utilizes @push.rocks/smartpromise for async operations
+
+## Key Implementation Details
+- Runtime detection based on checking if `process` is defined
+- Dynamic module loading using Function constructor for Node.js modules
+- Script tag injection for browser module loading with duplicate prevention
+- OS detection uses the native Node.js 'os' module loaded dynamically
+
+## Testing Approach
+- Tests use @git.zone/tstest with tap-based testing
+- Test file demonstrates OS detection and CI environment detection
+- Tests can run in both Node.js and browser environments
+
+## Important Notes
+- The `getSafeNodeModule` uses dynamic import via Function constructor to avoid bundler issues
+- Browser module loading tracks loaded scripts to prevent duplicate loads
+- All OS detection methods are async and return false in browser environments
+- The package is isomorphic and designed for use in both Node.js and browser contexts

readme.md

@@ -0,0 +1,256 @@
+# @push.rocks/smartenv
+
+A cross-platform TypeScript library for detecting and managing runtime environments. It provides comprehensive environment detection capabilities and safe module loading for both Node.js and browser contexts.
+
+## Install
+
+To install `@push.rocks/smartenv`, you need Node.js and pnpm installed. Then, run the following command:
+
+```bash
+pnpm install @push.rocks/smartenv --save
+```
+
+## Usage
+
+`@push.rocks/smartenv` is a powerful utility for managing and accessing environment-specific information within your application. It enables your code to adapt seamlessly to different environments such as development, testing, and production.
+
+### Getting Started
+
+First, import the `Smartenv` class from the package:
+
+```typescript
+import { Smartenv } from '@push.rocks/smartenv';
+```
+
+### Initializing Smartenv
+
+Create an instance of `Smartenv` to access all environment detection and module loading features:
+
+```typescript
+const smartEnv = new Smartenv();
+```
+
+## Core Features
+
+- **Runtime Environment Detection**: Instantly detect whether your code is running in Node.js or browser
+- **Operating System Detection**: Identify Mac, Windows, or Linux platforms in Node.js environments
+- **CI Environment Detection**: Detect if running in a continuous integration environment
+- **Safe Module Loading**: Load modules conditionally based on the runtime environment
+- **Browser Information**: Access user agent information in browser contexts
+- **Node.js Version**: Get the current Node.js version when running in Node.js
+
+## API Reference
+
+### Environment Detection
+
+#### `isNode: boolean`
+Returns `true` if running in a Node.js environment.
+
+```typescript
+if (smartEnv.isNode) {
+  console.log('Running in Node.js');
+}
+```
+
+#### `isBrowser: boolean`
+Returns `true` if running in a browser environment.
+
+```typescript
+if (smartEnv.isBrowser) {
+  console.log('Running in browser');
+}
+```
+
+#### `runtimeEnv: string`
+Returns the runtime environment as a string ('node' or 'browser').
+
+```typescript
+console.log(`Runtime: ${smartEnv.runtimeEnv}`);
+```
+
+#### `isCI: boolean`
+Returns `true` if running in a CI environment (checks for CI environment variable).
+
+```typescript
+if (smartEnv.isCI) {
+  console.log('Running in CI environment');
+}
+```
+
+### Platform Detection (Node.js only)
+
+#### `isMacAsync(): Promise<boolean>`
+Asynchronously checks if running on macOS.
+
+```typescript
+const isMac = await smartEnv.isMacAsync();
+if (isMac) {
+  console.log('Running on macOS');
+}
+```
+
+#### `isWindowsAsync(): Promise<boolean>`
+Asynchronously checks if running on Windows.
+
+```typescript
+const isWindows = await smartEnv.isWindowsAsync();
+if (isWindows) {
+  console.log('Running on Windows');
+}
+```
+
+#### `isLinuxAsync(): Promise<boolean>`
+Asynchronously checks if running on Linux.
+
+```typescript
+const isLinux = await smartEnv.isLinuxAsync();
+if (isLinux) {
+  console.log('Running on Linux');
+}
+```
+
+### Runtime Information
+
+#### `nodeVersion: string`
+Returns the Node.js version (only available in Node.js environment).
+
+```typescript
+if (smartEnv.isNode) {
+  console.log(`Node.js version: ${smartEnv.nodeVersion}`);
+}
+```
+
+#### `userAgent: string`
+Returns the browser user agent string (only available in browser environment).
+
+```typescript
+if (smartEnv.isBrowser) {
+  console.log(`Browser: ${smartEnv.userAgent}`);
+}
+```
+
+### Module Loading
+
+#### `getEnvAwareModule(options)`
+Loads a module appropriate for the current environment. In Node.js, it uses dynamic import; in browsers, it loads a script via URL.
+
+```typescript
+const module = await smartEnv.getEnvAwareModule({
+  nodeModuleName: 'node-fetch',
+  webUrlArg: 'https://unpkg.com/whatwg-fetch@3.6.2/dist/fetch.umd.js',
+  getFunction: () => window.fetch
+});
+```
+
+#### `getSafeNodeModule<T>(moduleName, runAfterFunc?)`
+Safely loads a Node.js module with error handling. Only works in Node.js environment.
+
+```typescript
+const fs = await smartEnv.getSafeNodeModule('fs');
+if (fs) {
+  // Use fs module
+}
+
+// With post-load function
+const express = await smartEnv.getSafeNodeModule('express', async (mod) => {
+  console.log('Express loaded successfully');
+});
+```
+
+#### `getSafeWebModule(url, getFunction)`
+Safely loads a web module via script tag. Only works in browser environment. Prevents duplicate loading of the same script.
+
+```typescript
+const jQuery = await smartEnv.getSafeWebModule(
+  'https://code.jquery.com/jquery-3.6.0.min.js',
+  () => window.jQuery
+);
+```
+
+### Debugging
+
+#### `printEnv()`
+Prints the current environment information to the console for debugging purposes.
+
+```typescript
+await smartEnv.printEnv();
+// Output in Node.js: "running on NODE" + version
+// Output in browser: "running on BROWSER" + user agent
+```
+
+## Common Use Cases
+
+### 1. Isomorphic Module Loading
+
+```typescript
+// Define environment-specific implementations
+const cryptoModule = await smartEnv.getEnvAwareModule({
+  nodeModuleName: 'crypto',
+  webUrlArg: 'https://unpkg.com/crypto-js@4.1.1/crypto-js.js',
+  getFunction: () => window.CryptoJS
+});
+```
+
+### 2. Platform-Specific Operations
+
+```typescript
+if (smartEnv.isNode) {
+  const os = await smartEnv.getSafeNodeModule('os');
+  console.log(`Home directory: ${os.homedir()}`);
+} else {
+  console.log('Browser environment - no filesystem access');
+}
+```
+
+### 3. CI/CD Pipeline Detection
+
+```typescript
+if (smartEnv.isCI) {
+  // Run extended tests or different build configuration
+  console.log('Running in CI - enabling extended test suite');
+} else {
+  console.log('Local development environment');
+}
+```
+
+### 4. Dynamic Script Loading in Browser
+
+```typescript
+if (smartEnv.isBrowser) {
+  // Load analytics only in browser
+  await smartEnv.getSafeWebModule(
+    'https://www.google-analytics.com/analytics.js',
+    () => window.ga
+  );
+}
+```
+
+## TypeScript Support
+
+The package is written in TypeScript and provides full type definitions. The main type export is:
+
+```typescript
+export interface IEnvObject {
+  name: string;
+  value: string;
+}
+```
+
+## License and Legal Information
+
+This repository contains open-source code that is licensed under the MIT License. A copy of the MIT License can be found in the [license](license) file within this repository. 
+
+**Please note:** The MIT License does not grant permission to use the trade names, trademarks, service marks, or product names of the project, except as required for reasonable and customary use in describing the origin of the work and reproducing the content of the NOTICE file.
+
+### Trademarks
+
+This project is owned and maintained by Task Venture Capital GmbH. The names and logos associated with Task Venture Capital GmbH and any related products or services are trademarks of Task Venture Capital GmbH and are not included within the scope of the MIT license granted herein. Use of these trademarks must comply with Task Venture Capital GmbH's Trademark Guidelines, and any usage must be approved in writing by Task Venture Capital GmbH.
+
+### Company Information
+
+Task Venture Capital GmbH  
+Registered at District court Bremen HRB 35230 HB, Germany
+
+For any legal inquiries or if you require further information, please contact us via email at hello@task.vc.
+
+By using this repository, you acknowledge that you have read this section, agree to comply with its terms, and understand that the licensing of the code does not imply endorsement by Task Venture Capital GmbH of any derivative works.

test/test.js

@@ -1,21 +0,0 @@
-"use strict";
-const smartenv = require("../dist/index.js");
-const beautylog = require("beautylog");
-smartenv.printEnv();
-// test smartenv.obs.add
-smartenv.obs.add('myTestObject', { key1: 'Peter' });
-smartenv.obs.add('myTestObject', { key1: 'Klaus' }); // now trying to add a second
-smartenv.printEnv();
-beautylog.log(smartenv.obs.get('myTestObject').key1); // this should be Peter
-// test smartenv.obs.replace
-smartenv.obs.replace('myTestObject', { key1: 'Klaus' });
-beautylog.log(smartenv.obs.get('myTestObject').key1); // this should be Klaus
-// test smartenv.obs.merge
-smartenv.obs.merge('myTestObject', { key2: 'Peter' });
-beautylog.log(smartenv.obs.get('myTestObject').key1 + smartenv.obs.get('myTestObject').key2);
-// this should be KlausPeter
-let key2 = 'hello';
-smartenv.obs.get('myTestObject').key2 = key2;
-beautylog.log(smartenv.obs.get('myTestObject').key2);
-beautylog.success('Success!');
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidGVzdC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbInRlc3QudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IjtBQUFBLDZDQUE0QztBQUM1Qyx1Q0FBc0M7QUFDdEMsUUFBUSxDQUFDLFFBQVEsRUFBRSxDQUFBO0FBRW5CLHdCQUF3QjtBQUN4QixRQUFRLENBQUMsR0FBRyxDQUFDLEdBQUcsQ0FBQyxjQUFjLEVBQUMsRUFBQyxJQUFJLEVBQUMsT0FBTyxFQUFDLENBQUMsQ0FBQTtBQUMvQyxRQUFRLENBQUMsR0FBRyxDQUFDLEdBQUcsQ0FBQyxjQUFjLEVBQUMsRUFBQyxJQUFJLEVBQUMsT0FBTyxFQUFDLENBQUMsQ0FBQSxDQUFDLDZCQUE2QjtBQUM3RSxRQUFRLENBQUMsUUFBUSxFQUFFLENBQUE7QUFDbkIsU0FBUyxDQUFDLEdBQUcsQ0FBQyxRQUFRLENBQUMsR0FBRyxDQUFDLEdBQUcsQ0FBQyxjQUFjLENBQUMsQ0FBQyxJQUFJLENBQUMsQ0FBQSxDQUFDLHVCQUF1QjtBQUU1RSw0QkFBNEI7QUFDNUIsUUFBUSxDQUFDLEdBQUcsQ0FBQyxPQUFPLENBQUMsY0FBYyxFQUFDLEVBQUMsSUFBSSxFQUFDLE9BQU8sRUFBQyxDQUFDLENBQUE7QUFDbkQsU0FBUyxDQUFDLEdBQUcsQ0FBQyxRQUFRLENBQUMsR0FBRyxDQUFDLEdBQUcsQ0FBQyxjQUFjLENBQUMsQ0FBQyxJQUFJLENBQUMsQ0FBQSxDQUFDLHVCQUF1QjtBQUU1RSwwQkFBMEI7QUFDMUIsUUFBUSxDQUFDLEdBQUcsQ0FBQyxLQUFLLENBQUMsY0FBYyxFQUFDLEVBQUMsSUFBSSxFQUFDLE9BQU8sRUFBQyxDQUFDLENBQUE7QUFDakQsU0FBUyxDQUFDLEdBQUcsQ0FBQyxRQUFRLENBQUMsR0FBRyxDQUFDLEdBQUcsQ0FBQyxjQUFjLENBQUMsQ0FBQyxJQUFJLEdBQUcsUUFBUSxDQUFDLEdBQUcsQ0FBQyxHQUFHLENBQUMsY0FBYyxDQUFDLENBQUMsSUFBSSxDQUFDLENBQUE7QUFDNUYsNEJBQTRCO0FBRTVCLElBQUksSUFBSSxHQUFHLE9BQU8sQ0FBQTtBQUNsQixRQUFRLENBQUMsR0FBRyxDQUFDLEdBQUcsQ0FBQyxjQUFjLENBQUMsQ0FBQyxJQUFJLEdBQUcsSUFBSSxDQUFBO0FBQzVDLFNBQVMsQ0FBQyxHQUFHLENBQUMsUUFBUSxDQUFDLEdBQUcsQ0FBQyxHQUFHLENBQUMsY0FBYyxDQUFDLENBQUMsSUFBSSxDQUFDLENBQUE7QUFFcEQsU0FBUyxDQUFDLE9BQU8sQ0FBQyxVQUFVLENBQUMsQ0FBQSJ9

test/test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"test.js","sourceRoot":"","sources":["test.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,IAAI,QAAQ,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;AAC3C,IAAI,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;AACrC,QAAQ,CAAC,QAAQ,EAAE,CAAC;AAEpB,uBAAuB;AACvB,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,cAAc,EAAC,EAAC,IAAI,EAAC,OAAO,EAAC,CAAC,CAAC;AAChD,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,cAAc,EAAC,EAAC,IAAI,EAAC,OAAO,EAAC,CAAC,CAAC,CAAC,4BAA4B;AAC7E,QAAQ,CAAC,QAAQ,EAAE,CAAC;AACpB,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,uBAAuB;AAE7E,2BAA2B;AAC3B,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,cAAc,EAAC,EAAC,IAAI,EAAC,OAAO,EAAC,CAAC,CAAC;AACpD,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,uBAAuB;AAE7E,yBAAyB;AACzB,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,cAAc,EAAC,EAAC,IAAI,EAAC,OAAO,EAAC,CAAC,CAAC;AAClD,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,4BAA4B;AAE1H,IAAI,IAAI,GAAG,OAAO,CAAC;AACnB,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC;AAC7C,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC;AAErD,SAAS,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC"}

test/test.ts

@@ -1,24 +1,37 @@
-import * as smartenv from '../dist/index.js'
-import * as beautylog from 'beautylog'
-smartenv.printEnv()
+import { tap, expect } from '@git.zone/tstest/tapbundle';
+import * as smartenv from '../ts/index.js';
 
-// test smartenv.obs.add
-smartenv.obs.add('myTestObject',{key1:'Peter'})
-smartenv.obs.add('myTestObject',{key1:'Klaus'}) // now trying to add a second
-smartenv.printEnv()
-beautylog.log(smartenv.obs.get('myTestObject').key1) // this should be Peter
+let testEnv: smartenv.Smartenv;
 
-// test smartenv.obs.replace
-smartenv.obs.replace('myTestObject',{key1:'Klaus'})
-beautylog.log(smartenv.obs.get('myTestObject').key1) // this should be Klaus
+tap.test('should print env', async () => {
+  testEnv = new smartenv.Smartenv();
+});
 
-// test smartenv.obs.merge
-smartenv.obs.merge('myTestObject',{key2:'Peter'})
-beautylog.log(smartenv.obs.get('myTestObject').key1 + smartenv.obs.get('myTestObject').key2)
-// this should be KlausPeter
+tap.test('should print a overview to console', async () => {
+  testEnv.printEnv();
+});
 
-let key2 = 'hello'
-smartenv.obs.get('myTestObject').key2 = key2
-beautylog.log(smartenv.obs.get('myTestObject').key2)
+tap.test('should get os', async () => {
+  const resultMac = await testEnv.isMacAsync();
+  const resultLinux = await testEnv.isLinuxAsync();
+  const resultWindows = await testEnv.isWindowsAsync();
+  const osModule = await import('os');
+  if (resultMac) {
+    expect(osModule.platform()).toEqual('darwin');
+    console.log('platform is Mac!');
+  } else if (resultLinux) {
+    expect(osModule.platform()).toEqual('linux');
+    console.log('platform is Linux!');
+  } else {
+    expect(osModule.platform()).toEqual('win32');
+    console.log('platform is Windows!');
+  }
+});
 
-beautylog.success('Success!')
+tap.test('should state wether we are in CI', async () => {
+  if (process.env.CI) {
+    expect(testEnv.isCI).toBeTrue();
+  }
+});
+
+tap.start();

ts/00_commitinfo_data.ts

@@ -0,0 +1,8 @@
+/**
+ * autocreated commitinfo by @pushrocks/commitinfo
+ */
+export const commitinfo = {
+  name: '@push.rocks/smartenv',
+  version: '5.0.12',
+  description: 'store things about your environment and let them travel across modules'
+}

ts/index.ts

@@ -1,12 +1 @@
-import * as plugins from './smartenv.plugins'
-import * as classes from './smartenv.classes'
-import * as SmartenvEnvironment from './smartenv.environment'
-import * as SmartenvObjectstorage from './smartenv.objectstorage'
-
-let smartenv = {
-    getEnv: SmartenvEnvironment.getEnv,
-    printEnv: SmartenvEnvironment.printEnv,
-    obs: SmartenvObjectstorage.obs
-} // create smartenv object
-
-export = smartenv
+export * from './smartenv.classes.smartenv.js';

ts/interfaces/index.ts

@@ -0,0 +1,9 @@
+export let defaultme = null;
+declare global {
+  namespace NodeJS {
+    interface Global {
+      window: any;
+      navigator: any;
+    }
+  }
+}

ts/smartenv.classes.helpers.ts

@@ -1,51 +0,0 @@
-export var getEnvString = function(): string {
-    if (typeof window !== 'undefined') {
-        return 'browser'
-    } else if (typeof process !== 'undefined') {
-        return 'node'
-    }
-}
-
-export var getUserAgentString = function(): string{
-    if (isBrowser()) {
-        return  navigator.userAgent
-    } else {
-        return undefined
-    }
-}
-
-export var isNode = function(): boolean {
-    return getEnvString() === 'node'
-}
-
-export var getNodeVersion = function(): string {
-    return process.version
-}
-
-export var isBrowser = function(): boolean {
-    return !isNode()
-}
-
-export var isCI = function(){
-    if (process.env.CI) {
-        return true
-    } else {
-        return false
-    };
-}
-
-export var isC9 = function(){
-    if (process.env.C9_HOSTNAME) {
-        return true
-    } else {
-        return false
-    }
-}
-
-export var isTravis = function(){
-    if (process.env.TRAVIS) {
-        return true
-    } else {
-        return false
-    };
-}

ts/smartenv.classes.smartenv.ts

@@ -0,0 +1,155 @@
+import * as plugins from './smartenv.plugins.js';
+import * as interfaces from './interfaces/index.js';
+
+// interfaces
+export interface IEnvObject {
+  name: string;
+  value: string;
+}
+
+/**
+ * Smartenv class that makes it easy
+ */
+export class Smartenv {
+  public async getEnvAwareModule(optionsArg: {
+    nodeModuleName: string;
+    webUrlArg: string;
+    getFunction: () => any;
+  }) {
+    if (this.isNode) {
+      const moduleResult = await this.getSafeNodeModule(optionsArg.nodeModuleName);
+      return moduleResult;
+    } else if (this.isBrowser) {
+      const moduleResult = await this.getSafeWebModule(
+        optionsArg.webUrlArg,
+        optionsArg.getFunction
+      );
+      return moduleResult;
+    } else {
+      console.error('platform for loading not supported by smartenv');
+    }
+  }
+
+  public async getSafeNodeModule<T = any>(moduleNameArg: string, runAfterFunc?: (moduleArg: T) => Promise<any>): Promise<T> {
+    if (!this.isNode) {
+      console.error(`You tried to load a node module in a wrong context: ${moduleNameArg}. This does not throw.`);
+      return;
+    }
+    // tslint:disable-next-line: function-constructor
+    const returnValue: T = await (new Function(`return import('${moduleNameArg}')`)() as Promise<T>);
+    if (runAfterFunc) {
+      await runAfterFunc(returnValue);
+    }
+    return returnValue;
+  }
+
+  public loadedScripts: string[] = [];
+  public async getSafeWebModule(urlArg: string, getFunctionArg: () => any) {
+    if (!this.isBrowser) {
+      console.error('You tried to load a web module in a wrong context');
+      return;
+    }
+
+    if (this.loadedScripts.includes(urlArg)) {
+      return getFunctionArg();
+    } else {
+      this.loadedScripts.push(urlArg);
+    }
+
+    const done = plugins.smartpromise.defer();
+    if (globalThis.importScripts) {
+      globalThis.importScripts(urlArg);
+      done.resolve();
+    } else {
+      const script = document.createElement('script');
+      script.onload = () => {
+        done.resolve();
+      };
+      script.src = urlArg;
+      document.head.appendChild(script);
+    }
+    await done.promise;
+    return getFunctionArg();
+  }
+
+  public get runtimeEnv() {
+    if (typeof process !== 'undefined') {
+      return 'node';
+    } else {
+      return 'browser';
+    }
+  }
+
+  public get isBrowser(): boolean {
+    return !this.isNode;
+  }
+
+  public get userAgent(): string {
+    if (this.isBrowser) {
+      // make sure we are in Browser
+      return navigator.userAgent;
+    } else {
+      return 'undefined';
+    }
+  }
+
+  public get isNode(): boolean {
+    return this.runtimeEnv === 'node';
+  }
+
+  public get nodeVersion(): string {
+    return process.version;
+  }
+
+  public get isCI(): boolean {
+    if (this.isNode) {
+      if (process.env.CI) {
+        return true;
+      } else {
+        return false;
+      }
+    } else {
+      return false;
+    }
+  }
+
+  public async isMacAsync(): Promise<boolean> {
+    if (this.isNode) {
+      const os = await this.getSafeNodeModule('os');
+      return os.platform() === 'darwin';
+    } else {
+      return false;
+    }
+  }
+
+  public async isWindowsAsync(): Promise<boolean> {
+    if (this.isNode) {
+      const os = await this.getSafeNodeModule('os');
+      return os.platform() === 'win32';
+    } else {
+      return false;
+    }
+  }
+
+  public async isLinuxAsync(): Promise<boolean> {
+    if (this.isNode) {
+      const os = await this.getSafeNodeModule('os');
+      return os.platform() === 'linux';
+    } else {
+      return false;
+    }
+  }
+
+  /**
+   * prints the environment to console
+   */
+  public async printEnv() {
+    if (this.isNode) {
+      console.log('running on NODE');
+      console.log('node version is ' + this.nodeVersion);
+    } else {
+      console.log('running on BROWSER');
+      console.log('browser is ' + this.userAgent);
+    }
+  }
+}

ts/smartenv.classes.ts

@@ -1,22 +0,0 @@
-import helpers = require('./smartenv.classes.helpers')
-
-export class Environment {
-    runtimeEnv: string
-    isBrowser: boolean
-    userAgent: string
-    isNode: boolean
-    nodeVersion: string
-    isCI: boolean
-    isTravis: boolean
-    isC9: boolean
-    constructor() {
-        this.runtimeEnv = helpers.getEnvString()
-        this.isBrowser = helpers.isBrowser()
-        this.userAgent = helpers.getUserAgentString()
-        this.isNode = helpers.isNode()
-        this.nodeVersion = helpers.getNodeVersion()
-        this.isCI = helpers.isCI()
-        this.isTravis = helpers.isTravis()
-        this.isC9 = helpers.isC9()
-    };
-}

ts/smartenv.environment.ts

@@ -1,38 +0,0 @@
-/**
- * Deals with the environment the current JS script is running in.
- */
-import * as plugins from './smartenv.plugins'
-import * as classes from './smartenv.classes'
-import * as objectStorage from './smartenv.objectstorage'
-
-
-let environment: classes.Environment
-let envDetermined: boolean = false
-
-/**
- * returns the environment
- * @returns {Environment}
- */
-export var getEnv = function(){
-    if (!envDetermined) {
-        environment = new classes.Environment()
-        envDetermined = true // ensure code above only runs once
-    };
-    return environment
-}
-
-/**
- * prints the environment to console
- */
-export var  printEnv = function() {
-    if (this.getEnv().isNode) {
-        console.log('running on NODE')
-        let smartenvVersion = require('../package.json').version
-        console.log('node version is ' + this.getEnv().nodeVersion + ' and smartenv version is ' + smartenvVersion)
-    } else {
-        console.log('running on BROWSER')
-        console.log('browser is ' + this.getEnv().userAgent)
-    }
-    console.log('the smartenv registration store currently holds the following properties:')
-    console.log(Object.getOwnPropertyNames(objectStorage.obs.getAll()))
-}

ts/smartenv.objectstorage.ts

@@ -1,39 +0,0 @@
-import plugins = require('./smartenv.plugins')
-export var obs: any = {
-    add: function(paramNameArg = 'undefined',objectArg = 'undefined') {
-        if (paramNameArg === 'undefined') {
-            console.log('paramName is undefined')
-            return
-        }
-        if (objectArg === 'undefined') {
-            console.log('objectArg is undefined')
-        }
-        if (typeof obsItems[paramNameArg] === 'undefined') {
-            obsItems[paramNameArg] = objectArg
-        } else {
-            console.log('object is already present, so add operation has failed.')
-        }
-        return obsItems[paramNameArg]
-    },
-    replace: function(paramNameArg,objectArg){
-        obsItems[paramNameArg] = objectArg
-    },
-    merge: function(paramNameArg,objectArg){
-        if (!(typeof obsItems[paramNameArg] === 'undefined')) {
-            obsItems[paramNameArg] = plugins._.assign(obsItems[paramNameArg],objectArg)
-        } else {
-            console.log('object is not present, so there is nothing to merge')
-        }
-    },
-    get: function(keyName) {
-        return obsItems[keyName]
-    },
-    getAll: function () {
-        return obsItems
-    },
-    addComplete: function(itemsArg) {
-        obsItems = plugins._.assign(obsItems,itemsArg)
-        return obsItems
-    }
-}
-export var obsItems: any = {}

ts/smartenv.plugins.ts

@@ -1,8 +1,3 @@
-import 'typings-global'
-import * as Q from 'q'
-import * as _ from 'lodash'
+import * as smartpromise from '@push.rocks/smartpromise';
 
-export {
-    Q,
-    _
-}
+export { smartpromise };

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"
+  ]
+}

tslint.json

@@ -1,3 +0,0 @@
-{
-    "extends": "tslint-config-standard"
-}