feat: api route

[hulxv]

Description

Introduce API route support in MetaSSR to allow developers to define backend API endpoints directly within the framework. This feature would enable seamless integration of API logic alongside server-side rendering, allowing for dynamic content fetching, user authentication, or data manipulation without the need for external APIs.

Client-Side Example

// ./src/api/user.js

export async function GET(req) {
    const { id } = req.params;
    const user = await database.getUserById(id);

    

    if (user) {
        res.status(200).json(user);
        return {
            status: 200,
            body: Json.stringify(user)
        }
    } else {
        return {
            status: 404,
            body: JSON.stringify({
                message: "User is not found."
            })
        }
    }
}

export async function POST(req) {
    const newUser = await database.createUser(req.body);
    return {
        status: 201,
        body: Json.stringify(newUser)
    }
   
}

Polyglot Programming Support

With the integration of Metacall, API routes can be written in different programming languages, making it easy for developers to use their language of choice to define routes and business logic. This provides flexibility for teams with varying language expertise.

Example in Python

# ./src/api/user.py

async def GET(req):
    user_id = req.params['id']
    user = await database.get_user_by_id(user_id)

    if user:
        return {
            "status": 200,
            "body": json.dumps(user)
        }
    else:
        return {
            "status": 404,
            "body": json.dumps({
                "message": "User not found."
            })
        }

async def POST(req):
    new_user = await database.create_user(req.body)
    return {
        "status": 201,
        "body": json.dumps(new_user)
    }

Benefits

• Streamlines the process of building backend APIs for server-side rendered applications by co-locating API logic within the same framework.
• Reduces the need for external services, enabling tighter integration between SSR components and backend API logic.
• Polyglot support allows backend APIs to be written in different languages, giving developers the flexibility to use the best tools for their particular use case.