Skip to content
MeshQLMeshQLMeshQL Docs

Packages

MeshQL ships as focused libraries. JSR packages use @meshql/* import paths (TypeScript source). npm packages use meshql-* names (compiled ESM). Same semver on both registries.

JSR npm Purpose
@meshql/core meshql-core Parser, planner, shaper, createMesh()
@meshql/postgres meshql-postgres Postgres buildSelectSql ($1, $2, …)
@meshql/sqlite meshql-sqlite SQLite buildSelectSql for node:sqlite / Bun / D1
@meshql/prisma meshql-prisma Prisma catch-all resolver (v0.6.0)
@meshql/drizzle meshql-drizzle Drizzle relational query resolver (v0.6.0)
@meshql/kysely meshql-kysely Kysely + SQL builder resolver (v0.6.0)
@meshql/http meshql-http Express, Fastify, Hono adapters
@meshql/client meshql-client Typed client SDK (Node + browser)
@meshql/upload meshql-upload Multipart file uploads
@meshql/integrity meshql-integrity Request signing and integrity tokens
@meshql/access meshql-access Entity, row, and field access control
@meshql/access-cache meshql-access-cache Cache permission results per user (v0.8.0)
@meshql/persisted-queries meshql-persisted-queries Register queries, X-Mesh-Query-Id transport (v0.8.0)
@meshql/pubsub meshql-pubsub Pub/sub for real-time subscriptions (v0.9.0)
@meshql/sse meshql-sse Field-aware SSE subscriptions — Express, Fastify, Hono (v0.9.0)
@meshql/codemods meshql-codemods GraphQL SDL → MeshQL schema migration (v0.9.0)
@meshql/gateway meshql-gateway Static multi-service gateway — fetch + stitch (v0.9.0)
@meshql/docs meshql-docs Interactive playground + schema introspection (v0.10.0)

Typical stacks

Section titled “Typical stacks”

SQLite (zero setup on Node 22.5+):

Terminal window
# npm
npm install meshql-core meshql-sqlite meshql-http meshql-client


# JSR
npx jsr add @meshql/core @meshql/sqlite @meshql/http @meshql/client

Postgres:

Terminal window
# npm
npm install meshql-core meshql-postgres meshql-http meshql-client pg


# JSR
npx jsr add @meshql/core @meshql/postgres @meshql/http @meshql/client

Prisma (v0.6.0):

Terminal window
npm install meshql-core meshql-prisma meshql-http meshql-client @prisma/client
# or: npx jsr add @meshql/core @meshql/prisma @meshql/http @meshql/client

With security plugins:

Terminal window
# npm
npm install meshql-core meshql-http meshql-integrity meshql-access


# JSR
npx jsr add @meshql/core @meshql/http @meshql/integrity @meshql/access

Real-time (SSE + pub/sub):

Terminal window
# npm
npm install meshql-pubsub meshql-sse meshql-core meshql-http


# JSR
npx jsr add @meshql/pubsub @meshql/sse @meshql/core @meshql/http

GraphQL migration:

Terminal window
npx jsr add @meshql/codemods
# or: npm install meshql-codemods

Multi-service (gateway V1):

Terminal window
npx jsr add @meshql/gateway @meshql/client @meshql/core

Interactive playground:

Terminal window
npx jsr add @meshql/docs @meshql/core
# or: npm install meshql-docs meshql-core

Import paths

Section titled “Import paths”
Registry Example import
JSR import { createMesh } from "@meshql/core"
npm import { createMesh } from "meshql-core"

Per-package docs: core · postgres · sqlite · prisma · drizzle · kysely · http · client · upload · integrity · access · access-cache · persisted-queries · pubsub · sse · codemods · gateway · docs

Guides: Thinking in MeshQL · From GraphQL · ORM adapters · Database connections · SQL integration · Playground