Arex.Vertex (arex v0.1.0)

Graph vertex helpers with boundary-aware traversal.

This module builds vertex creation and traversal operations on top of the core record, query, and command helpers while preserving tenant and scope boundaries.

Use Arex.Vertex when your application works with ArcadeDB vertex types but still wants the same ergonomics as Arex.Record: validated identifiers, normalized errors, boundary stamping on writes, and boundary filtering on reads and traversals.

In practice this module is a thin, focused graph layer over the record and query primitives. It exists so graph code can stay as concise and explicit as document code without losing the tenant/scope model.

Summary

Functions

both(rid, edge_type \\ nil, opts \\ [])

Traverses both incoming and outgoing neighbor vertices, optionally restricted by edge type.

create(type, attrs, opts \\ [])

Creates a vertex and stamps any active tenant and scope values.

delete(rid, opts \\ [])

Deletes a vertex by RID after confirming it is visible within the active boundary.

fetch(rid, opts \\ [])

Fetches a vertex by RID using the same boundary rules as Arex.Record.fetch/2.

incoming(rid, edge_type \\ nil, opts \\ [])

Traverses incoming neighbor vertices, optionally restricted by edge type.

merge(rid, attrs, opts \\ [])

Merges attributes into a vertex and re-fetches the updated record.

out(rid, edge_type \\ nil, opts \\ [])

Traverses outgoing neighbor vertices, optionally restricted by edge type.

replace(rid, attrs, opts \\ [])

Replaces a vertex content payload while preserving its current boundary fields.

upsert(type, attrs, opts \\ [])

Upserts a vertex type using the same cardinality and boundary rules as Arex.Record.upsert/3.

Functions

both(rid, edge_type \\ nil, opts \\ [])

Traverses both incoming and outgoing neighbor vertices, optionally restricted by edge type.

create(type, attrs, opts \\ [])

Creates a vertex and stamps any active tenant and scope values.

The type name is validated before Arex sends the create vertex command.

delete(rid, opts \\ [])

Deletes a vertex by RID after confirming it is visible within the active boundary.

fetch(rid, opts \\ [])

Fetches a vertex by RID using the same boundary rules as Arex.Record.fetch/2.

incoming(rid, edge_type \\ nil, opts \\ [])

Traverses incoming neighbor vertices, optionally restricted by edge type.

merge(rid, attrs, opts \\ [])

Merges attributes into a vertex and re-fetches the updated record.

out(rid, edge_type \\ nil, opts \\ [])

Traverses outgoing neighbor vertices, optionally restricted by edge type.

replace(rid, attrs, opts \\ [])

Replaces a vertex content payload while preserving its current boundary fields.

upsert(type, attrs, opts \\ [])

Upserts a vertex type using the same cardinality and boundary rules as Arex.Record.upsert/3.