Installation

Install the client with your package manager of choice. Node 18 or newer is required.

# npm
npm install @meridian/client

# pnpm
pnpm add @meridian/client

Quickstart

Create a client and run your first query. Connections are pooled automatically.

import { createClient } from '@meridian/client'

const db = createClient({ url: process.env.MERIDIAN_URL })
const users = await db.from('users').where({ active: true })

Configuration

Options are read from meridian.toml, then overridden by environment variables.

Client

createClient(options)

Returns a pooled client. Safe to create once and share across your application.

• url — connection string, required
• poolSize — maximum concurrent connections
• timeout — per-query timeout before rejection

Errors

Every error extends MeridianError and carries a stable .code you can branch on.