etincidunt 1.0.0

package/.prettierignore

@@ -0,0 +1,2 @@
+package.json
+package-lock.json

package/.travis.yml

@@ -0,0 +1,29 @@
+language: node_js
+sudo: false
+notifications:
+  email: false
+node_js:
+  - "8"
+  - "10"
+cache:
+  directories: # Cache dependencies
+    - node_modules
+before_script:
+  - npm run bootstrap
+script:
+  - npm run test:ci
+deploy:
+  provider: pages
+  skip_cleanup: true
+  github_token: $GITHUB_TOKEN # Set in travis-ci.org dashboard
+  on:
+    branch: master
+  local-dir: docs/build
+  target_branch: gh-pages
+before_deploy:
+ - npm run docs:build
+env:
+  - MOZ_HEADLESS=1
+addons:
+  chrome: stable
+  firefox: latest

package/.vscode/launch.json

@@ -0,0 +1,24 @@
+{
+  // Use IntelliSense to learn about possible Node.js debug attributes.
+  // Hover to view descriptions of existing attributes.
+  // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "type": "node",
+      "request": "launch",
+      "name": "Debug Node Tests",
+      "program": "${workspaceRoot}/node_modules/.bin/jasmine",
+      "args": [
+        "--config=jasmine.json"
+      ]
+    },
+    {
+      "type": "node",
+      "request": "launch",
+      "name": "Debug Changelog Script",
+      "program": "${workspaceRoot}/support/changelog.js",
+      "args": ["--config=jasmine.json"]
+    }
+  ]
+}

package/.vscode/settings.json

@@ -0,0 +1,3 @@
+{
+    "editor.tabSize": 2
+}

package/demos/ago-node-cli/README.md

@@ -0,0 +1,29 @@
+# Node CLI Examples
+
+This demo shows how to create a command-line application that interacts with the ArcGIS Online API.
+
+At this point, the commands are very simple and intended to demonstrate how to build up tooling.
+
+This project uses the `commander` module, which streamlines the creation of node cli applications. Check out the [README](https://github.com/tj/commander.js/blob/master/Readme.md) for more details.
+
+### Installing
+
+Like all the other demo apps, run `npm run bootstrap` from the root.
+
+### Running
+If you use this demo as a starting point for your own command line package, you would publish it to npm, then on the target systems run `npm install <your-cli-package>`, and it would be available as a command.
+
+But, this is demo code, and thus the package is not "installed" via `npm install ...`, before we can call it as `ago <command> <query>` we need to run `npm link` in the `/demos/ago-node-cli` folder. After you do that, the command should work.
+
+Here is a post with information on creating node command line tools: [A Guide to Creating a NodeJs Command](https://x-team.com/blog/a-guide-to-creating-a-nodejs-command/)
+
+### Commands
+
+| command | description | example |
+| --- | --- | --- |
+| `ago search <query>` | search for items | `ago search water` |
+| `ago export <id> <file>` | export an item to a json file | `ago export a62cb9d894f145cc89531c096d0012b1 pa.json` |
+
+## Building your own tooling
+
+If you want to build out some commands of your own, you can also clone a stand-alone version of this repo from https://github.com/dbouwman/arcgis-rest-js-commands

package/demos/ago-node-cli/ago.js

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+require('isomorphic-fetch');
+require('isomorphic-form-data');
+/**
+ * This demo uses the commander module, which streamlines the creation of command-line-applications
+ */
+const program = require('commander');
+
+program
+  .version('0.0.1');
+
+/**
+ * Bring in the search command...
+ */
+const itemSearchCommand = require('./lib/item-search-command');
+
+program
+  .command('search <query>')
+  .description('Search for items')
+  .action(function (query) {
+    itemSearchCommand.execute(query);
+  });
+
+  const itemExportCommand = require('./lib/item-export-command');
+  program
+  .command('export <itemId> <filename>')
+  .description('Export an item to a json file')
+  .action(function (id, filename) {
+    itemExportCommand.execute(id, filename);
+  });
+
+program.parse(process.argv);

package/demos/ago-node-cli/index.js

@@ -0,0 +1,11 @@
+/**
+ * Re-export the commands so they can be used in other contexts
+ */
+const itemSearchCommand = require('./lib/item-search-command');
+const itemExportCommand = require('./lib/item-export-command');
+
+// just re-export the commands so they can be run in another scropt
+module.exports = {
+  search: itemSearchCommand,
+  export: itemExportCommand
+};

package/demos/ago-node-cli/lib/item-export-command.js

@@ -0,0 +1,48 @@
+const { getItem, getItemData } = require("@esri/arcgis-rest-items");
+const jsonfile = require('jsonfile');
+
+module.exports = {
+  /**
+   * Execute the command
+   */
+  execute: function (id, fileName) {
+    console.info(`Exporting item ${id} to file ${fileName}`);
+    // construct the search call..
+    let model = {};
+    return getItem(id)
+    .then((item) => {
+      model.item = item;
+      if (this.shouldFetchData(item.type)){
+        console.info(`...Fetching ./data for item of type ${item.type}`);
+        return getItemData(id);
+      } else {
+        console.info(`...Items of type ${item.type} do not have json ./data - skipping`);
+        return Promise.resolve();
+      }
+    })
+    .then((maybeData) => {
+      if (maybeData) {
+        model.data = maybeData;
+      }
+      // now write out the file...
+      jsonfile.writeFileSync(fileName, model,  {spaces: 2});
+      console.info(`Done. Exported "${model.item.title}" to ${fileName}`);
+    })
+    .catch((err) => {
+      console.error(err);
+    });
+  },
+
+  /**
+   * Not all item types have json /data
+   */
+  shouldFetchData (type) {
+    let result = false;
+    let exportables = ['Web Map', 'Web Mapping Application', 'Hub Page', 'Hub Initiative', 'Hub Site Application'];
+    // if the type is in this list, we can export it...
+    if (exportables.indexOf(type) > -1) {
+      result = true;
+    }
+    return result;
+  }
+}

package/demos/ago-node-cli/lib/item-search-command.js

@@ -0,0 +1,35 @@
+
+/**
+ * Bring in searchItems fn
+ */
+const { searchItems } = require("@esri/arcgis-rest-items");
+
+module.exports = {
+  /**
+   * Execute the command
+   */
+  execute: function (query) {
+    // construct the search call..
+    return searchItems({ 
+      searchForm: {
+        q: query,
+        start: 1,
+        num: 10
+      }
+    })
+    .then((response) => {
+      // if we got results
+      if (Array.isArray(response.results) && response.results.length)  {
+        console.info(`${response.total} items found for "${query}".`);
+        response.results.forEach((entry) => {
+          console.info(`${entry.id} | ${entry.title}`);
+        })
+      } else {
+        console.info(`No results found for "${query}".`);
+      }
+    })
+    .catch((err) => {
+      console.error(err);
+    });
+  }
+}

package/demos/ago-node-cli/package-lock.json

@@ -0,0 +1,172 @@
+{
+	"requires": true,
+	"lockfileVersion": 1,
+	"dependencies": {
+		"ansi-styles": {
+			"version": "3.2.0",
+			"resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-3.2.0.tgz",
+			"integrity": "sha512-NnSOmMEYtVR2JVMIGTzynRkkaxtiq1xnFBcdQD/DnNCYPoEPsVJhM98BDyaoNOQIi7p4okdi3E27eN7GQbsUug==",
+			"requires": {
+				"color-convert": "^1.9.0"
+			}
+		},
+		"async": {
+			"version": "2.6.0",
+			"resolved": "https://registry.npmjs.org/async/-/async-2.6.0.tgz",
+			"integrity": "sha512-xAfGg1/NTLBBKlHFmnd7PlmUW9KhVQIUuSrYem9xzFUZy13ScvtyGGejaae9iAVRiRq9+Cx7DPFaAAhCpyxyPw==",
+			"requires": {
+				"lodash": "^4.14.0"
+			}
+		},
+		"chalk": {
+			"version": "2.3.1",
+			"resolved": "https://registry.npmjs.org/chalk/-/chalk-2.3.1.tgz",
+			"integrity": "sha512-QUU4ofkDoMIVO7hcx1iPTISs88wsO8jA92RQIm4JAwZvFGGAV2hSAA1NX7oVj2Ej2Q6NDTcRDjPTFrMCRZoJ6g==",
+			"requires": {
+				"ansi-styles": "^3.2.0",
+				"escape-string-regexp": "^1.0.5",
+				"supports-color": "^5.2.0"
+			}
+		},
+		"color-convert": {
+			"version": "1.9.1",
+			"resolved": "https://registry.npmjs.org/color-convert/-/color-convert-1.9.1.tgz",
+			"integrity": "sha512-mjGanIiwQJskCC18rPR6OmrZ6fm2Lc7PeGFYwCmy5J34wC6F1PzdGL6xeMfmgicfYcNLGuVFA3WzXtIDCQSZxQ==",
+			"requires": {
+				"color-name": "^1.1.1"
+			}
+		},
+		"color-name": {
+			"version": "1.1.3",
+			"resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.3.tgz",
+			"integrity": "sha1-p9BVi9icQveV3UIyj3QIMcpTvCU="
+		},
+		"combined-stream": {
+			"version": "1.0.6",
+			"resolved": "https://registry.npmjs.org/combined-stream/-/combined-stream-1.0.6.tgz",
+			"integrity": "sha1-cj599ugBrFYTETp+RFqbactjKBg=",
+			"requires": {
+				"delayed-stream": "~1.0.0"
+			}
+		},
+		"commander": {
+			"version": "2.14.1",
+			"resolved": "https://registry.npmjs.org/commander/-/commander-2.14.1.tgz",
+			"integrity": "sha512-+YR16o3rK53SmWHU3rEM3tPAh2rwb1yPcQX5irVn7mb0gXbwuCCrnkbV5+PBfETdfg1vui07nM6PCG1zndcjQw=="
+		},
+		"delayed-stream": {
+			"version": "1.0.0",
+			"resolved": "https://registry.npmjs.org/delayed-stream/-/delayed-stream-1.0.0.tgz",
+			"integrity": "sha1-3zrhmayt+31ECqrgsp4icrJOxhk="
+		},
+		"encoding": {
+			"version": "0.1.12",
+			"resolved": "https://registry.npmjs.org/encoding/-/encoding-0.1.12.tgz",
+			"integrity": "sha1-U4tm8+5izRq1HsMjgp0flIDHS+s=",
+			"requires": {
+				"iconv-lite": "~0.4.13"
+			}
+		},
+		"escape-string-regexp": {
+			"version": "1.0.5",
+			"resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-1.0.5.tgz",
+			"integrity": "sha1-G2HAViGQqN/2rjuyzwIAyhMLhtQ="
+		},
+		"form-data": {
+			"version": "1.0.1",
+			"resolved": "https://registry.npmjs.org/form-data/-/form-data-1.0.1.tgz",
+			"integrity": "sha1-rjFduaSQf6BlUCMEpm13M0de43w=",
+			"requires": {
+				"async": "^2.0.1",
+				"combined-stream": "^1.0.5",
+				"mime-types": "^2.1.11"
+			}
+		},
+		"graceful-fs": {
+			"version": "4.1.11",
+			"resolved": "https://registry.npmjs.org/graceful-fs/-/graceful-fs-4.1.11.tgz",
+			"integrity": "sha1-Dovf5NHduIVNZOBOp8AOKgJuVlg=",
+			"optional": true
+		},
+		"has-flag": {
+			"version": "3.0.0",
+			"resolved": "https://registry.npmjs.org/has-flag/-/has-flag-3.0.0.tgz",
+			"integrity": "sha1-tdRU3CGZriJWmfNGfloH87lVuv0="
+		},
+		"iconv-lite": {
+			"version": "0.4.19",
+			"resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.4.19.tgz",
+			"integrity": "sha512-oTZqweIP51xaGPI4uPa56/Pri/480R+mo7SeU+YETByQNhDG55ycFyNLIgta9vXhILrxXDmF7ZGhqZIcuN0gJQ=="
+		},
+		"is-stream": {
+			"version": "1.1.0",
+			"resolved": "https://registry.npmjs.org/is-stream/-/is-stream-1.1.0.tgz",
+			"integrity": "sha1-EtSj3U5o4Lec6428hBc66A2RykQ="
+		},
+		"isomorphic-fetch": {
+			"version": "2.2.1",
+			"resolved": "https://registry.npmjs.org/isomorphic-fetch/-/isomorphic-fetch-2.2.1.tgz",
+			"integrity": "sha1-YRrhrPFPXoH3KVB0coGf6XM1WKk=",
+			"requires": {
+				"node-fetch": "^1.0.1",
+				"whatwg-fetch": ">=0.10.0"
+			}
+		},
+		"isomorphic-form-data": {
+			"version": "1.0.0",
+			"resolved": "https://registry.npmjs.org/isomorphic-form-data/-/isomorphic-form-data-1.0.0.tgz",
+			"integrity": "sha1-BEe+fg9rht7z05MDbPdmSpiRkQA=",
+			"requires": {
+				"form-data": "^1.0.0-rc3"
+			}
+		},
+		"jsonfile": {
+			"version": "4.0.0",
+			"resolved": "https://registry.npmjs.org/jsonfile/-/jsonfile-4.0.0.tgz",
+			"integrity": "sha1-h3Gq4HmbZAdrdmQPygWPnBDjPss=",
+			"requires": {
+				"graceful-fs": "^4.1.6"
+			}
+		},
+		"lodash": {
+			"version": "4.17.5",
+			"resolved": "https://registry.npmjs.org/lodash/-/lodash-4.17.5.tgz",
+			"integrity": "sha512-svL3uiZf1RwhH+cWrfZn3A4+U58wbP0tGVTLQPbjplZxZ8ROD9VLuNgsRniTlLe7OlSqR79RUehXgpBW/s0IQw=="
+		},
+		"mime-db": {
+			"version": "1.30.0",
+			"resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.30.0.tgz",
+			"integrity": "sha1-dMZD2i3Z1qRTmZY0ZbJtXKfXHwE="
+		},
+		"mime-types": {
+			"version": "2.1.17",
+			"resolved": "https://registry.npmjs.org/mime-types/-/mime-types-2.1.17.tgz",
+			"integrity": "sha1-Cdejk/A+mVp5+K+Fe3Cp4KsWVXo=",
+			"requires": {
+				"mime-db": "~1.30.0"
+			}
+		},
+		"node-fetch": {
+			"version": "1.7.3",
+			"resolved": "https://registry.npmjs.org/node-fetch/-/node-fetch-1.7.3.tgz",
+			"integrity": "sha512-NhZ4CsKx7cYm2vSrBAr2PvFOe6sWDf0UYLRqA6svUYg7+/TSfVAu49jYC4BvQ4Sms9SZgdqGBgroqfDhJdTyKQ==",
+			"requires": {
+				"encoding": "^0.1.11",
+				"is-stream": "^1.0.1"
+			}
+		},
+		"supports-color": {
+			"version": "5.2.0",
+			"resolved": "https://registry.npmjs.org/supports-color/-/supports-color-5.2.0.tgz",
+			"integrity": "sha512-F39vS48la4YvTZUPVeTqsjsFNrvcMwrV3RLZINsmHo+7djCvuUzSIeXOnZ5hmjef4bajL1dNccN+tg5XAliO5Q==",
+			"requires": {
+				"has-flag": "^3.0.0"
+			}
+		},
+		"whatwg-fetch": {
+			"version": "2.0.3",
+			"resolved": "https://registry.npmjs.org/whatwg-fetch/-/whatwg-fetch-2.0.3.tgz",
+			"integrity": "sha1-nITsLc9oGH/wC8ZOEnS0QhduHIQ="
+		}
+	}
+}

package/demos/ago-node-cli/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "node-cli",
+  "version": "1.6.0",
+  "description": "arcgis-rest-js node command-line item search example",
+  "main": "ago.js",
+  "scripts": {
+    "start": "echo \"CLI - node index.js <search>\" && exit 1"
+  },
+  "bin": {
+    "ago": "./ago.js"
+  },
+  "private": true,
+  "keywords": [
+    "arcgis",
+    "node",
+    "arcgis-rest-js"
+  ],
+  "author": "Dave Bouwman <dbouwman@esri.com>",
+  "license": "Apache-2.0",
+  "dependencies": {
+    "@esri/arcgis-rest-auth": "^1.6.0",
+    "@esri/arcgis-rest-items": "^1.6.0",
+    "@esri/arcgis-rest-request": "^1.6.0",
+    "chalk": "^2.3.0",
+    "commander": "^2.12.2",
+    "isomorphic-fetch": "^2.2.1",
+    "isomorphic-form-data": "^1.0.0",
+    "jsonfile": "^4.0.0"
+  }
+}

package/demos/attachments/README.md

@@ -0,0 +1,5 @@
+# Running this demo
+
+1. Make sure you run `npm run bootstrap` in the root folder to setup the dependencies
+1. `npm start`
+1. Visit http://localhost:8080

package/demos/attachments/index.html

@@ -0,0 +1,164 @@
+<!DOCTYPE html>
+<html>
+<title>Attachments</title>
+
+<link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/css/bootstrap.min.css" integrity="sha384-BVYiiSIFeK1dGmJRAkycuHAHRg32OmUcww7on3RYdg4Va+PmSTsz/K68vbdEjh4u" crossorigin="anonymous">
+
+<script src="https://cdn.polyfill.io/v2/polyfill.js?features=es5,Promise,fetch"></script>
+
+<div class="container-fluid">
+  <div class="row">
+    <div class="col-md-12">
+      <h3>Attachments</h3>
+      <form id="getForm">
+        <div class="form-group">
+          <label for="serviceUrl">Service URL</label>
+          <input type="text" id="serviceUrl" name="serviceUrl" class="form-control" value="http://sampleserver6.arcgisonline.com/arcgis/rest/services/SF311/FeatureServer/0/" required>
+        </div>
+        <div class="form-group">
+          <label for="featureId">Feature ID</label>
+          <input type="number" min="0" step="1" id="featureId" name="featureId" class="form-control" value="3339970" required>
+        </div>
+        <div class="form-group">
+          <button type="submit" class="btn"><span class="glyphicon glyphicon-paperclip" aria-hidden="true"></span> Get Attachments</button>
+        </div>
+      </form>
+    </div>
+  </div>
+  <div class="row">
+    <div class="col-md-12">
+      <form id="addForm">
+        <div class="form-group">
+          <label for="attachFile">File</label>
+          <input type="file" id="attachFile" name="attachFile" required>
+        </div>
+        <div class="form-group">
+          <button type="submit" class="btn btn-success"><span class="glyphicon glyphicon-plus" aria-hidden="true"></span> Add Attachment</button>
+        </div>
+      </form>
+    </div>
+  </div>
+  <div class="row">
+    <div class="col-md-12">
+      <p id="resultMessage"></p>
+      <table class="table table-striped">
+        <thead>
+          <th>Attachment ID</th>
+          <th>Content Type</th>
+          <th>Size</th>
+          <th>Attachment</th>
+          <th>Delete</th>
+        </thead>
+        <tbody id="result"></tbody>
+      </table>
+    </div>
+  </div>
+</div>
+
+<script src="https://rawgit.com/kriszyp/put-selector/master/put.js"></script>
+<script src="node_modules/@esri/arcgis-rest-request/dist/umd/request.umd.js"></script>
+<script src="node_modules/@esri/arcgis-rest-feature-service/dist/umd/feature-service.umd.js"></script>
+
+<script>
+  let serviceUrl, featureId;
+
+  let validService = false;
+
+  // ref some nodes
+  const getForm = document.getElementById('getForm');
+  const addForm = document.getElementById('addForm');
+  const resultMessage = document.getElementById('resultMessage');
+  const result = document.getElementById('result');
+
+  // delete attachment and get again to update table rows
+  const deleteAttachment = attachmentId => {
+    arcgisRest.deleteAttachments({
+      url: serviceUrl,
+      featureId: featureId,
+      attachmentIds: [attachmentId]
+    }).then(res => {
+      console.log(res);
+      arcgisRest.getAttachments({
+        url: serviceUrl,
+        featureId: featureId
+      }).then(getResponse).catch(getError);
+    }).catch(err => {
+      console.log(err);
+      alert(err.message + ' Check the console for more details.');
+    });
+  }
+
+  // handle get attachments response and create table rows
+  const getResponse = res => {
+    console.log(res);
+    const infos = res.attachmentInfos;
+    validService = true;
+    resultMessage.innerHTML = 'Feature has ' + infos.length + ' attachments.';
+    result.innerHTML = '';
+    if (infos.length) {
+      infos.forEach(info => {
+        const tr = put(result, 'tr');
+        put(tr, 'td', info.id);
+        put(tr, 'td', info.contentType);
+        put(tr, 'td', info.size);
+        put(tr, 'td a.btn.btn-primary', {
+          target: '_blank',
+          href: serviceUrl + '/' + featureId + '/attachments/' + info.id,
+          innerHTML: '<span class="glyphicon glyphicon-file" aria-hidden="true"></span> ' + info.name
+        });
+        put(tr, 'td a.btn.btn-danger', {
+          href: '#',
+          innerHTML: '<span class="glyphicon glyphicon-remove" aria-hidden="true"></span> ' + info.name,
+          onclick: evt => {
+            evt.preventDefault();
+            deleteAttachment(info.id);
+          }
+        });
+      });
+    }
+  };
+
+  // handle get attachments error
+  const getError = err => {
+    console.log(err);
+    validService = false;
+    resultMessage.innerHTML = err.message + ' Check the console for more details.';
+    result.innerHTML = '';
+  }
+
+  // handle get attachments form submit
+  getForm.addEventListener('submit', function (evt) {
+    evt.preventDefault();
+    arcgisRest.getAttachments({
+      url: serviceUrl = getForm.serviceUrl.value,
+      featureId: featureId = getForm.featureId.value
+    }).then(getResponse).catch(getError);
+  });
+
+  // handle add attachment form submit and get again to update table rows
+  addForm.addEventListener('submit', function (evt) {
+    evt.preventDefault();
+    if (!validService) {
+      alert('Not so fast. Start by getting a feature\'s attachments first.');
+      return;
+    }
+    arcgisRest.addAttachment({
+      url: serviceUrl,
+      featureId: featureId,
+      attachment: evt.target.attachFile.files[0],
+      params: {
+        returnEditMoment: true
+      }
+    }).then(res => {
+      console.log(res);
+      arcgisRest.getAttachments({
+        url: serviceUrl,
+        featureId: featureId
+      }).then(getResponse).catch(getError);
+    }).catch(err => {
+      console.log(err);
+      alert(err.message + ' Check the console for more details.');
+    });
+  });
+</script>
+</html>