dotsnap 1.0.0

package/.env

@@ -0,0 +1,11 @@
+# Production Environment
+TIMOTHY_KEY=sk-live-1234567890abcdef
+ABIGAIL_PASSWORD=myPassword123
+STRIPE_SECRET_KEY=sk_test_51ABC123xyz789
+DATABASE_URL=postgresql://user:pass@localhost:5432/db
+JWT_SECRET=super-secret-jwt-token-12345
+
+# AWS Configuration
+AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
+AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
+NEXT_PUBLIC_APP_URL=https://myapp.com

package/.env.safe

@@ -0,0 +1,11 @@
+# Production Environment
+TIMOTHY_KEY=sk-*****************cdef
+ABIGAIL_PASSWORD=myP******d123
+STRIPE_SECRET_KEY=sk_***************z789
+DATABASE_URL=pos*********************************2/db
+JWT_SECRET=sup*********************2345
+
+# AWS Configuration
+AWS_ACCESS_KEY_ID=AKI*************MPLE
+AWS_SECRET_ACCESS_KEY=wJa*********************************EKEY
+NEXT_PUBLIC_APP_URL=htt**********.com

package/README.md

@@ -0,0 +1,105 @@
+# DotSnap CLI
+
+Mask your .env files securely - from the command line.
+
+## Installation
+
+### Global Installation
+
+```bash
+npm install -g dotsnap
+```
+
+### NPX (No Installation)
+
+```bash
+npx dotsnap mask
+```
+
+## Usage
+
+### Mask your .env file
+
+```bash
+dotsnap mask
+```
+
+This will:
+
+- Read your `.env` file
+- Mask all secret values
+- Save to `.env.safe`
+
+### Custom input/output
+
+```bash
+dotsnap mask -i .env.production -o .env.production.safe
+```
+
+### Fully hide values
+
+```bash
+dotsnap mask --fully-hide
+```
+
+### Open Web UI
+
+```bash
+dotsnap web
+```
+
+## Options
+
+### `dotsnap mask`
+
+| Option                | Description                 | Default          |
+| --------------------- | --------------------------- | ---------------- |
+| `-i, --input <file>`  | Input .env file             | `.env`           |
+| `-o, --output <file>` | Output file                 | `.env.safe`      |
+| `--fully-hide`        | Hide all values completely  | `false`          |
+| `--no-first-last`     | Don't show first/last chars | Shows by default |
+
+### `dotsnap web`
+
+| Option              | Description    | Default |
+| ------------------- | -------------- | ------- |
+| `-p, --port <port>` | Port to run on | `3000`  |
+
+## Examples
+
+```bash
+# Basic usage
+dotsnap mask
+
+# Custom files
+dotsnap mask -i .env.prod -o .env.prod.safe
+
+# Fully hide all values
+dotsnap mask --fully-hide
+
+# Open web UI
+dotsnap web
+```
+
+## Security
+
+- 100% local processing
+- No network requests
+- No data collection
+- Open source
+
+## License
+
+MIT
+
+```
+
+# cli/.npmignore
+```
+
+node_modules/
+\*.log
+.DS_Store
+test/
+.git/
+.github/

package/bin/dotsnap.js

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+
+const { program } = require("commander");
+const chalk = require("chalk");
+const packageJson = require("../package.json");
+const { maskCommand } = require("../src/commands/mask");
+const { webCommand } = require("../src/commands/web");
+
+program
+  .name("dotsnap")
+  .description("Mask your .env files securely")
+  .version(packageJson.version);
+
+program
+  .command("mask")
+  .description("Mask secrets in your .env file")
+  .option("-i, --input <file>", "Input .env file", ".env")
+  .option("-o, --output <file>", "Output file", ".env.safe")
+  .option("--fully-hide", "Completely hide all values with ****")
+  .option("--no-first-last", "Don't show first/last characters")
+  .action(maskCommand);
+
+program
+  .command("web")
+  .description("Open the web UI in your browser")
+  .option("-p, --port <port>", "Port to run on", "3000")
+  .action(webCommand);
+
+program.parse();

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "dotsnap",
+  "version": "1.0.0",
+  "description": "Mask your .env files securely - CLI and Web UI",
+  "main": "src/index.js",
+  "bin": {
+    "dotsnap": "bin/dotsnap.js"
+  },
+  "scripts": {
+    "test": "echo \"No tests yet\" && exit 0"
+  },
+  "keywords": [
+    "env",
+    "environment",
+    "secrets",
+    "security",
+    "mask",
+    "dotenv",
+    "cli"
+  ],
+  "author": "Your Name <Timothy Okoduwa>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/timothy-okoduwa/dotsnap.git"
+  },
+  "bugs": {
+    "url": "https://github.com/timothy-okoduwa/dotsnap/issues"
+  },
+  "homepage": "https://github.com/timothy-okoduwa/dotsnap#readme",
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "commander": "^11.1.0",
+    "ora": "^5.4.1"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  }
+}

package/src/commands/mask.js

@@ -0,0 +1,60 @@
+const chalk = require("chalk");
+const ora = require("ora");
+const {
+  readEnvFile,
+  writeEnvFile,
+  fileExists,
+} = require("../utils/fileSystem");
+const { processEnvContent } = require("../utils/mask");
+const { logSuccess, logError, logInfo } = require("../utils/logger");
+
+async function maskCommand(options) {
+  const spinner = ora("Processing .env file...").start();
+
+  try {
+    // Check if input file exists
+    if (!fileExists(options.input)) {
+      spinner.fail();
+      logError(`File not found: ${options.input}`);
+      process.exit(1);
+    }
+
+    // Read the .env file
+    spinner.text = "Reading .env file...";
+    const content = readEnvFile(options.input);
+
+    // Count secrets
+    const secretCount = content
+      .split("\n")
+      .filter(
+        (line) => !line.trim().startsWith("#") && line.includes("="),
+      ).length;
+
+    // Mask the content
+    spinner.text = "Masking secrets...";
+    const showFirstLast = options.firstLast !== false;
+    const fullyHide = options.fullyHide || false;
+    const maskedContent = processEnvContent(content, showFirstLast, fullyHide);
+
+    // Write to output file
+    spinner.text = "Saving masked file...";
+    writeEnvFile(options.output, maskedContent);
+
+    spinner.succeed();
+
+    // Success messages
+    console.log("");
+    logSuccess(`Found .env file`);
+    logSuccess(`Masked ${secretCount} secrets`);
+    logSuccess(`Saved to ${options.output}`);
+    console.log("");
+    logInfo(`You can now safely share ${chalk.cyan(options.output)}`);
+    console.log("");
+  } catch (error) {
+    spinner.fail();
+    logError(`Failed to mask secrets: ${error.message}`);
+    process.exit(1);
+  }
+}
+
+module.exports = { maskCommand };

package/src/commands/web.js

@@ -0,0 +1,30 @@
+const chalk = require("chalk");
+const { logInfo, logSuccess, logError } = require("../utils/logger");
+
+async function webCommand(options) {
+  const port = options.port || 3000;
+
+  console.log("");
+  logInfo("Opening DotSnap Web UI...");
+  console.log("");
+
+  // Try to open the hosted web version
+  const url = "https://dotsnap.com/tool"; // Replace with your actual domain
+
+  logSuccess(`Opening browser at: ${chalk.cyan(url)}`);
+  console.log("");
+  logInfo("If the browser doesn't open automatically, visit:");
+  console.log(`  ${chalk.cyan(url)}`);
+  console.log("");
+
+  // Try to open browser
+  const open = require("open");
+  try {
+    await open(url);
+  } catch (error) {
+    logError("Could not open browser automatically");
+    logInfo(`Please visit: ${chalk.cyan(url)}`);
+  }
+}
+
+module.exports = { webCommand };

package/src/index.js

@@ -0,0 +1,6 @@
+const { processEnvContent, maskSecret } = require("./utils/mask");
+
+module.exports = {
+  processEnvContent,
+  maskSecret,
+};

package/src/utils/fileSystem.js

@@ -0,0 +1,28 @@
+const fs = require("fs");
+const path = require("path");
+
+function fileExists(filePath) {
+  return fs.existsSync(filePath);
+}
+
+function readEnvFile(filePath) {
+  try {
+    return fs.readFileSync(filePath, "utf8");
+  } catch (error) {
+    throw new Error(`Failed to read file: ${error.message}`);
+  }
+}
+
+function writeEnvFile(filePath, content) {
+  try {
+    fs.writeFileSync(filePath, content, "utf8");
+  } catch (error) {
+    throw new Error(`Failed to write file: ${error.message}`);
+  }
+}
+
+module.exports = {
+  fileExists,
+  readEnvFile,
+  writeEnvFile,
+};

package/src/utils/logger.js

@@ -0,0 +1,24 @@
+const chalk = require("chalk");
+
+function logSuccess(message) {
+  console.log(chalk.green("✓"), message);
+}
+
+function logError(message) {
+  console.log(chalk.red("✗"), message);
+}
+
+function logInfo(message) {
+  console.log(chalk.blue("ℹ"), message);
+}
+
+function logWarning(message) {
+  console.log(chalk.yellow("⚠"), message);
+}
+
+module.exports = {
+  logSuccess,
+  logError,
+  logInfo,
+  logWarning,
+};

package/src/utils/mask.js

@@ -0,0 +1,56 @@
+function maskSecret(value, showFirstLast = true, fullyHide = false) {
+  if (!value) return value;
+
+  const unquoted = value.replace(/^["']|["']$/g, "");
+
+  if (fullyHide) {
+    return "****";
+  }
+
+  const len = unquoted.length;
+  if (len <= 4) {
+    return "****";
+  }
+
+  if (!showFirstLast) {
+    return "*".repeat(len);
+  }
+
+  const firstChars = unquoted.slice(0, 3);
+  const lastChars = unquoted.slice(-4);
+  const maskedMiddle = "*".repeat(Math.max(len - 7, 4));
+
+  return firstChars + maskedMiddle + lastChars;
+}
+
+function processEnvContent(content, showFirstLast = true, fullyHide = false) {
+  const lines = content.split("\n");
+
+  return lines
+    .map((line) => {
+      if (!line.trim() || line.trim().startsWith("#")) {
+        return line;
+      }
+
+      const equalsIndex = line.indexOf("=");
+      if (equalsIndex === -1) {
+        return line;
+      }
+
+      const key = line.slice(0, equalsIndex).trim();
+      const value = line.slice(equalsIndex + 1).trim();
+
+      if (!value) {
+        return line;
+      }
+
+      const maskedValue = maskSecret(value, showFirstLast, fullyHide);
+      return `${key}=${maskedValue}`;
+    })
+    .join("\n");
+}
+
+module.exports = {
+  maskSecret,
+  processEnvContent,
+};