@cloak-db/app 0.1.0

package/dist/cli.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli.js

@@ -0,0 +1,130 @@
+#!/usr/bin/env node
+
+// src/cli.ts
+import { spawn, execSync } from "child_process";
+import { parseArgs } from "util";
+var IMAGE_NAME = "ghcr.io/cloak-db/app";
+var DEFAULT_PORT = 3e3;
+function printHelp() {
+  console.log(`
+Cloak DB - Local-first database studio
+
+Usage: cloak-app [options]
+
+Options:
+  -p, --port <port>     Port to run on (default: ${DEFAULT_PORT})
+  -v, --version <tag>   Docker image version/tag (default: latest)
+  -h, --help            Show this help message
+
+Examples:
+  cloak-app                    # Run on port ${DEFAULT_PORT}
+  cloak-app --port 8080        # Run on port 8080
+  cloak-app --version v0.2.0   # Run specific version
+
+Requirements:
+  Docker must be installed and running.
+  Install from https://docker.com
+`);
+}
+function parseCliArgs() {
+  try {
+    const { values } = parseArgs({
+      options: {
+        port: { type: "string", short: "p", default: String(DEFAULT_PORT) },
+        version: { type: "string", short: "v", default: "latest" },
+        help: { type: "boolean", short: "h", default: false }
+      },
+      allowPositionals: false
+    });
+    return {
+      port: parseInt(values.port, 10),
+      version: values.version,
+      help: values.help
+    };
+  } catch {
+    console.error("Error parsing arguments. Use --help for usage information.");
+    process.exit(1);
+  }
+}
+function checkDocker() {
+  try {
+    execSync("docker --version", { stdio: "ignore" });
+    return true;
+  } catch {
+    return false;
+  }
+}
+function checkDockerRunning() {
+  try {
+    execSync("docker info", { stdio: "ignore" });
+    return true;
+  } catch {
+    return false;
+  }
+}
+function runContainer(options) {
+  const image = `${IMAGE_NAME}:${options.version}`;
+  const containerName = `cloak-app-${Date.now()}`;
+  console.log(`
+\u{1F680} Starting Cloak DB on port ${options.port}...`);
+  console.log(`   Image: ${image}
+`);
+  const dockerProcess = spawn(
+    "docker",
+    [
+      "run",
+      "--rm",
+      "--name",
+      containerName,
+      "-p",
+      `${options.port}:3000`,
+      image
+    ],
+    { stdio: "inherit" }
+  );
+  const cleanup = () => {
+    console.log("\n\n\u{1F6D1} Stopping Cloak DB...");
+    try {
+      execSync(`docker stop ${containerName}`, { stdio: "ignore" });
+    } catch {
+    }
+  };
+  process.on("SIGINT", cleanup);
+  process.on("SIGTERM", cleanup);
+  dockerProcess.on("error", (err) => {
+    console.error(`Failed to start container: ${err.message}`);
+    process.exit(1);
+  });
+  dockerProcess.on("close", (code) => {
+    process.exit(code ?? 0);
+  });
+}
+function main() {
+  const options = parseCliArgs();
+  if (options.help) {
+    printHelp();
+    process.exit(0);
+  }
+  if (!checkDocker()) {
+    console.error(`
+\u274C Docker is required to run Cloak DB.
+
+Install Docker from: https://docker.com
+`);
+    process.exit(1);
+  }
+  if (!checkDockerRunning()) {
+    console.error(`
+\u274C Docker is installed but not running.
+
+Please start Docker Desktop or the Docker daemon.
+`);
+    process.exit(1);
+  }
+  if (isNaN(options.port) || options.port < 1 || options.port > 65535) {
+    console.error(`\u274C Invalid port: ${options.port}. Must be between 1 and 65535.`);
+    process.exit(1);
+  }
+  runContainer(options);
+}
+main();

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@cloak-db/app",
+  "version": "0.1.0",
+  "description": "Run Cloak DB locally with Docker",
+  "type": "module",
+  "bin": {
+    "cloak-app": "./dist/cli.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup src/cli.ts --format esm --dts",
+    "dev": "tsup src/cli.ts --format esm --watch",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "pnpm build"
+  },
+  "keywords": [
+    "cloak-db",
+    "database",
+    "postgres",
+    "docker",
+    "cli"
+  ],
+  "author": "Cloak DB",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/cloak-db/cloak-db.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://cloak-db.com",
+  "engines": {
+    "node": ">=18"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.9.2"
+  }
+}