Linebridge

A multiproposal framework to build fast, scalable, and secure servers.

Currently used on RageStudio's services backends, like Comty

Suported Engines

• hyper-express (default) | High Performance Node.js Webserver.
• worker | IPC Worker for sharding and efficient multi-threading.

Features

• Multiproposal architecture | Designed to adapt to different project needs.
• Modular and Extensible | Easily add or replace components as needed.
• 🚀 Fast & Scalable | Optimized for performance under high traffic.
• 🔐 Secure by Default | Security-focused setup right out of the box.
• 📡 Supports WebSockets | Real-time communication ready.
• 📦 Multi-Protocol Support | Communicate over multiple protocols effortlessly.
• 🔧 Built-in Transcompiler | Automatically transcompiles code on boot for smoother deployment.

Getting Started

Installation

npm install linebridge

Warning

If you're using Yarn, you might encounter installation issues. We recommend using npm.

Example

Create a http server

// index.js
import { Server } from "linebridge"

class MyAPI extends Server {
    // set a id for the server
    static refName = "my-api"
    // define a file based router
    static routesPath = `${__dirname}/routes`
    // define custom listen port
    static listenPort = 3000

    // set manual routes
    routes = {
        // basic route
        "/hi": {
            method: "get",
            fn: async (req, res) => {
                return {
                    message: "Hello world"
                }
            }
        },
        // use custom middleware
        "/middleware-custom": {
            method: "get",
            middlewares: [
                "custom-middleware"
            ],
            fn: async (req, res) => {
                return {
                    message: "The middleware is working!"
                }
            }
        },
        // get from context
        "/db": {
            method: "get",
            useContexts: [
                "db"
            ],
            fn: async (req, res, ctx) => {
                console.log(ctx)
                return ctx.db.data
            }
        },
        // use parameters
        "/sum/:value1/:value2": {
            method: "get",
            fn: async (req, res) => {
                return {
                    result: parseInt(req.params.value1) + parseInt(req.params.value2)
                }
            }
        }
    }

    // define default middlewares to use on every request
    useMiddlewares = [
        async (req, res) => {
            console.log("Im executed every request")
        }
    ]

    // you can also define custom middlewares to use on endpoints
    middlewares = {
        "custom-middleware": async (req, res) => {
            console.log("Im a custom middleware")
        }
    }

    // define custom contexts to use on endpoints
    contexts = {
        db: {
            data: [
                {
                    id: 1,
                    name: "John Doe"
                },
                {
                    id: 2,
                    name: "Jane Doe"
                }
            ]
        }
    }

    async onInitialize() {
        console.log("Server initialized")
    }

    async onClose() {
        console.log("Server closed")
    }
}

Boot(MyAPI)

Run the server

linebridge-boot index.js

Documentation

The official documentation is on its way. Stay tuned for detailed guides and API references to help you unlock the full potential of Linebridge.