@graphium/orm

English · 한국어

Graph-native OGM with multiple graph DB backends

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

@graphium/orm is the Apache AGE graph-sync layer. The AGE primitives (agtype parser, cypher-sql helpers) ship on the main entry point, and the MikroORM binding ships on the @graphium/orm/mikro-orm sub-path.

What's new in 0.4

• Raw query @security JSDoc — AGE raw helpers carry the uniform @security WARNING JSDoc tag (Phase 5.4); use parameter-binding helpers (buildAgeSql, buildCypherSql) instead of string interpolation.

Status

foundation helper

What It Provides

• AGE SQL wrapping from rendered Cypher
• agtype parsing and row normalization
• extension/bootstrap helpers

Current public surface:

• buildAgeSql(...)
• buildCypherSql(...)
• extractReturnColumns(...)
• parseAgType(...)
• normalizeAgeRows(...)
• ensureAgeExtension(...)
• ensureAgeExtensionInstalled(...)
• ensureAgeSession(...)

Typical Usage

Most application users consume the MikroORM binding on the @graphium/orm/mikro-orm sub-path rather than the raw AGE primitives. The sub-path re-exports everything needed for the MikroORM + AGE graph-sync flow, so the agtype/cypher-sql helpers above are usually internal detail.

Related Docs

• Root README