@wxn0brp/falcon-frame 0.8.2 → 0.8.3

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 wxn0brP
+Copyright (c) 2026 wxn0brP
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,25 +1,24 @@
 # FalconFrame
 
-> Lightweight modular TypeScript web framework built for speed and clarity.
+A minimal, modular TypeScript web library.
 
-**FalconFrame** is a minimalist web framework inspired by the middleware-first style, with routing similar to Express, but written in pure TypeScript. It supports static files, data validation, and cookie management, all without external dependencies apart from a logger.
+## Features
 
-## ✨ Features
+- Zero-dependency routing engine
+- Middleware chaining
+- Static file serving
+- Request validation via inline schemas
+- OpenAPI document generation
+- Cookie management
+- Debuggable logger
 
-- 🚀 Zero-dependency routing engine
-- 🧱 Middleware chaining
-- 📁 Static file serving
-- 📦 Request validation via inline schemas
-- 🍪 Cookie management
-- 🔍 Debuggable logger
-
-## 📦 Installation
+## Installation
 
 ```bash
-yarn add @wxn0brp/falcon-frame
+bun add @wxn0brp/falcon-frame
 ```
 
-## 🚦 Usage Example
+## Usage Example
 
 ```ts
 import FalconFrame, { validateBody } from "@wxn0brp/falcon-frame";
@@ -83,13 +82,13 @@ app.post(
 // Protected route
 app.get("/dashboard", requireAuth, (req, res) => {
     return {
-        message: `👑 Welcome to the dashboard, ${req.cookies.session}`,
+        message: `Welcome to the dashboard, ${req.cookies.session}`,
     });
 });
 
 app.post("/logout", (req, res) => {
     res.cookie("session", "", { maxAge: 0 });
-    res.json({ message: "👋 Logged out" });
+    res.json({ message: "Logged out" });
 });
 
 // if no route matches
@@ -101,6 +100,6 @@ app.set404((req, res) => {
 app.l(3000);
 ```
 
-## 📜 License
+## License
 
-Published under the MIT license
+Published under the MIT license.

package/dist/req.js

@@ -1,3 +1,4 @@
+import { randomUUID } from "crypto";
 import { URL } from "url";
 import { parseCookies } from "./helpers.js";
 import { getMiddlewares, matchMiddleware } from "./middleware.js";
@@ -34,6 +35,12 @@ export function handleRequest(req, res, FF, reRoute = false) {
         fn(req);
         handleRequest(req, res, FF, true);
     };
+    if (FF.opts.xRequestId !== "disable") {
+        if (req.headers["x-request-id"])
+            res.setHeader("x-request-id", req.headers["x-request-id"]);
+        else if (FF.opts.xRequestId === "auto")
+            res.setHeader("x-request-id", randomUUID());
+    }
     logger.info(`Incoming request: ${req.method} ${req.url}`);
     const middlewaresPath = req.path + "/";
     const middlewares = getMiddlewares(FF.middlewares, middlewaresPath.replace(/\/+/g, "/"));

package/dist/sse.d.ts

@@ -1,7 +1,10 @@
 import { FFResponse } from "./res.js";
 import type { FFRequest, RouteHandler } from "./types.js";
 export declare class SSEManager {
-    private clients;
+    _clients: Map<string, {
+        req: FFRequest;
+        res: FFResponse;
+    }>;
     getMiddleware(lastHandler?: RouteHandler): RouteHandler;
     getClients(): Map<string, {
         req: FFRequest;

package/dist/sse.js

@@ -1,37 +1,37 @@
 import { randomUUID } from "crypto";
 export class SSEManager {
-    clients = new Map();
+    _clients = new Map();
     getMiddleware(lastHandler) {
         return (req, res, next) => {
             res.sseInit();
             const id = randomUUID();
-            this.clients.set(id, { req, res });
+            this._clients.set(id, { req, res });
             req.on("close", () => {
-                this.clients.delete(id);
+                this._clients.delete(id);
             });
             req.sseId = id;
             lastHandler?.(req, res, next);
         };
     }
     getClients() {
-        return this.clients;
+        return this._clients;
     }
     sendAll(data) {
-        for (const { res } of this.clients.values()) {
+        for (const { res } of this._clients.values()) {
             res.sseSend(data);
         }
     }
     sendTo(id, data) {
-        const client = this.clients.get(id);
+        const client = this._clients.get(id);
         if (client) {
             client.res.sseSend(data);
         }
     }
     disconnect(id) {
-        const client = this.clients.get(id);
+        const client = this._clients.get(id);
         if (client) {
             client.res.end();
-            this.clients.delete(id);
+            this._clients.delete(id);
         }
     }
 }

package/dist/types.d.ts

@@ -82,6 +82,7 @@ export interface FFOpts {
     bodyLimit?: string;
     disableJsonParser?: boolean;
     disableUrlencodedParser?: boolean;
+    xRequestId?: "auto" | "disable" | "manual";
 }
 export type FFVars = {
     "render data": Record<string, any>;

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@wxn0brp/falcon-frame",
-  "version": "0.8.2",
+  "version": "0.8.3",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "author": "wxn0brP",
   "license": "MIT",
   "type": "module",
-  "description": "Lightweight modular TypeScript web framework",
+  "description": "Lightweight modular TypeScript web library",
   "homepage": "https://github.com/wxn0brP/FalconFrame",
   "repository": {
     "type": "git",
@@ -15,7 +15,6 @@
   "keywords": [
     "http",
     "web",
-    "framework",
     "typescript",
     "modular",
     "lightweight",
@@ -26,10 +25,10 @@
   "devDependencies": {
     "@types/node": "*",
     "tsc-alias": "*",
-    "typescript": "^6"
+    "typescript": "^7"
   },
   "dependencies": {
-    "@wxn0brp/lucerna-log": "^0.2.2"
+    "@wxn0brp/lucerna-log": "^0.2.4"
   },
   "files": [
     "dist"