@ship.zone/szci 7.1.1 → 7.1.3

package/bin/szci-wrapper.js

@@ -59,22 +59,24 @@ function executeBinary() {
   const binaryName = getBinaryName();
   const binaryPath = join(__dirname, '..', 'dist', 'binaries', binaryName);
 
-  // Check if binary exists
-  if (!existsSync(binaryPath)) {
+  const denoSourcePath = join(__dirname, '..', 'mod.ts');
+  const denoConfigPath = join(__dirname, '..', 'deno.json');
+  const command = existsSync(binaryPath) ? binaryPath : 'deno';
+  const args = existsSync(binaryPath)
+    ? process.argv.slice(2)
+    : ['run', '--allow-all', '--config', denoConfigPath, denoSourcePath, ...process.argv.slice(2)];
+
+  if (!existsSync(binaryPath) && !existsSync(denoSourcePath)) {
     console.error(`Error: Binary not found at ${binaryPath}`);
-    console.error('This might happen if:');
-    console.error('1. The postinstall script failed to run');
-    console.error('2. The platform is not supported');
-    console.error('3. The package was not installed correctly');
-    console.error('');
+    console.error(`Error: Deno source fallback not found at ${denoSourcePath}`);
     console.error('Try reinstalling the package:');
     console.error('  npm uninstall -g @ship.zone/szci');
     console.error('  npm install -g @ship.zone/szci');
     process.exit(1);
   }
 
-  // Spawn the binary with all arguments passed through
-  const child = spawn(binaryPath, process.argv.slice(2), {
+  // Spawn the binary or the Deno source fallback with all arguments passed through.
+  const child = spawn(command, args, {
     stdio: 'inherit',
     shell: false
   });

package/changelog.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## Pending
+
+
+## 2026-05-20 - 7.1.3
+
+### Fixes
+
+- add Deno source fallback when platform binaries are unavailable (npm)
+  - run the packaged Deno entrypoint from the wrapper when no compiled binary is present
+  - include Deno source files in the npm package and compile binaries during build and prepublish
+  - make postinstall resolve the package version from package.json and continue installation if binary downloads fail
+
+## 2026-02-08 - 7.1.2 - fix(readme)
+Correct license link and fix markdown line break for company name in README
+
+- Updated README link to the license file from ./license to ./LICENSE
+- Added trailing spaces after 'Task Venture Capital GmbH' to preserve a Markdown line break
+- Documentation-only change; no code modified
+
 ## 2026-02-07 - 7.1.1 - fix(workflows)
 normalize default branch to 'main' across CI/release workflows and docs; update package metadata; clean .gitignore and fix readme license link
 

package/deno.json

@@ -0,0 +1,63 @@
+{
+  "name": "@ship.zone/szci",
+  "version": "7.1.3",
+  "exports": "./mod.ts",
+  "nodeModulesDir": "auto",
+  "tasks": {
+    "dev": "deno run --allow-all mod.ts",
+    "compile": "deno task compile:all",
+    "compile:all": "bash scripts/compile-all.sh",
+    "test": "deno test --allow-all test/",
+    "test:watch": "deno test --allow-all --watch test/",
+    "check": "deno check mod.ts",
+    "fmt": "deno fmt",
+    "lint": "deno lint"
+  },
+  "lint": {
+    "rules": {
+      "tags": [
+        "recommended"
+      ]
+    }
+  },
+  "fmt": {
+    "useTabs": false,
+    "lineWidth": 100,
+    "indentWidth": 2,
+    "semiColons": true,
+    "singleQuote": true
+  },
+  "compilerOptions": {
+    "lib": [
+      "deno.window"
+    ],
+    "strict": true
+  },
+  "imports": {
+    "@std/path": "jsr:@std/path@^1.0.0",
+    "@std/fmt": "jsr:@std/fmt@^1.0.0",
+    "@std/cli": "jsr:@std/cli@^1.0.0",
+    "@std/assert": "jsr:@std/assert@^1.0.0",
+    "@api.global/typedrequest": "npm:@api.global/typedrequest@^3.1.10",
+    "@push.rocks/npmextra": "npm:@push.rocks/npmextra@^5.1.2",
+    "@push.rocks/projectinfo": "npm:@push.rocks/projectinfo@^5.0.2",
+    "@push.rocks/qenv": "npm:@push.rocks/qenv@^6.0.2",
+    "@push.rocks/smartanalytics": "npm:@push.rocks/smartanalytics@^2.0.15",
+    "@push.rocks/smartcli": "npm:@push.rocks/smartcli@^4.0.11",
+    "@push.rocks/smartfile": "npm:@push.rocks/smartfile@^11.0.21",
+    "@push.rocks/smartgit": "npm:@push.rocks/smartgit@^3.1.1",
+    "@push.rocks/smartlog": "npm:@push.rocks/smartlog@^3.0.7",
+    "@push.rocks/smartlog-destination-local": "npm:@push.rocks/smartlog-destination-local@^9.0.0",
+    "@push.rocks/smartobject": "npm:@push.rocks/smartobject@^1.0.12",
+    "@push.rocks/smartpath": "npm:@push.rocks/smartpath@^5.0.11",
+    "@push.rocks/smartpromise": "npm:@push.rocks/smartpromise@^4.0.4",
+    "@push.rocks/smartrequest": "npm:@push.rocks/smartrequest@^2.0.23",
+    "@push.rocks/smartshell": "npm:@push.rocks/smartshell@^3.0.6",
+    "@push.rocks/smartsocket": "npm:@push.rocks/smartsocket@^2.0.22",
+    "@push.rocks/smartssh": "npm:@push.rocks/smartssh@^2.0.1",
+    "@push.rocks/smartstring": "npm:@push.rocks/smartstring@^4.0.8",
+    "@push.rocks/smartexpect": "npm:@push.rocks/smartexpect@^1.0.15",
+    "@serve.zone/api": "npm:@serve.zone/api@^4.3.11",
+    "@tsclass/tsclass": "npm:@tsclass/tsclass@^4.1.2"
+  }
+}

package/mod.ts

@@ -0,0 +1,47 @@
+#!/usr/bin/env -S deno run --allow-all
+
+/**
+ * SZCI - Serve Zone CI/CD Tool
+ *
+ * A command-line tool for streamlining Node.js and Docker workflows
+ * within CI environments, particularly GitLab CI, GitHub CI, and Gitea CI.
+ *
+ * Required Permissions:
+ * - --allow-net: Network access for Docker registries, npm, git operations
+ * - --allow-read: Read configuration files, Dockerfiles, package.json
+ * - --allow-write: Write configuration files, build artifacts
+ * - --allow-run: Execute system commands (docker, git, npm, ssh)
+ * - --allow-sys: Access system information (OS details)
+ * - --allow-env: Read/write environment variables
+ *
+ * @module
+ */
+
+import { Szci } from './ts/szci.classes.szci.ts';
+
+/**
+ * Main entry point for the SZCI application
+ * Parses command-line arguments and executes the requested command
+ */
+async function main(): Promise<void> {
+  // Create Szci instance
+  const szciInstance = new Szci();
+
+  // Start the CLI
+  // Deno.args is already 0-indexed (unlike Node's process.argv which starts at index 2)
+  // The smartcli library may expect process.argv format, so we might need to prepend placeholders
+  await szciInstance.start();
+}
+
+// Execute main and handle errors
+if (import.meta.main) {
+  try {
+    await main();
+  } catch (error) {
+    console.error(`Error: ${error instanceof Error ? error.message : String(error)}`);
+    Deno.exit(1);
+  }
+}
+
+// Export for programmatic use
+export { Szci } from './ts/szci.classes.szci.ts';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ship.zone/szci",
-  "version": "7.1.1",
+  "version": "7.1.3",
   "description": "Serve Zone CI - A tool to streamline Node.js and Docker workflows within CI environments, particularly GitLab CI, providing various CI/CD utilities. Powered by Deno with standalone executables.",
   "keywords": [
     "Node.js",
@@ -34,14 +34,11 @@
   "bin": {
     "szci": "./bin/szci-wrapper.js"
   },
-  "scripts": {
-    "postinstall": "node scripts/install-binary.js",
-    "prepublishOnly": "echo 'Publishing SZCI binaries to npm...'",
-    "test": "echo 'Tests are run with Deno: deno task test'",
-    "build": "echo 'no build needed'"
-  },
   "files": [
     "bin/",
+    "deno.json",
+    "mod.ts",
+    "ts/",
     "scripts/install-binary.js",
     "readme.md",
     "license",
@@ -63,5 +60,9 @@
     "access": "public",
     "registry": "https://registry.npmjs.org/"
   },
-  "packageManager": "pnpm@10.18.1+sha512.77a884a165cbba2d8d1c19e3b4880eee6d2fcabd0d879121e282196b80042351d5eb3ca0935fa599da1dc51265cc68816ad2bddd2a2de5ea9fdf92adbec7cd34"
-}
+  "scripts": {
+    "postinstall": "node scripts/install-binary.js",
+    "test": "echo 'Tests are run with Deno: deno task test'",
+    "build": "deno task compile"
+  }
+}

package/readme.md

@@ -371,7 +371,7 @@ deno task lint
 
 ## License and Legal Information
 
-This repository contains open-source code licensed under the MIT License. A copy of the license can be found in the [license](./license) file.
+This repository contains open-source code licensed under the MIT License. A copy of the license can be found in the [LICENSE](./LICENSE) file.
 
 **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.
 
@@ -383,7 +383,7 @@ Use of these trademarks must comply with Task Venture Capital GmbH's Trademark G
 
 ### Company Information
 
-Task Venture Capital GmbH
+Task Venture Capital GmbH  
 Registered at District Court Bremen HRB 35230 HB, Germany
 
 For any legal inquiries or further information, please contact us via email at hello@task.vc.

package/scripts/install-binary.js

@@ -6,7 +6,7 @@
  */
 
 import { platform, arch } from 'os';
-import { existsSync, mkdirSync, writeFileSync, chmodSync, unlinkSync } from 'fs';
+import { existsSync, mkdirSync, chmodSync, unlinkSync, readFileSync } from 'fs';
 import { join, dirname } from 'path';
 import { fileURLToPath } from 'url';
 import https from 'https';
@@ -20,7 +20,21 @@ const streamPipeline = promisify(pipeline);
 
 // Configuration
 const REPO_BASE = 'https://code.foss.global/ship.zone/szci';
-const VERSION = process.env.npm_package_version || '4.1.37';
+function getPackageVersion() {
+  if (process.env.npm_package_version) {
+    return process.env.npm_package_version;
+  }
+  const packageJsonPath = join(__dirname, '..', 'package.json');
+  if (existsSync(packageJsonPath)) {
+    const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf8'));
+    if (packageJson.version) {
+      return packageJson.version;
+    }
+  }
+  return '0.0.0';
+}
+
+const VERSION = getPackageVersion();
 
 function getBinaryInfo() {
   const plat = platform();
@@ -156,7 +170,7 @@ async function main() {
     // Construct download URL
     // Try release URL first, fall back to raw branch if needed
     const releaseUrl = `${REPO_BASE}/releases/download/v${VERSION}/${binaryInfo.binaryName}`;
-    const fallbackUrl = `${REPO_BASE}/raw/branch/master/dist/binaries/${binaryInfo.binaryName}`;
+    const fallbackUrl = `${REPO_BASE}/raw/branch/main/dist/binaries/${binaryInfo.binaryName}`;
 
     console.log('Downloading platform-specific binary...');
     console.log('This may take a moment depending on your connection speed.');
@@ -173,7 +187,7 @@ async function main() {
         // Try fallback URL
         await downloadFile(fallbackUrl, binaryPath);
       } catch (fallbackErr) {
-        console.error(`❌ Error: Failed to download binary`);
+        console.warn(`⚠️  Warning: Failed to download binary`);
         console.error(`  Primary URL: ${releaseUrl}`);
         console.error(`  Fallback URL: ${fallbackUrl}`);
         console.error('');
@@ -182,17 +196,14 @@ async function main() {
         console.error('2. Network connectivity issues');
         console.error('3. The version specified does not exist');
         console.error('');
-        console.error('You can try:');
-        console.error('1. Installing from source: https://code.foss.global/ship.zone/szci');
-        console.error('2. Downloading the binary manually from the releases page');
-        console.error('3. Building from source with: deno task compile');
+        console.warn('Continuing with the packaged Deno source fallback.');
 
         // Clean up partial download
         if (existsSync(binaryPath)) {
           unlinkSync(binaryPath);
         }
 
-        process.exit(1);
+        return;
       }
     }
 

package/ts/00_commitinfo_data.ts

@@ -0,0 +1,8 @@
+/**
+ * autocreated commitinfo by @push.rocks/commitinfo
+ */
+export const commitinfo = {
+  name: '@ship.zone/szci',
+  version: '7.1.3',
+  description: 'Serve Zone CI - A tool to streamline Node.js and Docker workflows within CI environments, particularly GitLab CI, providing various CI/CD utilities. Powered by Deno with standalone executables.'
+}

package/ts/connector.cloudly/cloudlyconnector.ts

@@ -0,0 +1,31 @@
+import * as plugins from '../szci.plugins.ts';
+
+import { Szci } from '../szci.classes.szci.ts';
+import { logger } from '../szci.logging.ts';
+
+/**
+ * connects to cloudly
+ */
+export class CloudlyConnector {
+  public szciRef: Szci;
+
+  constructor(szciRefArg: Szci) {
+    this.szciRef = szciRefArg;
+  }
+
+  public async announceDockerContainer(
+    optionsArg: plugins.tsclass.container.IContainer,
+    testCloudlyUrlArg?: string
+  ) {
+    const cloudlyUrl = testCloudlyUrlArg || this.szciRef.szciConfig.getConfig().urlCloudly;
+    if (!cloudlyUrl) {
+      logger.log(
+        'warn',
+        'no cloudly url provided. Thus we cannot announce the newly built Dockerimage!'
+      );
+      return;
+    }
+
+    // lets push to cloudly here
+  }
+}

package/ts/index.ts

@@ -0,0 +1,9 @@
+import { Szci } from './szci.classes.szci.ts';
+
+export const szciInstance = new Szci();
+
+export { Szci };
+
+export const runCli = async () => {
+  await szciInstance.start();
+};

package/ts/manager.docker/index.ts

@@ -0,0 +1,78 @@
+import { logger } from '../szci.logging.ts';
+import { bash } from '../szci.bash.ts';
+import { Szci } from '../szci.classes.szci.ts';
+
+export class SzciDockerManager {
+  public szciRef: Szci;
+
+  constructor(szciArg: Szci) {
+    this.szciRef = szciArg;
+  }
+
+  /**
+   * Bridges SZCI_LOGIN_DOCKER* env vars to DOCKER_REGISTRY_N format for tsdocker,
+   * and handles GitLab CI registry auto-login.
+   */
+  private bridgeEnvVars() {
+    const env = Deno.env.toObject();
+
+    // Bridge GitLab CI registry as DOCKER_REGISTRY_0
+    if (env['GITLAB_CI']) {
+      const ciJobToken = env['CI_JOB_TOKEN'];
+      if (!ciJobToken) {
+        logger.log('error', 'Running in GitLab CI, but no CI_JOB_TOKEN found!');
+        Deno.exit(1);
+      }
+      Deno.env.set('DOCKER_REGISTRY_0', `registry.gitlab.com|gitlab-ci-token|${ciJobToken}`);
+    }
+
+    // Bridge SZCI_LOGIN_DOCKER* → DOCKER_REGISTRY_N
+    let registryIndex = 1;
+    const sortedKeys = Object.keys(env)
+      .filter((key) => key.startsWith('SZCI_LOGIN_DOCKER'))
+      .sort();
+    for (const key of sortedKeys) {
+      Deno.env.set(`DOCKER_REGISTRY_${registryIndex}`, env[key]);
+      registryIndex++;
+    }
+  }
+
+  /**
+   * Handle cli input by bridging env vars and delegating to tsdocker.
+   */
+  public handleCli = async (argvArg: any) => {
+    if (argvArg._.length < 2) {
+      logger.log(
+        'info',
+        `>>szci docker ...<< cli arguments invalid... Please read the documentation.`
+      );
+      return;
+    }
+
+    this.bridgeEnvVars();
+
+    const action: string = argvArg._[1];
+    const extraArgs = argvArg._.slice(2).join(' ');
+
+    switch (action) {
+      case 'build':
+        await bash(`npx @git.zone/tsdocker build ${extraArgs}`.trim());
+        break;
+      case 'login':
+      case 'prepare':
+        await bash(`npx @git.zone/tsdocker login ${extraArgs}`.trim());
+        break;
+      case 'test':
+        await bash(`npx @git.zone/tsdocker test ${extraArgs}`.trim());
+        break;
+      case 'push':
+        await bash(`npx @git.zone/tsdocker push ${extraArgs}`.trim());
+        break;
+      case 'pull':
+        await bash(`npx @git.zone/tsdocker pull ${extraArgs}`.trim());
+        break;
+      default:
+        logger.log('error', `>>szci docker ...<< action >>${action}<< not supported`);
+    }
+  };
+}

package/ts/manager.git/index.ts

@@ -0,0 +1,71 @@
+import { logger } from '../szci.logging.ts';
+import * as plugins from './mod.plugins.ts';
+import { bash, bashNoError } from '../szci.bash.ts';
+import { Szci } from '../szci.classes.szci.ts';
+
+export class SzciGitManager {
+  public szciRef: Szci;
+
+  constructor(szciRefArg: Szci) {
+    this.szciRef = szciRefArg;
+  }
+
+  /**
+   * handle cli input
+   * @param argvArg
+   */
+  public handleCli = async (argvArg: any) => {
+    if (argvArg._.length >= 2) {
+      const action: string = argvArg._[1];
+      switch (action) {
+        case 'mirror':
+          await this.mirror();
+          break;
+        default:
+          logger.log('error', `szci git -> action >>${action}<< not supported!`);
+      }
+    } else {
+      logger.log('info', `szci git -> cli arguments invalid! Please read the documentation.`);
+    }
+  };
+
+  public mirror = async () => {
+    const githubToken = Deno.env.get("SZCI_GIT_GITHUBTOKEN");
+    const githubUser = Deno.env.get("SZCI_GIT_GITHUBGROUP") || this.szciRef.szciEnv.repo.user;
+    const githubRepo = Deno.env.get("SZCI_GIT_GITHUB") || this.szciRef.szciEnv.repo.repo;
+    if (
+      this.szciRef.szciConfig.getConfig().projectInfo.npm.packageJson.private === true ||
+      this.szciRef.szciConfig.getConfig().npmAccessLevel === 'private'
+    ) {
+      logger.log(
+        'warn',
+        `refusing to mirror due to private property use a private mirror location instead`
+      );
+      return;
+    }
+    if (githubToken) {
+      logger.log('info', 'found github token.');
+      logger.log('info', 'attempting the mirror the repository to GitHub');
+
+      // remove old mirrors
+      await bashNoError('git remote rm mirror');
+
+      await bash(`git fetch`);
+      // add the mirror
+      await bashNoError(
+        `git remote add mirror https://${githubToken}@github.com/${githubUser}/${githubRepo}.git`
+      );
+      await bashNoError(`git push mirror --all`);
+      await bashNoError(`git checkout origin/master`);
+      await bashNoError(`git push mirror master`);
+      logger.log('ok', 'pushed all branches to mirror!');
+      await bashNoError(`git push mirror --tags`);
+      logger.log('ok', 'pushed all tags to mirror!');
+      // remove old mirrors
+      await bashNoError('git remote rm mirror');
+    } else {
+      logger.log('error', `cannot find SZCI_GIT_GITHUBTOKEN env var!`);
+      Deno.exit(1);
+    }
+  };
+}

package/ts/manager.git/mod.plugins.ts

@@ -0,0 +1 @@
+export * from '../szci.plugins.ts';

package/ts/manager.nodejs/index.ts

@@ -0,0 +1,82 @@
+import * as plugins from '../szci.plugins.ts';
+import * as paths from '../szci.paths.ts';
+
+import { logger } from '../szci.logging.ts';
+import { bash, bashNoError, nvmAvailable } from '../szci.bash.ts';
+import { Szci } from '../szci.classes.szci.ts';
+
+export class SzciNodeJsManager {
+  public szciRef: Szci;
+
+  constructor(szciRefArg: Szci) {
+    this.szciRef = szciRefArg;
+  }
+
+  /**
+   * handle cli input
+   * @param argvArg
+   */
+  public async handleCli(argvArg: any) {
+    if (argvArg._.length >= 3) {
+      const action: string = argvArg._[1];
+      switch (action) {
+        case 'install':
+          await this.install(argvArg._[2]);
+          break;
+        default:
+          logger.log('error', `>>szci node ...<< action >>${action}<< not supported`);
+          Deno.exit(1);
+      }
+    } else {
+      logger.log(
+        'error',
+        `>>szci node ...<< cli arguments invalid... Please read the documentation.`
+      );
+      Deno.exit(1);
+    }
+  }
+
+  /**
+   * Install a specific version of node
+   * @param versionArg
+   */
+  public async install(versionArg: any) {
+    logger.log('info', `now installing node version ${versionArg}`);
+    let version: string;
+    if (versionArg === 'stable') {
+      version = '22';
+    } else if (versionArg === 'lts') {
+      version = '20';
+    } else if (versionArg === 'legacy') {
+      version = '18';
+    } else {
+      version = versionArg;
+    }
+    if (await nvmAvailable.promise) {
+      await bash(`nvm install ${version} && nvm alias default ${version}`);
+      logger.log('success', `Node version ${version} successfully installed!`);
+    } else {
+      logger.log('warn', 'Nvm not in path so staying at installed node version!');
+    }
+    logger.log('info', 'now installing latest npm version');
+    await bash('npm install -g npm');
+    await bash('node -v');
+    await bash('npm -v');
+
+    // lets look for further config
+    const config = await this.szciRef.szciConfig.getConfig();
+    logger.log('info', 'Now checking for needed global npm tools...');
+    for (const npmTool of config.npmGlobalTools) {
+      logger.log('info', `Checking for global "${npmTool}"`);
+      const whichOutput: string = await bashNoError(`which ${npmTool}`);
+      const toolAvailable: boolean = !(/not\sfound/.test(whichOutput) || whichOutput === '');
+      if (toolAvailable) {
+        logger.log('info', `Tool ${npmTool} is available`);
+      } else {
+        logger.log('info', `globally installing ${npmTool} from npm`);
+        await bash(`npm install ${npmTool} -q -g`);
+      }
+    }
+    logger.log('success', 'all global npm tools specified in npmextra.json are now available!');
+  }
+}

package/ts/manager.npm/index.ts

@@ -0,0 +1,194 @@
+import * as plugins from './mod.plugins.ts';
+import * as paths from '../szci.paths.ts';
+
+import { logger } from '../szci.logging.ts';
+import { bash, bashNoError, nvmAvailable } from '../szci.bash.ts';
+import { Szci } from '../szci.classes.szci.ts';
+
+export class SzciNpmManager {
+  public szciRef: Szci;
+
+  constructor(szciRefArg: Szci) {
+    this.szciRef = szciRefArg;
+  }
+
+  /**
+   * handle cli input
+   * @param argvArg
+   */
+  public async handleCli(argvArg: any) {
+    if (argvArg._.length >= 2) {
+      const action: string = argvArg._[1];
+      switch (action) {
+        case 'install':
+          await this.install();
+          break;
+        case 'build':
+          await this.build();
+          break;
+        case 'prepare':
+          await this.prepare();
+          break;
+        case 'test':
+          await this.test();
+          break;
+        case 'publish':
+          await this.publish();
+          break;
+        default:
+          logger.log('error', `>>szci npm ...<< action >>${action}<< not supported`);
+          Deno.exit(1);
+      }
+    } else {
+      logger.log(
+        'info',
+        `>>szci npm ...<< cli arguments invalid... Please read the documentation.`
+      );
+      Deno.exit(1);
+    }
+  }
+
+  /**
+   * authenticates npm with token from env var
+   */
+  public async prepare() {
+    logger.log('info', 'running >>npm prepare<<');
+    const config = this.szciRef.szciConfig.getConfig();
+    let npmrcFileString: string = '';
+    await plugins.smartobject.forEachMinimatch(
+      Deno.env.toObject(),
+      'SZCI_TOKEN_NPM*',
+      (npmEnvArg: string) => {
+        if (!npmEnvArg) {
+          logger.log('note','found empty token...');
+          return;
+        }
+        const npmRegistryUrl = npmEnvArg.split('|')[0];
+        logger.log('ok', `found token for ${npmRegistryUrl}`);
+        let npmToken = npmEnvArg.split('|')[1];
+        if (npmEnvArg.split('|')[2] && npmEnvArg.split('|')[2] === 'plain') {
+          logger.log('ok', 'npm token not base64 encoded.');
+        } else {
+          logger.log('ok', 'npm token base64 encoded.');
+          npmToken = plugins.smartstring.base64.decode(npmToken);
+        }
+        npmrcFileString += `//${npmRegistryUrl}/:_authToken="${npmToken}"\n`;
+      }
+    );
+    logger.log('info', `setting default npm registry to ${config.npmRegistryUrl}`);
+    npmrcFileString += `registry=https://${config.npmRegistryUrl}\n`;
+
+    // final check
+    if (npmrcFileString.length > 0) {
+      logger.log('info', 'found one or more access tokens');
+    } else {
+      logger.log('error', 'no access token found! Exiting!');
+      Deno.exit(1);
+    }
+
+    // lets save it to disk
+    plugins.smartfile.memory.toFsSync(npmrcFileString, '/root/.npmrc');
+
+    // lets set the cache directory
+    await bash(`npm config set cache ${paths.SzciCacheDir}  --global `);
+
+    return;
+  }
+
+  /**
+   * publish a package to npm
+   */
+  public async publish() {
+    const buildPublishCommand = async () => {
+      let npmAccessCliString = ``;
+      let npmRegistryCliString = ``;
+      let publishVerdaccioAsWell = false;
+      const config = this.szciRef.szciConfig.getConfig();
+      const availableRegistries: string[] = [];
+      await plugins.smartobject.forEachMinimatch(
+        Deno.env.toObject(),
+        'SZCI_TOKEN_NPM*',
+        (npmEnvArg: string) => {
+          availableRegistries.push(npmEnvArg.split('|')[0]);
+        }
+      );
+
+      // -> configure package access level
+      if (config.npmAccessLevel) {
+        npmAccessCliString = `--access=${config.npmAccessLevel}`;
+        if (config.npmAccessLevel === 'public') {
+          publishVerdaccioAsWell = true;
+        }
+      } else {
+        throw new Error('You need to set a npmAccessLevel!!!');
+      }
+      // -> configure registry url
+      if (config.npmRegistryUrl) {
+        npmRegistryCliString = `--registry=https://${config.npmRegistryUrl}`;
+      } else {
+        logger.log('error', `no registry url specified. Can't publish!`);
+        Deno.exit(1);
+      }
+
+      let publishCommand = `npm publish ${npmAccessCliString} ${npmRegistryCliString} `;
+
+      // publishEverywhere
+      if (publishVerdaccioAsWell) {
+        const verdaccioRegistry = availableRegistries.find((registryString) =>
+          registryString.startsWith('verdaccio')
+        );
+        if (verdaccioRegistry) {
+          logger.log(
+            'info',
+            `package is public and verdaccio registry is specified. Also publishing to Verdaccio!`
+          );
+          publishCommand = `${publishCommand} && npm publish ${npmAccessCliString} --registry=https://${verdaccioRegistry}`;
+        } else {
+          logger.log(
+            'error',
+            `This package should also be published to Verdaccio, however there is no Verdaccio registry data available!`
+          );
+        }
+      }
+      return publishCommand;
+    };
+
+    // -> preparing
+    logger.log('info', `now preparing environment:`);
+    this.prepare();
+    await bash(`npm -v`);
+    await bash(`pnpm -v`);
+
+    // -> build it
+    await this.install();
+    await this.build();
+
+    logger.log('success', `Nice!!! The build for the publication was successfull!`);
+    logger.log('info', `Lets clean up so we don't publish any packages that don't belong to us:`);
+    // -> clean up before we publish stuff
+    await bashNoError(`rm -r ./.szci_cache`);
+    await bash(`rm -r ./node_modules`);
+
+    logger.log('success', `Cleaned up!:`);
+
+    // -> publish it
+    logger.log('info', `now invoking npm to publish the package!`);
+    await bash(await buildPublishCommand());
+    logger.log('success', `Package was successfully published!`);
+  }
+
+  public async install(): Promise<void> {
+    logger.log('info', 'now installing dependencies:');
+    await bash('pnpm install');
+  }
+
+  public async build(): Promise<void> {
+    logger.log('info', 'now building the project:');
+    await bash('pnpm run build');
+  }
+
+  public async test(): Promise<void> {
+    logger.log('info', 'now starting tests:');
+    await bash('pnpm test');
+  }
+}

package/ts/manager.npm/mod.plugins.ts

@@ -0,0 +1 @@
+export * from '../szci.plugins.ts';

package/ts/mod_ssh/index.ts

@@ -0,0 +1,97 @@
+import { logger } from '../szci.logging.ts';
+import * as plugins from './mod.plugins.ts';
+
+let sshInstance: plugins.smartssh.SshInstance;
+
+/**
+ * Interface for CLI arguments
+ */
+interface ICliArgs {
+  _: string[];
+  [key: string]: unknown;
+}
+
+/**
+ * Handle SSH CLI commands
+ */
+export const handleCli = async (argvArg: ICliArgs): Promise<void> => {
+  if (argvArg._.length >= 2) {
+    const action = argvArg._[1];
+    switch (action) {
+      case 'prepare':
+        await prepare();
+        break;
+      default:
+        logger.log('error', `action >>${action}<< not supported`);
+        Deno.exit(1);
+    }
+  } else {
+    logger.log('error', `>>szci ssh ...<< please specify an action!`);
+    Deno.exit(1);
+  }
+};
+
+/**
+ * Checks if a string value is defined and not a placeholder
+ */
+const isValidValue = (value: string | undefined): boolean => {
+  return Boolean(value && value !== 'undefined' && value !== '##');
+};
+
+/**
+ * Checks for ENV vars in form of SZCI_SSHKEY_* and deploys any found ones
+ */
+export const prepare = async (): Promise<void> => {
+  sshInstance = new plugins.smartssh.SshInstance();
+
+  // Get all env vars and filter for SSH keys
+  const envVars = Deno.env.toObject();
+  const sshKeyEnvVars = Object.entries(envVars).filter(([key]) =>
+    key.startsWith('SZCI_SSHKEY_')
+  );
+
+  // Process each SSH key env var
+  for (const [key, value] of sshKeyEnvVars) {
+    logger.log('info', `Processing SSH key from ${key}`);
+    addSshKeyFromEnvVar(value);
+  }
+
+  // Only write to disk if not in test mode
+  if (!Deno.env.get('SZCI_TEST')) {
+    try {
+      sshInstance.writeToDisk();
+      logger.log('ok', 'SSH keys written to disk');
+    } catch (error) {
+      logger.log('error', `Failed to write SSH keys: ${(error as Error).message}`);
+      throw error;
+    }
+  } else {
+    logger.log('info', 'In test mode, so not storing SSH keys to disk!');
+  }
+};
+
+/**
+ * Parses an SSH key env var and adds it to the SSH instance
+ * Format: host|privKeyBase64|pubKeyBase64
+ */
+const addSshKeyFromEnvVar = (sshkeyEnvVarArg: string): void => {
+  const [host, privKeyBase64, pubKeyBase64] = sshkeyEnvVarArg.split('|');
+  const sshKey = new plugins.smartssh.SshKey();
+
+  logger.log('info', `Found SSH identity for ${host || 'unknown host'}`);
+
+  if (isValidValue(host)) {
+    logger.log('info', '---> host defined!');
+    sshKey.host = host;
+  }
+  if (isValidValue(privKeyBase64)) {
+    logger.log('info', '---> privKey defined!');
+    sshKey.privKeyBase64 = privKeyBase64;
+  }
+  if (isValidValue(pubKeyBase64)) {
+    logger.log('info', '---> pubKey defined!');
+    sshKey.pubKeyBase64 = pubKeyBase64;
+  }
+
+  sshInstance.addKey(sshKey);
+};

package/ts/mod_ssh/mod.plugins.ts

@@ -0,0 +1 @@
+export * from '../szci.plugins.ts';

package/ts/szci.bash.ts

@@ -0,0 +1,96 @@
+import { logger } from './szci.logging.ts';
+import * as plugins from './szci.plugins.ts';
+import * as paths from './szci.paths.ts';
+
+/**
+ * wether nvm is available or not
+ */
+export let nvmAvailable = plugins.smartpromise.defer<boolean>();
+/**
+ * the smartshell instance for szci
+ */
+const szciSmartshell = new plugins.smartshell.Smartshell({
+  executor: 'bash',
+  sourceFilePaths: [],
+});
+
+/**
+ * check for tools.
+ */
+const checkToolsAvailable = async () => {
+  // check for nvm
+  if (!Deno.env.get('SZCI_TEST')) {
+    if (
+      (await szciSmartshell.execSilent(`bash -c "source /usr/local/nvm/nvm.sh"`)).exitCode === 0
+    ) {
+      szciSmartshell.shellEnv.addSourceFiles([`/usr/local/nvm/nvm.sh`]);
+      nvmAvailable.resolve(true);
+    } else if (
+      (await szciSmartshell.execSilent(`bash -c "source ~/.nvm/nvm.sh"`)).exitCode === 0
+    ) {
+      szciSmartshell.shellEnv.addSourceFiles([`~/.nvm/nvm.sh`]);
+      nvmAvailable.resolve(true);
+    } else {
+      nvmAvailable.resolve(false);
+    }
+  } else {
+    nvmAvailable.resolve(true);
+  }
+};
+checkToolsAvailable();
+
+/**
+ * bash() allows using bash with nvm in path
+ * @param commandArg - The command to execute
+ * @param retryArg - The retryArg: 0 to any positive number will retry, -1 will always succeed, -2 will return undefined
+ */
+export let bash = async (commandArg: string, retryArg: number = 2): Promise<string> => {
+  await nvmAvailable.promise; // make sure nvm check has run
+  let execResult!: plugins.smartshell.IExecResult;
+
+  // determine if we fail
+  let failOnError: boolean = true;
+  if (retryArg === -1) {
+    failOnError = false;
+    retryArg = 0;
+  }
+
+  if (!Deno.env.get('SZCI_TEST')) {
+    // SZCI_TEST is used during testing
+    for (let i = 0; i <= retryArg; i++) {
+      if (Deno.env.get('DEBUG_SZCI') === 'true') {
+        console.log(commandArg);
+      }
+      execResult = await szciSmartshell.exec(commandArg);
+
+      // determine how bash reacts to error and success
+      if (execResult.exitCode !== 0 && i === retryArg) {
+        // something went wrong and retries are exhausted
+        if (failOnError) {
+          logger.log('error', 'something went wrong and retries are exhausted');
+          Deno.exit(1);
+        }
+      } else if (execResult.exitCode === 0) {
+        // everything went fine, or no error wanted
+        i = retryArg + 1; // retry +1 breaks for loop, if everything works out ok retrials are not wanted
+      } else {
+        logger.log('warn', 'Something went wrong! Exit Code: ' + execResult.exitCode.toString());
+        logger.log('info', 'Retry ' + (i + 1).toString() + ' of ' + retryArg.toString());
+      }
+    }
+  } else {
+    logger.log('info', 'ShellExec would be: ' + commandArg);
+    execResult = {
+      exitCode: 0,
+      stdout: 'testOutput',
+    };
+  }
+  return execResult.stdout;
+};
+
+/**
+ * bashNoError allows executing stuff without throwing an error
+ */
+export let bashNoError = async (commandArg: string): Promise<string> => {
+  return await bash(commandArg, -1);
+};

package/ts/szci.classes.szci.ts

@@ -0,0 +1,58 @@
+import * as plugins from './szci.plugins.ts';
+
+
+// env
+import { SzciEnv } from './szci.classes.szcienv.ts';
+import { SzciInfo } from './szci.classes.szciinfo.ts';
+import { SzciCli } from './szci.classes.szcicli.ts';
+import { SzciConfig } from './szci.classes.szciconfig.ts';
+
+// connectors
+import { CloudlyConnector } from './connector.cloudly/cloudlyconnector.ts';
+
+// managers
+import { SzciDockerManager } from './manager.docker/index.ts';
+import { SzciGitManager } from './manager.git/index.ts';
+import { SzciNodeJsManager } from './manager.nodejs/index.ts';
+import { SzciNpmManager } from './manager.npm/index.ts';
+
+export class Szci {
+  public analytics: plugins.smartanalytics.Analytics;
+  public cloudlyConnector!: CloudlyConnector;
+
+  public szciEnv!: SzciEnv;
+  public szciInfo!: SzciInfo;
+  public szciConfig!: SzciConfig;
+  public szciCli!: SzciCli;
+
+  // managers
+  public dockerManager!: SzciDockerManager;
+  public gitManager!: SzciGitManager;
+  public nodejsManager!: SzciNodeJsManager;
+  public npmManager!: SzciNpmManager;
+
+  constructor() {
+    this.analytics = new plugins.smartanalytics.Analytics({
+      apiEndPoint: 'https://pubapi.lossless.one/analytics',
+      projectId: 'gitzone',
+      appName: 'szci',
+    });
+  }
+
+  public async start() {
+    this.cloudlyConnector = new CloudlyConnector(this);
+    this.szciEnv = new SzciEnv(this);
+    this.szciInfo = new SzciInfo(this);
+    await this.szciInfo.printToConsole();
+    this.szciCli = new SzciCli(this);
+    this.szciConfig = new SzciConfig(this);
+    await this.szciConfig.init();
+
+    // managers
+    this.dockerManager = new SzciDockerManager(this);
+    this.gitManager = new SzciGitManager(this);
+    this.nodejsManager = new SzciNodeJsManager(this);
+    this.npmManager = new SzciNpmManager(this);
+    this.szciCli.startParse();
+  }
+}

package/ts/szci.classes.szcicli.ts

@@ -0,0 +1,68 @@
+import { logger } from './szci.logging.ts';
+import * as plugins from './szci.plugins.ts';
+import * as paths from './szci.paths.ts';
+import { Szci } from './szci.classes.szci.ts';
+
+export class SzciCli {
+  public szciRef: Szci;
+  public smartcli: plugins.smartcli.Smartcli;
+
+  constructor(szciArg: Szci) {
+    this.szciRef = szciArg;
+    this.smartcli = new plugins.smartcli.Smartcli();
+    this.smartcli.addVersion(this.szciRef.szciInfo.version);
+
+    // docker
+    this.smartcli.addCommand('docker').subscribe(
+      async (argvArg) => {
+        await this.szciRef.dockerManager.handleCli(argvArg);
+      },
+      (err) => {
+        console.log(err);
+        Deno.exit(1);
+      }
+    );
+
+    // git
+    this.smartcli.addCommand('git').subscribe(
+      async (argvArg) => {
+        await this.szciRef.gitManager.handleCli(argvArg);
+      },
+      (err) => {
+        console.log(err);
+        Deno.exit(1);
+      }
+    );
+
+    // node
+    this.smartcli.addCommand('node').subscribe(
+      async (argvArg) => {
+        await this.szciRef.nodejsManager.handleCli(argvArg);
+      },
+      (err) => {
+        console.log(err);
+        Deno.exit(1);
+      }
+    );
+
+    // npm
+    this.smartcli.addCommand('npm').subscribe(
+      async (argvArg) => {
+        await this.szciRef.npmManager.handleCli(argvArg);
+      },
+      (err) => {
+        console.log(err);
+      }
+    );
+
+    // ssh
+    this.smartcli.addCommand('ssh').subscribe(async (argvArg) => {
+      const modSsh = await import('./mod_ssh/index.ts');
+      await modSsh.handleCli(argvArg);
+    });
+  }
+
+  public startParse = () => {
+    this.smartcli.startParse();
+  };
+}

package/ts/szci.classes.szciconfig.ts

@@ -0,0 +1,63 @@
+import * as plugins from './szci.plugins.ts';
+import * as paths from './szci.paths.ts';
+
+import { logger } from './szci.logging.ts';
+import { Szci } from './szci.classes.szci.ts';
+
+/**
+ * the main config interface for szci
+ */
+export interface ISzciOptions {
+  projectInfo: plugins.projectinfo.ProjectInfo;
+
+  // npm
+  npmGlobalTools: string[];
+  npmAccessLevel?: 'private' | 'public';
+  npmRegistryUrl: string;
+
+  // urls
+  urlCloudly?: string;
+}
+
+/**
+ * a config class for Szci
+ */
+export class SzciConfig {
+  public szciRef: Szci;
+
+  public szciNpmextra!: plugins.npmextra.Npmextra;
+  public kvStorage!: plugins.npmextra.KeyValueStore;
+  public szciQenv!: plugins.qenv.Qenv;
+
+  private configObject!: ISzciOptions;
+
+  constructor(szciRefArg: Szci) {
+    this.szciRef = szciRefArg;
+  }
+
+  public async init() {
+    this.szciNpmextra = new plugins.npmextra.Npmextra(paths.cwd);
+    this.kvStorage = new plugins.npmextra.KeyValueStore({
+      typeArg: 'userHomeDir',
+      identityArg: `.szci_${this.szciRef.szciEnv.repo.user}_${this.szciRef.szciEnv.repo.repo}`,
+    });
+    this.szciQenv = new plugins.qenv.Qenv(
+      paths.SzciProjectDir,
+      paths.SzciProjectNogitDir,
+      false
+    );
+
+    this.configObject = {
+      projectInfo: new plugins.projectinfo.ProjectInfo(paths.cwd),
+      npmGlobalTools: [],
+      npmAccessLevel: 'private',
+      npmRegistryUrl: 'registry.npmjs.org',
+      urlCloudly: await this.szciQenv.getEnvVarOnDemand('SZCI_URL_CLOUDLY'),
+    };
+    this.configObject = this.szciNpmextra.dataFor<ISzciOptions>('@ship.zone/szci', this.configObject);
+  }
+
+  public getConfig(): ISzciOptions {
+    return this.configObject;
+  }
+}

package/ts/szci.classes.szcienv.ts

@@ -0,0 +1,25 @@
+import * as plugins from './szci.plugins.ts';
+import { Szci } from './szci.classes.szci.ts';
+
+export class SzciEnv {
+  public szciRef: Szci;
+
+  public repoString: string;
+  public repo: plugins.smartstring.GitRepo;
+
+  constructor(szciRefArg: Szci) {
+    this.szciRef = szciRefArg;
+
+    // Determine repo string from environment
+    let repoUrl: string | undefined;
+    if (Deno.env.get("GITLAB_CI")) {
+      repoUrl = Deno.env.get("CI_REPOSITORY_URL");
+    }
+    if (!repoUrl && Deno.env.get("SZCI_COMPUTED_REPOURL")) {
+      repoUrl = Deno.env.get("SZCI_COMPUTED_REPOURL");
+    }
+
+    this.repoString = repoUrl || 'https://undefined:undefined@github.com/undefined/undefined.git';
+    this.repo = new plugins.smartstring.GitRepo(this.repoString);
+  }
+}

package/ts/szci.classes.szciinfo.ts

@@ -0,0 +1,18 @@
+import * as plugins from './szci.plugins.ts';
+import * as paths from './szci.paths.ts';
+import { logger } from './szci.logging.ts';
+import { Szci } from './szci.classes.szci.ts';
+import denoConfig from '../deno.json' with { type: 'json' };
+
+export class SzciInfo {
+  public szciRef: Szci;
+  public version = denoConfig.version;
+
+  constructor(szciArg: Szci) {
+    this.szciRef = szciArg;
+  }
+
+  public async printToConsole() {
+    await logger.log('info', `szci version: ${this.version}`);
+  }
+}

package/ts/szci.logging.ts

@@ -0,0 +1,14 @@
+import * as plugins from './szci.plugins.ts';
+
+export const logger = new plugins.smartlog.Smartlog({
+  logContext: {
+    company: 'Some Company',
+    companyunit: 'Some Unit',
+    containerName: 'Some ContainerName',
+    environment: 'test',
+    runtime: 'deno',
+    zone: 'Some Zone',
+  },
+});
+
+logger.addLogDestination(new plugins.smartlogDestinationLocal.DestinationLocal());

package/ts/szci.paths.ts

@@ -0,0 +1,31 @@
+import * as plugins from './szci.plugins.ts';
+
+/**
+ * Get current working directory (evaluated at call time, not module load time)
+ */
+export const getCwd = (): string => Deno.cwd();
+
+/**
+ * Current working directory - use getCwd() if you need the live value after chdir
+ * @deprecated Use getCwd() for dynamic cwd resolution
+ */
+export const cwd = Deno.cwd();
+
+// package paths
+export const SzciPackageRoot = plugins.path.join(
+  plugins.smartpath.get.dirnameFromImportMetaUrl(import.meta.url),
+  '../'
+);
+export const SzciPackageConfig = plugins.path.join(SzciPackageRoot, './config.json');
+
+// project paths - use functions for dynamic resolution
+export const getSzciProjectDir = (): string => getCwd();
+export const getSzciProjectNogitDir = (): string => plugins.path.join(getCwd(), './.nogit');
+export const getSzciTestDir = (): string => plugins.path.join(getCwd(), './test');
+export const getSzciCacheDir = (): string => plugins.path.join(getCwd(), './.szci_cache');
+
+// Static paths (for backwards compatibility - captured at module load)
+export const SzciProjectDir = cwd;
+export const SzciProjectNogitDir = plugins.path.join(SzciProjectDir, './.nogit');
+export const SzciTestDir = plugins.path.join(cwd, './test');
+export const SzciCacheDir = plugins.path.join(cwd, './.szci_cache');

package/ts/szci.plugins.ts

@@ -0,0 +1,60 @@
+// Deno std libraries
+import * as path from '@std/path';
+
+export { path };
+
+// @apiglobal
+import * as typedrequest from '@api.global/typedrequest';
+
+export { typedrequest };
+
+// @servezone
+import * as servezoneApi from '@serve.zone/api';
+
+export { servezoneApi };
+
+// @push.rocks
+import * as npmextra from '@push.rocks/npmextra';
+import * as projectinfo from '@push.rocks/projectinfo';
+import * as qenv from '@push.rocks/qenv';
+import * as smartanalytics from '@push.rocks/smartanalytics';
+import * as smartfile from '@push.rocks/smartfile';
+import * as smartcli from '@push.rocks/smartcli';
+import * as smartgit from '@push.rocks/smartgit';
+import * as smartlog from '@push.rocks/smartlog';
+import * as smartlogDestinationLocal from '@push.rocks/smartlog-destination-local';
+import * as smartobject from '@push.rocks/smartobject';
+import * as smartpath from '@push.rocks/smartpath';
+import * as smartpromise from '@push.rocks/smartpromise';
+import * as smartrequest from '@push.rocks/smartrequest';
+import * as smartshell from '@push.rocks/smartshell';
+import * as smartsocket from '@push.rocks/smartsocket';
+import * as smartssh from '@push.rocks/smartssh';
+import * as smartstring from '@push.rocks/smartstring';
+
+export {
+  npmextra,
+  projectinfo,
+  qenv,
+  smartanalytics,
+  smartfile,
+  smartgit,
+  smartcli,
+  smartlog,
+  smartlogDestinationLocal,
+  smartobject,
+  smartpath,
+  smartpromise,
+  smartrequest,
+  smartshell,
+  smartsocket,
+  smartssh,
+  smartstring,
+};
+
+// @tsclass scope
+import * as tsclass from '@tsclass/tsclass';
+
+export { tsclass };
+
+