qcobjects-cli 2.5.148-beta → 2.5.153-beta

package/.github/workflows/codeql-analysis.yml

@@ -16,7 +16,7 @@ on:
     branches: [ main ]
   pull_request:
     # The branches below must be a subset of the branches above
-    branches: [ "v2.3", "v2.4" ]
+    branches: [ "main", "development" ]
   schedule:
     - cron: '23 16 * * 2'
 

package/.github/workflows/{npmpublish-lts.yml → npmpublish.yml}

@@ -1,12 +1,9 @@
-# This workflow will run tests using node and then publish a package to GitHub Packages when a release is created
-# For more information see: https://help.github.com/actions/language-and-framework-guides/publishing-nodejs-packages
-
-name: Node.js Publish LTS version
+name: Node.js Publish
 
 on:
   push:
     tags:
-      - 'v*.*.*-lts'
+      - 'v*.*.*'
 
 jobs:
   build:
@@ -39,4 +36,12 @@ jobs:
       - name: Upgrade npm for OIDC support (requires >=11.5.1)
         run: npm install -g npm@latest
       - run: npm i --legacy-peer-deps
-      - run: npm publish --tag lts
+      - name: Publish to npm
+        run: |
+          if [[ "${{ github.ref }}" == *-beta ]]; then
+            npm publish --tag beta
+          elif [[ "${{ github.ref }}" == *-lts ]]; then
+            npm publish --tag lts
+          else
+            npm publish
+          fi

package/AGENTS.md

@@ -3,57 +3,57 @@
 TypeScript CLI tool and HTTP/HTTP2 server for the [QCObjects](https://qcobjects.dev) framework.
 Node >=22, npm >=10.
 
-## Git workflow
-
-See `.opencode/instructions/git-workflow.md` — topic branches from `development`, no rebase, SemVer tags.
-
 ## Commands
 
 | Action | Command |
 |--------|---------|
-| Install | `npm install` |
-| Lint | `npm run lint` (`eslint src/**/*.ts --fix`) |
-| Test | `npm test` (lint → jasmine) |
-| Run single test | `npx ts-node --project ./tsconfig.jasmine.json ./node_modules/jasmine/bin/jasmine` |
-| Build (types → ts → esm) | `npm run build` |
-| Build TS only | `npm run build:ts` — **runs `npm test` first**, then `node ./transpile.js tsconfig.json` |
+| Install | `npm i --legacy-peer-deps` (peer deps don't auto-install on npm >=10) |
+| Lint | `npm run lint` |
+| Test (lint + jasmine) | `npm test` |
+| Run jasmine only | `npm run test:jasmine` |
+| Full build (types → CJS → ESM) | `npm run build` |
+| Build CJS only (runs test first) | `npm run build:ts` |
 | Build types only | `npm run build:ts-types` |
-| Build ESM bundle | `npm run build:esbuild` |
-| Dev server | `npm start` (aliased to `qcobjects-shell`) |
+| Build ESM + browser IIFE | `npm run build:esbuild` |
+| Dev server | `npm start` (aliases `qcobjects-shell`) |
 
 ## Architecture
 
 - **CLI framework:** Commander (`src/cli-main.ts` — `SwitchCommander` class)
 - **Commands** in `src/cli-commands-*.ts`, registered via `src/cli-commands.ts`
-- **Servers:** HTTP (`src/main-http-server.ts`), HTTP/2 (`src/main-http2-server.ts`), GAE variant
-- **Build pipeline:** Custom `transpile.js` (TS compiler API) produces CJS → `esbuild` produces ESM + browser IIFE
+- **Servers:** HTTP (`src/main-http-server.ts`), HTTP/2 (`src/main-http2-server.ts`), GAE (`src/main-http-gae-server.ts`)
+- **Build pipeline:** Custom `transpile.js` (TS compiler API) → CJS, then `build-esbuild-esm.js` → ESM + browser IIFE
 - **Output:** `public/cjs/`, `public/esm/`, `public/browser/`, `public/types/`
+- **Deno:** `deno.json` + `mod.ts` for Deno compatibility
+- **Entrypoints:** `src/qcobjects-cli.ts` (CLI), `src/qcobjects-http{-2,}-server.ts` (servers), `src/qcobjects-shell.ts`, `src/qcobjects-collab.ts`
+- **Source convention:** Most modules import `qcobjects` at top and use `InheritClass`, `Package()`, `Export()`, `CONFIG`, `logger`, `Component`, `Service`
+- **Plugin autodiscovery:** Scans `dependencies`/`devDependencies` for packages with `qcobjects-lib`, `qcobjects-handler`, `qcobjects-command` keywords
 
-## Testing quirks
+## Testing
 
-- **Framework:** Jasmine v3.7 (`spec/support/jasmine.json`)
-- Single spec: `spec/testsSpec.ts` — verifies `qcobjects` version matches between `peerDependencies` and `devDependencies`
-- Mock path in `tsconfig.jasmine.json`: `qcobjects-sdk` → `spec/mocks/qcobjects-sdk.mock.ts`
+- **Framework:** Jasmine v3.7, single spec at `spec/testsSpec.ts`
+- Verifies `qcobjects` version matches between `peerDependencies` and `devDependencies`
+- **Mock:** `tsconfig.jasmine.json` maps `qcobjects-sdk` → `spec/mocks/qcobjects-sdk.mock.ts` (file may not exist yet)
 - Config: `stopSpecOnExpectationFailure: true`, `failSpecWithNoExpectations: true`, `random: false`
 
-## QCObjects patterns used in source
-
-- `InheritClass`, `Package()`, `Export()`, `CONFIG`, `logger`, `Service`, `Component`
-- Plugin autodiscovery: scans `dependencies`/`devDependencies` for packages with `qcobjects-lib`, `qcobjects-handler`, `qcobjects-command` keywords
-
 ## Config & env
 
-- `config.json` at root — runtime config
+- `config.json` at root — **gitignored** (local dev only), default: `{"devmode":"debug"}`
 - `src/defaultsettings.ts` — `$ENV(VAR)` template syntax resolved at runtime
 - `process.env.PORT` overrides HTTP listen port
-- Dev mode: `config.json` `{"devmode":"debug"}`
+- Version tracked in `VERSION` file; CLI has built-in `v-patch`/`v-minor`/`v-major`/`v-sync`/`v-changelog` commands
 
-## Pre-commit
+## CI / Git
 
-`.pre-commit-config.yaml`: trailing-whitespace, end-of-file-fixer, check-yaml, check-added-large-files (500 KB max).
-Run `pre-commit install` to activate hooks.
+- **CI workflows** (`ci.yml`, `codeql-analysis.yml`) have **placeholder steps** (TODOs) — not runnable
+- Real publish: `.github/workflows/npmpublish.yml` — triggered by `v*.*.*` tags, uses OIDC (`id-token: write`), detects `-beta`/`-lts` suffix for npm dist-tag
+- **Branch model:** `main` ← `development` ← `feature/*`/`fix/*`/`bugfix/*`. PRs into `development` auto-created on topic-branch push. PRs to `main` must come from `development`.
+- **No rebase.** Use `git pull` (merge).
+- **Postversion** is `"git push"` (branch only). Tag is pushed separately by `syncGit` to avoid duplicate CI.
+- Version sync: `v-patch --git --npm` calls `npm version` internally (triggers `preversion`/`postversion`), then `syncGit` pushes VERSION commit + tag
+- See `.opencode/instructions/git-workflow.md` for detailed git workflow rules.
 
-## Build artifacts
+## ESLint
 
-- `build/templates/` — compiled template copies
-- Lockfile: `package-lock.json` only (no yarn/pnpm)
+- Uses `recommendedTypeChecked` but many core rules explicitly disabled (`no-explicit-any: off`, `no-unused-vars: off`, `no-var: off`, `no-unsafe-*: off`, etc.) — lint is permissive
+- Ignores `**/*.js`, `spec/**/*`, `node_modules`

package/VERSION

@@ -1 +1 @@
-2.5.148-beta
+2.5.153-beta

package/build-esbuild-esm.js

@@ -112,6 +112,28 @@ const buildConfigs = {
               content = content
                 .replace(/const\s+{([^}]+)}\s*=\s*require\(['"]([^'"]+)['"]\)/g, 'import { $1 } from "$2"')
                 .replace(/const\s+([^=]+)\s*=\s*require\(['"]([^'"]+)['"]\)/g, 'import $1 from "$2"');
+
+              // Convert await import(var) → JSON.parse(fs.readFileSync(var, "utf8"))
+              // for variables referencing paths ending in .json/.jsonp/.md/.mdc/.text/.txt
+              const extensionsToConvert = ['json', 'jsonp', 'md', 'mdc', 'text', 'txt'];
+              const extPattern = extensionsToConvert.join('|');
+              const varDeclRegex = new RegExp(
+                `(?:const|let|var)\\s+(\\w+)\\s*=[^;]*?\\.(?:${extPattern})["'\`][^;]*;`,
+                'g'
+              );
+              const jsonVars = new Set();
+              let match;
+              while ((match = varDeclRegex.exec(content)) !== null) {
+                jsonVars.add(match[1]);
+              }
+              if (jsonVars.size > 0) {
+                const importRegex = new RegExp(
+                  `await import\\((${[...jsonVars].join('|')})\\)`,
+                  'g'
+                );
+                content = content.replace(importRegex, 'JSON.parse(fs.readFileSync($1, "utf8"))');
+              }
+
               writeFileSync(file, content, 'utf8');
             });
           });

package/docs/launch-and-server.md

@@ -0,0 +1,253 @@
+# Launch & Server Architecture
+
+## How to launch an app
+
+After creating a project with `qcobjects create myapp --pwa`, enter the project directory and run:
+
+```shell
+npm start
+```
+
+This executes `npm run createcert && npm run serve` (defined in the generated `package.json`). The `serve` script runs `qcobjects-server`.
+
+Alternatively, from anywhere:
+
+```shell
+qcobjects launch <appname>
+```
+
+**Note:** The `<appname>` argument is accepted for interface consistency but is not used by the server — the server discovers the app from the current working directory.
+
+## The launch chain
+
+```
+qcobjects launch <appname>
+  │
+  ▼
+src/cli-main.ts:455-472
+  └─ exec("qcobjects-server")
+       │
+       ▼
+package.json bin → public/cjs/qcobjects-http2-server.js
+       │
+       ▼
+src/qcobjects-http2-server.ts
+  ├─ import "./defaultsettings"      ← loads CONFIG defaults + project config.json
+  ├─ choose server class:
+  │    CONFIG.get("useLegacyHTTP", false)
+  │    → false (default): HTTP2Server  (src/main-http2-server.ts)
+  │    → true:           HTTPServer    (src/main-http-server.ts)
+  └─ New(serverClass).start()
+```
+
+## CLI command handler
+
+**File:** `src/cli-main.ts:455-472`
+
+```typescript
+switchCommander.program.command("launch <appname>")
+  .description("Launches the application")
+  .action(function () {
+    logger.info("Launching...");
+    setTimeout(() => {
+      logger.info("Go to the browser and open https://localhost ");
+      logger.info("Press Ctrl-C to stop serving ");
+      exec("qcobjects-server", () => {})
+        .stdout?.on("data", data => console.log(data));
+    }, 5000);
+  });
+```
+
+The handler:
+1. Logs `"Launching..."` immediately
+2. Waits 5 seconds
+3. Spawns `qcobjects-server` (the HTTP/2 server binary) via `child_process.exec()`
+4. Pipes the server's stdout to the console
+
+The 5-second delay exists so the CLI process can exit gracefully before the server takes over.
+
+## Server binary
+
+The `qcobjects-server` binary is defined in `package.json`:
+
+| Binary | Path | Source |
+|--------|------|--------|
+| `qcobjects-server` | `public/cjs/qcobjects-http2-server.js` | `src/qcobjects-http2-server.ts` |
+| `qcobjects-http-server` | `public/cjs/qcobjects-http-server.js` | `src/qcobjects-http-server.ts` |
+| `qcobjects-gae-server` | `public/cjs/qcobjects-gae-http-server.js` | `src/qcobjects-gae-http-server.ts` |
+
+## Server selection
+
+**File:** `src/qcobjects-http2-server.ts`
+
+```typescript
+import "./defaultsettings";
+import { CONFIG, New } from "qcobjects";
+import { HTTPServer } from "./main-http-server";
+import { HTTP2Server } from "./main-http2-server";
+
+const _ServerClass_ = CONFIG.get("useLegacyHTTP", false)
+  ? HTTPServer
+  : HTTP2Server;
+const app = New(_ServerClass_);
+app.start();
+```
+
+The default is **HTTP/2** (`useLegacyHTTP: false`). Set `useLegacyHTTP: true` in the project's `config.json` to use HTTP/1.1.
+
+| Server | File | Listens on | Default port |
+|--------|------|------------|--------------|
+| HTTP/2 (default) | `src/main-http2-server.ts` | HTTP redirect (port 8080 → 8443) + HTTPS/2 (port 8443) | 8443 |
+| Legacy HTTP | `src/main-http-server.ts` | HTTP (plain, single port) | `process.env.PORT` \|\| 8080 |
+| GAE HTTP | `src/main-http-gae-server.ts` | HTTP (single port, GAE compatible) | `process.env.PORT` \|\| 8080 |
+
+## App discovery
+
+The server does not use the `<appname>` argument. Instead, the app is discovered through the **current working directory**:
+
+1. **`src/defaultsettings.ts:133`** — `CONFIG.set("projectPath", \`${process.cwd()}/\`)`
+2. **`src/defaultsettings.ts:173-178`** — reads `<projectPath>/config.json` and merges every key into CONFIG, overriding all defaults
+3. **`src/defaultsettings.ts:90`** — `documentRoot` defaults to `<projectPath>/public/`
+4. **`src/main-file.ts`** — `FileDispatcher` resolves all file requests relative to `documentRoot`
+
+The implicit contract is that the user is `cd`'d into the project directory, and the project contains a `config.json` and a `public/` directory.
+
+## CONFIG settings reference
+
+All defaults are set in `src/defaultsettings.ts:83-136`.
+
+### Server & network
+
+| Setting | Default | Description |
+|---------|---------|-------------|
+| `serverPortHTTP` | `"8080"` | Port for HTTP (and HTTP→HTTPS redirect in HTTP/2 mode) |
+| `serverPortHTTPS` | `"8443"` | Port for HTTPS/HTTP/2 |
+| `useLegacyHTTP` | `false` | Use HTTP/1.1 instead of HTTP/2 |
+| `allowHTTP1` | `true` | Allow HTTP/1.1 fallback on the HTTP/2 server |
+| `documentRoot` | `$config(projectPath)public/` | Root directory for static file serving |
+| `documentRootFileIndex` | `"index.html"` | Default file served for directory paths |
+| `cacheControl` | `"max-age=31536000"` | Cache-Control header for static files |
+| `backendTimeout` | `20000` | Request timeout in ms (set at runtime) |
+
+### TLS / certificates
+
+| Setting | Default | Description |
+|---------|---------|-------------|
+| `private-key-pem` | `$config(domain)-privkey.pem` | TLS private key file |
+| `private-cert-pem` | `$config(domain)-cert.pem` | TLS certificate file |
+| `certificate_provider` | `$ENV(CERTIFICATE_PROVIDER)` | `self_signed` or `letsencrypt` |
+
+### Backend
+
+| Setting | Default | Description |
+|---------|---------|-------------|
+| `backend.db_engine.name` | `$ENV(ENGINE_NAME)` | Database engine name |
+| `backend.auth.enabled` | `true` | Enable authentication |
+| `backend.routes` | `[]` | Route definitions (microservice dispatch) |
+
+### Autodiscovery
+
+| Setting | Default | Description |
+|---------|---------|-------------|
+| `autodiscover` | `true` | Master switch for plugin autodiscovery |
+| `autodiscover_commands` | `true` | Auto-load `qcobjects-command` plugins |
+| `autodiscover_handlers` | `true` | Auto-load `qcobjects-handler` plugins |
+
+### Config resolution order
+
+1. Hardcoded defaults (`defaultsettings.ts:83-136`)
+2. `$ENV(VAR)` template literals resolved at runtime from environment variables
+3. `$config(key)` template literals resolved from CONFIG values
+4. Project `<projectPath>/config.json` values merged on top (overrides all)
+
+## HTTP/2 server start
+
+**File:** `src/main-http2-server.ts:433-448`
+
+```typescript
+start() {
+  var server = this.server;
+
+  const httpServer = http.createServer((req, res) => {
+    res.writeHead(301, {
+      Location: `https://${req.headers.host}${req.url}`
+    });
+    res.end();
+  });
+
+  httpServer.listen(CONFIG.get("serverPortHTTP"));     // 8080 → redirects to HTTPS
+  server.listen(CONFIG.get("serverPortHTTPS"));         // 8443 → HTTP/2
+}
+```
+
+- Creates an HTTP redirector on `serverPortHTTP` (8080) that sends 301 redirects to HTTPS
+- Creates the HTTP/2 secure server on `serverPortHTTPS` (8443) using `http2.createSecureServer()` with TLS key and cert from CONFIG
+
+## Legacy HTTP server start
+
+**File:** `src/main-http-server.ts:595-598`
+
+```typescript
+start() {
+  var server = this.server;
+  server.listen(process.env.PORT || CONFIG.get("serverPortHTTP"));
+}
+```
+
+Single HTTP listener on `process.env.PORT || serverPortHTTP` (default 8080).
+
+## Request handling flow
+
+Both server variants follow the same pattern on each request:
+
+```
+Incoming request
+  │
+  ▼
+Check global.get("backendAvailable")?
+  │
+  ├─ Yes (project config.json has "backend" key)
+  │     │
+  │     ├─ Load interceptors from CONFIG.get("backend").interceptors
+  │     ├─ Match request path against CONFIG.get("backend").routes
+  │     │
+  │     ├─ Route matched?
+  │     │   ├─ Yes → Instantiate route.microservice + ".Microservice"
+  │     │   │         via New(microServiceClassFactory, { ...CONFIG values })
+  │     │   └─ No  → Fall through to HTTPServerResponse / HTTP2ServerResponse
+  │     │
+  │     └─ Response class serves file via FileDispatcher
+  │
+  └─ No (no backend config)
+        │
+        └─ HTTPServerResponse / HTTP2ServerResponse
+              └─ FileDispatcher resolves <documentRoot>/<path>
+```
+
+### Key files
+
+| File | Role |
+|------|------|
+| `src/qcobjects-http2-server.ts` | Server bootstrap — chooses HTTP vs HTTP/2 |
+| `src/qcobjects-http-server.ts` | Legacy HTTP bootstrap |
+| `src/qcobjects-gae-http-server.ts` | GAE-compatible bootstrap |
+| `src/main-http2-server.ts` | HTTP2Server, HTTP2ServerResponse, HTTP2ServerRequest |
+| `src/main-http-server.ts` | HTTPServer, BackendMicroservice, HTTPServerResponse |
+| `src/main-http-gae-server.ts` | GAE-compatible server classes |
+| `src/main-file.ts` | FileDispatcher — filesystem resolution |
+| `src/defaultsettings.ts` | All CONFIG defaults + config.json loading + plugin autodiscovery |
+| `src/common-pipelog.ts` | PipeLog logging utility |
+
+## Template-generated app scripts
+
+Running `qcobjects create myapp --pwa` generates a `package.json` with these relevant scripts:
+
+| Script | Command | Purpose |
+|--------|---------|---------|
+| `start` | `npm run createcert && npm run serve` | Full launch (generate TLS cert then serve) |
+| `serve` | `qcobjects-server` | Start HTTP/2 server |
+| `http-server` | `qcobjects-http-server` | Start legacy HTTP server |
+| `createcert` | `qcobjects-createcert` | Generate self-signed TLS certificate |
+| `prestart` | `npm run publish:web` | Build before launching |
+
+The recommended workflow: `npm start` → generates a self-signed cert (if needed) → builds the web assets → starts the HTTP/2 server.

package/docs/release-pipeline.md

@@ -0,0 +1,122 @@
+# Release Pipeline
+
+## Why this change
+
+Previously the repo used version-specific branches (v2.3, v2.4-beta, v2.4-ts,
+v2.5-beta) to track different architecture waves (ECMA5, ES6+JS, full TS+JS).
+As the number of active tracks grew, branch-based management added complexity:
+CI workflows needed per-branch configuration, PR paths were unclear, and
+promoting a beta to LTS required manual cross-branch coordination.
+
+## What changed
+
+- Removed all version-specific branches (v2.3, v2.4-beta, v2.4-ts, v2.5-beta)
+- Single active development branch: `development`
+- Release channel is encoded in the tag suffix, not in a branch name
+- Old version tracks preserved as archive tags
+
+## Branch model
+
+    main          ← release digest (merged from development via PR)
+    development   ← single active development branch
+    feature/*     ← topic branches, PR into development
+    fix/*
+    bugfix/*
+
+No more version-specific branches. Every release is a tag on `main`.
+
+## Release channels (tags)
+
+| Tag pattern | npm dist-tag | Triggered by |
+|-------------|-------------|--------------|
+| `vX.Y.Z`        | `latest` | `npmpublish.yml` (suffix detection) |
+| `vX.Y.Z-lts`    | `lts`    | `npmpublish.yml` (suffix detection) |
+| `vX.Y.Z-beta`   | `beta`   | `npmpublish.yml` (suffix detection) |
+| (future) `-dev` | `dev`    | (add pattern to `npmpublish.yml`) |
+| (future) `-alpha` | `alpha` | (add pattern to `npmpublish.yml`) |
+
+## Promotion workflow
+
+1. Daily work on `development` branch
+2. `v-patch --git --npm` → tag `vX.Y.Z-beta` (beta publish)
+3. Change VERSION suffix → `v-patch --git --npm` → tag `vX.Y.Z-lts` (LTS publish)
+4. PR `development` → `main` → merge → tag `vX.Y.Z` on `main` (latest publish)
+
+## Branch snapshot and removal steps
+
+These steps preserve the latest state of every old version branch as a tag,
+then delete the branches. Run them once during migration.
+
+### Prerequisites
+
+```bash
+git fetch --all --prune
+```
+
+### 1. Archive v2.4-beta
+
+```bash
+git tag archive/v2.4-beta origin/v2.4-beta
+git push origin archive/v2.4-beta
+```
+
+### 2. Archive v2.4-ts
+
+```bash
+git tag archive/v2.4-ts origin/v2.4-ts
+git push origin archive/v2.4-ts
+```
+
+### 3. Bootstrap development from v2.5-beta
+
+```bash
+git checkout -b development origin/v2.5-beta
+git push -u origin development
+```
+
+### 4. Delete old remote branches
+
+```bash
+git push origin --delete v2.5-beta v2.4-beta v2.4-ts
+```
+
+### 5. Delete old local branches
+
+```bash
+git branch -d v2.5-beta
+```
+
+### 6. Verify
+
+```bash
+git branch -a          # should show only main, development
+git tag -ln archive/*  # should show archive/v2.4-beta, archive/v2.4-ts
+```
+
+## Archived tracks
+
+v2.3 is already captured by existing tags `v2.3.1` through `v2.3.50` — no
+separate archive tag needed. Its commits are ancestors of `main`.
+
+| Archive tag | Source branch | Created |
+|-------------|--------------|---------|
+| `archive/v2.4-beta` | `origin/v2.4-beta` | migration date |
+| `archive/v2.4-ts`   | `origin/v2.4-ts`   | migration date |
+| `v2.3.50` (existing tag) | `v2.3` branch (GitLab, merged to master) | n/a |
+
+## CI pipeline updates
+
+| File | Change |
+|------|--------|
+| `.github/workflows/codeql-analysis.yml` | branch targets from `[v2.3, v2.4]` to `[main, development]` |
+| `.github/workflows/npmpublish.yml` | consolidated single workflow (was 3 separate) |
+| `.github/workflows/open-pr-to-development.yml` | already targets `development`, no changes needed |
+| `.github/workflows/main-pr-source.yml` | already enforces `development` → `main`, no changes needed |
+| `.github/workflows/ci.yml` | already targets `main`/`development`, no changes needed |
+
+## Future considerations
+
+- When starting a new architecture wave (e.g. v2.6), branch from `main` into a
+  feature branch, develop on `development`, and release via the same tag flow
+- Archived branches are never deleted from git history — the tags ensure
+  the code is always accessible for reference or hotfix branching

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qcobjects-cli",
-  "version": "2.5.148-beta",
+  "version": "2.5.153-beta",
   "description": "qcobjects cli command line tool",
   "main": "public/cjs/index.js",
   "module": "public/esm/index.mjs",
@@ -156,7 +156,7 @@
     "@types/node": "^22.10.2",
     "@typescript-eslint/eslint-plugin": "^5.58.0",
     "@typescript-eslint/parser": "^5.58.0",
-    "esbuild": "^0.24.0",
+    "esbuild": "^0.28.0",
     "esbuild-plugin-alias": "^0.2.1",
     "eslint": "^8.56.0",
     "eslint-config-prettier": "^8.10.0",

package/public/cjs/cli-commands-version.js

@@ -44,7 +44,7 @@ class CommandHandler extends qcobjects_1.InheritClass {
         this.switchCommander = switchCommander;
         const commandHandler = this;
         this.choiceOption = {
-            v_major(filename, options) {
+            async v_major(filename, options) {
                 filename = (typeof filename === "undefined") ? ("VERSION") : (filename);
                 const versionString = this.getVersionStringFromFile(filename);
                 const versionSuffix = this.parseVersionSuffix(versionString);
@@ -56,10 +56,10 @@ class CommandHandler extends qcobjects_1.InheritClass {
                 this.saveNewVersionFile(filename, newVersion);
                 if (options.syncGit) {
                     var commitMsg = options.commitMsg || `New Version v${newVersion}`;
-                    this.syncGit(newVersion, commitMsg, options.syncNpm);
+                    await this.syncGit(newVersion, commitMsg, options.syncNpm);
                 }
             },
-            v_minor(filename, options) {
+            async v_minor(filename, options) {
                 filename = (typeof filename === "undefined") ? ("VERSION") : (filename);
                 const versionString = this.getVersionStringFromFile(filename);
                 const versionSuffix = this.parseVersionSuffix(versionString);
@@ -71,10 +71,11 @@ class CommandHandler extends qcobjects_1.InheritClass {
                 this.saveNewVersionFile(filename, newVersion);
                 if (options.syncGit) {
                     var commitMsg = options.commitMsg || `New Version v${newVersion}`;
-                    this.syncGit(newVersion, commitMsg, options.syncNpm);
+                    await this.syncGit(newVersion, commitMsg, options.syncNpm);
                 }
             },
-            v_patch(filename, options) {
+            async v_patch(filename, options) {
+
                 filename = (typeof filename === "undefined") ? ("VERSION") : (filename);
                 const versionString = this.getVersionStringFromFile(filename);
                 const versionSuffix = this.parseVersionSuffix(versionString);
@@ -86,7 +87,7 @@ class CommandHandler extends qcobjects_1.InheritClass {
                 this.saveNewVersionFile(filename, newVersion);
                 if (options.syncGit) {
                     var commitMsg = options.commitMsg || `New Version v${newVersion}`;
-                    this.syncGit(newVersion, commitMsg, options.syncNpm);
+                    await this.syncGit(newVersion, commitMsg, options.syncNpm);
                 }
             },
             v_sync(filename, options) {
@@ -151,7 +152,7 @@ class CommandHandler extends qcobjects_1.InheritClass {
             .option("-m, --commit-msg [message]", "Commit Message")
             .description("Semantic Versioning: Upgrade to a new major version")
             .action(function (args, options) {
-            commandHandler.choiceOption.v_major.call(commandHandler, args, options);
+            return commandHandler.choiceOption.v_major.call(commandHandler, args, options);
         });
         switchCommander.program.command("v-minor [filename]")
             .option("--git, --sync-git", "Sync with Git")
@@ -159,7 +160,7 @@ class CommandHandler extends qcobjects_1.InheritClass {
             .option("-m, --commit-msg [message]", "Commit Message")
             .description("Semantic Versioning: Upgrade to a new minor version")
             .action(function (args, options) {
-            commandHandler.choiceOption.v_minor.call(commandHandler, args, options);
+            return commandHandler.choiceOption.v_minor.call(commandHandler, args, options);
         });
         switchCommander.program.command("v-patch [filename]")
             .option("--git, --sync-git", "Sync with Git")
@@ -167,7 +168,7 @@ class CommandHandler extends qcobjects_1.InheritClass {
             .option("-m, --commit-msg [message]", "Commit Message")
             .description("Semantic Versioning: Upgrade to a new patch version")
             .action(function (args, options) {
-            commandHandler.choiceOption.v_patch.call(commandHandler, args, options);
+            return commandHandler.choiceOption.v_patch.call(commandHandler, args, options);
         });
         switchCommander.program.command("v-sync [filename]")
             .option("-m, --commit-msg [message]", "Commit Message")
@@ -198,7 +199,7 @@ class CommandHandler extends qcobjects_1.InheritClass {
             _commands_.push(`git tag -a "v${versionString}" -m "${commitMsg}"`);
         }
         _commands_.push("git push && git push --tags");
-        this.switchCommander.shellCommands(_commands_).then(function (response) {
+        return this.switchCommander.shellCommands(_commands_).then(function (response) {
             qcobjects_1.logger.info("Synced to Git");
             qcobjects_1.logger.debug(response);
         }).catch(function (e) {