flareperf 0.1.0

package/README.md

@@ -0,0 +1,43 @@
+# flareperf
+
+> **Unified Cloudflare Edge Performance & Budget Guardian**  
+> Enforce Worker bundle size budgets, analyze V8 isolate cold-start latency, verify 50-subrequest limits, and eliminate D1 SQLite N+1 query bottlenecks.
+
+## 🚀 Quickstart
+
+Run via `npx` (no installation required):
+
+```bash
+# Run comprehensive check
+npx flareperf check .
+
+# Check bundle size against Cloudflare tier budgets (free, paid, ai)
+npx flareperf bundle dist/_worker.js --budget free
+
+# Check V8 isolate cold-start complexity
+npx flareperf isolate src/index.ts
+
+# Check for 50-subrequest limit violations
+npx flareperf subrequests src/
+
+# Check for D1 N+1 query loops
+npx flareperf d1 src/
+```
+
+Or install globally:
+
+```bash
+npm install -g flareperf
+```
+
+## 📦 Rust Crate
+
+Also available on [crates.io](https://crates.io/crates/flareperf):
+
+```bash
+cargo install flareperf
+```
+
+## 📄 License
+
+MIT © [Brandon Hubbard](https://brandonhubbard.com)

package/bin/flareperf.js

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+
+const { spawnSync } = require('child_process');
+const path = require('path');
+const os = require('os');
+const fs = require('fs');
+
+const platform = os.platform();
+const binName = platform === 'win32' ? 'flareperf.exe' : 'flareperf';
+const localBinPath = path.join(__dirname, binName);
+
+let targetBin = localBinPath;
+
+if (!fs.existsSync(localBinPath)) {
+  // Check if available globally in PATH
+  try {
+    const check = spawnSync(binName, ['--version'], { stdio: 'ignore' });
+    if (check.status === 0) {
+      targetBin = binName;
+    } else {
+      console.error(`Error: Could not find flareperf binary at ${localBinPath}`);
+      console.error('Run npm rebuild flareperf or install via cargo: cargo install flareperf');
+      process.exit(1);
+    }
+  } catch (_e) {
+    console.error(`Error: Could not find flareperf binary at ${localBinPath}`);
+    console.error('Run npm rebuild flareperf or install via cargo: cargo install flareperf');
+    process.exit(1);
+  }
+}
+
+const args = process.argv.slice(2);
+const result = spawnSync(targetBin, args, { stdio: 'inherit' });
+
+if (result.error) {
+  console.error('Failed to execute flareperf:', result.error);
+  process.exit(1);
+}
+
+process.exit(result.status ?? 0);

package/install.js

@@ -0,0 +1,78 @@
+const fs = require('fs');
+const path = require('path');
+const https = require('https');
+const os = require('os');
+const { execSync } = require('child_process');
+
+const platform = os.platform();
+const arch = os.arch();
+
+const REPO = 'bhubbard/flareperf';
+const VERSION = require('./package.json').version;
+
+let assetName = 'flareperf';
+
+if (platform === 'win32') {
+  if (arch !== 'x64') throw new Error('Unsupported architecture on Windows: ' + arch);
+  assetName = 'flareperf-win32-x64.exe';
+} else if (platform === 'darwin') {
+  if (arch === 'x64') assetName = 'flareperf-darwin-x64';
+  else if (arch === 'arm64') assetName = 'flareperf-darwin-arm64';
+  else throw new Error('Unsupported architecture on macOS: ' + arch);
+} else if (platform === 'linux') {
+  if (arch !== 'x64') throw new Error('Unsupported architecture on Linux: ' + arch);
+  assetName = 'flareperf-linux-x64';
+} else {
+  throw new Error('Unsupported platform: ' + platform);
+}
+
+const url = `https://github.com/${REPO}/releases/download/v${VERSION}/${assetName}`;
+
+const binDir = path.join(__dirname, 'bin');
+const binaryPath = path.join(binDir, platform === 'win32' ? 'flareperf.exe' : 'flareperf');
+
+if (!fs.existsSync(binDir)) {
+  fs.mkdirSync(binDir, { recursive: true });
+}
+
+// If binary is already present, skip download
+if (fs.existsSync(binaryPath)) {
+  console.log(`flareperf binary already present at ${binaryPath}`);
+  process.exit(0);
+}
+
+console.log(`Downloading flareperf v${VERSION} for ${platform} ${arch}...`);
+console.log(`URL: ${url}`);
+
+function download(downloadUrl, dest) {
+  return new Promise((resolve, reject) => {
+    const file = fs.createWriteStream(dest);
+    https.get(downloadUrl, (response) => {
+      if (response.statusCode === 302 || response.statusCode === 301) {
+        download(response.headers.location, dest).then(resolve).catch(reject);
+      } else if (response.statusCode === 200) {
+        response.pipe(file);
+        file.on('finish', () => {
+          file.close();
+          resolve();
+        });
+      } else {
+        reject(new Error(`Failed to download: ${response.statusCode} ${response.statusMessage}`));
+      }
+    }).on('error', (err) => {
+      fs.unlink(dest, () => reject(err));
+    });
+  });
+}
+
+download(url, binaryPath)
+  .then(() => {
+    if (platform !== 'win32') {
+      execSync(`chmod +x "${binaryPath}"`);
+    }
+    console.log('Successfully installed flareperf binary.');
+  })
+  .catch((err) => {
+    console.warn('Notice: Could not automatically download prebuilt binary:', err.message);
+    console.warn('You can build flareperf from source with: cargo install flareperf');
+  });

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "flareperf",
+  "version": "0.1.0",
+  "description": "Unified Cloudflare Edge Performance & Budget Guardian — Bundle size budgets, V8 isolate cold-start analysis, 50-subrequest limits, and D1 batching.",
+  "main": "bin/flareperf.js",
+  "bin": {
+    "flareperf": "bin/flareperf.js"
+  },
+  "scripts": {
+    "postinstall": "node install.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bhubbard/flareperf.git"
+  },
+  "keywords": [
+    "cloudflare",
+    "workers",
+    "performance",
+    "pages",
+    "budgets",
+    "cli",
+    "linter",
+    "cold-start",
+    "d1",
+    "subrequests"
+  ],
+  "author": "Brandon Hubbard <bhubbard@users.noreply.github.com>",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/bhubbard/flareperf/issues"
+  },
+  "homepage": "https://bhubbard.github.io/flareperf",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "bin/flareperf.js",
+    "install.js",
+    "README.md"
+  ]
+}