@graphium/memgraph

English · 한국어

Graph-native OGM with multiple graph DB backends

Explicit persistence model — no Proxy magic, no N+1 footguns

@graphium/memgraph is the Memgraph backend for Graphium.

What's new in 0.4

• Unlimited find() by default — the 0.3 implicit 10 000-row cap is removed. Opt back in via Graph.create({ defaultMaxRows: 10_000 }).
• profile: 'production' preset — enables slow-query, N+1, and EXPLAIN-cost detectors in one line.
• TLS multi-signal warning → throw — plaintext bolt:// to non-loopback hosts throws under any production-like signal (NODE_ENV, k8s, Lambda, Vercel, GRAPHIUM_REQUIRE_TLS).
• Read-only repositories — @InjectRepository(User, { mode: 'read-only' }) for NestJS (Phase 6.1).

Status

experimental

Current Scope

• CRUD, populate, relationship sync, and typed query builder support
• raw Cypher execution
• managed transactions with read-your-write consistency on a direct Bolt connection
• Memgraph-specific migration generation and snapshotting

Current Limits

• direct bolt:// only
• routing schemes are rejected
• bookmark-based transaction options are rejected
• database is validated at connect time and fails fast when unsupported

Driver-native tuning should use driverConfig. Transport security remains owned by the connection URI/scheme, for example:

MemgraphDriver.create({
  uri: 'bolt://127.0.0.1:7687',
  driverConfig: {
    fetchSize: 1_000,
    maxConnectionPoolSize: 25,
    connectionTimeout: 20_000,
    telemetryDisabled: true,
  },
})

Related Docs

• Root README