Όbelisk Αrchitect

obelisk-arc is an HTTP request router for use in a single Architect @http function¹.
It utilizes Architect's helpers and familiar payload shapes and the power of find-my-way (used by Fastify and Restify) to help create a router in a single AWS Lambda².

This web site's routes are handled in a single Lambda by the obelisk-arc router and deployed with Architect. Try the links below:

• /things/123 returns the path param as JSON
• /things/near/123-456/radius/789?foo=bar returns complex params as JSON³
• /form a form that POSTs to itself -- been a while since you seen that, eh?
• /router displays the same route map as text/plain
• /silent a defined route that doesn't return a value. The router's default route picks up
• /not-found a route that doesn't exist. The router's default route picks up
• /throw will throw-throw and does not fall back to the router's default route

This Lambda's router.prettyPrint():

└── / (GET)
    ├── async (GET)
    ├── router (GET)
    ├── silent (GET)
    ├── form (GET, POST)
    └── th
        ├── row (GET)
        └── ings/
            ├── near/
            │   └── :lat-:lng
            │       └── /radius/
            │           └── :r (GET)
            └── :id (GET)

A rad feature of find-my-way ☝️

¹ This version of Obelisk is only compatible with Architect's Node.js runtime helpers: @architect/functions.
For a more generic Lambda version see obelisk-lambda.

² "Monolithic" Lambdas that handle many routes-per-function are not usually recommended. Typically, cloud functions should be plentiful and small. However, there are some use cases where a "fat" Lambda can remain focused and quick while handling a wide variety of request paths.

³ This is the source for the complex route above:

import arc from "@architect/functions";
import Router from "obelisk-arc";

const router = new Router();

router.on(
	"GET",
	"/things/near/:lat-:lng/radius/:r",
	async ({ routeParams, query }) => {
		const { lat, lng, r } = routeParams;
		const { foo } = query;

		// do something with route and query params

		return {
			json: { routeParams, query },
		};
	},
);

export const handler = arc.http(router.mount());

Docs + Source: github.com/tbeseda/obelisk-arc