safelaunch 1.0.7 → 1.0.8

package/README.md

@@ -4,7 +4,7 @@
 
 safelaunch is a comprehensive environment validator for JavaScript projects. Run it before every push to catch everything that will break production.
 
-Works with Node.js, Next.js, Vite, and Create React App projects. Automatically detects your project type and runs the right checks.
+Automatically detects your project type and runs the right checks.
 
 ## Install
 
@@ -16,7 +16,9 @@ npm install -g safelaunch
 
 safelaunch init
 
-Scans your entire codebase, finds every environment variable your app uses, and generates env.manifest.json automatically. Works with process.env and import.meta.env.
+Scans your entire codebase and generates env.manifest.json automatically.
+
+Works with process.env and import.meta.env.
 
 **Step 2: Validate before every push**
 
@@ -24,7 +26,7 @@ safelaunch validate
 
 ## What safelaunch checks
 
-safelaunch validate runs 7 checks:
+safelaunch validate runs 11 checks:
 
 1. Missing required environment variables
 2. Empty required environment variables
@@ -33,59 +35,50 @@ safelaunch validate runs 7 checks:
 5. Dependencies not installed
 6. Dependency drift (in package.json but not installed)
 7. Variables in .env.example but missing from .env
+8. Missing VITE_ prefix for Vite projects
+9. Missing NEXT_PUBLIC_ prefix for Next.js projects
+10. Missing REACT_APP_ prefix for Create React App
+11. .env file priority order for Next.js projects
 
-## Example output
-
-Running safelaunch...
+## Supported project types
 
-project type: Node.js
+safelaunch automatically detects your project type.
 
-⚠️  RUNTIME MISMATCH
+- Node.js       scans process.env
+- Next.js       scans process.env, checks NEXT_PUBLIC_ prefixes
+- Vite          scans import.meta.env, checks VITE_ prefixes
+- React CRA     scans REACT_APP_ variables
 
-   Node required: 18
-   Node actual:   20
+## Example output
 
-⚠️  DEPENDENCY DRIFT (1 found)
+Running safelaunch...
 
-   express   in package.json but not installed
+project type: Vite
 
-❌ EMPTY VARIABLES (1 found)
+⚠️  FRAMEWORK PREFIX WARNINGS (1 found)
 
-   DATABASE_URL   required but empty in .env
+   API_URL   missing VITE_ prefix - will be undefined in browser
 
 ❌ MISSING VARIABLES (1 found)
 
-   REDIS_URL   required but missing from .env
+   VITE_STRIPE_KEY   required but missing from .env
 
 ✅ PASSING (1)
 
-   API_KEY   present
+   VITE_API_URL   present
 
 Your environment is not ready for production.
 
-## Supported project types
-
-safelaunch automatically detects your project type.
-
-- Node.js       scans process.env
-- Next.js       scans process.env
-- Vite          scans import.meta.env
-- React CRA     scans process.env REACT_APP_ variables
-
 ## CI Integration
 
-Add this to your GitHub Actions workflow:
-
 - name: Install safelaunch
   run: npm install -g safelaunch
 
 - name: Validate environment
   run: safelaunch validate
 
-Blocks deployments automatically if any check fails.
-
 ## Built by Orches
 
-Deployment Reliability Infrastructure.
+JavaScript Reliability Infrastructure.
 GitHub: https://github.com/karthicedric7-cloud/safelaunch
 VS Code: https://marketplace.visualstudio.com/items?itemName=Orches.deploycheck-vscode

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "safelaunch",
-  "version": "1.0.7",
+  "version": "1.0.8",
   "description": "Backend Reliability Infrastructure - catch what breaks production before it breaks",
   "main": "index.js",
   "bin": {

package/src/validate.js

@@ -28,30 +28,42 @@ function readManifest() {
   return JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
 }
 
-function readEnv() {
-  const envPath = path.join(process.cwd(), '.env');
-  if (!fs.existsSync(envPath)) {
-    console.log('\nNo .env file found.\n');
-    process.exit(1);
-  }
+function readEnv(cwd) {
+  const envFiles = ['.env.local', '.env.development.local', '.env.production.local', '.env.development', '.env.production', '.env'];
   const envVars = {};
   const duplicates = [];
   const seen = new Set();
-  const lines = fs.readFileSync(envPath, 'utf8').split('\n');
-  for (const line of lines) {
-    const match = line.match(/^([^=]+)=(.*)$/);
-    if (match) {
-      const key = match[1].trim();
-      if (seen.has(key)) duplicates.push(key);
-      seen.add(key);
-      envVars[key] = match[2].trim();
+  const loadedFiles = [];
+
+  for (const file of envFiles) {
+    const envPath = path.join(cwd, file);
+    if (!fs.existsSync(envPath)) continue;
+    loadedFiles.push(file);
+    const lines = fs.readFileSync(envPath, 'utf8').split('\n');
+    for (const line of lines) {
+      const match = line.match(/^([^=]+)=(.*)$/);
+      if (match) {
+        const key = match[1].trim();
+        if (seen.has(key)) {
+          duplicates.push(key + ' (in ' + file + ')');
+        } else {
+          seen.add(key);
+          envVars[key] = match[2].trim();
+        }
+      }
     }
   }
-  return { envVars, duplicates };
+
+  if (loadedFiles.length === 0) {
+    console.log('\nNo .env file found.\n');
+    process.exit(1);
+  }
+
+  return { envVars, duplicates, loadedFiles };
 }
 
-function readEnvExample() {
-  const envExamplePath = path.join(process.cwd(), '.env.example');
+function readEnvExample(cwd) {
+  const envExamplePath = path.join(cwd, '.env.example');
   if (!fs.existsSync(envExamplePath)) return null;
   const envVars = {};
   const lines = fs.readFileSync(envExamplePath, 'utf8').split('\n');
@@ -70,8 +82,8 @@ function checkRuntime(manifest) {
   return null;
 }
 
-function checkEnvExample(envVars) {
-  const example = readEnvExample();
+function checkEnvExample(envVars, cwd) {
+  const example = readEnvExample(cwd);
   if (!example) return [];
   const missing = [];
   for (const key of Object.keys(example)) {
@@ -80,9 +92,9 @@ function checkEnvExample(envVars) {
   return missing;
 }
 
-function checkDependencyDrift() {
-  const packagePath = path.join(process.cwd(), 'package.json');
-  const modulesPath = path.join(process.cwd(), 'node_modules');
+function checkDependencyDrift(cwd) {
+  const packagePath = path.join(cwd, 'package.json');
+  const modulesPath = path.join(cwd, 'node_modules');
   if (!fs.existsSync(packagePath)) return null;
   if (!fs.existsSync(modulesPath)) return { notInstalled: true, missing: [] };
   const pkg = JSON.parse(fs.readFileSync(packagePath, 'utf8'));
@@ -95,17 +107,57 @@ function checkDependencyDrift() {
   return { notInstalled: false, missing };
 }
 
+function checkFrameworkPrefixes(envVars, manifest, projectType) {
+  const warnings = [];
+  const variables = Object.keys(manifest.variables || {});
+
+  if (projectType === 'vite') {
+    for (const key of variables) {
+      if (!key.startsWith('VITE_')) {
+        warnings.push(key + '   missing VITE_ prefix - will be undefined in browser');
+      }
+    }
+  }
+
+  if (projectType === 'next') {
+    for (const key of variables) {
+      if (!key.startsWith('NEXT_PUBLIC_') && !key.startsWith('NEXT_') ) {
+        warnings.push(key + '   consider NEXT_PUBLIC_ prefix to expose to browser');
+      }
+    }
+  }
+
+  if (projectType === 'cra') {
+    for (const key of variables) {
+      if (!key.startsWith('REACT_APP_')) {
+        warnings.push(key + '   missing REACT_APP_ prefix - will be undefined in browser');
+      }
+    }
+  }
+
+  return warnings;
+}
+
 function validate() {
   console.log('\nRunning safelaunch...\n');
 
   const cwd = process.cwd();
   const manifest = readManifest();
-  const { envVars, duplicates } = readEnv();
-
   const projectType = manifest.projectType || detectProjectType(cwd);
+
   const typeLabels = { vite: 'Vite', next: 'Next.js', cra: 'Create React App', node: 'Node.js' };
   console.log('project type: ' + (typeLabels[projectType] || 'Node.js') + '\n');
 
+  const { envVars, duplicates, loadedFiles } = readEnv(cwd);
+
+  if (loadedFiles.length > 1) {
+    console.log('env files loaded (priority order):\n');
+    for (const file of loadedFiles) {
+      console.log('   ' + file);
+    }
+    console.log('');
+  }
+
   const missing = [];
   const empty = [];
   const passing = [];
@@ -121,8 +173,9 @@ function validate() {
   }
 
   const runtimeMismatch = checkRuntime(manifest);
-  const exampleMissing = checkEnvExample(envVars);
-  const drift = checkDependencyDrift();
+  const exampleMissing = checkEnvExample(envVars, cwd);
+  const drift = checkDependencyDrift(cwd);
+  const prefixWarnings = checkFrameworkPrefixes(envVars, manifest, projectType);
 
   if (runtimeMismatch) {
     console.log('⚠️  RUNTIME MISMATCH\n');
@@ -134,7 +187,7 @@ function validate() {
   if (duplicates.length > 0) {
     console.log('⚠️  DUPLICATE VARIABLES (' + duplicates.length + ' found)\n');
     for (const key of duplicates) {
-      console.log('   ' + key + '   defined more than once in .env');
+      console.log('   ' + key);
     }
     console.log('');
   }
@@ -152,6 +205,14 @@ function validate() {
     }
   }
 
+  if (prefixWarnings.length > 0) {
+    console.log('⚠️  FRAMEWORK PREFIX WARNINGS (' + prefixWarnings.length + ' found)\n');
+    for (const warning of prefixWarnings) {
+      console.log('   ' + warning);
+    }
+    console.log('');
+  }
+
   if (exampleMissing.length > 0) {
     console.log('⚠️  MISSING FROM .env.example (' + exampleMissing.length + ' found)\n');
     for (const key of exampleMissing) {
@@ -184,7 +245,9 @@ function validate() {
     console.log('');
   }
 
-  const hasFailed = runtimeMismatch || missing.length > 0 || empty.length > 0 || duplicates.length > 0 || exampleMissing.length > 0 || (drift && (drift.notInstalled || drift.missing.length > 0));
+  const hasFailed = runtimeMismatch || missing.length > 0 || empty.length > 0 ||
+    duplicates.length > 0 || exampleMissing.length > 0 || prefixWarnings.length > 0 ||
+    (drift && (drift.notInstalled || drift.missing.length > 0));
 
   if (hasFailed) {
     console.log('Your environment is not ready for production.\n');