dotenvx-tui 2.0.0

package/README.md

@@ -0,0 +1,54 @@
+# dotenvx-tui
+
+Full-screen terminal UI for managing [dotenvx](https://dotenvx.com)-encrypted environment variables.
+
+```
+┌─ Scopes ────┐ ┌─ Envs ───┐ ┌─ Keys ──────────────┐
+│ > apps/api  │ │ > local  │ │ [x] DATABASE_URL    │
+│   apps/web  │ │   staging│ │ [ ] API_KEY         │
+│   pkg/db    │ │   prod   │ │ [x] REDIS_URL       │
+└─────────────┘ └──────────┘ └─────────────────────┘
+┌─ Preview ────────────────────────────────────────┐
+│ DATABASE_URL = post••••••••••••••••••            │
+└──────────────────────────────────────────────────┘
+ s:set  g:get  d:diff  i:import  e:export  c:copy
+```
+
+## Install
+
+```bash
+npm install -g dotenvx-tui
+```
+
+## Usage
+
+```bash
+# Run in current directory (must have dotenvx-encrypted .env.* files)
+dotenvx-tui
+
+# Or specify a project directory
+dotenvx-tui ~/my-project
+
+# Or run without installing
+npx dotenvx-tui
+```
+
+## Prerequisites
+
+[dotenvx](https://dotenvx.com) must be installed: `brew install dotenvx/brew/dotenvx`
+
+## Features
+
+- Three-panel browser (Scopes | Environments | Keys)
+- Keyboard-driven navigation with circular wrapping
+- Multi-select batch operations
+- Set, get, diff, import, export, and copy to clipboard
+- Live file watching (auto-refresh on changes)
+- Masked value preview with auto-mask timer
+- Memory-safe secret handling
+
+Full documentation: [github.com/warui1/dotenvx-tui](https://github.com/warui1/dotenvx-tui)
+
+## License
+
+MIT

package/bin/cli.js

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+
+const { spawn } = require("child_process");
+const path = require("path");
+const fs = require("fs");
+
+const NAME = "dotenvx-tui";
+const binPath = path.join(__dirname, NAME);
+
+if (!fs.existsSync(binPath)) {
+  console.error(
+    `${NAME} binary not found. Try reinstalling:\n` +
+      `  npm install -g dotenvx-tui`
+  );
+  process.exit(1);
+}
+
+const child = spawn(binPath, process.argv.slice(2), {
+  stdio: "inherit",
+});
+
+child.on("error", (err) => {
+  console.error(`Failed to start ${NAME}: ${err.message}`);
+  process.exit(1);
+});
+
+child.on("close", (code) => {
+  process.exit(code ?? 1);
+});

package/install.js

@@ -0,0 +1,100 @@
+#!/usr/bin/env node
+
+// Postinstall script: downloads the correct binary from GitHub Releases.
+// No external dependencies — uses Node.js built-in https/fs/child_process.
+
+const https = require("https");
+const fs = require("fs");
+const path = require("path");
+const { execSync } = require("child_process");
+const { createGunzip } = require("zlib");
+
+const REPO = "SpyrosBou/dotenvx-tui";
+const NAME = "dotenvx-tui";
+const VERSION = require("./package.json").version;
+
+const PLATFORM_MAP = {
+  darwin: "darwin",
+  linux: "linux",
+};
+
+const ARCH_MAP = {
+  x64: "amd64",
+  arm64: "arm64",
+};
+
+function getTarget() {
+  const platform = PLATFORM_MAP[process.platform];
+  const arch = ARCH_MAP[process.arch];
+
+  if (!platform || !arch) {
+    console.error(
+      `Unsupported platform: ${process.platform}-${process.arch}\n` +
+        `Supported: darwin-arm64, darwin-x64, linux-arm64, linux-x64\n` +
+        `Build from source: go install github.com/${REPO}@latest`
+    );
+    process.exit(1);
+  }
+
+  return { platform, arch };
+}
+
+function downloadFile(url) {
+  return new Promise((resolve, reject) => {
+    https
+      .get(url, (res) => {
+        if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+          return downloadFile(res.headers.location).then(resolve, reject);
+        }
+        if (res.statusCode !== 200) {
+          return reject(new Error(`Download failed: HTTP ${res.statusCode}`));
+        }
+        const chunks = [];
+        res.on("data", (chunk) => chunks.push(chunk));
+        res.on("end", () => resolve(Buffer.concat(chunks)));
+        res.on("error", reject);
+      })
+      .on("error", reject);
+  });
+}
+
+function extractTarGz(buffer, destDir) {
+  // Write to temp file and use system tar (available on macOS + Linux)
+  const tmpFile = path.join(destDir, "_archive.tar.gz");
+  fs.writeFileSync(tmpFile, buffer);
+  execSync(`tar -xzf "${tmpFile}" -C "${destDir}" "${NAME}"`, { stdio: "ignore" });
+  fs.unlinkSync(tmpFile);
+}
+
+async function main() {
+  const { platform, arch } = getTarget();
+  const archiveName = `${NAME}_${VERSION}_${platform}_${arch}.tar.gz`;
+  const url = `https://github.com/${REPO}/releases/download/v${VERSION}/${archiveName}`;
+  const binDir = path.join(__dirname, "bin");
+
+  // Skip if binary already exists
+  const binPath = path.join(binDir, NAME);
+  if (fs.existsSync(binPath)) {
+    return;
+  }
+
+  console.log(`Downloading ${NAME} v${VERSION} for ${platform}/${arch}...`);
+
+  try {
+    const buffer = await downloadFile(url);
+    fs.mkdirSync(binDir, { recursive: true });
+    extractTarGz(buffer, binDir);
+    fs.chmodSync(binPath, 0o755);
+    console.log(`Installed ${NAME} to ${binPath}`);
+  } catch (err) {
+    console.error(
+      `Failed to download ${NAME}: ${err.message}\n\n` +
+        `You can install manually:\n` +
+        `  go install github.com/${REPO}@latest\n` +
+        `  # or download from: https://github.com/${REPO}/releases`
+    );
+    process.exit(1);
+  }
+}
+
+main();

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "dotenvx-tui",
+  "version": "2.0.0",
+  "description": "Full-screen terminal UI for managing dotenvx-encrypted environment variables",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/warui1/dotenvx-tui.git"
+  },
+  "license": "MIT",
+  "author": "warui1",
+  "bin": {
+    "dotenvx-tui": "bin/cli.js"
+  },
+  "scripts": {
+    "postinstall": "node install.js"
+  },
+  "files": [
+    "bin/cli.js",
+    "install.js"
+  ],
+  "keywords": [
+    "dotenvx",
+    "dotenv",
+    "env",
+    "secrets",
+    "tui",
+    "terminal",
+    "encryption"
+  ],
+  "engines": {
+    "node": ">=16"
+  }
+}