RPC

Hello World

Performance benchmarks for a simple Hello World endpoint.

A hello world route with no validation: routing and framework overhead only, about as fast as each framework can get. The numbers are generated on every docs deploy from this repository's code.

See the code

Requests per Second

$ loading benchmark…

Throughput

$ loading benchmark…

Latency

$ loading benchmark…

Max Memory

$ loading benchmark…

Max CPU

$ loading benchmark…

Benchmark Code

Every server answers this same route.

import {FatalError} from '@mionjs/core';
import {createMionRouter, Routes} from '@mionjs/router';

export type User = {id: string; name: string; surname: string};

// every helper below gets these options by type
const mion = createMionRouter({basePath: 'api/v1'});

// parameters are validated before each function runs
const routes = {
  // reads the HttpOnly session cookie the browser sends
  auth: mion.middleware((ctx): void | FatalError<'not-authorized'> => {
    const cookie = ctx.request.headers.get('cookie');
    // a FatalError ends the request: sayHello never runs, and the client gets it typed
    if (!cookie?.includes('session='))
      return new FatalError({
        publicMessage: 'Not Authorized',
        type: 'not-authorized',
      });
  }),
  users: {
    sayHello: mion.route(
      (ctx, user: User): string => `Hello ${user.name} ${user.surname}`
    ),
  },
  log: mion.middleware(
    (ctx): void => console.log(Date.now(), ctx.path, ctx.response.statusCode),
    {alwaysRun: true}
  ),
} satisfies Routes;

export const myApi = mion.initRoutes(routes);

// the client imports only this type
export type MyApi = typeof myApi;