Gateway

In this page, we'll introduce you how to write a gateway and some protips for it

Basic

Gateway is a function that controll where a new inbound request should go

Please, take a look on this diagram

An example gateway

Pro

Did you know that you could access routing Declarative in ur gateway?

import type { MaybePromise, Result, RuntimeRoute } from "ashes-urn";
import type { MRequestOPT } from "..";

export async function gateway(contents: MRequestOPT, routeObj: RuntimeRoute, app: ((...args: any[]) => MaybePromise<Result | any>)) {
    if (routeObj.isAdmin) throw new Error("No admin allowed!") // here
    return await app(contents)
}

And you can pass parameters to the handler?

import type { MaybePromise, Result, RuntimeRoute } from "ashes-urn";
import type { User } from "./type"
import type { MRequestOPT } from "..";

export async function gateway(contents: MRequestOPT, routeObj: RuntimeRoute, app: ((...args: any[]) => MaybePromise<Result | any>)) {
    const body = contents.body as Sch2Ts<typeof postLogin>
    if (await db.get<User>('Users', {_id: toObjId(body.id)}))
        return await app(contents, userObj); // here
    return await app(contents)
}