Method updateProperty

packages/graph/src/Graph.ts:670–718

* Update a property of a vertex or edge. * @param id The id of the vertex or edge, or the vertex or edge itself. * @param key The key of the property. * @param value The value of the property. * @throws PropertyValidationError if validateProperties is enabled and key is not in schema.

(
    id: ElementId | Vertex<TSchema, any> | Edge<TSchema, any>,
    key: string,
    value: any,
  )

   * @throws UniqueConstraintViolationError if a unique constraint would be violated.
   */
  public updateProperty(
    id: ElementId | Vertex<TSchema, any> | Edge<TSchema, any>,
    key: string,
    value: any,
  ): void {
    if (typeof id === "object") {
      id = id.id;
    }
    const label = getLabelFromElementId(id);
    const isVertex = label in this.#config.schema.vertices;
    const isEdge = label in this.#config.schema.edges;

    // Validate and transform property value when validation is enabled (default: false)
    let parsedValue = value;
    const validateProperties = this.#config.validateProperties ?? true;
    if (validateProperties) {
      const schemaProperties = isVertex
        ? this.#config.schema.vertices[label]?.properties
        : isEdge
          ? this.#config.schema.edges[label]?.properties
          : undefined;
      // parsePropertyValue validates key exists and transforms value
      parsedValue = parsePropertyValue(key, label, value, schemaProperties);
    }

    // Ensure unique indexes are built before checking constraints
    if (this.#indexManager.isUnique(label, key)) {
      const elements = isVertex
        ? this.#config.storage.getVertices([label])
        : this.#config.storage.getEdges([label]);
      this.#indexManager.ensureUniqueIndexesBuilt(label, elements);

      // Check unique constraint (exclude current element since it's an update)
      // Use parsedValue for unique constraint check
      this.#indexManager.checkUniqueConstraint(label, key, parsedValue, id);
    }

    const element = isVertex
      ? this.#config.storage.getVertexById(id)
      : isEdge
        ? this.#config.storage.getEdgeById(id)
        : undefined;
    const oldValue = element ? (element.properties as Record<string, unknown>)[key] : undefined;
    // Store the parsed/transformed value, not the raw input
    this.#config.storage.updateProperty(id, key, parsedValue);
    if (element) {
      this.#indexManager.onPropertyUpdate(id, key, oldValue, parsedValue);
    }
  }

  public toJSON() {
    return {