Basic Scan Example

# Install globally
npm install -g kafkacode

# Scan your project
kafkacode scan ./src

# Project structure
my-app/
├── src/
│   ├── config.js
│   ├── auth.js
│   └── utils/
│       └── validator.js
└── package.json

cd my-app
kafkacode scan ./src

🎯 PRIVACY SCAN REPORT
═══════════════════════════════════════════════════════════

📊 SCAN SUMMARY
📁 Directory: ./src
⏰ Timestamp: 2025-01-15 10:30:45
📄 Files Scanned: 3
🔍 Total Issues: 2
🏆 Privacy Grade: 🟡 B-

═══════════════════════════════════════════════════════════

🔴 CRITICAL (1)
────────────────────────────────────────────────────────────
  📄 src/config.js:5
     AWS Access Key detected
     const AWS_KEY = "AKIAIOSFODNN7EXAMPLE"

     💡 Recommendation: Move to environment variables

🟡 MEDIUM (1)
────────────────────────────────────────────────────────────
  📄 src/utils/validator.js:12
     Email address found in code
     const adminEmail = "[email protected]"

     💡 Recommendation: Use configuration file

═══════════════════════════════════════════════════════════

// ❌ Hardcoded credentials
const AWS_KEY = "AKIAIOSFODNN7EXAMPLE";
const DB_PASSWORD = "mypassword123";
const adminEmail = "[email protected]";

module.exports = {
  AWS_KEY,
  DB_PASSWORD,
  adminEmail
};

AWS_KEY=AKIAIOSFODNN7EXAMPLE
DB_PASSWORD=mypassword123
ADMIN_EMAIL=[email protected]

// ✅ Using environment variables
require('dotenv').config();

module.exports = {
  AWS_KEY: process.env.AWS_KEY,
  DB_PASSWORD: process.env.DB_PASSWORD,
  adminEmail: process.env.ADMIN_EMAIL
};

kafkacode scan ./src

📊 SCAN SUMMARY
📄 Files Scanned: 3
🔍 Total Issues: 0
🏆 Privacy Grade: 🟢 A+

✅ No privacy issues detected!

kafkacode scan ./src --verbose

🚀 Starting KafkaCode privacy scan...
📁 Discovering source code files...
Found 3 files to analyze
🔍 Performing privacy analysis...

Analyzing: src/config.js
Analyzing: src/auth.js
Analyzing: src/utils/validator.js

✅ Analysis complete

🎯 PRIVACY SCAN REPORT
[... report details ...]

{
  "scripts": {
    "scan": "kafkacode scan ./src",
    "prescan": "echo '🔍 Running privacy scan...'",
    "test": "npm run scan && jest"
  }
}

npm run scan

#!/bin/bash

echo "🔍 Running KafkaCode privacy scan..."

kafkacode scan ./src

if [ $? -ne 0 ]; then
  echo "❌ Privacy issues detected. Commit aborted."
  exit 1
fi

echo "✅ Privacy scan passed"
exit 0

chmod +x .git/hooks/pre-commit

# Scan without installing
npx kafkacode scan ./src

# Scan with verbose mode
npx kafkacode scan ./src --verbose

# 1. Create project
mkdir my-project && cd my-project
npm init -y

# 2. Create source files
mkdir src
echo "const apiKey = 'test-key';" > src/config.js

# 3. Scan
npx kafkacode scan ./src

# 4. Fix issues and add to CI
npm install --save-dev kafkacode
# Add to package.json scripts

#!/bin/bash

echo "Pre-deployment privacy check..."

kafkacode scan ./src

if [ $? -eq 0 ]; then
  echo "✅ Privacy check passed. Deploying..."
  npm run deploy
else
  echo "❌ Privacy issues found. Deployment aborted."
  exit 1
fi

# Create temp directory with files to scan
mkdir -p /tmp/scan
cp src/config.js src/auth.js /tmp/scan/

# Scan only these files
kafkacode scan /tmp/scan