feat(zone): add a zone

README.md

@@ -67,6 +67,16 @@ Saves the modifications to the `Zone` object.
 properties at once. This method executes the modifications in series, but if an
 error occurs, there are no guarantees which properties would have been applied.
 
+#### `addZone(z, [jumpstart, [options]]): Promise<Zone>`
+
+* z: `Zone` object
+* jumpstart: `true` to automatically fetch existing DNS records
+  (default). `false` to disable this behavior.
+* options: *see Request Options*
+* *API Reference*: [Create a zone](https://api.cloudflare.com/#zone-create-a-zone)
+
+Add a zone to an account or organization.
+
 #### `deleteZone(z, [options]): Promise<{id: string}>`
 
 * z: `Zone` object or string zone id

index.js

@@ -73,6 +73,7 @@ module.exports = prototypal({
   browseZones: zones.browse,
   readZone: zones.read,
   editZone: zones.edit,
+  addZone: zones.add,
   deleteZone: zones.delete,
   deleteCache: purge.delete,
   browseDNS: dns.browse,

lib/zones.js

@@ -115,6 +115,23 @@ function edit(z, options) {
   return sendPatched.call(this);
 }
 
+function add(z, jumpstart, options) {
+  options = options || {};
+
+  var body = z.toJSON({useAliases: true});
+
+  if (jumpstart === false) {
+    body.jump_start = false; // eslint-disable-line camelcase
+  }
+
+  options.method = 'POST';
+  options.body = JSON.stringify(body);
+
+  return this._got('zones', options).then(function (response) {
+    return Zone.create(response.body.result);
+  });
+}
+
 function remove(z, options) {
   var zid = Zone.is(z) ? z.id : z;
   var uri = join('zones', zid);
@@ -130,5 +147,6 @@ function remove(z, options) {
 module.exports.browse = browse;
 module.exports.read = read;
 module.exports.edit = edit;
+module.exports.add = add;
 module.exports.delete = remove;
 module.exports.Zone = Zone;

test/zones.js

@@ -229,3 +229,25 @@ test('edit paused and vanity name servers', async t => {
   t.true(zone.paused);
   t.deepEqual(zone.vanityNameservers, ['ns1.example.com', 'ns2.example.com']);
 });
+
+test('add zone', async t => {
+  let z = Zone.create({
+    name: 'example.com'
+  });
+
+  nock('https://api.cloudflare.com')
+    .post('/client/v4/zones', {
+      name: 'example.com',
+      jump_start: false
+    })
+    .reply(200, {
+      result: {
+        id: '8',
+        name: 'example.com'
+      }
+    });
+
+  let zone = await t.context.cf.addZone(z, false);
+  t.true(Zone.is(zone));
+  t.true(zone.id === '8');
+});