Function parsePropertyValue

packages/graph/src/Graph.ts:42–81

(
  key: string,
  label: string,
  value: T,
  schemaProperties: ElementSchema["properties"] | undefined,
)

 * @throws AsyncValidationError if schema returns a Promise (not supported)
 */
export function parsePropertyValue<T>(
  key: string,
  label: string,
  value: T,
  schemaProperties: ElementSchema["properties"] | undefined,
): T {
  if (!schemaProperties) {
    return value;
  }

  // If key is not in schema, allow it without validation
  // (only validate properties that have explicit schema definitions)
  if (!(key in schemaProperties)) {
    return value;
  }

  // Validate and transform value using the property's type schema
  const propertySchema = schemaProperties[key];
  if (propertySchema?.type?.["~standard"]?.validate) {
    const result = propertySchema.type["~standard"].validate(value);

    // Check for async result (not supported)
    if (result instanceof Promise) {
      throw new AsyncValidationError(key, label);
    }

    // Check for validation errors (empty issues array is treated as success)
    if ("issues" in result && result.issues && result.issues.length > 0) {
      const issues = result.issues.map((issue) => issue.message);
      throw new PropertyTypeError(key, label, value, issues);
    }

    // Return the transformed/validated value
    if ("value" in result) {
      return result.value as T;
    }
  }

  return value;
}

/**
 * Parse all properties of an element through their Standard Schema validators.