make-json-to-env 1.0.4 → 1.0.6

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ajay Vishwakarma
+
+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

@@ -1,82 +1,137 @@
-# make-json-to-env 🚀
+# 🚀 make-json-to-env
 
-A lightweight CLI tool to transform your `JSON` configuration files into `.env` templates instantly. Perfect for generating `.env.example` files without manual typing.
+**The ultimate zero-dependency CLI tool to transform complex, nested JSON into clean, production-ready `.env` files.**
+
+---
+
+## 💡 Why `make-json-to-env`?
+
+Most JSON-to-ENV converters stop at the first level or handle arrays poorly. `make-json-to-env` was built to solve the "Deep Config" problem. Whether you have a 10-level nested Firebase config or a simple flat JSON, this tool generates a standard, predictable `.env` structure that works with `dotenv`, Docker, and Shell scripts.
+
+---
+
+## 🔥 Features
+
+* **⚡ Ultra-Lightweight** – Zero dependencies. It uses native Node.js `fs` and `path` modules.
+* **🌳 Infinite Recursion** – No depth limits. It flattens deep objects into a `PARENT_CHILD_KEY` convention.
+* **🔢 Intelligent Array Mapping** – Converts arrays into indexed variables (e.g., `TAGS_0`, `TAGS_1`).
+* **🛡️ Built with TypeScript** – Fully type-safe with robust error handling for invalid JSON.
+* **⚙️ Prefix Support** – Prepend `export `, `SET `, or `REACT_APP_` to every variable automatically.
+* **🚫 Smart Flattening Toggle** – Use `--no-flatten` if you want nested objects to stay as JSON strings.
 
 ---
 
 ## 📦 Installation
 
-You can run it directly without installing using `npx`:
+### Use without installing (Recommended)
 
 ```bash
-npx make-json-to-env <filename.json>
+npx make-json-to-env config.json
 
 ```
 
-Or install it globally to use the command anywhere:
+### Global Installation
 
 ```bash
 npm install -g make-json-to-env
 
 ```
 
-## 🛠 Usage
+---
+
+## 🛠 Usage & Commands
 
-Once installed, use the `convert-json-env` command followed by your JSON file:
+The tool provides the `make-json-to-env` command.
 
-### Basic Conversion
+### 1. Basic Conversion
+
+Converts `config.json` to `config.env`.
 
 ```bash
-convert-json-env config.json
+make-json-to-env config.json
 
 ```
 
-*This will create a `config.env` file in the same directory.*
+### 2. Using Custom Prefixes
+
+Great for shell scripts or specific frameworks (like Create React App).
+
+```bash
+make-json-to-env config.json --prefix="export "
+
+```
 
-### With a Prefix
+### 3. Disabling Flattening
 
-Use the `--prefix` flag to prepend strings to every line (useful for shell scripts or specific frameworks).
+Keep nested objects as serialized strings.
 
 ```bash
-convert-json-env firebaseConfig.json --prefix="export "
+make-json-to-env data.json --no-flatten
 
 ```
 
 ---
 
-## 📋 Example
+## 📋 Deep-Flattening Example
 
-**Input (`example.json`):**
+**Input (`settings.json`):**
 
 ```json
 {
-  "apiKey": "12345",
-  "authDomain": "app.firebaseapp.com",
-  "projectId": "my-app"
+  "server": {
+    "port": 3000,
+    "auth": {
+      "methods": ["google", "github"],
+      "enabled": true
+    }
+  },
+  "log_level": "info"
 }
 
 ```
 
-**Command:**
+**Output (`settings.env`):**
 
-```bash
-convert-json-env example.json --prefix="export "
+```env
+SERVER_PORT=3000
+SERVER_AUTH_METHODS_0=google
+SERVER_AUTH_METHODS_1=github
+SERVER_AUTH_ENABLED=true
+LOG_LEVEL=info
 
 ```
 
-**Output (`example.env`):**
+---
 
-```env
-APP_NAME="My Cool App"
-PORT=8080
-DB_ENABLED=true
-```
+## 🚀 Advanced Flag Reference
+
+| Flag | Type | Description |
+| --- | --- | --- |
+| `<filename>` | `string` | **Required.** The path to your JSON source file. |
+| `--prefix` | `string` | Prepend a string to every key (e.g., `--prefix="VITE_"`). |
+| `--no-flatten` | `boolean` | Stops recursion. Nested objects are saved as JSON strings. |
+
+---
+
+## 🛠 Development & Contributing
+
+Contributions are welcome! To set up the project locally:
+
+1. **Clone the repo:** `git clone https://github.com/ajay-vish/make-json-to-env.git`
+2. **Install types:** `npm install`
+3. **Build from TS:** `npm run build`
+4. **Test locally:** `node dist/index.js example.json`
+
+---
+
+## 📄 License
+
+Distributed under the **MIT License**. See the `LICENSE` file for full text.
 
 ---
 
-## ✨ Features
+## ⭐️ Support
+
+If this tool saved you time, please give it a star on [GitHub](https://github.com/ajay-vish/make-json-to-env)!
 
-* **No Dependencies:** Light as a feather, uses native Node.js modules.
-* **Smart Naming:** Automatically generates the output filename based on your input.
-* **Case Formatting:** Automatically converts keys to `UPPER_CASE` for standard `.env` compliance.
-* **Security First:** Helps you create `.env.example` files so you never accidentally commit your real secrets.
+---

package/dist/index.js

@@ -0,0 +1,118 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const args = process.argv.slice(2);
+const inputFile = args.find((arg) => !arg.startsWith("--"));
+const prefixArg = args.find((arg) => arg.startsWith("--prefix="));
+const noFlatten = args.includes("--no-flatten");
+const prefix = prefixArg
+    ? prefixArg.split("=")[1].replace(/['"]+/g, "")
+    : "";
+if (!inputFile) {
+    console.error('❌ Usage: convert-json-env <file.json> [--prefix="export "] [--no-flatten]');
+    process.exit(1);
+}
+/**
+ * Recursive Flattener
+ */
+function flattenObject(obj, parentKey = "", res = {}) {
+    for (let key in obj) {
+        const propName = parentKey
+            ? `${parentKey}_${key.toUpperCase()}`
+            : key.toUpperCase();
+        if (Array.isArray(obj[key])) {
+            obj[key].forEach((val, i) => {
+                flattenObject({ [`${i}`]: val }, propName, res);
+            });
+        }
+        else if (typeof obj[key] === "object" && obj[key] !== null) {
+            flattenObject(obj[key], propName, res);
+        }
+        else {
+            res[propName] = obj[key];
+        }
+    }
+    return res;
+}
+/**
+ * Simple Formatter (No flattening)
+ */
+function simpleFormat(obj) {
+    const res = {};
+    for (let key in obj) {
+        res[key.toUpperCase()] = obj[key];
+    }
+    return res;
+}
+function run() {
+    const inputPath = path.resolve(process.cwd(), inputFile);
+    const fileInfo = path.parse(inputPath);
+    const outputPath = path.join(fileInfo.dir, `${fileInfo.name}.env`);
+    if (!fs.existsSync(inputPath)) {
+        console.error(`❌ File not found: ${inputFile}`);
+        process.exit(1);
+    }
+    try {
+        const json = JSON.parse(fs.readFileSync(inputPath, "utf8"));
+        // Choose strategy based on flag
+        const dataToProcess = noFlatten ? simpleFormat(json) : flattenObject(json);
+        const envContent = Object.entries(dataToProcess)
+            .map(([key, value]) => {
+            let val = value;
+            // If no-flatten is on, objects stay objects, so we stringify them
+            if (typeof val === "object" && val !== null) {
+                val = JSON.stringify(val);
+            }
+            else if (val === null) {
+                val = "";
+            }
+            let strVal = String(val);
+            if (strVal.includes(" "))
+                strVal = `"${strVal}"`;
+            return `${prefix}${key}=${strVal}`;
+        })
+            .join("\n");
+        fs.writeFileSync(outputPath, envContent);
+        console.log(`🚀 Done! Mode: ${noFlatten ? "Simple" : "Recursive Flatten"}`);
+        console.log(`✅ Saved to: ${path.basename(outputPath)}`);
+    }
+    catch (e) {
+        console.error("❌ Error:", e.message);
+    }
+}
+run();

package/package.json

@@ -1,28 +1,52 @@
 {
   "name": "make-json-to-env",
-  "version": "1.0.4",
-  "description": "Generates a template .env.example from a config.json file",
-  "main": "index.js",
+  "version": "1.0.6",
+  "description": "Infinite recursive JSON to ENV flattener written in TypeScript.",
+  "main": "./dist/index.js",
   "bin": {
-    "make-json-to-env": "./index.js"
+    "make-json-to-env": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepare": "npm run build",
+    "start": "ts-node src/index.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ajay-vish/make-json-to-env.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ajay-vish/make-json-to-env/issues"
+  },
+  "homepage": "https://github.com/ajay-vish/make-json-to-env#readme",
+  "devDependencies": {
+    "@types/node": "^20.19.35",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.3"
   },
   "keywords": [
     "env",
     "json",
     "converter",
-    "template",
+    "recursive",
+    "flatten",
     "dot-env",
     "environment-variables",
     "config-to-env",
     "cli",
     "devtools",
     "automation",
-    "boilerplate",
     "env-example",
     "dotenv-generator",
     "configuration",
     "secrets-management"
   ],
-  "author": "Your Name",
+  "author": "Ajay Vishwakarma",
   "license": "MIT"
 }

package/index.js

@@ -1,62 +0,0 @@
-#!/usr/bin/env node
-const fs = require('fs');
-const path = require('path');
-
-// 1. Parse CLI Arguments
-const args = process.argv.slice(2);
-const inputFile = args.find(arg => !arg.startsWith('--'));
-const prefixArg = args.find(arg => arg.startsWith('--prefix='));
-const prefix = prefixArg ? prefixArg.split('=')[1].replace(/['"]+/g, '') : '';
-
-if (!inputFile) {
-  console.error('❌ Usage: convert-json-env <filename.json> [--prefix="your-prefix"]');
-  process.exit(1);
-}
-
-/**
- * Converts JSON keys and values to ENV format
- */
-function convertToEnv(json, prefix) {
-  return Object.entries(json)
-    .map(([key, value]) => {
-      const envKey = `${prefix}${key.toUpperCase()}`;
-      
-      // Handle different value types
-      let envValue = value;
-      if (typeof value === 'object' && value !== null) {
-        envValue = JSON.stringify(value);
-      }
-      
-      // Wrap in quotes if value contains spaces
-      if (typeof envValue === 'string' && envValue.includes(' ')) {
-        envValue = `"${envValue}"`;
-      }
-
-      return `${envKey}=${envValue}`;
-    })
-    .join('\n');
-}
-
-function run() {
-  const inputPath = path.resolve(process.cwd(), inputFile);
-  const parsedPath = path.parse(inputPath);
-  const outputPath = path.join(parsedPath.dir, `${parsedPath.name}.env`);
-
-  if (!fs.existsSync(inputPath)) {
-    console.error(`❌ Error: File not found: ${inputFile}`);
-    process.exit(1);
-  }
-
-  try {
-    const fileContent = fs.readFileSync(inputPath, 'utf8');
-    const json = JSON.parse(fileContent);
-    const envContent = convertToEnv(json, prefix);
-
-    fs.writeFileSync(outputPath, envContent);
-    console.log(`✅ ${path.basename(outputPath)} created with values.`);
-  } catch (error) {
-    console.error('❌ Error:', error.message);
-  }
-}
-
-run();