Change api 'addFieldToNode' to 'createNodeField'

.eslintrc

@@ -1,4 +1,5 @@
 {
+  "parser": "babel-eslint",
   "extends": [
     "google",
     "eslint:recommended",

docs/docs/creating-and-modifying-pages.md

@@ -83,4 +83,4 @@ Often you will need to programmatically create pages. For example, you have
 markdown files that each should be a page.
 
 TODO finish this once it's more settled how to modify nodes to add slugs and
-other special fields that we want to associate with a node. Perhaps `addFieldToNode`.
+other special fields that we want to associate with a node. Perhaps `createNodeField`.

docs/docs/migrating-from-v0-to-v1.md

@@ -134,7 +134,7 @@ Here's how you do that.
 const path = require('path')
 
 exports.onNodeCreate = ({ node, boundActionCreators, getNode }) => {
-  const { addFieldToNode } = boundActionCreators
+  const { createNodeField } = boundActionCreators
   let slug
   if (node.internal.type === `MarkdownRemark`) {
     const fileNode = getNode(node.parent)
@@ -148,7 +148,7 @@ exports.onNodeCreate = ({ node, boundActionCreators, getNode }) => {
     }
 
     // Add slug as a field on the node.
-    addFieldToNode({ node, fieldName: `slug`, fieldValue: slug })
+    createNodeField({ node, fieldName: `slug`, fieldValue: slug })
   }
 }
 ```

packages/gatsby/src/redux/__tests__/nodes.js

@@ -108,7 +108,7 @@ describe(`Create and update nodes`, () => {
     )
     let state = nodeReducer(undefined, action)
 
-    const addFieldAction = actions.addFieldToNode(
+    const addFieldAction = actions.createNodeField(
       {
         node: state[`hi`],
         fieldName: `joy`,
@@ -138,7 +138,7 @@ describe(`Create and update nodes`, () => {
     )
     let state = nodeReducer(undefined, action)
 
-    const addFieldAction = actions.addFieldToNode(
+    const addFieldAction = actions.createNodeField(
       {
         node: state[`hi`],
         fieldName: `joy`,
@@ -149,7 +149,7 @@ describe(`Create and update nodes`, () => {
     state = nodeReducer(state, addFieldAction)
 
     function callActionCreator() {
-      actions.addFieldToNode(
+      actions.createNodeField(
         {
           node: state[`hi`],
           fieldName: `joy`,

packages/gatsby/src/redux/actions.js

@@ -1,3 +1,4 @@
+// @flow
 import Joi from "joi"
 import chalk from "chalk"
 const _ = require(`lodash`)
@@ -184,7 +185,21 @@ actions.createNode = (node, plugin) => {
   }
 }
 
-actions.addFieldToNode = ({ node, fieldName, fieldValue }, plugin) => {
+/**
+ * Create field on a node a plugin don't own. Once a plugin has claimed a field name
+ * the field name can't be used by other plugins.
+ * @param {Object} _ref
+ * @param {Object} _ref.node the target node object
+ * @param {String} _ref.fieldName the name for the field
+ * @param {String} _ref.fieldValue the value for the field
+ * @example
+ * createNodeField({
+ *   node,
+ *   fieldName: `happiness`,
+ *   fieldValue: `is sweet graphql queries`
+ * })
+ */
+actions.createNodeField = ({ node, fieldName, fieldValue }, plugin) => {
   // Ensure required fields are set.
   if (!node.internal.fieldOwners) {
     node.internal.fieldOwners = {}

www/gatsby-node.js

@@ -69,7 +69,7 @@ exports.createPages = ({ graphql, boundActionCreators }) => {
 
 // Create slugs for files.
 exports.onNodeCreate = ({ node, boundActionCreators, getNode }) => {
-  const { addFieldToNode } = boundActionCreators
+  const { createNodeField } = boundActionCreators
   let slug
   if (node.internal.type === `File`) {
     const parsedFilePath = parseFilepath(node.relativePath)
@@ -83,7 +83,7 @@ exports.onNodeCreate = ({ node, boundActionCreators, getNode }) => {
       }
     }
     if (slug) {
-      addFieldToNode({ node, fieldName: `slug`, fieldValue: slug })
+      createNodeField({ node, fieldName: `slug`, fieldValue: slug })
     }
   } else if (
     node.internal.type === `MarkdownRemark` &&
@@ -107,15 +107,15 @@ exports.onNodeCreate = ({ node, boundActionCreators, getNode }) => {
       parsedFilePath.name === `README`
     ) {
       slug = `/docs/packages/${parsedFilePath.dir}/`
-      addFieldToNode({
+      createNodeField({
         node,
         fieldName: `title`,
         fieldValue: parsedFilePath.dir,
       })
-      addFieldToNode({ node, fieldName: `package`, fieldValue: true })
+      createNodeField({ node, fieldName: `package`, fieldValue: true })
     }
     if (slug) {
-      addFieldToNode({ node, fieldName: `slug`, fieldValue: slug })
+      createNodeField({ node, fieldName: `slug`, fieldValue: slug })
     }
   }
 }