jatin-lean 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jatin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,215 @@
+# ⚡ jatin-lean
+
+**A high-performance Rust CLI utility to prune non-essential files from `node_modules`, reducing disk footprint by up to 50% without breaking runtime dependencies.**
+
+Created by **Jatin Jalandhra**
+
+[![npm version](https://img.shields.io/npm/v/jatin-lean.svg)](https://www.npmjs.com/package/jatin-lean)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+---
+
+## 🚀 Quick Start
+
+```bash
+# Run directly with npx (no installation needed)
+npx jatin-lean
+
+# Execute deletion
+npx jatin-lean --force
+
+# Verbose mode
+npx jatin-lean --verbose
+```
+
+---
+
+## 🎯 What It Does
+
+Intelligently removes non-runtime files from your `node_modules`:
+
+| Category | Examples | Risk |
+|---|---|---|
+| **Documentation** | README.md, CHANGELOG.md | ▪ Low |
+| **Test Assets** | test/, *.test.js, *.spec.js | ▪ Low |
+| **CI/CD Config** | .travis.yml, .github/ | ▪ Low |
+| **Examples** | example/, demos/ | ▪ Low |
+| **Source Maps** | *.js.map, *.css.map | ▪▪ Medium |
+| **Build Artifacts** | *.c, *.o, Makefile | ▪▪ Medium |
+| **TS Sources** | *.ts, *.tsx (keeps .d.ts) | ▪▪▪ High |
+
+---
+
+## 🛡️ Safety First
+
+Before deleting anything:
+1. ✅ Parses `package.json` entry points (main, module, exports, bin, types)
+2. ✅ Auto-whitelists runtime-critical files
+3. ✅ Never touches `.bin/` directories
+4. ✅ Dry-run mode by default (safe preview)
+
+---
+
+## 📖 Usage
+
+### Basic Commands
+
+```bash
+# Dry run (default - safe preview)
+npx jatin-lean
+
+# Execute deletion
+npx jatin-lean --force
+
+# Verbose - show every file
+npx jatin-lean --verbose
+
+# Scan specific project
+npx jatin-lean /path/to/project
+
+# Global mode - scan all projects
+npx jatin-lean ~/projects --global
+```
+
+### CLI Options
+
+| Flag | Description |
+|---|---|
+| `--force` / `-f` | Execute deletion (default is dry-run) |
+| `--verbose` / `-v` | Show individual files targeted |
+| `--global` / `-g` | Scan all projects in a directory |
+| `--max-depth N` | Max directory depth for global scan |
+| `--help` / `-h` | Print help information |
+| `--version` / `-V` | Print version |
+
+---
+
+## 📊 Example Output
+
+```
+  ╔═══════════════════════════════════════════════╗
+  ║  ⚡ jatin-lean — Node Modules Pruner ⚡      ║
+  ║     Slim your node_modules by up to 50%      ║
+  ║          Created by Jatin Jalandhra          ║
+  ╚═══════════════════════════════════════════════╝
+
+  Phase 1: Discovery ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  ◉ Scanning node_modules... Found 5,057 files across 71 packages.
+  ◉ Total size indexed: 68.7MB
+
+  Phase 2: Simulation ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  ◉ Analyzing dependency tree... 2,400 files (35MB) identified.
+
+    ╭────────────────┬───────┬─────────┬────────────╮
+    │ Category       ┆ Files ┆ Size    ┆ Risk       │
+    ╞════════════════╪═══════╪═════════╪════════════╡
+    │ Documentation  ┆ 1,200 ┆ 15MB    ┆ ▪ Low      │
+    │ Test-Asset     ┆ 800   ┆ 12MB    ┆ ▪ Low      │
+    │ Source-Map     ┆ 400   ┆ 8MB     ┆ ▪▪ Medium  │
+    ╰────────────────┴───────┴─────────┴────────────╯
+
+  Phase 3: Confirmation ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  [SAFE] No critical runtime files targeted.
+
+  💾 Total Savings: 35MB (51% of node_modules)
+  ℹ This will NOT affect npm start or npm build.
+
+  → Run with --force to execute deletion.
+  ✨ Made with ❤️  by Jatin Jalandhra
+```
+
+---
+
+## 🔧 Use Cases
+
+### In package.json Scripts
+
+```json
+{
+  "scripts": {
+    "postinstall": "jatin-lean --force",
+    "clean:modules": "jatin-lean --force"
+  }
+}
+```
+
+### In Dockerfile
+
+```dockerfile
+FROM node:18-alpine
+WORKDIR /app
+COPY package*.json ./
+RUN npm ci --production
+RUN npx jatin-lean --force
+COPY . .
+CMD ["npm", "start"]
+```
+
+### CI/CD Pipeline
+
+```yaml
+- name: Install dependencies
+  run: npm ci
+- name: Optimize node_modules
+  run: npx jatin-lean --force
+```
+
+---
+
+## 🌍 Platform Support
+
+Pre-built binaries for:
+- **Linux**: x64, ARM64
+- **macOS**: Intel, Apple Silicon
+- **Windows**: x64
+
+The correct binary is automatically downloaded during installation.
+
+---
+
+## ⚡ Performance
+
+- **Fast**: Parallel scanning with Rust + rayon
+- **Efficient**: Completes in seconds, not minutes
+- **Safe**: Entry points protected automatically
+
+Expected performance:
+- Small projects (< 100 packages): < 1 second
+- Medium projects (100-500 packages): 1-3 seconds
+- Large projects (500+ packages): 3-10 seconds
+
+---
+
+## 📄 License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+---
+
+## 🤝 Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+---
+
+## ⚠️ Disclaimer
+
+While `jatin-lean` is designed to be safe:
+1. Run in dry-run mode first (default behavior)
+2. Review the list of files to be deleted
+3. Test your application after pruning
+4. Keep backups of critical projects
+
+**Use at your own risk.**
+
+---
+
+## 🔗 Links
+
+- [GitHub Repository](https://github.com/your-username/jatin-lean)
+- [Issue Tracker](https://github.com/your-username/jatin-lean/issues)
+- [npm Package](https://www.npmjs.com/package/jatin-lean)
+
+---
+
+**Made with ❤️ by Jatin Jalandhra**

package/bin/jatin-lean.js

@@ -0,0 +1,61 @@
+#!/usr/bin/env node
+
+/**
+ * Wrapper script to execute the jatin-lean binary.
+ * This is the entry point when running `npx jatin-lean` or `jatin-lean`.
+ */
+
+const { spawn } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+const BINARY_NAME = 'jatin-lean' + (process.platform === 'win32' ? '.exe' : '');
+const BINARY_PATH = path.join(__dirname, '..', 'bin', BINARY_NAME);
+
+function runBinary() {
+  // Check if binary exists
+  if (!fs.existsSync(BINARY_PATH)) {
+    console.error('Error: jatin-lean binary not found.');
+    console.error('Please run: npm install jatin-lean');
+    console.error(`Expected location: ${BINARY_PATH}`);
+    process.exit(1);
+  }
+
+  // Check if binary is executable
+  try {
+    fs.accessSync(BINARY_PATH, fs.constants.X_OK);
+  } catch (error) {
+    console.error('Error: Binary is not executable.');
+    console.error('Attempting to fix permissions...');
+    try {
+      fs.chmodSync(BINARY_PATH, 0o755);
+      console.log('✓ Permissions fixed.');
+    } catch (chmodError) {
+      console.error('Failed to fix permissions:', chmodError.message);
+      process.exit(1);
+    }
+  }
+
+  // Pass all arguments to the binary
+  const args = process.argv.slice(2);
+  
+  const child = spawn(BINARY_PATH, args, {
+    stdio: 'inherit',
+    env: process.env,
+  });
+
+  child.on('error', (error) => {
+    console.error('Failed to start jatin-lean:', error.message);
+    process.exit(1);
+  });
+
+  child.on('exit', (code, signal) => {
+    if (signal) {
+      process.kill(process.pid, signal);
+    } else {
+      process.exit(code || 0);
+    }
+  });
+}
+
+runBinary();

package/index.js

@@ -0,0 +1,28 @@
+/**
+ * Main entry point for programmatic usage (if needed in the future).
+ * For now, this package is primarily a CLI tool.
+ */
+
+const { execSync } = require('child_process');
+const path = require('path');
+
+const BINARY_PATH = path.join(__dirname, 'bin', 'jatin-lean' + (process.platform === 'win32' ? '.exe' : ''));
+
+/**
+ * Execute jatin-lean with the given arguments.
+ * @param {string[]} args - Command line arguments
+ * @param {object} options - Execution options
+ * @returns {Buffer} - Command output
+ */
+function run(args = [], options = {}) {
+  const command = `"${BINARY_PATH}" ${args.join(' ')}`;
+  return execSync(command, {
+    stdio: 'inherit',
+    ...options,
+  });
+}
+
+module.exports = {
+  run,
+  binaryPath: BINARY_PATH,
+};

package/install.js

@@ -0,0 +1,124 @@
+#!/usr/bin/env node
+
+/**
+ * Post-install script to download the appropriate binary for the platform.
+ * This runs automatically after `npm install jatin-lean`.
+ */
+
+const fs = require('fs');
+const path = require('path');
+const https = require('https');
+const { execSync } = require('child_process');
+
+const PACKAGE_VERSION = require('./package.json').version;
+const BINARY_NAME = 'jatin-lean';
+
+// Platform-specific binary names
+const PLATFORM_MAP = {
+  'linux-x64': 'jatin-lean-linux-x64',
+  'linux-arm64': 'jatin-lean-linux-arm64',
+  'darwin-x64': 'jatin-lean-macos-x64',
+  'darwin-arm64': 'jatin-lean-macos-arm64',
+  'win32-x64': 'jatin-lean-windows-x64.exe',
+};
+
+function getPlatformKey() {
+  const platform = process.platform;
+  const arch = process.arch;
+  return `${platform}-${arch}`;
+}
+
+function getBinaryName() {
+  const platformKey = getPlatformKey();
+  const binaryName = PLATFORM_MAP[platformKey];
+  
+  if (!binaryName) {
+    console.error(`Unsupported platform: ${platformKey}`);
+    console.error('Supported platforms:', Object.keys(PLATFORM_MAP).join(', '));
+    process.exit(1);
+  }
+  
+  return binaryName;
+}
+
+function getBinaryPath() {
+  return path.join(__dirname, 'bin', BINARY_NAME + (process.platform === 'win32' ? '.exe' : ''));
+}
+
+function downloadBinary(url, dest) {
+  return new Promise((resolve, reject) => {
+    console.log(`Downloading ${url}...`);
+    
+    const file = fs.createWriteStream(dest);
+    
+    https.get(url, (response) => {
+      if (response.statusCode === 302 || response.statusCode === 301) {
+        // Follow redirect
+        https.get(response.headers.location, (redirectResponse) => {
+          redirectResponse.pipe(file);
+          file.on('finish', () => {
+            file.close();
+            resolve();
+          });
+        }).on('error', reject);
+      } else if (response.statusCode === 200) {
+        response.pipe(file);
+        file.on('finish', () => {
+          file.close();
+          resolve();
+        });
+      } else {
+        reject(new Error(`Failed to download: HTTP ${response.statusCode}`));
+      }
+    }).on('error', reject);
+  });
+}
+
+async function install() {
+  const binaryName = getBinaryName();
+  const binaryPath = getBinaryPath();
+  const binDir = path.dirname(binaryPath);
+  
+  // Create bin directory if it doesn't exist
+  if (!fs.existsSync(binDir)) {
+    fs.mkdirSync(binDir, { recursive: true });
+  }
+  
+  // Check if binary already exists (for local development)
+  if (fs.existsSync(binaryPath)) {
+    console.log('Binary already exists, skipping download.');
+    fs.chmodSync(binaryPath, 0o755);
+    return;
+  }
+  
+  // For now, try to copy from local build if available (development mode)
+  const localBinaryPath = path.join(__dirname, '..', 'target', 'release', BINARY_NAME);
+  if (fs.existsSync(localBinaryPath)) {
+    console.log('Using local development binary...');
+    fs.copyFileSync(localBinaryPath, binaryPath);
+    fs.chmodSync(binaryPath, 0o755);
+    console.log('✓ Installation complete!');
+    return;
+  }
+  
+  // In production, download from GitHub releases
+  const downloadUrl = `https://github.com/your-username/jatin-lean/releases/download/v${PACKAGE_VERSION}/${binaryName}`;
+  
+  try {
+    await downloadBinary(downloadUrl, binaryPath);
+    fs.chmodSync(binaryPath, 0o755);
+    console.log('✓ Installation complete!');
+  } catch (error) {
+    console.error('Failed to download binary:', error.message);
+    console.error('\nYou can manually download the binary from:');
+    console.error(downloadUrl);
+    console.error(`\nAnd place it at: ${binaryPath}`);
+    process.exit(1);
+  }
+}
+
+// Run installation
+install().catch((error) => {
+  console.error('Installation failed:', error);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "jatin-lean",
+  "version": "0.1.0",
+  "description": "A high-performance CLI utility to prune non-essential files from node_modules, reducing disk footprint by up to 50% without breaking runtime dependencies.",
+  "main": "index.js",
+  "bin": {
+    "jatin-lean": "bin/jatin-lean.js"
+  },
+  "scripts": {
+    "postinstall": "node install.js",
+    "test": "node bin/jatin-lean.js --help"
+  },
+  "keywords": [
+    "node_modules",
+    "cleanup",
+    "prune",
+    "disk-space",
+    "optimization",
+    "npm",
+    "dependencies",
+    "cli"
+  ],
+  "author": "Jatin Jalandhra",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/your-username/jatin-lean.git"
+  },
+  "bugs": {
+    "url": "https://github.com/your-username/jatin-lean/issues"
+  },
+  "homepage": "https://github.com/your-username/jatin-lean#readme",
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "os": [
+    "linux",
+    "darwin",
+    "win32"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ],
+  "files": [
+    "bin/",
+    "install.js",
+    "index.js",
+    "README.md",
+    "LICENSE"
+  ]
+}