@akash-chowdhury-24/deployhub 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Akash Chowdhury
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,176 @@
+# DeployHub
+
+Zero-configuration deployment and artifact manager for Node.js projects. When you push to GitHub, DeployHub automatically detects your project type, builds it, creates a versioned artifact, uploads to cloud storage, and optionally deploys to your server.
+
+## Installation
+
+```bash
+npm install -g @akash-chowdhury-24/deployhub
+```
+
+Or use locally in your project:
+
+```bash
+npm install deployhub
+npx @akash-chowdhury-24/deployhub init
+```
+
+## Quick Start
+
+### 1. Initialize
+
+```bash
+deployhub init
+```
+
+This interactive wizard will:
+
+- Detect your framework (React, Vue, Next.js, Node, Python, etc.)
+- Configure build commands and output directory
+- Set up storage providers (AWS, Google Drive, Azure, GCP, Dropbox, Local)
+- Optionally configure deployment targets (SSH, Docker, EC2, Kubernetes, etc.)
+- Generate `deployhub.config.json`
+- Generate `.github/workflows/deployhub.yml`
+- Generate `.env.example`
+
+### 2. Configure credentials
+
+```bash
+cp .env.example .env
+# Edit .env with your credentials
+
+deployhub storage add aws
+deployhub storage add gdrive
+```
+
+### 3. Run pre-flight checks
+
+```bash
+deployhub doctor
+```
+
+### 4. Deploy
+
+```bash
+deployhub build
+```
+
+Or push to `main` — GitHub Actions runs `deployhub build` automatically.
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `deployhub init` | Interactive project setup |
+| `deployhub build` | Full pipeline: detect → install → test → build → artifact → storage → deploy |
+| `deployhub artifact create` | Create artifact from current build |
+| `deployhub artifact list` | List all artifacts |
+| `deployhub artifact restore <version>` | Download and extract an artifact |
+| `deployhub storage add <provider>` | Add storage provider credentials |
+| `deployhub storage list` | List storage providers and connection status |
+| `deployhub deploy` | Deploy latest artifact |
+| `deployhub rollback [version]` | Rollback to a previous version |
+| `deployhub logs` | Show logs from last deployment |
+| `deployhub doctor` | Pre-flight checks |
+| `deployhub verify` | Health check on configured endpoint |
+| `deployhub clean` | Remove old local artifacts |
+| `deployhub update` | Check for CLI updates |
+
+## GitHub Secrets
+
+Add these secrets in your repository (Settings → Secrets and variables → Actions). Only add secrets for providers you selected during `init`:
+
+| Secret | Provider |
+|--------|----------|
+| `AWS_ACCESS_KEY_ID` | AWS S3 |
+| `AWS_SECRET_ACCESS_KEY` | AWS S3 |
+| `AWS_BUCKET` | AWS S3 |
+| `AWS_REGION` | AWS S3 |
+| `GDRIVE_CLIENT_ID` | Google Drive |
+| `GDRIVE_CLIENT_SECRET` | Google Drive |
+| `GDRIVE_REFRESH_TOKEN` | Google Drive |
+| `GDRIVE_FOLDER_ID` | Google Drive |
+| `AZURE_CONNECTION_STRING` | Azure Blob |
+| `AZURE_CONTAINER` | Azure Blob |
+| `GCP_PROJECT_ID` | GCP Storage |
+| `GCP_KEY_FILE` | GCP Storage |
+| `GCP_BUCKET` | GCP Storage |
+| `DROPBOX_ACCESS_TOKEN` | Dropbox |
+| `SSH_HOST` | SSH deployment |
+| `SSH_USER` | SSH deployment |
+| `SSH_KEY` | SSH deployment |
+
+## `deployhub doctor` Output
+
+The doctor command runs independent checks and always completes without crashing:
+
+```
+  Checking Git...               ✓ Git installed, repo detected, remote set
+  Checking Docker...            ✓ Docker running
+  Checking Build command...     ✓ "npm run build" found in package.json
+  Checking AWS...               ✓ Credentials valid, bucket accessible
+  Checking Google Drive...      ✓ Connected
+  Checking SSH target...        ✓ Can reach host
+  Checking Health endpoint...   ✓ URL reachable (HTTP 200)
+  Checking Secrets...           ✓ All required env vars present
+  Checking GitHub Actions...    ✓ Workflow file exists at .github/workflows/deployhub.yml
+  Checking Storage write...     ✓ Test upload succeeded
+
+  ✓ Ready to deploy (10/10 checks passed)
+```
+
+If checks fail:
+
+```
+  Checking AWS...               ✗ Missing: AWS_SECRET_ACCESS_KEY
+  Checking Health endpoint...   ✗ No URL configured
+
+  8/10 — fix the 2 issues above before deploying
+```
+
+## Artifact Structure
+
+Each build creates:
+
+```
+artifact/
+  {projectName}/
+    {YYYY-MM-DD}/
+      v{semver}/
+        artifact.zip
+        metadata.json
+        logs.txt
+        checksums.txt
+        deployment.json
+        release-notes.md
+        README.md
+```
+
+## Configuration
+
+`deployhub.config.json` is generated by `init`. Credentials are **never** stored in this file — only in `.env` or GitHub Secrets.
+
+## Pipeline Stages
+
+1. **detect** — auto-detect project type
+2. **install** — install dependencies
+3. **test** — run test suite (skippable)
+4. **build** — run build command
+5. **docker** — build Docker image (skippable)
+6. **artifact** — create artifact.zip + metadata
+7. **storage** — upload to all configured providers (parallel)
+8. **deploy** — deploy to configured targets
+9. **verify** — health check after deployment
+10. **notify** — send Slack/email/webhook notifications
+
+## Author
+
+**Akash Chowdhury**
+📧 akashbumbac24@gmail.com
+💼 [linkedin.com/in/akash-chowdhury-12141a222](https://www.linkedin.com/in/akash-chowdhury-12141a222/)
+
+Built with ❤ — if DeployHub saves you time, feel free to connect on LinkedIn.
+
+## License
+
+MIT

package/install.ps1

@@ -0,0 +1,55 @@
+# DeployHub install script for Windows
+# Author: Akash Chowdhury — canonical source: src/utils/author.js
+# Repository: https://github.com/Akash-Chowdhury-24/DeployHub
+
+$ErrorActionPreference = "Stop"
+
+$GitHubRepo = "Akash-Chowdhury-24/DeployHub"
+$BinaryName = "deployhub.exe"
+
+function Get-LatestVersion {
+    $release = Invoke-RestMethod -Uri "https://api.github.com/repos/$GitHubRepo/releases/latest"
+    return $release.tag_name
+}
+
+function Get-InstallDir {
+    $localBin = Join-Path $env:LOCALAPPDATA "Programs\DeployHub"
+    if (-not (Test-Path $localBin)) {
+        New-Item -ItemType Directory -Path $localBin -Force | Out-Null
+    }
+    return $localBin
+}
+
+function Add-ToPath {
+    param([string]$Dir)
+    $userPath = [Environment]::GetEnvironmentVariable("Path", "User")
+    if ($userPath -notlike "*$Dir*") {
+        [Environment]::SetEnvironmentVariable("Path", "$userPath;$Dir", "User")
+        $env:Path = "$env:Path;$Dir"
+        Write-Host "Added $Dir to user PATH"
+    }
+}
+
+try {
+    $version = Get-LatestVersion
+    $assetName = "deployhub-win.exe"
+    $url = "https://github.com/$GitHubRepo/releases/download/$version/$assetName"
+    $installDir = Get-InstallDir
+    $dest = Join-Path $installDir $BinaryName
+
+    Write-Host "Downloading DeployHub $version for Windows..."
+    Invoke-WebRequest -Uri $url -OutFile $dest -UseBasicParsing
+
+    if (-not (Test-Path $dest) -or (Get-Item $dest).Length -eq 0) {
+        throw "Binary download failed"
+    }
+
+    Add-ToPath $installDir
+    Write-Host "DeployHub $version installed to $dest"
+    & $dest --version
+}
+catch {
+    Write-Host "Binary install failed ($($_.Exception.Message)). Falling back to npm..." -ForegroundColor Yellow
+    npm install -g deployhub@latest
+    Write-Host "DeployHub installed via npm."
+}

package/install.sh

@@ -0,0 +1,99 @@
+#!/bin/sh
+# DeployHub install script
+# Author: Akash Chowdhury — canonical source: src/utils/author.js
+# Repository: https://github.com/Akash-Chowdhury-24/DeployHub
+
+set -e
+
+GITHUB_REPO="Akash-Chowdhury-24/DeployHub"
+INSTALL_DIR="/usr/local/bin"
+BINARY_NAME="deployhub"
+
+detect_platform() {
+  OS="$(uname -s | tr '[:upper:]' '[:lower:]')"
+  ARCH="$(uname -m)"
+
+  case "$OS" in
+    linux)
+      case "$ARCH" in
+        x86_64|amd64) PLATFORM="linux" ;;
+        *) echo "Unsupported Linux architecture: $ARCH" >&2; exit 1 ;;
+      esac
+      ;;
+    darwin)
+      case "$ARCH" in
+        x86_64) PLATFORM="macos" ;;
+        arm64|aarch64) PLATFORM="macos-arm64" ;;
+        *) echo "Unsupported macOS architecture: $ARCH" >&2; exit 1 ;;
+      esac
+      ;;
+    *)
+      echo "Unsupported OS: $OS. Use install.ps1 on Windows." >&2
+      exit 1
+      ;;
+  esac
+}
+
+fetch_latest_version() {
+  if command -v curl >/dev/null 2>&1; then
+    VERSION=$(curl -fsSL "https://api.github.com/repos/${GITHUB_REPO}/releases/latest" \
+      | sed -n 's/.*"tag_name"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p' \
+      | head -n 1)
+  elif command -v wget >/dev/null 2>&1; then
+    VERSION=$(wget -qO- "https://api.github.com/repos/${GITHUB_REPO}/releases/latest" \
+      | sed -n 's/.*"tag_name"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p' \
+      | head -n 1)
+  else
+    echo "curl or wget is required to download DeployHub." >&2
+    exit 1
+  fi
+
+  if [ -z "$VERSION" ]; then
+    echo "Could not determine latest release version. Falling back to npm install." >&2
+    npm install -g deployhub@latest
+    echo "DeployHub installed via npm."
+    exit 0
+  fi
+}
+
+download_binary() {
+  ASSET="deployhub-${PLATFORM}"
+  URL="https://github.com/${GITHUB_REPO}/releases/download/${VERSION}/${ASSET}"
+  TMP="$(mktemp)"
+
+  echo "Downloading DeployHub ${VERSION} (${PLATFORM})..."
+  if command -v curl >/dev/null 2>&1; then
+    curl -fsSL "$URL" -o "$TMP"
+  else
+    wget -qO "$TMP" "$URL"
+  fi
+
+  if [ ! -s "$TMP" ]; then
+    echo "Binary download failed. Falling back to npm install." >&2
+    rm -f "$TMP"
+    npm install -g deployhub@latest
+    echo "DeployHub installed via npm."
+    exit 0
+  fi
+
+  if [ "$(id -u)" -eq 0 ]; then
+    install -m 755 "$TMP" "${INSTALL_DIR}/${BINARY_NAME}"
+  else
+    if command -v sudo >/dev/null 2>&1; then
+      sudo install -m 755 "$TMP" "${INSTALL_DIR}/${BINARY_NAME}"
+    else
+      mkdir -p "${HOME}/.local/bin"
+      install -m 755 "$TMP" "${HOME}/.local/bin/${BINARY_NAME}"
+      echo "Installed to ${HOME}/.local/bin/${BINARY_NAME} — ensure it is on your PATH"
+    fi
+  fi
+
+  rm -f "$TMP"
+}
+
+detect_platform
+fetch_latest_version
+download_binary
+
+echo "DeployHub ${VERSION} installed successfully."
+deployhub --version 2>/dev/null || true

package/package.json

@@ -0,0 +1,86 @@
+{
+  "name": "@akash-chowdhury-24/deployhub",
+  "version": "1.0.0",
+  "description": "Zero-configuration deployment and artifact manager",
+  "type": "module",
+  "main": "./src/cli/index.js",
+  "license": "MIT",
+  "homepage": "https://github.com/Akash-Chowdhury-24/DeployHub#readme",
+  "bugs": {
+    "url": "https://github.com/Akash-Chowdhury-24/DeployHub/issues"
+  },
+  "keywords": [
+    "deploy",
+    "deployment",
+    "ci-cd",
+    "artifacts",
+    "cli",
+    "devops",
+    "automation"
+  ],
+  "files": [
+    "src",
+    "install.sh",
+    "install.ps1",
+    "README.md",
+    "LICENSE"
+  ],
+  "bin": {
+    "deployhub": "src/cli/index.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Akash-Chowdhury-24/DeployHub.git"
+  },
+  "scripts": {
+    "start": "node src/cli/index.js",
+    "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js",
+    "prepublishOnly": "npm test",
+    "build:bundle": "node scripts/build-bundle.mjs",
+    "build:bin": "npm run build:bundle && pkg dist/deployhub.cjs --targets node20-linux-x64,node20-macos-x64,node20-macos-arm64,node20-win-x64 --output dist/deployhub --compress GZip"
+  },
+  "pkg": {
+    "scripts": "dist/deployhub.cjs",
+    "assets": [
+      "node_modules/ssh2/**/*"
+    ],
+    "outputPath": "dist"
+  },
+  "dependencies": {
+    "commander": "^12.0.0",
+    "inquirer": "^9.0.0",
+    "execa": "^8.0.0",
+    "ora": "^8.0.0",
+    "chalk": "^5.0.0",
+    "archiver": "^6.0.0",
+    "fs-extra": "^11.0.0",
+    "js-yaml": "^4.0.0",
+    "axios": "^1.0.0",
+    "zod": "^3.23.0",
+    "@aws-sdk/client-s3": "^3.0.0",
+    "@aws-sdk/lib-storage": "^3.0.0",
+    "@azure/storage-blob": "^12.0.0",
+    "@google-cloud/storage": "^7.0.0",
+    "dropbox": "^10.0.0",
+    "googleapis": "^140.0.0",
+    "ssh2": "^1.0.0",
+    "node-ssh": "^13.0.0",
+    "semver": "^7.0.0",
+    "dotenv": "^16.0.0",
+    "basic-ftp": "^5.0.0",
+    "nodemailer": "^6.9.0"
+  },
+  "devDependencies": {
+    "jest": "^29.0.0",
+    "pkg": "^5.8.1",
+    "esbuild": "^0.21.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "author": {
+    "name": "Akash Chowdhury",
+    "email": "akashbumbac24@gmail.com",
+    "url": "https://www.linkedin.com/in/akash-chowdhury-12141a222/"
+  }
+}

package/src/adapters/dotnet.adapter.js

@@ -0,0 +1,41 @@
+import { execa } from 'execa';
+import fs from 'fs-extra';
+import path from 'path';
+import { createLogger } from '../logger/index.js';
+
+function create(config, cwd) {
+  const log = createLogger('dotnet');
+
+  return {
+    detect() {
+      const files = fs.readdirSync(cwd);
+      return files.some((f) => f.endsWith('.csproj'));
+    },
+
+    async install() {
+      log.info('Restoring .NET packages...');
+      await execa('dotnet', ['restore'], { cwd, stdio: 'inherit' });
+    },
+
+    async test() {
+      await execa('dotnet', ['test'], { cwd, stdio: 'inherit' });
+    },
+
+    async build() {
+      log.info(`Running: ${config.buildCommand}`);
+      const [cmd, ...args] = config.buildCommand.split(' ');
+      await execa(cmd, args, { cwd, stdio: 'inherit', shell: true });
+    },
+
+    async docker() {
+      if (await fs.pathExists(path.join(cwd, 'Dockerfile'))) {
+        await execa('docker', ['build', '-t', `${config.project}:latest`, '.'], {
+          cwd,
+          stdio: 'inherit',
+        });
+      }
+    },
+  };
+}
+
+export default { create };

package/src/adapters/go.adapter.js

@@ -0,0 +1,40 @@
+import { execa } from 'execa';
+import fs from 'fs-extra';
+import path from 'path';
+import { createLogger } from '../logger/index.js';
+
+function create(config, cwd) {
+  const log = createLogger('go');
+
+  return {
+    detect() {
+      return fs.existsSync(path.join(cwd, 'go.mod'));
+    },
+
+    async install() {
+      log.info('Downloading Go modules...');
+      await execa('go', ['mod', 'download'], { cwd, stdio: 'inherit' });
+    },
+
+    async test() {
+      await execa('go', ['test', './...'], { cwd, stdio: 'inherit' });
+    },
+
+    async build() {
+      log.info(`Running: ${config.buildCommand}`);
+      const [cmd, ...args] = config.buildCommand.split(' ');
+      await execa(cmd, args, { cwd, stdio: 'inherit', shell: true });
+    },
+
+    async docker() {
+      if (await fs.pathExists(path.join(cwd, 'Dockerfile'))) {
+        await execa('docker', ['build', '-t', `${config.project}:latest`, '.'], {
+          cwd,
+          stdio: 'inherit',
+        });
+      }
+    },
+  };
+}
+
+export default { create };

package/src/adapters/index.js

@@ -0,0 +1,48 @@
+import nodeAdapter from './node.adapter.js';
+import pythonAdapter from './python.adapter.js';
+import phpAdapter from './php.adapter.js';
+import javaAdapter from './java.adapter.js';
+import goAdapter from './go.adapter.js';
+import dotnetAdapter from './dotnet.adapter.js';
+import railsAdapter from './rails.adapter.js';
+
+/** @type {Record<string, import('./node.adapter.js').default>} */
+const ADAPTERS = {
+  react: nodeAdapter,
+  vue: nodeAdapter,
+  angular: nodeAdapter,
+  nextjs: nodeAdapter,
+  svelte: nodeAdapter,
+  astro: nodeAdapter,
+  vanilla: nodeAdapter,
+  node: nodeAdapter,
+  express: nodeAdapter,
+  nestjs: nodeAdapter,
+  fastify: nodeAdapter,
+  koa: nodeAdapter,
+  python: pythonAdapter,
+  fastapi: pythonAdapter,
+  django: pythonAdapter,
+  flask: pythonAdapter,
+  php: phpAdapter,
+  laravel: phpAdapter,
+  symfony: phpAdapter,
+  java: javaAdapter,
+  spring: javaAdapter,
+  go: goAdapter,
+  dotnet: dotnetAdapter,
+  rails: railsAdapter,
+};
+
+/**
+ * @param {string} framework
+ * @param {import('../core/config.js').DeployHubConfig} config
+ * @param {string} [cwd]
+ * @returns {import('./node.adapter.js').default}
+ */
+export function getAdapter(framework, config, cwd = process.cwd()) {
+  const AdapterClass = ADAPTERS[framework] || nodeAdapter;
+  return AdapterClass.create(config, cwd);
+}
+
+export default { getAdapter };

package/src/adapters/java.adapter.js

@@ -0,0 +1,46 @@
+import { execa } from 'execa';
+import fs from 'fs-extra';
+import path from 'path';
+import { createLogger } from '../logger/index.js';
+
+function create(config, cwd) {
+  const log = createLogger('java');
+
+  return {
+    detect() {
+      return (
+        fs.existsSync(path.join(cwd, 'pom.xml')) ||
+        fs.existsSync(path.join(cwd, 'build.gradle'))
+      );
+    },
+
+    async install() {
+      log.info('Resolving Java dependencies...');
+    },
+
+    async test() {
+      if (fs.existsSync(path.join(cwd, 'pom.xml'))) {
+        await execa('mvn', ['test'], { cwd, stdio: 'inherit' });
+      } else {
+        await execa('./gradlew', ['test'], { cwd, stdio: 'inherit', shell: true });
+      }
+    },
+
+    async build() {
+      log.info(`Running: ${config.buildCommand}`);
+      const [cmd, ...args] = config.buildCommand.split(' ');
+      await execa(cmd, args, { cwd, stdio: 'inherit', shell: true });
+    },
+
+    async docker() {
+      if (await fs.pathExists(path.join(cwd, 'Dockerfile'))) {
+        await execa('docker', ['build', '-t', `${config.project}:latest`, '.'], {
+          cwd,
+          stdio: 'inherit',
+        });
+      }
+    },
+  };
+}
+
+export default { create };

package/src/adapters/node.adapter.js

@@ -0,0 +1,77 @@
+import { execa } from 'execa';
+import fs from 'fs-extra';
+import path from 'path';
+import { createLogger } from '../logger/index.js';
+
+/**
+ * @typedef {Object} LanguageAdapter
+ * @property {function(): boolean} detect
+ * @property {function(): Promise<void>} install
+ * @property {function(): Promise<void>} test
+ * @property {function(): Promise<void>} build
+ * @property {function(): Promise<void>} docker
+ */
+
+/**
+ * @param {import('../core/config.js').DeployHubConfig} config
+ * @param {string} cwd
+ */
+function create(config, cwd) {
+  const log = createLogger('node');
+
+  return {
+    detect() {
+      return fs.existsSync(path.join(cwd, 'package.json'));
+    },
+
+    async install() {
+      log.info('Installing dependencies...');
+      if (fs.existsSync(path.join(cwd, 'package-lock.json'))) {
+        await execa('npm', ['ci'], { cwd, stdio: 'inherit' });
+      } else {
+        await execa('npm', ['install'], { cwd, stdio: 'inherit' });
+      }
+    },
+
+    async test() {
+      const pkg = await fs.readJson(path.join(cwd, 'package.json'));
+      if (!pkg.scripts?.test) {
+        log.warn('No test script found, skipping');
+        return;
+      }
+      log.info('Running tests...');
+      await execa('npm', ['test'], { cwd, stdio: 'inherit' });
+    },
+
+    async build() {
+      const buildCommand =
+        config.buildCommand ||
+        (config.projectType === 'both' ? config.frontend?.buildCommand : null) ||
+        (config.projectType === 'backend' ? config.backend?.buildCommand : null);
+
+      if (!buildCommand) {
+        log.info('No build command configured, skipping');
+        return;
+      }
+
+      log.info(`Running build: ${buildCommand}`);
+      const [cmd, ...args] = buildCommand.split(' ');
+      await execa(cmd, args, { cwd, stdio: 'inherit', shell: true });
+    },
+
+    async docker() {
+      if (!(await fs.pathExists(path.join(cwd, 'Dockerfile')))) {
+        log.warn('No Dockerfile found, skipping docker build');
+        return;
+      }
+      log.info('Building Docker image...');
+      const imageName = `${config.project}:latest`;
+      await execa('docker', ['build', '-t', imageName, '.'], {
+        cwd,
+        stdio: 'inherit',
+      });
+    },
+  };
+}
+
+export default { create };