Skip to main content

Express.js

This guide shows how to integrate @liorandb/driver with Express by creating a single shared LioranClient at startup and reusing it from routes and middleware.

Install​

npm i @liorandb/driver

1) Create a shared client module​

Create src/liorandb.ts (or similar) and export one LioranClient.

import { LioranClient } from "@liorandb/driver";

const uri = process.env.LIORAN_URI;
if (!uri) throw new Error("Missing env var: LIORAN_URI");

export const lioranClient = new LioranClient(uri);

export async function connectLioran() {
  await lioranClient.connect();
}

2) Connect once at startup, then use in routes​

import express from "express";
import { connectLioran, lioranClient } from "./liorandb";

async function main() {
  await connectLioran();

  const app = express();
  app.use(express.json());

  app.get("/items", async (_req, res) => {
    const db = await lioranClient.db("default");
    const items = db.collection<{ sku: string; qty: number }>("items");
    res.json({ data: await items.find({}).toArray() });
  });

  app.listen(3000, () => console.log("http://localhost:3000"));
}

main().catch((err) => {
  console.error(err);
  process.exit(1);
});

Notes​

  • Keep the LioranClient in module scope and share it via imports; don’t create a new client per request.
  • close() is a no-op for the driver, so shutdown handling is optional.