Method addVertex

packages/graph/src/Graph.ts:513–550

(...args: any[])

    properties: VertexProperties<TSchema, TVertexLabel>,
  ): Vertex<TSchema, TVertexLabel>;
  public addVertex(...args: any[]) {
    let label: string;
    let properties: Record<string, unknown>;
    if (args.length === 1 && typeof args[0] === "object" && args[0] !== null) {
      label = args[0].label;
      properties = args[0].properties;
    } else {
      label = args[0];
      properties = args[1];
    }

    // Validate and transform properties when validation is enabled
    const validateProperties = this.#config.validateProperties ?? true;
    if (validateProperties) {
      const schemaProperties = this.#config.schema.vertices[label]?.properties;
      properties = parseProperties(label, properties, schemaProperties);
    }

    const data: StoredVertex = {
      "@type": "Vertex",
      id: this.generateElementId(label),
      properties,
    };

    // Ensure unique indexes are built before checking constraints
    this.#indexManager.ensureUniqueIndexesBuilt(label, this.#config.storage.getVertices([label]));

    // Check unique constraints before adding (throws if violated)
    this.#indexManager.checkAllUniqueConstraints(label, data.properties as Record<string, unknown>);

    // Add to storage
    this.#config.storage.addVertex(data);

    // Add to indexes
    this.#indexManager.onElementAdd(data);

    return this.instantiateVertex(data);
  }

  /**
   * Delete a vertex from the graph.