safelaunch 1.0.5 → 1.0.7

package/README.md

@@ -2,50 +2,79 @@
 
 > Catch what breaks production before it breaks.
 
-safelaunch validates your local environment against a required environment contract before you push to production. No more missing variables. No more runtime mismatches. No more production surprises.
+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.
 
 ## Install
 
 npm install -g safelaunch
 
-## Quick Start
-
-**Step 1: Generate your environment manifest automatically**
+## Two commands. That is it.
 
-Run this in your project folder:
+**Step 1: Generate your environment manifest**
 
 safelaunch init
 
-safelaunch scans your entire codebase, finds every environment variable your app uses, and generates env.manifest.json automatically.
+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.
 
-**Step 2: Validate before you push**
+**Step 2: Validate before every push**
 
 safelaunch validate
 
-**Step 3: See exactly what will break**
+## What safelaunch checks
+
+safelaunch validate runs 7 checks:
+
+1. Missing required environment variables
+2. Empty required environment variables
+3. Runtime version mismatch (Node version)
+4. Duplicate variables in .env
+5. Dependencies not installed
+6. Dependency drift (in package.json but not installed)
+7. Variables in .env.example but missing from .env
+
+## Example output
+
+Running safelaunch...
+
+project type: Node.js
 
-Running safelaunch validate gives you:
+⚠️  RUNTIME MISMATCH
 
-❌ MISSING VARIABLES (2 found)
+   Node required: 18
+   Node actual:   20
 
-   DATABASE_URL   required but missing from .env
-   REDIS_URL      required but missing from .env
+⚠️  DEPENDENCY DRIFT (1 found)
+
+   express   in package.json but not installed
+
+❌ EMPTY VARIABLES (1 found)
+
+   DATABASE_URL   required but empty in .env
+
+❌ MISSING VARIABLES (1 found)
+
+   REDIS_URL   required but missing from .env
 
 ✅ PASSING (1)
 
    API_KEY   present
 
 Your environment is not ready for production.
-Fix the issues above and run safelaunch again.
 
-## Commands
+## Supported project types
+
+safelaunch automatically detects your project type.
 
-safelaunch init      scan project and generate env.manifest.json automatically
-safelaunch validate  validate your .env against the manifest
+- 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 to block deployments automatically:
+Add this to your GitHub Actions workflow:
 
 - name: Install safelaunch
   run: npm install -g safelaunch
@@ -53,6 +82,10 @@ Add this to your GitHub Actions workflow to block deployments automatically:
 - name: Validate environment
   run: safelaunch validate
 
+Blocks deployments automatically if any check fails.
+
 ## Built by Orches
 
-Backend Reliability Infrastructure.
+Deployment 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.5",
+  "version": "1.0.7",
   "description": "Backend Reliability Infrastructure - catch what breaks production before it breaks",
   "main": "index.js",
   "bin": {

package/src/init.js

@@ -1,17 +1,35 @@
 const fs = require('fs');
 const path = require('path');
 
-function scanFiles(dir, extensions, found = new Set()) {
+function detectProjectType(cwd) {
+  if (fs.existsSync(path.join(cwd, 'vite.config.js')) ||
+      fs.existsSync(path.join(cwd, 'vite.config.ts'))) {
+    return 'vite';
+  }
+  if (fs.existsSync(path.join(cwd, 'next.config.js')) ||
+      fs.existsSync(path.join(cwd, 'next.config.ts'))) {
+    return 'next';
+  }
+  const packagePath = path.join(cwd, 'package.json');
+  if (fs.existsSync(packagePath)) {
+    const pkg = JSON.parse(fs.readFileSync(packagePath, 'utf8'));
+    const deps = Object.assign({}, pkg.dependencies, pkg.devDependencies);
+    if (deps['react-scripts']) return 'cra';
+  }
+  return 'node';
+}
+
+function scanFiles(dir, extensions, pattern, found = new Set()) {
   const items = fs.readdirSync(dir);
   for (const item of items) {
     if (item === 'node_modules' || item === '.git') continue;
     const full = path.join(dir, item);
     const stat = fs.statSync(full);
     if (stat.isDirectory()) {
-      scanFiles(full, extensions, found);
+      scanFiles(full, extensions, pattern, found);
     } else if (extensions.some(ext => item.endsWith(ext))) {
       const content = fs.readFileSync(full, 'utf8');
-      const matches = content.matchAll(/process\.env\.([A-Z_][A-Z0-9_]*)/g);
+      const matches = content.matchAll(pattern);
       for (const match of matches) {
         found.add(match[1]);
       }
@@ -22,28 +40,58 @@ function scanFiles(dir, extensions, found = new Set()) {
 
 function init() {
   console.log('\nscanning project for environment variables...\n');
+
   const cwd = process.cwd();
-  const extensions = ['.js', '.ts', '.jsx', '.tsx'];
-  const found = scanFiles(cwd, extensions);
+  const manifestPath = path.join(cwd, 'env.manifest.json');
+
+  if (fs.existsSync(manifestPath)) {
+    console.log('env.manifest.json already exists. delete it first.\n');
+    return;
+  }
+
+  const projectType = detectProjectType(cwd);
+  const extensions = ['.js', '.ts', '.jsx', '.tsx', '.vue', '.svelte'];
+
+  let pattern;
+  let typeLabel;
+
+  if (projectType === 'vite') {
+    pattern = /import\.meta\.env\.([A-Z_][A-Z0-9_]*)/g;
+    typeLabel = 'Vite';
+  } else if (projectType === 'cra') {
+    pattern = /process\.env\.(REACT_APP_[A-Z0-9_]*)/g;
+    typeLabel = 'Create React App';
+  } else if (projectType === 'next') {
+    pattern = /process\.env\.([A-Z_][A-Z0-9_]*)/g;
+    typeLabel = 'Next.js';
+  } else {
+    pattern = /process\.env\.([A-Z_][A-Z0-9_]*)/g;
+    typeLabel = 'Node.js';
+  }
+
+  console.log('detected project type: ' + typeLabel + '\n');
+
+  const found = scanFiles(cwd, extensions, pattern);
+
   if (found.size === 0) {
-    console.log('no process.env references found.\n');
+    console.log('no environment variables found in your project.\n');
     return;
   }
+
   const variables = {};
   for (const key of [...found].sort()) {
     variables[key] = { required: true, description: '' };
   }
+
   const manifest = {
     version: '1',
+    projectType: projectType,
     runtime: { node: process.version.replace('v', '').split('.')[0] },
     variables
   };
-  const manifestPath = path.join(cwd, 'env.manifest.json');
-  if (fs.existsSync(manifestPath)) {
-    console.log('env.manifest.json already exists. delete it first.\n');
-    return;
-  }
+
   fs.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2));
+
   console.log('found ' + found.size + ' environment variables:\n');
   for (const key of [...found].sort()) {
     console.log('  ' + key);

package/src/validate.js

@@ -1,6 +1,24 @@
 const fs = require('fs');
 const path = require('path');
 
+function detectProjectType(cwd) {
+  if (fs.existsSync(path.join(cwd, 'vite.config.js')) ||
+      fs.existsSync(path.join(cwd, 'vite.config.ts'))) {
+    return 'vite';
+  }
+  if (fs.existsSync(path.join(cwd, 'next.config.js')) ||
+      fs.existsSync(path.join(cwd, 'next.config.ts'))) {
+    return 'next';
+  }
+  const packagePath = path.join(cwd, 'package.json');
+  if (fs.existsSync(packagePath)) {
+    const pkg = JSON.parse(fs.readFileSync(packagePath, 'utf8'));
+    const deps = Object.assign({}, pkg.dependencies, pkg.devDependencies);
+    if (deps['react-scripts']) return 'cra';
+  }
+  return 'node';
+}
+
 function readManifest() {
   const manifestPath = path.join(process.cwd(), 'env.manifest.json');
   if (!fs.existsSync(manifestPath)) {
@@ -80,9 +98,14 @@ function checkDependencyDrift() {
 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 missing = [];
   const empty = [];
   const passing = [];