Module Middleware/Singleton

The singleton middleware let's you create a singleton object that will be shared between loaders of a single requests.

This is specially useful to share objects that needs to be created only once per request, like a cache, but not shared between requests.

import { createSingletonMiddleware } from "remix-utils/middleware/singleton";

export const [singletonMiddleware, getSingleton] = createSingletonMiddleware({
	instantiator: () => new MySingletonClass(),
});
Copy

To use it, you need to add it to the middleware array in the route where you want to use it.

import { singletonMiddleware } from "~/middleware/singleton.server";
export const middleware: Route.MiddlewareFunction[] = [singletonMiddleware];
Copy

And you can use the getSingleton function in your loaders to get the singleton object.

import { getSingleton } from "~/middleware/singleton.server";

export async function loader({ context }: Route.LoaderArgs) {
	let singleton = getSingleton(context);
	let result = await singleton.method();
	// ...
}
Copy

The singleton middleware can be created with different classes and arguments, so you can have multiple singletons in the same request.

import { createSingletonMiddleware } from "remix-utils/middleware/singleton";

export const [singletonMiddleware, getSingleton] = createSingletonMiddleware({
	instantiator: () => new MySingletonClass("arg1", "arg2"),
});

export const [anotherSingletonMiddleware, getAnotherSingleton] = createSingletonMiddleware({
	instantiator: () => new AnotherSingletonClass("arg1", "arg2"),
});
Copy

And use it in a route like this.

import { singletonMiddleware, anotherSingletonMiddleware } from "~/middleware/singleton.server";

export const middleware: Route.MiddlewareFunction[] = [
	singletonMiddleware,
	anotherSingletonMiddleware,
];
Copy

You can also access the request and context objects in the instantiator function, so you can create the singleton based on the request or context.

import { createSingletonMiddleware } from "remix-utils/middleware/singleton";
import { MySingletonClass } from "~/singleton";

export const [singletonMiddleware, getSingleton] = createSingletonMiddleware({
	instantiator: (request, context) => {
		return new MySingletonClass(request, context);
	},
});
Copy

This can allows you to create a class that depends on the request, maybe to read the URL or body, or depends on the context, maybe to read the session or some other data.