create-bro-framework 1.0.0

package/index.js

@@ -0,0 +1,45 @@
+#!/usr/bin/env node
+import { execSync } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+
+const targetDir = process.argv[2] || 'my-bro-api';
+const dest = path.resolve(process.cwd(), targetDir);
+
+console.log(`\n💪 Bootstrapping bro.js project in ${dest}...\n`);
+
+// 1. Create the folder
+if (!fs.existsSync(dest)) {
+  fs.mkdirSync(dest, { recursive: true });
+}
+
+// 2. Initialize package.json and install the framework
+try {
+  console.log('Installing bro.js framework (this takes a few seconds)...');
+  execSync('npm init -y', { cwd: dest, stdio: 'ignore' });
+  
+  // NOTE: If you named the package "brojs" in Step 2, use "brojs" here!
+  execSync('npm install bro-framework', { cwd: dest, stdio: 'inherit' });
+
+  // 3. Add dev script to package.json
+  const pkgPath = path.join(dest, 'package.json');
+  const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+  pkg.scripts = { dev: "bro dev", start: "bro start" };
+  pkg.type = "module";
+  fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2));
+
+  // 4. Run the framework's auto-scaffolder
+  console.log('\nRunning framework setup...');
+  execSync('npx bro init', { cwd: dest, stdio: 'inherit' });
+  
+  // 5. Create a sample route
+  const routesDir = path.join(dest, 'routes');
+  fs.mkdirSync(routesDir);
+  fs.writeFileSync(path.join(routesDir, 'index.get.js'), `import { defineRoute } from 'bro-framework';\n\nexport default defineRoute({\n  handler: () => ({ message: 'Welcome to bro.js, bro.' })\n});`);
+
+  console.log(`\nDone! Your backend is ready.\n\n  cd ${targetDir}\n  npm run dev\n`);
+
+} catch (error) {
+  console.error('\nFailed to scaffold project. Make sure Node.js is installed properly.');
+  process.exit(1);
+}

package/package.json

@@ -0,0 +1,8 @@
+{
+  "name": "create-bro-framework",
+  "version": "1.0.0",
+  "type": "module",
+  "bin": {
+    "create-bro-app": "./index.js"
+  }
+}

package/template/.cursorrules

@@ -0,0 +1,48 @@
+# bro.js Project Guidelines
+
+You are operating inside a `bro.js` Node.js backend project. Follow these strict rules to ensure all generated code complies with the framework's core architecture.
+
+## Core Directives
+- **Language**: Pure JavaScript with ES Modules (`import`/`export`). Absolutely NO TypeScript (`.ts`) and NO CommonJS (`require()`).
+- **File-Based Routing**: All endpoints live in the `routes/` directory. The file name dictates the path and HTTP method (e.g., `routes/users/[id].get.js` maps to `GET /users/:id`).
+- **Imports**: Always import `{ defineRoute, z } from 'bro-framework'` when creating a route.
+- **Handler Context**: DO NOT use standard Express patterns (`req`, `res`, `next`). `bro.js` abstracts this. You must destructure the framework context inside the handler function: `({ body, params, query, user, db, io, files, error })`.
+- **Responses**: Simply return a JavaScript object or primitive. The framework automatically formats it as a `200 OK` JSON response. Do NOT use `res.json()` or `res.send()`.
+
+## Route Example
+Here is the perfect example of a protected POST route with Zod validation. Use this as your template:
+
+```javascript
+import { defineRoute, z } from 'bro-framework';
+
+export default defineRoute({
+  // Require Authorization: Bearer <token>
+  auth: true, 
+  
+  // Zod bouncer validation (auto-rejects bad requests)
+  body: z.object({
+    title: z.string().min(5),
+    content: z.string()
+  }),
+  
+  handler: async ({ body, user, db, io }) => {
+    // 1. Data is typed and safe. user is populated from the JWT.
+    
+    // 2. Access the database via the injected context
+    const post = await db.collection('posts').insertOne({
+      ...body,
+      authorId: user.id
+    });
+    
+    // 3. Emit real-time events via the injected WebSocket instance
+    io.emit('new_post', { title: body.title });
+    
+    // 4. Return an object (Automatically sends HTTP 200)
+    return {
+      success: true,
+      postId: post.insertedId
+    };
+  }
+});
+```
+