dj-express 1.0.1

package/.gitattributes

@@ -0,0 +1,2 @@
+# Auto detect text files and perform LF normalization
+* text=auto

package/README.md

@@ -0,0 +1,136 @@
+# Mini Express
+
+A minimal Express.js implementation for beginners to understand how Express works internally.
+
+## Quick Start
+
+```bash
+node example.js
+```
+
+## How Express Works (Internally)
+
+### 1. Routes are just an Array
+
+```javascript
+const routes = [];
+
+app.get = (path, handler) => {
+  routes.push({ method: "GET", path, handler });
+};
+```
+
+When you call `app.get("/users", handler)`, it simply adds to an array!
+
+### 2. Middlewares are also an Array
+
+```javascript
+const middlewares = [];
+
+app.use = (middleware) => {
+  middlewares.push(middleware);
+};
+```
+
+### 3. The `next()` Function (Magic!)
+
+```javascript
+let i = 0;
+
+function next() {
+  const middleware = middlewares[i++];
+  if (middleware) {
+    middleware(req, res, next);
+  } else {
+    handleRoute();
+  }
+}
+```
+
+`next()` simply calls the next function in the array!
+
+### 4. `res.send()` is just a wrapper
+
+```javascript
+res.send = (data) => {
+  if (typeof data === "object") {
+    res.setHeader("Content-Type", "application/json");
+    res.end(JSON.stringify(data));
+  } else {
+    res.end(data);
+  }
+};
+```
+
+### 5. Body Parsing (Reading POST data)
+
+```javascript
+req.on("data", (chunk) => (body += chunk));
+req.on("end", () => {
+  req.body = JSON.parse(body);
+});
+```
+
+Node.js sends data in chunks, we collect them and parse.
+
+## Usage
+
+```javascript
+const { createApp } = require("./index");
+
+const app = createApp();
+
+// Middleware
+app.use((req, res, next) => {
+  console.log(req.method, req.url);
+  next();
+});
+
+// Routes
+app.get("/", (req, res) => {
+  res.json({ message: "Hello!" });
+});
+
+app.get("/users/:id", (req, res) => {
+  res.json({ userId: req.params.id });
+});
+
+app.post("/data", (req, res) => {
+  res.json(req.body);
+});
+
+app.listen(3000);
+```
+
+## Test Commands
+
+```bash
+# GET request
+curl http://localhost:3000/
+
+# Route params
+curl http://localhost:3000/users/123
+
+# Query params
+curl "http://localhost:3000/search?q=express"
+
+# POST with body
+curl -X POST -H "Content-Type: application/json" -d '{"name":"John"}' http://localhost:3000/data
+```
+
+## Features
+
+| Feature        | How it works                                     |
+| -------------- | ------------------------------------------------ |
+| Routing        | Routes stored in array, matched by path & method |
+| Middleware     | Array of functions, `next()` calls the next one  |
+| `req.params`   | Extracted from `/users/:id` pattern              |
+| `req.query`    | Parsed from `?key=value`                         |
+| `req.body`     | Parsed from POST request body                    |
+| `res.send()`   | Auto-detects JSON vs text                        |
+| `res.json()`   | Sends JSON response                              |
+| `res.status()` | Sets status code                                 |
+
+## License
+
+MIT

package/example.js

@@ -0,0 +1,98 @@
+/**
+ * Mini Express - Example Usage
+ *
+ * Run: node example.js
+ * Test: curl http://localhost:3000/
+ */
+
+const { createApp } = require("./index");
+
+const app = createApp();
+
+// ============================================
+// MIDDLEWARE EXAMPLES
+// ============================================
+
+// Middleware 1: Logger - Har request log karta hai
+app.use((req, res, next) => {
+  console.log(`[${new Date().toLocaleTimeString()}] ${req.method} ${req.url}`);
+  next(); // IMPORTANT: next() call karna zaroori hai!
+});
+
+// Middleware 2: Custom header add karta hai
+app.use((req, res, next) => {
+  res.setHeader("X-Powered-By", "Mini-Express");
+  next();
+});
+
+// ============================================
+// ROUTE EXAMPLES
+// ============================================
+
+// GET / - Home page
+app.get("/", (req, res) => {
+  res.send({ message: "Welcome to Mini Express! 🚀" });
+});
+
+// GET /hello - Simple text response
+app.get("/hello", (req, res) => {
+  res.send("<h1>Hello World!</h1>");
+});
+
+// GET /users/:id - Route params example
+// Try: curl http://localhost:3000/users/123
+app.get("/users/:id", (req, res) => {
+  res.json({
+    message: "User found!",
+    userId: req.params.id,
+  });
+});
+
+// GET /search?q=something - Query params example
+// Try: curl "http://localhost:3000/search?q=express&limit=10"
+app.get("/search", (req, res) => {
+  res.json({
+    message: "Search results",
+    query: req.query,
+  });
+});
+
+// POST /data - Body parsing example
+// Try: curl -X POST -H "Content-Type: application/json" -d '{"name":"John"}' http://localhost:3000/data
+app.post("/data", (req, res) => {
+  res.status(201).json({
+    message: "Data received!",
+    data: req.body,
+  });
+});
+
+// GET /posts/:postId/comments/:commentId - Multiple params
+// Try: curl http://localhost:3000/posts/1/comments/42
+app.get("/posts/:postId/comments/:commentId", (req, res) => {
+  res.json({
+    postId: req.params.postId,
+    commentId: req.params.commentId,
+  });
+});
+
+// ============================================
+// START SERVER
+// ============================================
+
+const PORT = 3000;
+
+app.listen(PORT, () => {
+  console.log(`
+╔═══════════════════════════════════════════════╗
+║  Mini Express Server Running!                 ║
+║  http://localhost:${PORT}                        ║
+╠═══════════════════════════════════════════════╣
+║  Try these URLs:                              ║
+║  • GET  /                                     ║
+║  • GET  /hello                                ║
+║  • GET  /users/123                            ║
+║  • GET  /search?q=express                     ║
+║  • POST /data  (with JSON body)               ║
+╚═══════════════════════════════════════════════╝
+    `);
+});

package/index.js

@@ -0,0 +1,242 @@
+/**
+ * Mini Express - A minimal Express.js implementation
+ *
+ * This shows how Express works internally.
+ * Express is not magic - it's just JavaScript!
+ */
+
+// ============================================
+// STEP 1: CREATE APP FUNCTION
+// ============================================
+// Express ka createApp() ek function return karta hai
+// jo http.createServer() ke saath use hota hai
+
+function createApp() {
+  // ============================================
+  // STEP 2: ROUTES STORAGE
+  // ============================================
+  // Routes ek simple array mein store hote hain
+  // Jab app.get() ya app.post() call hota hai, route yahan add hota hai
+
+  const routes = [];
+
+  // ============================================
+  // STEP 3: MIDDLEWARE STORAGE
+  // ============================================
+  // Middlewares bhi ek array mein store hote hain
+  // Jab app.use() call hota hai, middleware yahan add hota hai
+
+  const middlewares = [];
+
+  // ============================================
+  // STEP 4: MAIN REQUEST HANDLER
+  // ============================================
+  // Ye function har HTTP request pe call hota hai
+  // http.createServer(app) - yahan 'app' ye function hai
+
+  const app = (req, res) => {
+    // ============================================
+    // STEP 5: ENHANCE RESPONSE OBJECT
+    // ============================================
+    // Express mein res.send(), res.json() kaise kaam karta hai
+
+    // res.send() - Automatically detect karta hai data type
+    res.send = (data) => {
+      if (typeof data === "object") {
+        res.setHeader("Content-Type", "application/json");
+        res.end(JSON.stringify(data));
+      } else {
+        res.setHeader("Content-Type", "text/html");
+        res.end(data);
+      }
+    };
+
+    // res.json() - Directly JSON bhejta hai
+    res.json = (data) => {
+      res.setHeader("Content-Type", "application/json");
+      res.end(JSON.stringify(data));
+    };
+
+    // res.status() - Status code set karta hai
+    res.status = (code) => {
+      res.statusCode = code;
+      return res; // Chaining ke liye
+    };
+
+    // ============================================
+    // STEP 6: BODY PARSING (POST DATA)
+    // ============================================
+    // Node.js mein body directly nahi milta
+    // Hume stream se data read karna padta hai
+
+    function parseBody(callback) {
+      let body = "";
+
+      // Data chunks aate hain
+      req.on("data", (chunk) => {
+        body += chunk;
+      });
+
+      // Jab poora data aa jaye
+      req.on("end", () => {
+        try {
+          req.body = JSON.parse(body);
+        } catch {
+          req.body = {};
+        }
+        callback();
+      });
+    }
+
+    // ============================================
+    // STEP 7: ROUTE MATCHING
+    // ============================================
+    // URL ke according sahi route dhundhta hai
+
+    function handleRoute() {
+      const { url, method } = req;
+
+      // Parse URL (query string alag karo)
+      const [path, queryString] = url.split("?");
+
+      // Query params parse karo (?name=John&age=25)
+      req.query = {};
+      if (queryString) {
+        queryString.split("&").forEach((param) => {
+          const [key, value] = param.split("=");
+          req.query[key] = decodeURIComponent(value || "");
+        });
+      }
+
+      // Route dhundho
+      for (const route of routes) {
+        const match = matchRoute(route.path, path);
+
+        if (match && route.method === method) {
+          req.params = match.params; // URL params (/users/:id)
+          route.handler(req, res);
+          return;
+        }
+      }
+
+      // Koi route match nahi hua
+      res.status(404).send("404 Not Found");
+    }
+
+    // ============================================
+    // STEP 8: MIDDLEWARE CHAIN (CORE MAGIC!)
+    // ============================================
+    // Ye Express ka sabse important concept hai
+    // next() call karne pe agle middleware pe jaata hai
+
+    let middlewareIndex = 0;
+
+    function next() {
+      // Current middleware lo
+      const middleware = middlewares[middlewareIndex++];
+
+      if (middleware) {
+        // Middleware execute karo, next pass karo
+        middleware(req, res, next);
+      } else {
+        // Koi middleware nahi bacha, route handle karo
+        handleRoute();
+      }
+    }
+
+    // ============================================
+    // STEP 9: START THE CHAIN
+    // ============================================
+    // Pehle body parse karo (POST ke liye)
+    // Phir middleware chain start karo
+
+    parseBody(() => {
+      next();
+    });
+  };
+
+  // ============================================
+  // STEP 10: ROUTE REGISTRATION METHODS
+  // ============================================
+  // app.get(), app.post() kaise kaam karte hain
+  // Ye simply routes array mein push karte hain
+
+  app.get = (path, handler) => {
+    routes.push({ method: "GET", path, handler });
+  };
+
+  app.post = (path, handler) => {
+    routes.push({ method: "POST", path, handler });
+  };
+
+  app.put = (path, handler) => {
+    routes.push({ method: "PUT", path, handler });
+  };
+
+  app.delete = (path, handler) => {
+    routes.push({ method: "DELETE", path, handler });
+  };
+
+  // ============================================
+  // STEP 11: MIDDLEWARE REGISTRATION
+  // ============================================
+  // app.use() kaise kaam karta hai
+  // Ye simply middlewares array mein push karta hai
+
+  app.use = (middleware) => {
+    middlewares.push(middleware);
+  };
+
+  // ============================================
+  // STEP 12: LISTEN METHOD
+  // ============================================
+  // app.listen() - Express style server start
+
+  app.listen = (port, callback) => {
+    const http = require("http");
+    const server = http.createServer(app);
+    server.listen(port, callback);
+    return server;
+  };
+
+  return app;
+}
+
+// ============================================
+// HELPER: ROUTE MATCHING WITH PARAMS
+// ============================================
+// /users/:id ko /users/123 se match karta hai
+// aur { id: "123" } return karta hai
+
+function matchRoute(routePath, actualPath) {
+  const routeParts = routePath.split("/");
+  const actualParts = actualPath.split("/");
+
+  // Length match nahi ho thi toh false
+  if (routeParts.length !== actualParts.length) {
+    return null;
+  }
+
+  const params = {};
+
+  for (let i = 0; i < routeParts.length; i++) {
+    const routePart = routeParts[i];
+    const actualPart = actualParts[i];
+
+    // :param pattern check karo
+    if (routePart.startsWith(":")) {
+      const paramName = routePart.slice(1); // ":" hatao
+      params[paramName] = actualPart;
+    } else if (routePart !== actualPart) {
+      // Match nahi hua
+      return null;
+    }
+  }
+
+  return { params };
+}
+
+// ============================================
+// EXPORT
+// ============================================
+module.exports = { createApp };

package/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "dj-express",
+  "version": "1.0.1",
+  "description": "A minimal Express.js implementation for beginners - learn how Express works internally",
+  "main": "index.js",
+  "scripts": {
+    "start": "node example.js"
+  },
+  "keywords": [
+    "express",
+    "http",
+    "server",
+    "educational",
+    "learning"
+  ],
+  "author": "",
+  "license": "MIT"
+}