Middleware / Interceptor

How could a framework exist without middleware? It's a fundamental component, enabling modular and reusable code for request handling.

There are two-ways to handle / intercept request

1. Using interceptor

1. Let's start by creating a logger:

src/payments/middleware.ts

import { getRequest } from "@minimajs/server";

export async function logger() {
  const req = getRequest();
  console.log(req.url);
}

In this example, we've created a simple logger middleware that logs the URL of incoming requests.

Next, let's integrate this middleware into our application:

2. Just wrap your module with an interceptor.

src/payments/index.ts

import { interceptor } from "@minimajs/server";
import { logger } from "./middleware.ts";

// creating a payments module.
async function payments(app: App) {
  // handling routes.
  app.get("/", handleGetRequest);
}

export const paymentsModule = interceptor([logger], payments);

Here, we've used the interceptor function to wrap our payments module with the logger.

3. Register paymentModule

src/index.ts

import { paymentModule } from "src/payments";
app.register(paymentModule, {
  prefix: "/payments",
});

Ensuring that all requests to the /payments endpoint are logged.

Express middlewares

But what if you want to leverage existing Express middleware? Not a problem! interceptor is fully compatible with Express middleware:

src/index.ts

import { yourExpressMiddleware } from "@express/middleware-factory";

// Integrate your Express middleware with the interceptor

app.register(interceptor([yourExpressMiddleware], paymentModule), {
  prefix: "/payments",
});

2. Middleware

creating a middleware

src/logger/middleware.ts

import { getRequestURL, middleware } from "@minimajs/server";

export const logger = middleware(async function logger() {
  console.log(getRequestURL());
});

Registering it to home module

src/home/index.ts

import { type App } from "@minimajs/server";
import { logger } from "../logger/middleware";
export function home(app: App) {
  app.register(logger, {
    filter() {
      return true;
    },
  });
  app.get("/", () => {
    return "welcome home!";
  });
}