@argus-vrt/web 0.1.0 → 0.1.1

package/dist-cli/index.js

@@ -0,0 +1,482 @@
+#!/usr/bin/env node
+
+// cli/index.ts
+import { Command } from "commander";
+
+// cli/commands/init.ts
+import * as p from "@clack/prompts";
+import chalk from "chalk";
+import { existsSync as existsSync2, mkdirSync, writeFileSync } from "fs";
+import { resolve as resolve2 } from "path";
+
+// cli/utils/config.ts
+import { existsSync } from "fs";
+import { resolve } from "path";
+var DOCKER_IMAGE = "ghcr.io/maxcwolf/argus-web";
+var DEFAULT_DIR = "./argus";
+var DEFAULT_PORT = 3e3;
+var DEFAULT_DB_PASSWORD = "argus";
+var DEFAULT_SCREENSHOTS_PATH = "./argus-data/images";
+function findArgusDir(dir) {
+  const target = dir ? resolve(dir) : resolve(process.cwd(), DEFAULT_DIR);
+  if (!existsSync(resolve(target, "docker-compose.yml"))) {
+    throw new Error(
+      `No docker-compose.yml found in ${target}.
+Run 'argus-web init' first to set up Argus.`
+    );
+  }
+  return target;
+}
+
+// cli/templates/docker-compose.ts
+function generateDockerCompose(options) {
+  const lines = [];
+  lines.push("services:");
+  lines.push("  web:");
+  lines.push(`    image: ${DOCKER_IMAGE}:latest`);
+  lines.push("    container_name: argus-web");
+  if (!options.includeNginx) {
+    lines.push("    ports:");
+    lines.push(`      - "\${PORT:-${options.port}}:3000"`);
+  } else {
+    lines.push("    expose:");
+    lines.push('      - "3000"');
+  }
+  lines.push("    environment:");
+  if (options.includeDb) {
+    lines.push(
+      "      - DATABASE_URL=postgresql://argus:${DB_PASSWORD:-argus}@db:5432/argus"
+    );
+  } else {
+    lines.push("      - DATABASE_URL=${DATABASE_URL}");
+  }
+  lines.push("      - NODE_ENV=production");
+  if (options.includeDb) {
+    lines.push("    depends_on:");
+    lines.push("      db:");
+    lines.push("        condition: service_healthy");
+  }
+  lines.push("    volumes:");
+  lines.push(
+    `      - \${SCREENSHOTS_PATH:-${options.screenshotsPath}}:/screenshots:ro`
+  );
+  lines.push("    restart: unless-stopped");
+  if (options.includeDb) {
+    lines.push("");
+    lines.push("  db:");
+    lines.push("    image: postgres:16-alpine");
+    lines.push("    container_name: argus-db");
+    lines.push("    environment:");
+    lines.push("      POSTGRES_USER: argus");
+    lines.push("      POSTGRES_PASSWORD: ${DB_PASSWORD:-argus}");
+    lines.push("      POSTGRES_DB: argus");
+    lines.push("    volumes:");
+    lines.push("      - postgres_data:/var/lib/postgresql/data");
+    lines.push("    healthcheck:");
+    lines.push('      test: ["CMD-SHELL", "pg_isready -U argus"]');
+    lines.push("      interval: 5s");
+    lines.push("      timeout: 5s");
+    lines.push("      retries: 5");
+    lines.push("    restart: unless-stopped");
+  }
+  if (options.includeNginx) {
+    lines.push("");
+    lines.push("  nginx:");
+    lines.push("    image: nginx:alpine");
+    lines.push("    container_name: argus-nginx");
+    lines.push("    ports:");
+    lines.push(`      - "\${PORT:-${options.port}}:80"`);
+    if (options.https !== "none") {
+      lines.push('      - "443:443"');
+    }
+    lines.push("    volumes:");
+    lines.push("      - ./nginx.conf:/etc/nginx/conf.d/default.conf:ro");
+    if (options.https === "letsencrypt") {
+      lines.push("      - certbot_data:/etc/letsencrypt:ro");
+      lines.push("      - certbot_www:/var/www/certbot:ro");
+    } else if (options.https === "custom") {
+      lines.push("      - ./certs:/etc/nginx/certs:ro");
+    }
+    lines.push("    depends_on:");
+    lines.push("      - web");
+    lines.push("    restart: unless-stopped");
+    if (options.https === "letsencrypt") {
+      lines.push("");
+      lines.push("  certbot:");
+      lines.push("    image: certbot/certbot");
+      lines.push("    container_name: argus-certbot");
+      lines.push("    volumes:");
+      lines.push("      - certbot_data:/etc/letsencrypt");
+      lines.push("      - certbot_www:/var/www/certbot");
+      lines.push(
+        "    entrypoint: /bin/sh -c 'trap exit TERM; while :; do certbot renew; sleep 12h & wait $${!}; done'"
+      );
+    }
+  }
+  const volumes = [];
+  if (options.includeDb) volumes.push("  postgres_data:");
+  if (options.https === "letsencrypt") {
+    volumes.push("  certbot_data:");
+    volumes.push("  certbot_www:");
+  }
+  if (volumes.length > 0) {
+    lines.push("");
+    lines.push("volumes:");
+    lines.push(...volumes);
+  }
+  return lines.join("\n") + "\n";
+}
+
+// cli/templates/env.ts
+function generateEnv(options) {
+  const lines = [];
+  lines.push("# Argus Web Dashboard Configuration");
+  lines.push("# Generated by argus-web init");
+  lines.push("");
+  lines.push("# Server port");
+  lines.push(`PORT=${options.port}`);
+  lines.push("");
+  if (options.includeDb) {
+    lines.push("# Database password (used by both PostgreSQL container and web app)");
+    lines.push(`DB_PASSWORD=${options.dbPassword}`);
+  } else {
+    lines.push("# PostgreSQL connection string");
+    lines.push(`DATABASE_URL=${options.dbConnectionString || "postgresql://user:password@host:5432/argus"}`);
+  }
+  lines.push("");
+  lines.push("# Path to screenshots directory (mounted read-only into the container)");
+  lines.push(`SCREENSHOTS_PATH=${options.screenshotsPath}`);
+  lines.push("");
+  return lines.join("\n");
+}
+
+// cli/templates/nginx.ts
+function generateNginxConf(options) {
+  const lines = [];
+  if (options.https !== "none") {
+    lines.push("server {");
+    lines.push("    listen 80;");
+    lines.push(`    server_name ${options.domain};`);
+    lines.push("");
+    if (options.https === "letsencrypt") {
+      lines.push("    location /.well-known/acme-challenge/ {");
+      lines.push("        root /var/www/certbot;");
+      lines.push("    }");
+      lines.push("");
+    }
+    lines.push("    location / {");
+    lines.push("        return 301 https://$server_name$request_uri;");
+    lines.push("    }");
+    lines.push("}");
+    lines.push("");
+    lines.push("server {");
+    lines.push("    listen 443 ssl http2;");
+    lines.push(`    server_name ${options.domain};`);
+    lines.push("");
+    if (options.https === "letsencrypt") {
+      lines.push(`    ssl_certificate /etc/letsencrypt/live/${options.domain}/fullchain.pem;`);
+      lines.push(`    ssl_certificate_key /etc/letsencrypt/live/${options.domain}/privkey.pem;`);
+    } else {
+      lines.push("    ssl_certificate /etc/nginx/certs/fullchain.pem;");
+      lines.push("    ssl_certificate_key /etc/nginx/certs/privkey.pem;");
+    }
+    lines.push("");
+    lines.push("    # SSL settings");
+    lines.push("    ssl_protocols TLSv1.2 TLSv1.3;");
+    lines.push("    ssl_prefer_server_ciphers off;");
+    lines.push("");
+  } else {
+    lines.push("server {");
+    lines.push("    listen 80;");
+    lines.push(`    server_name ${options.domain};`);
+    lines.push("");
+  }
+  lines.push("    client_max_body_size 50M;");
+  lines.push("");
+  lines.push("    location / {");
+  lines.push("        proxy_pass http://web:3000;");
+  lines.push("        proxy_http_version 1.1;");
+  lines.push("        proxy_set_header Upgrade $http_upgrade;");
+  lines.push("        proxy_set_header Connection 'upgrade';");
+  lines.push("        proxy_set_header Host $host;");
+  lines.push("        proxy_set_header X-Real-IP $remote_addr;");
+  lines.push("        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;");
+  lines.push("        proxy_set_header X-Forwarded-Proto $scheme;");
+  lines.push("        proxy_cache_bypass $http_upgrade;");
+  lines.push("    }");
+  lines.push("}");
+  return lines.join("\n") + "\n";
+}
+
+// cli/utils/docker.ts
+import { execa } from "execa";
+async function isDockerInstalled() {
+  try {
+    await execa("docker", ["--version"]);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function isDockerRunning() {
+  try {
+    await execa("docker", ["info"], { stdio: "ignore" });
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function dockerCompose(args, cwd, options) {
+  return execa("docker", ["compose", ...args], {
+    cwd,
+    stdio: "inherit",
+    ...options
+  });
+}
+async function ensureDocker() {
+  if (!await isDockerInstalled()) {
+    throw new Error(
+      "Docker is not installed. Please install Docker first:\nhttps://docs.docker.com/get-docker/"
+    );
+  }
+  if (!await isDockerRunning()) {
+    throw new Error(
+      "Docker is not running. Please start Docker Desktop or the Docker daemon."
+    );
+  }
+}
+
+// cli/commands/init.ts
+async function initCommand(options) {
+  p.intro(chalk.bold("Argus Web Dashboard Setup"));
+  const outputDir = resolve2(options.dir || DEFAULT_DIR);
+  if (existsSync2(resolve2(outputDir, "docker-compose.yml"))) {
+    const overwrite = await p.confirm({
+      message: `Configuration already exists in ${outputDir}. Overwrite?`,
+      initialValue: false
+    });
+    if (p.isCancel(overwrite) || !overwrite) {
+      p.cancel("Setup cancelled.");
+      process.exit(0);
+    }
+  }
+  const hasDocker = await isDockerInstalled();
+  if (!hasDocker) {
+    p.log.warn(
+      "Docker is not installed. You can still generate config files, but you'll need Docker to run Argus."
+    );
+  }
+  const answers = await p.group(
+    {
+      deployMethod: () => p.select({
+        message: "Deployment method",
+        options: [
+          { value: "compose", label: "Docker Compose", hint: "recommended" },
+          { value: "manual", label: "Config files only", hint: "generate files without starting" }
+        ]
+      }),
+      includeDb: () => p.select({
+        message: "PostgreSQL setup",
+        options: [
+          { value: true, label: "Include PostgreSQL container", hint: "recommended" },
+          { value: false, label: "External PostgreSQL", hint: "enter connection string" }
+        ]
+      }),
+      dbConnectionString: ({ results }) => {
+        if (results.includeDb) return Promise.resolve(void 0);
+        return p.text({
+          message: "PostgreSQL connection string",
+          placeholder: "postgresql://user:password@host:5432/argus",
+          validate: (value) => {
+            if (!value) return "Connection string is required";
+            if (!value.startsWith("postgresql://") && !value.startsWith("postgres://")) {
+              return "Must start with postgresql:// or postgres://";
+            }
+          }
+        });
+      },
+      dbPassword: ({ results }) => {
+        if (!results.includeDb) return Promise.resolve(DEFAULT_DB_PASSWORD);
+        return p.text({
+          message: "Database password",
+          defaultValue: DEFAULT_DB_PASSWORD,
+          placeholder: DEFAULT_DB_PASSWORD
+        });
+      },
+      port: () => p.text({
+        message: "Port",
+        defaultValue: String(DEFAULT_PORT),
+        placeholder: String(DEFAULT_PORT),
+        validate: (value) => {
+          const num = parseInt(value, 10);
+          if (isNaN(num) || num < 1 || num > 65535) return "Must be a valid port (1-65535)";
+        }
+      }),
+      domain: () => p.text({
+        message: "Domain (leave empty for localhost)",
+        placeholder: "argus.yourcompany.com"
+      }),
+      https: ({ results }) => {
+        if (!results.domain) return Promise.resolve("none");
+        return p.select({
+          message: "HTTPS configuration",
+          options: [
+            { value: "letsencrypt", label: "Let's Encrypt", hint: "automatic certificates" },
+            { value: "custom", label: "Custom certificate", hint: "provide your own certs" },
+            { value: "none", label: "No HTTPS", hint: "HTTP only" }
+          ]
+        });
+      },
+      includeNginx: ({ results }) => {
+        if (!results.domain) return Promise.resolve(false);
+        return p.select({
+          message: "Reverse proxy",
+          options: [
+            { value: true, label: "Include Nginx container", hint: "recommended with domain" },
+            { value: false, label: "No reverse proxy", hint: "you manage this yourself" }
+          ]
+        });
+      },
+      screenshotsPath: () => p.text({
+        message: "Screenshots storage path",
+        defaultValue: DEFAULT_SCREENSHOTS_PATH,
+        placeholder: DEFAULT_SCREENSHOTS_PATH
+      })
+    },
+    {
+      onCancel: () => {
+        p.cancel("Setup cancelled.");
+        process.exit(0);
+      }
+    }
+  );
+  const s = p.spinner();
+  s.start("Generating configuration files");
+  mkdirSync(outputDir, { recursive: true });
+  const port = parseInt(answers.port, 10) || DEFAULT_PORT;
+  const composeOptions = {
+    port,
+    includeDb: answers.includeDb,
+    dbConnectionString: answers.dbConnectionString,
+    dbPassword: answers.dbPassword || DEFAULT_DB_PASSWORD,
+    includeNginx: answers.includeNginx,
+    domain: answers.domain,
+    https: answers.https,
+    screenshotsPath: answers.screenshotsPath || DEFAULT_SCREENSHOTS_PATH
+  };
+  writeFileSync(
+    resolve2(outputDir, "docker-compose.yml"),
+    generateDockerCompose(composeOptions)
+  );
+  const envOptions = {
+    port,
+    includeDb: answers.includeDb,
+    dbConnectionString: answers.dbConnectionString,
+    dbPassword: answers.dbPassword || DEFAULT_DB_PASSWORD,
+    screenshotsPath: answers.screenshotsPath || DEFAULT_SCREENSHOTS_PATH
+  };
+  writeFileSync(resolve2(outputDir, ".env"), generateEnv(envOptions));
+  if (answers.includeNginx && answers.domain) {
+    writeFileSync(
+      resolve2(outputDir, "nginx.conf"),
+      generateNginxConf({
+        domain: answers.domain,
+        https: answers.https
+      })
+    );
+  }
+  s.stop("Configuration files generated");
+  p.note(
+    [
+      `${chalk.dim("Directory:")}  ${outputDir}`,
+      `${chalk.dim("Files:")}      docker-compose.yml, .env${answers.includeNginx ? ", nginx.conf" : ""}`,
+      "",
+      `${chalk.dim("Next steps:")}`,
+      `  cd ${options.dir || DEFAULT_DIR}`,
+      "  argus-web start"
+    ].join("\n"),
+    "Setup complete"
+  );
+  if (answers.https === "letsencrypt" && answers.domain) {
+    p.log.info(
+      `Run this to obtain your initial SSL certificate:
+  docker compose run --rm certbot certonly --webroot -w /var/www/certbot -d ${answers.domain}`
+    );
+  }
+  p.outro(chalk.green("Happy testing!"));
+}
+
+// cli/commands/start.ts
+import chalk2 from "chalk";
+async function startCommand(options) {
+  const cwd = findArgusDir(options.dir);
+  await ensureDocker();
+  console.log(chalk2.blue("Starting Argus..."));
+  await dockerCompose(["up", "-d"], cwd);
+  console.log(chalk2.green("Argus is running."));
+}
+
+// cli/commands/stop.ts
+import chalk3 from "chalk";
+async function stopCommand(options) {
+  const cwd = findArgusDir(options.dir);
+  await ensureDocker();
+  console.log(chalk3.blue("Stopping Argus..."));
+  await dockerCompose(["down"], cwd);
+  console.log(chalk3.green("Argus stopped."));
+}
+
+// cli/commands/logs.ts
+async function logsCommand(options) {
+  const cwd = findArgusDir(options.dir);
+  await ensureDocker();
+  const args = ["logs", "-f"];
+  if (options.service) {
+    args.push(options.service);
+  }
+  await dockerCompose(args, cwd);
+}
+
+// cli/commands/status.ts
+import chalk4 from "chalk";
+async function statusCommand(options) {
+  const cwd = findArgusDir(options.dir);
+  await ensureDocker();
+  console.log(chalk4.blue("Argus status:\n"));
+  await dockerCompose(["ps"], cwd);
+  try {
+    const result = await dockerCompose(
+      ["exec", "web", "wget", "--spider", "--quiet", "http://localhost:3000"],
+      cwd,
+      { stdio: "pipe" }
+    );
+    if (result.exitCode === 0) {
+      console.log(chalk4.green("\nWeb dashboard is healthy."));
+    }
+  } catch {
+    console.log(chalk4.yellow("\nWeb dashboard health check failed \u2014 container may still be starting."));
+  }
+}
+
+// cli/commands/upgrade.ts
+import chalk5 from "chalk";
+async function upgradeCommand(options) {
+  const cwd = findArgusDir(options.dir);
+  await ensureDocker();
+  console.log(chalk5.blue("Pulling latest images..."));
+  await dockerCompose(["pull"], cwd);
+  console.log(chalk5.blue("Restarting with new images..."));
+  await dockerCompose(["up", "-d"], cwd);
+  console.log(chalk5.green("Argus upgraded successfully."));
+}
+
+// cli/index.ts
+var program = new Command();
+program.name("argus-web").description("Set up and manage the Argus web dashboard").version("0.1.0");
+program.command("init").description("Interactive setup wizard \u2014 generates docker-compose.yml, .env, and nginx.conf").option("-d, --dir <path>", "Output directory", "./argus").action(initCommand);
+program.command("start").description("Start Argus (docker compose up -d)").option("-d, --dir <path>", "Argus directory").action(startCommand);
+program.command("stop").description("Stop Argus (docker compose down)").option("-d, --dir <path>", "Argus directory").action(stopCommand);
+program.command("logs").description("View logs (docker compose logs -f)").option("-d, --dir <path>", "Argus directory").option("-s, --service <name>", "Service name (web, db, nginx)").action(logsCommand);
+program.command("status").description("Check container status and health").option("-d, --dir <path>", "Argus directory").action(statusCommand);
+program.command("upgrade").description("Pull latest images and restart").option("-d, --dir <path>", "Argus directory").action(upgradeCommand);
+program.parse();

package/package.json

@@ -1,8 +1,14 @@
 {
   "name": "@argus-vrt/web",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "license": "MIT",
   "type": "module",
+  "bin": {
+    "argus-web": "./dist-cli/index.js"
+  },
+  "files": [
+    "dist-cli/"
+  ],
   "repository": {
     "type": "git",
     "url": "https://github.com/maxcwolf/argus.git",
@@ -13,7 +19,8 @@
   },
   "scripts": {
     "dev": "vite dev --port 3000",
-    "build": "vite build",
+    "build": "vite build && tsup --config tsup.cli.config.ts",
+    "build:cli": "tsup --config tsup.cli.config.ts",
     "preview": "vite preview",
     "test": "vitest run",
     "db:generate": "drizzle-kit generate",
@@ -24,36 +31,41 @@
     "docker:down": "docker compose down"
   },
   "dependencies": {
+    "@clack/prompts": "^0.10.0",
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "execa": "^9.5.0"
+  },
+  "devDependencies": {
     "@paralleldrive/cuid2": "^3.3.0",
     "@tailwindcss/vite": "^4.0.6",
+    "@tanstack/devtools-vite": "^0.3.11",
     "@tanstack/react-devtools": "^0.7.0",
     "@tanstack/react-router": "^1.132.0",
     "@tanstack/react-router-devtools": "^1.132.0",
     "@tanstack/react-router-ssr-query": "^1.131.7",
     "@tanstack/react-start": "^1.132.0",
     "@tanstack/router-plugin": "^1.132.0",
-    "clsx": "^2.1.1",
-    "drizzle-orm": "^0.45.1",
-    "lucide-react": "^0.561.0",
-    "postgres": "^3.4.8",
-    "react": "^19.2.0",
-    "react-dom": "^19.2.0",
-    "tailwind-merge": "^2.6.0",
-    "tailwindcss": "^4.0.6",
-    "vite-tsconfig-paths": "^6.0.2"
-  },
-  "devDependencies": {
-    "@tanstack/devtools-vite": "^0.3.11",
     "@testing-library/dom": "^10.4.0",
     "@testing-library/react": "^16.2.0",
     "@types/node": "^22.10.2",
     "@types/react": "^19.2.0",
     "@types/react-dom": "^19.2.0",
     "@vitejs/plugin-react": "^5.0.4",
+    "clsx": "^2.1.1",
     "drizzle-kit": "^0.31.8",
+    "drizzle-orm": "^0.45.1",
     "jsdom": "^27.0.0",
+    "lucide-react": "^0.561.0",
+    "postgres": "^3.4.8",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0",
+    "tailwind-merge": "^2.6.0",
+    "tailwindcss": "^4.0.6",
+    "tsup": "^8.0.0",
     "typescript": "^5.7.2",
     "vite": "^7.1.7",
+    "vite-tsconfig-paths": "^6.0.2",
     "vitest": "^3.0.5",
     "web-vitals": "^5.1.0"
   }

package/.cta.json

@@ -1,15 +0,0 @@
-{
-  "projectName": "web",
-  "mode": "file-router",
-  "typescript": true,
-  "tailwind": true,
-  "packageManager": "yarn",
-  "git": false,
-  "install": true,
-  "addOnOptions": {},
-  "version": 1,
-  "framework": "react-cra",
-  "chosenAddOns": [
-    "start"
-  ]
-}