A Function first framework designed around Typescript
A minimal framework for building HTTP, Scheduled and Websocket functions in Typescript
Example Code
A simple crud operation
*There's a bit more to it, take a look at the documentation to see the full example.
interface Car {
id: string
ownerId: string
licensePlate: string
color: string
}
export type JustCarId = Pick<Car, 'id'>
export type UpdateCar = JustCarId & RequireAtLeastOne<Omit<Car, 'id'>
const updateCar: APIFunction<UpdateCar, void> = async (services, { id, ...data }, session) => {
const oldData = await services.car.getCar(id)
await services.car.updateCar(id, data)
if (oldData.licensePlate !== data.licensePlate) {
await services.email.sendLicenseChangedEmail(session.userEmail, id)
}
}
const isCarOwner: APIPermission<JustCarId> = async (services, { id }, session) => {
const { carOwner } = await services.car.getCar(id)
return carOwner === session.userId
}
addRoute({
// Route type
method: 'post',
// Route path
route: '/car/:id',
// The function to run when the route is hit
func: updateCar,
// Whether a session is required (optional, defaults to true)
auth: true,
// Permissions required to run this route, only one needs to pass
permissions: {
isCarOwner,
isAdmin
}
})
Minimal features
The essential tools you need to get the job done
Type Safety
Everything is vanilla typescript with common types, potentially starting from your database and ending with the client.
Minimal APIs
Spend less time learning libraries and more time writing code. A few core concepts can take you almost all the way.
Session aware
Provide the user session to each function invocation for context. Cookies, API keys or JWT out of the box (if you want).
Permissions
Check each function invocation against a group of permissions before they even run.
Service Lookups
Each function call gets provided with both global services, as well as session services created for each call.
Validate schemas
Validate all API calls via automatically generated schemas from typescript. No more manual validation required.