env-creator 1.1.0 → 1.2.0

package/README.md

@@ -64,7 +64,7 @@ pnpx env-creator create
 ```bash
 pnpx env-creator create PORT=3000 NODE_ENV=development
 # or short version
-pnpx env c PORT=3000 NODE_ENV=development
+pnpm exec env c PORT=3000 NODE_ENV=development
 ```
 
 **Resulting `.env`:**
@@ -146,31 +146,59 @@ pnpx env-creator delete .env.production		# Deletes .env.production
 
 ### 5. Sort `.env` keys alphabetically (alias: `srt`)
 
-Reads an environment file and reorders all `KEY=VALUE` lines alphabetically. Comments and empty lines are preserved at the top of the file. Defaults to `.env` if no file is specified.
+Reads an environment file and reorders all `KEY=VALUE` lines alphabetically. By default, it operates in a **flat sort mode**, meaning it binds each comment or empty line to the closest variable immediately below it, and sorts these blocks of keys.
+
+If you prefer to strictly preserve the exact file layout and structure, use the `--groups` (or `-g`) flag, which performs **intra-group sorting** that alphabetizes variables tightly inside their original continuous groups. Defaults to `.env` if no file is specified.
 
 ```bash
-pnpx env-creator sort [file]
+pnpx env-creator sort [--groups] [file]
 ```
 
 **Examples:**
 ```bash
-pnpx env-creator sort               	# Sorts .env
-pnpx env-creator sort .env.production	# Sorts .env.production
+pnpx env-creator sort               		# Flat sorts .env
+pnpx env-creator sort -g .env.production	# Group-sorts .env.production
 ```
 
+**Example 1: Flat Sort (Default)**
+
 **Before:**
 ```env
-# App config
+DB_USER=admin
+DB_PASS=secret
 PORT=3000
 APP_NAME=my-app
-DB_HOST=localhost
 ```
 
-**After:**
+**After (`env-creator sort`):**
 ```env
-# App config
 APP_NAME=my-app
-DB_HOST=localhost
+DB_PASS=secret
+DB_USER=admin
+PORT=3000
+```
+
+**Example 2: Intra-Group Sort (`--groups`)**
+
+**Before:**
+```env
+# DB Config
+DB_USER=admin
+DB_PASS=secret
+
+# App
+PORT=3000
+APP_NAME=my-app
+```
+
+**After (`env-creator sort -g`):**
+```env
+# DB Config
+DB_PASS=secret
+DB_USER=admin
+
+# App
+APP_NAME=my-app
 PORT=3000
 ```
 
@@ -184,10 +212,10 @@ pnpx env-creator generate-constants [file] [--out <filename>]
 
 **Examples:**
 ```bash
-pnpx env gc					# Generates envConstants.js from .env by default
-pnpx env gc .env.production			# Generates envConstants.js from .env.production
-pnpx env gc --out myConfig.js			# Generates myConfig.js from .env
-pnpx env gc .env.production --out config/env.js # Generates config/env.js from .env.production
+pnpm exec env gc					# Generates envConstants.js from .env by default
+pnpm exec env gc .env.production			# Generates envConstants.js from .env.production
+pnpm exec env gc --out myConfig.js			# Generates myConfig.js from .env
+pnpm exec env gc .env.production --out config/env.js	# Generates config/env.js from .env.production
 ```
 
 **Resulting `envConstants.js`:**

package/dist/index.js

@@ -1,12 +1,12 @@
-import n from"fs";import d from"path";import u from"readline";var t=process.argv.slice(2);t.length===0&&(h(),process.exit(0));function h(){console.log("Usage: env-creator <command> [options]"),console.log("   or: env <command> [options]"),console.log("Commands:"),console.log("  c, create [KEY=value...]   Create a .env file (optionally with values)"),console.log("  cfj, create-from-json <json> [--env <name>] Create .env or .env.<name> from JSON"),console.log("  s, split --env <dev|prod>  Create environment-specific file from .env"),console.log("  d, delete [file]           Delete an environment file (default: .env)"),console.log("  srt, sort [file]           Sort keys alphabetically in an env file (default: .env)"),console.log("  gc, generate-constants [file] [--out <file>] Generate a JS file with env variable constants"),console.log("Options:"),console.log("  -h, --help              Show this help message")}var g=t[0];(g==="--help"||g==="-h"||g==="help")&&(h(),process.exit(0));switch(g){case"c":case"create":{let e=d.join(process.cwd(),".env");if(n.existsSync(e))console.log(".env already exists");else{let s=t.slice(1),i="";if(s.length>0){let o=s.filter(c=>c.includes("="));i=o.join(`
+import n from"fs";import v from"path";import y from"readline";var t=process.argv.slice(2);t.length===0&&(u(),process.exit(0));function u(){console.log("Usage: env-creator <command> [options]"),console.log("   or: env <command> [options]"),console.log("Commands:"),console.log("  c, create [KEY=value...]   Create a .env file (optionally with values)"),console.log("  cfj, create-from-json <json> [--env <name>] Create .env or .env.<name> from JSON"),console.log("  s, split --env <dev|prod>  Create environment-specific file from .env"),console.log("  d, delete [file]           Delete an environment file (default: .env)"),console.log("  srt, sort [-g/--groups] [file] Sort keys alphabetically (default: .env). Use -g to sort inside existing groups."),console.log("  gc, generate-constants [file] [--out <file>] Generate a JS file with env variable constants"),console.log("Options:"),console.log("  -h, --help              Show this help message")}var m=t[0];(m==="--help"||m==="-h"||m==="help")&&(u(),process.exit(0));switch(m){case"c":case"create":{let s=v.join(process.cwd(),".env");if(n.existsSync(s))console.log(".env already exists");else{let i=t.slice(1),p="";if(i.length>0){let o=i.filter(f=>f.includes("="));p=o.join(`
 `)+(o.length>0?`
-`:"")}n.writeFileSync(e,i),console.log(i?"Created .env with specified fields":"Created empty .env")}break}case"cfj":case"create-from-json":{let e=t[1];e||(console.error("Please provide a JSON file"),process.exit(1)),n.existsSync(e)||(console.error("JSON file not found"),process.exit(1));let s=t.indexOf("--env"),o=`.env${s!==-1&&t[s+1]?`.${t[s+1]}`:""}`;if(n.existsSync(o)){console.log(`${o} already exists`);break}let c=JSON.parse(n.readFileSync(e,"utf-8")),f="";for(let l in c)f+=`${l}=${c[l]}
-`;n.writeFileSync(o,f),console.log(`Created ${o} from JSON`);break}case"s":case"split":{let e=t.indexOf("--env");(e===-1||!t[e+1])&&(console.error("Please specify environment with --env <dev|prod>"),process.exit(1));let s=t[e+1],i=d.join(process.cwd(),".env");n.existsSync(i)||(console.error(".env file not found"),process.exit(1));let c=n.readFileSync(i,"utf-8").split(/\r?\n/).filter(l=>l.trim()!==""&&!l.startsWith("#")).map(l=>l.split("=")[0]+"=").join(`
-`),f=d.join(process.cwd(),`.env.${s}`);if(n.existsSync(f)){console.log(`.env.${s} already exists`);break}n.writeFileSync(f,c),console.log(`Created .env.${s} with keys only`);break}case"d":case"delete":{let e=t[1]||".env",s=d.join(process.cwd(),e);n.existsSync(s)?(n.unlinkSync(s),console.log(`Deleted ${e}`)):console.log(`File ${e} does not exist`);break}case"srt":case"sort":{let e=t[1]||".env",s=d.join(process.cwd(),e);n.existsSync(s)||(console.error(`File ${e} does not exist`),process.exit(1));let i=n.readFileSync(s,"utf-8").split(/\r?\n/),o=i[i.length-1]===""?i.slice(0,-1):i,c=o.filter(a=>!a.startsWith("#")&&a.trim()!==""&&a.includes("=")).sort((a,m)=>a.localeCompare(m)),f=0,l=o.map(a=>!a.startsWith("#")&&a.trim()!==""&&a.includes("=")?c[f++]:a);n.writeFileSync(s,l.join(`
+`:"")}n.writeFileSync(s,p),console.log(p?"Created .env with specified fields":"Created empty .env")}break}case"cfj":case"create-from-json":{let s=t[1];s||(console.error("Please provide a JSON file"),process.exit(1)),n.existsSync(s)||(console.error("JSON file not found"),process.exit(1));let i=t.indexOf("--env"),o=`.env${i!==-1&&t[i+1]?`.${t[i+1]}`:""}`;if(n.existsSync(o)){console.log(`${o} already exists`);break}let f=JSON.parse(n.readFileSync(s,"utf-8")),d="";for(let e in f)d+=`${e}=${f[e]}
+`;n.writeFileSync(o,d),console.log(`Created ${o} from JSON`);break}case"s":case"split":{let s=t.indexOf("--env");(s===-1||!t[s+1])&&(console.error("Please specify environment with --env <dev|prod>"),process.exit(1));let i=t[s+1],p=v.join(process.cwd(),".env");n.existsSync(p)||(console.error(".env file not found"),process.exit(1));let f=n.readFileSync(p,"utf-8").split(/\r?\n/).filter(e=>e.trim()!==""&&!e.startsWith("#")).map(e=>e.split("=")[0]+"=").join(`
+`),d=v.join(process.cwd(),`.env.${i}`);if(n.existsSync(d)){console.log(`.env.${i} already exists`);break}n.writeFileSync(d,f),console.log(`Created .env.${i} with keys only`);break}case"d":case"delete":{let s=t[1]||".env",i=v.join(process.cwd(),s);n.existsSync(i)?(n.unlinkSync(i),console.log(`Deleted ${s}`)):console.log(`File ${s} does not exist`);break}case"srt":case"sort":{let s=t.includes("--groups")||t.includes("-g"),p=t.slice(1).find(a=>a!=="--groups"&&a!=="-g")||".env",o=v.join(process.cwd(),p);n.existsSync(o)||(console.error(`File ${p} does not exist`),process.exit(1));let f=n.readFileSync(o,"utf-8").split(/\r?\n/),d=f[f.length-1]===""?f.slice(0,-1):f,e=[];if(s){let a=[];for(let c of d)if(!c.startsWith("#")&&c.trim()!==""&&c.includes("="))a.push(c);else{if(a.length>0&&(a.sort((l,g)=>l.split("=")[0].trim().localeCompare(g.split("=")[0].trim())),e.push(...a),a=[],c.trim()!==""&&e.push("")),c.trim()===""&&e.length>0&&e[e.length-1].trim()==="")continue;e.push(c)}for(a.length>0&&(a.sort((c,r)=>c.split("=")[0].trim().localeCompare(r.split("=")[0].trim())),e.push(...a));e.length>0&&e[e.length-1].trim()==="";)e.pop()}else{let a=[],c=[];for(let r of d)!r.startsWith("#")&&r.trim()!==""&&r.includes("=")?(a.push({header:c,entry:r,key:r.split("=")[0].trim()}),c=[]):r.trim()!==""&&c.push(r);a.sort((r,l)=>r.key.localeCompare(l.key));for(let r of a)e.push(...r.header),e.push(r.entry);e.push(...c)}n.writeFileSync(o,e.join(`
 `)+`
-`),console.log(`Sorted keys in ${e}`);break}case"gc":case"generate-constants":{let e=t.indexOf("--out"),s=e!==-1&&t[e+1]?t[e+1]:"envConstants.js",o=(e!==-1?t.filter((r,p)=>p!==e&&p!==e+1):t)[1]||".env",c=d.join(process.cwd(),o);if(!n.existsSync(c)){let p=n.readdirSync(process.cwd()).filter(v=>v.startsWith(".env")&&!v.endsWith(".example"));p.length>0?(o=p[0],c=d.join(process.cwd(),o),console.log(`File ${t[1]||".env"} not found. Using ${o} instead.`)):(console.error(`File ${o} does not exist and no fallback .env* files were found`),process.exit(1))}let l=n.readFileSync(c,"utf-8").split(/\r?\n/).filter(r=>!r.startsWith("#")&&r.trim()!==""&&r.includes("=")).map(r=>r.split("=")[0].trim());if(l.length===0){console.log(`No variables found in ${o}`);break}let m=`export const ENV = {
-${l.map(r=>`	${r}: process.env.${r},`).join(`
+`),console.log(`Sorted keys in ${p}`);break}case"gc":case"generate-constants":{let s=t.indexOf("--out"),i=s!==-1&&t[s+1]?t[s+1]:"envConstants.js",o=(s!==-1?t.filter((l,g)=>g!==s&&g!==s+1):t)[1]||".env",f=v.join(process.cwd(),o);if(!n.existsSync(f)){let g=n.readdirSync(process.cwd()).filter(h=>h.startsWith(".env")&&!h.endsWith(".example"));g.length>0?(o=g[0],f=v.join(process.cwd(),o),console.log(`File ${t[1]||".env"} not found. Using ${o} instead.`)):(console.error(`File ${o} does not exist and no fallback .env* files were found`),process.exit(1))}let e=n.readFileSync(f,"utf-8").split(/\r?\n/).filter(l=>!l.startsWith("#")&&l.trim()!==""&&l.includes("=")).map(l=>l.split("=")[0].trim());if(e.length===0){console.log(`No variables found in ${o}`);break}let c=`export const ENV = {
+${e.map(l=>`	${l}: process.env.${l},`).join(`
 `)}
 };
-`,y=d.join(process.cwd(),s);if(n.existsSync(y)){let r=u.createInterface({input:process.stdin,output:process.stdout});r.question(`File ${s} already exists. Overwrite? (y/n) `,p=>{let v=p.trim().toLowerCase();v==="y"||v==="yes"?(n.writeFileSync(y,m),console.log(`Overwrote ${s} from ${o}`)):console.log("Action cancelled. File was not overwritten."),r.close()})}else n.writeFileSync(y,m),console.log(`Generated ${s} from ${o}`);break}default:console.error(`Unknown command: "${g}"
-`),h(),process.exit(1)}
+`,r=v.join(process.cwd(),i);if(n.existsSync(r)){let l=y.createInterface({input:process.stdin,output:process.stdout});l.question(`File ${i} already exists. Overwrite? (y/n) `,g=>{let h=g.trim().toLowerCase();h==="y"||h==="yes"?(n.writeFileSync(r,c),console.log(`Overwrote ${i} from ${o}`)):console.log("Action cancelled. File was not overwritten."),l.close()})}else n.writeFileSync(r,c),console.log(`Generated ${i} from ${o}`);break}default:console.error(`Unknown command: "${m}"
+`),u(),process.exit(1)}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "env-creator",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "A fast, lightweight CLI tool for managing and generating custom environment (`.env`) files",
   "type": "module",
   "bin": {
@@ -44,6 +44,9 @@
     "lint": "eslint .",
     "build": "esbuild src/index.js --bundle --platform=node --format=esm --target=node20 --minify --outfile=dist/index.js && printf '#!/usr/bin/env node\nimport(\"./index.js\");\n' > dist/cli.js && chmod +x dist/cli.js",
     "build:pack": "pnpm run build && pnpm pack",
-    "release": "pnpm version patch && pnpm publish"
+    "version:patch": "pnpm version patch",
+    "version:minor": "pnpm version minor",
+    "version:major": "pnpm version major",
+    "publish:npm": "pnpm publish"
   }
 }