safelaunch 1.0.8 → 1.0.10

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.
 
-Automatically detects your project type and runs the right checks.
+Works with Node.js, Next.js, Vite, and Create React App projects. Automatically detects your project type and runs the right checks.
 
 ## Install
 
@@ -16,9 +16,7 @@ npm install -g safelaunch
 
 safelaunch init
 
-Scans your entire codebase and generates env.manifest.json automatically.
-
-Works with process.env and import.meta.env.
+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 every push**
 
@@ -26,7 +24,7 @@ safelaunch validate
 
 ## What safelaunch checks
 
-safelaunch validate runs 11 checks:
+safelaunch validate runs 7 checks:
 
 1. Missing required environment variables
 2. Empty required environment variables
@@ -35,50 +33,59 @@ safelaunch validate runs 11 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
 
-## Supported project types
+## Example output
 
-safelaunch automatically detects your project type.
+Running safelaunch...
 
-- 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
+project type: Node.js
 
-## Example output
+⚠️  RUNTIME MISMATCH
 
-Running safelaunch...
+   Node required: 18
+   Node actual:   20
+
+⚠️  DEPENDENCY DRIFT (1 found)
 
-project type: Vite
+   express   in package.json but not installed
 
-⚠️  FRAMEWORK PREFIX WARNINGS (1 found)
+❌ EMPTY VARIABLES (1 found)
 
-   API_URL   missing VITE_ prefix - will be undefined in browser
+   DATABASE_URL   required but empty in .env
 
 ❌ MISSING VARIABLES (1 found)
 
-   VITE_STRIPE_KEY   required but missing from .env
+   REDIS_URL   required but missing from .env
 
 ✅ PASSING (1)
 
-   VITE_API_URL   present
+   API_KEY   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
 
-JavaScript 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.8",
+  "version": "1.0.10",
   "description": "Backend Reliability Infrastructure - catch what breaks production before it breaks",
   "main": "index.js",
   "bin": {
@@ -16,5 +16,8 @@
     "devops"
   ],
   "author": "",
-  "license": "ISC"
+  "license": "ISC",
+  "dependencies": {
+    "posthog-node": "^5.28.2"
+  }
 }

package/src/init.js

@@ -1,13 +1,14 @@
 const fs = require('fs');
 const path = require('path');
+const { track, shutdown } = require('./telemetry');
 
 function detectProjectType(cwd) {
   if (fs.existsSync(path.join(cwd, 'vite.config.js')) ||
-      fs.existsSync(path.join(cwd, 'vite.config.ts'))) {
+    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'))) {
+    fs.existsSync(path.join(cwd, 'next.config.ts'))) {
     return 'next';
   }
   const packagePath = path.join(cwd, 'package.json');
@@ -38,20 +39,20 @@ function scanFiles(dir, extensions, pattern, found = new Set()) {
   return found;
 }
 
-function init() {
+async function init() {
   console.log('\nscanning project for environment variables...\n');
-
   const cwd = process.cwd();
   const manifestPath = path.join(cwd, 'env.manifest.json');
 
   if (fs.existsSync(manifestPath)) {
     console.log('env.manifest.json already exists. delete it first.\n');
+    await track('safelaunch_init_already_exists');
+    await shutdown();
     return;
   }
 
   const projectType = detectProjectType(cwd);
   const extensions = ['.js', '.ts', '.jsx', '.tsx', '.vue', '.svelte'];
-
   let pattern;
   let typeLabel;
 
@@ -70,11 +71,12 @@ function init() {
   }
 
   console.log('detected project type: ' + typeLabel + '\n');
-
   const found = scanFiles(cwd, extensions, pattern);
 
   if (found.size === 0) {
     console.log('no environment variables found in your project.\n');
+    await track('safelaunch_init_run', { project_type: projectType, vars_found: 0 });
+    await shutdown();
     return;
   }
 
@@ -97,6 +99,9 @@ function init() {
     console.log('  ' + key);
   }
   console.log('\ncreated env.manifest.json\n');
+
+  await track('safelaunch_init_run', { project_type: projectType, vars_found: found.size });
+  await shutdown();
 }
 
 init();

package/src/telemetry.js

@@ -0,0 +1,22 @@
+const { PostHog } = require('posthog-node');
+
+const client = new PostHog('phc_WFm3O5H7wkZK2Ne3kyy5QgUXJR8y86SQbszSwk3BUn0', {
+  host: 'https://us.i.posthog.com'
+});
+
+function track(event, properties = {}) {
+  client.capture({
+    distinctId: 'anonymous',
+    event,
+    properties: {
+      ...properties,
+      cli_version: require('../../package.json').version,
+    }
+  });
+}
+
+async function shutdown() {
+  await client.shutdown();
+}
+
+module.exports = { track, shutdown };

package/src/validate.js

@@ -1,5 +1,6 @@
 const fs = require('fs');
 const path = require('path');
+const { track, shutdown } = require('./telemetry');
 
 function detectProjectType(cwd) {
   if (fs.existsSync(path.join(cwd, 'vite.config.js')) ||
@@ -28,42 +29,30 @@ function readManifest() {
   return JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
 }
 
-function readEnv(cwd) {
-  const envFiles = ['.env.local', '.env.development.local', '.env.production.local', '.env.development', '.env.production', '.env'];
+function readEnv() {
+  const envPath = path.join(process.cwd(), '.env');
+  if (!fs.existsSync(envPath)) {
+    console.log('\nNo .env file found.\n');
+    process.exit(1);
+  }
   const envVars = {};
   const duplicates = [];
   const seen = new Set();
-  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();
-        }
-      }
+  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();
     }
   }
-
-  if (loadedFiles.length === 0) {
-    console.log('\nNo .env file found.\n');
-    process.exit(1);
-  }
-
-  return { envVars, duplicates, loadedFiles };
+  return { envVars, duplicates };
 }
 
-function readEnvExample(cwd) {
-  const envExamplePath = path.join(cwd, '.env.example');
+function readEnvExample() {
+  const envExamplePath = path.join(process.cwd(), '.env.example');
   if (!fs.existsSync(envExamplePath)) return null;
   const envVars = {};
   const lines = fs.readFileSync(envExamplePath, 'utf8').split('\n');
@@ -82,8 +71,8 @@ function checkRuntime(manifest) {
   return null;
 }
 
-function checkEnvExample(envVars, cwd) {
-  const example = readEnvExample(cwd);
+function checkEnvExample(envVars) {
+  const example = readEnvExample();
   if (!example) return [];
   const missing = [];
   for (const key of Object.keys(example)) {
@@ -92,9 +81,9 @@ function checkEnvExample(envVars, cwd) {
   return missing;
 }
 
-function checkDependencyDrift(cwd) {
-  const packagePath = path.join(cwd, 'package.json');
-  const modulesPath = path.join(cwd, 'node_modules');
+function checkDependencyDrift() {
+  const packagePath = path.join(process.cwd(), 'package.json');
+  const modulesPath = path.join(process.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'));
@@ -107,57 +96,17 @@ function checkDependencyDrift(cwd) {
   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() {
+async function validate() {
   console.log('\nRunning safelaunch...\n');
 
   const cwd = process.cwd();
   const manifest = readManifest();
-  const projectType = manifest.projectType || detectProjectType(cwd);
+  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 = [];
@@ -173,9 +122,8 @@ function validate() {
   }
 
   const runtimeMismatch = checkRuntime(manifest);
-  const exampleMissing = checkEnvExample(envVars, cwd);
-  const drift = checkDependencyDrift(cwd);
-  const prefixWarnings = checkFrameworkPrefixes(envVars, manifest, projectType);
+  const exampleMissing = checkEnvExample(envVars);
+  const drift = checkDependencyDrift();
 
   if (runtimeMismatch) {
     console.log('⚠️  RUNTIME MISMATCH\n');
@@ -187,7 +135,7 @@ function validate() {
   if (duplicates.length > 0) {
     console.log('⚠️  DUPLICATE VARIABLES (' + duplicates.length + ' found)\n');
     for (const key of duplicates) {
-      console.log('   ' + key);
+      console.log('   ' + key + '   defined more than once in .env');
     }
     console.log('');
   }
@@ -205,14 +153,6 @@ 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) {
@@ -246,15 +186,36 @@ function validate() {
   }
 
   const hasFailed = runtimeMismatch || missing.length > 0 || empty.length > 0 ||
-    duplicates.length > 0 || exampleMissing.length > 0 || prefixWarnings.length > 0 ||
+    duplicates.length > 0 || exampleMissing.length > 0 ||
     (drift && (drift.notInstalled || drift.missing.length > 0));
 
   if (hasFailed) {
     console.log('Your environment is not ready for production.\n');
+    await track('safelaunch_validate_run', {
+      project_type: projectType,
+      passed: false,
+      missing: missing.length,
+      empty: empty.length,
+      duplicates: duplicates.length,
+      runtime_mismatch: !!runtimeMismatch,
+      dependency_drift: !!(drift && drift.missing.length > 0)
+    });
+    await shutdown();
     process.exit(1);
   } else {
     console.log('Your environment is ready for production.\n');
+    await track('safelaunch_validate_run', {
+      project_type: projectType,
+      passed: true,
+      vars_passing: passing.length
+    });
+    await shutdown();
   }
 }
 
-validate();
+validate();
+```
+
+Save with **Cmd + S**. Now we need to publish this to npm. Go to Terminal and run:
+```
+cd ~/safelaunch/safelaunch