npm - impeditmaiores - Versions diffs - 1.0.0 - Mend

impeditmaiores 1.0.0

Files changed (421) hide show

package/demos/jsapi-integration/index.html ADDED Viewed

@@ -0,0 +1,89 @@
+<!DOCTYPE html>
+<html>
+  <head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="initial-scale=1,maximum-scale=1,user-scalable=no">
+  <title>Share auth between rest-js and the jsapi</title>
+    <style>
+      html,
+      body,
+      #viewDiv {
+        padding: 0;
+        margin: 0;
+        height: 100%;
+        width: 100%;
+      }
+    </style>
+  <link rel="stylesheet" href="https://js.arcgis.com/4.13/esri/css/main.css">
+    <script src="node_modules/@esri/arcgis-rest-request/dist/umd/request.umd.js"></script>
+    <script src="node_modules/@esri/arcgis-rest-auth/dist/umd/auth.umd.js"></script>
+    <script src="node_modules/@esri/arcgis-rest-portal/dist/umd/portal.umd.js"></script>
+    <!--
+    NOTE: rather than include the ArcGIS API for JavaScript via a <script> tag
+    typically you would using something like https://github.com/Esri/esri-loader
+    to lazy-load the API _after_ you had used the light-weight arcgis-rest-js
+    libraries above to log in and fetch some data (see NOTE below)
+  -->
+    <script src="https://js.arcgis.com/4.13/"></script>
+  </head>
+  <body>
+    <div id="viewDiv"></div>
+    <script>
+      // first, log in
+      // using canned username/password from
+      // https://developers.arcgis.com/python/sample-notebooks/chennai-floods-analysis/
+      const session = new arcgisRest.UserSession({
+        username: "arcgis_python",
+        password: "P@ssword123"
+      });
+      // next, fetch a private item's data (not just the metadata)
+      // https://geosaurus.maps.arcgis.com/home/item.html?id=a3bbb0aa221343509ed154471eee5a97
+      const itemId = "a3bbb0aa221343509ed154471eee5a97";
+      arcgisRest.getItemData(itemId, { authentication: session })
+        .then(response => {
+        // once we have the private item, we can create a map
+        // NOTE: this is where you would lazy-load the ArcGIS API for JavaScript
+          require([
+            "esri/identity/IdentityManager",
+            "esri/views/MapView",
+            "esri/WebMap"
+          ], function(
+            esriId, MapView, WebMap
+          ) {
+          // pass the authenticated session over to the JSAPI Identity Manager
+          esriId.registerToken(session.toCredential());
+          // display the title of its basemap
+          console.debug(response);
+          console.debug(response.baseMap.title);
+          // create a map with the item
+          var webmap = new WebMap({
+            portalItem: {
+              id: itemId
+            }
+          });
+          // and pass it to the map view
+          var view = new MapView({
+            map: webmap,
+            container: "viewDiv"
+          });
+          // you can also pass credentials in the other direction
+          esriId.getCredential("https://arcgis.com/sharing/rest/")
+            .then(cred => {
+              const session2 = new arcgisRest.UserSession.fromCredential(cred);
+            });
+        });
+      });
+    </script>
+  </body>
+</html>

package/demos/jsapi-integration/package-lock.json ADDED Viewed

@@ -0,0 +1,184 @@
+{
+	"requires": true,
+	"lockfileVersion": 1,
+	"dependencies": {
+		"async": {
+			"version": "1.5.2",
+			"resolved": "https://registry.npmjs.org/async/-/async-1.5.2.tgz",
+			"integrity": "sha1-7GphrlZIDAw8skHJVhjiCJL5Zyo="
+		},
+		"colors": {
+			"version": "1.0.3",
+			"resolved": "https://registry.npmjs.org/colors/-/colors-1.0.3.tgz",
+			"integrity": "sha1-BDP0TYCWgP3rYO0mDxsMJi6CpAs="
+		},
+		"corser": {
+			"version": "2.0.1",
+			"resolved": "https://registry.npmjs.org/corser/-/corser-2.0.1.tgz",
+			"integrity": "sha1-jtolLsqrWEDc2XXOuQ2TcMgZ/4c="
+		},
+		"debug": {
+			"version": "2.6.8",
+			"resolved": "https://registry.npmjs.org/debug/-/debug-2.6.8.tgz",
+			"integrity": "sha1-5zFTHKLt4n0YgiJCfaF4IdaP9Pw=",
+			"requires": {
+				"ms": "2.0.0"
+			}
+		},
+		"eventemitter3": {
+			"version": "3.1.0",
+			"resolved": "https://registry.npmjs.org/eventemitter3/-/eventemitter3-3.1.0.tgz",
+			"integrity": "sha512-ivIvhpq/Y0uSjcHDcOIccjmYjGLcP09MFGE7ysAwkAvkXfpZlC985pH2/ui64DKazbTW/4kN3yqozUxlXzI6cA=="
+		},
+		"follow-redirects": {
+			"version": "1.5.0",
+			"resolved": "https://registry.npmjs.org/follow-redirects/-/follow-redirects-1.5.0.tgz",
+			"integrity": "sha512-fdrt472/9qQ6Kgjvb935ig6vJCuofpBUD14f9Vb+SLlm7xIe4Qva5gey8EKtv8lp7ahE1wilg3xL1znpVGtZIA==",
+			"requires": {
+				"debug": "^3.1.0"
+			},
+			"dependencies": {
+				"debug": {
+					"version": "3.1.0",
+					"resolved": "https://registry.npmjs.org/debug/-/debug-3.1.0.tgz",
+					"integrity": "sha512-OX8XqP7/1a9cqkxYw2yXss15f26NKWBpDXQd0/uK/KPqdQhxbPa994hnzjcE2VqQpDslf55723cKPUOGSmMY3g==",
+					"requires": {
+						"ms": "2.0.0"
+					}
+				}
+			}
+		},
+		"he": {
+			"version": "1.1.1",
+			"resolved": "https://registry.npmjs.org/he/-/he-1.1.1.tgz",
+			"integrity": "sha1-k0EP0hsAlzUVH4howvJx80J+I/0="
+		},
+		"http-proxy": {
+			"version": "1.17.0",
+			"resolved": "https://registry.npmjs.org/http-proxy/-/http-proxy-1.17.0.tgz",
+			"integrity": "sha512-Taqn+3nNvYRfJ3bGvKfBSRwy1v6eePlm3oc/aWVxZp57DQr5Eq3xhKJi7Z4hZpS8PC3H4qI+Yly5EmFacGuA/g==",
+			"requires": {
+				"eventemitter3": "^3.0.0",
+				"follow-redirects": "^1.0.0",
+				"requires-port": "^1.0.0"
+			}
+		},
+		"http-server": {
+			"version": "0.11.1",
+			"resolved": "https://registry.npmjs.org/http-server/-/http-server-0.11.1.tgz",
+			"integrity": "sha512-6JeGDGoujJLmhjiRGlt8yK8Z9Kl0vnl/dQoQZlc4oeqaUoAKQg94NILLfrY3oWzSyFaQCVNTcKE5PZ3cH8VP9w==",
+			"requires": {
+				"colors": "1.0.3",
+				"corser": "~2.0.0",
+				"ecstatic": "^3.0.0",
+				"http-proxy": "^1.8.1",
+				"opener": "~1.4.0",
+				"optimist": "0.6.x",
+				"portfinder": "^1.0.13",
+				"union": "~0.4.3"
+			},
+			"dependencies": {
+				"ecstatic": {
+					"version": "3.2.0",
+					"resolved": "https://registry.npmjs.org/ecstatic/-/ecstatic-3.2.0.tgz",
+					"integrity": "sha512-Goilx/2cfU9vvfQjgtNgc2VmJAD8CasQ6rZDqCd2u4Hsyd/qFET6nBf60jiHodevR3nl3IGzNKtrzPXWP88utQ==",
+					"requires": {
+						"he": "^1.1.1",
+						"mime": "^1.4.1",
+						"minimist": "^1.1.0",
+						"url-join": "^2.0.2"
+					}
+				}
+			}
+		},
+		"mime": {
+			"version": "1.6.0",
+			"resolved": "https://registry.npmjs.org/mime/-/mime-1.6.0.tgz",
+			"integrity": "sha512-x0Vn8spI+wuJ1O6S7gnbaQg8Pxh4NNHb7KSINmEWKiPE4RKOplvijn+NkmYmmRgP68mc70j2EbeTFRsrswaQeg=="
+		},
+		"minimist": {
+			"version": "1.2.0",
+			"resolved": "https://registry.npmjs.org/minimist/-/minimist-1.2.0.tgz",
+			"integrity": "sha1-o1AIsg9BOD7sH7kU9M1d95omQoQ="
+		},
+		"mkdirp": {
+			"version": "0.5.1",
+			"resolved": "https://registry.npmjs.org/mkdirp/-/mkdirp-0.5.1.tgz",
+			"integrity": "sha1-MAV0OOrGz3+MR2fzhkjWaX11yQM=",
+			"requires": {
+				"minimist": "0.0.8"
+			},
+			"dependencies": {
+				"minimist": {
+					"version": "0.0.8",
+					"resolved": "https://registry.npmjs.org/minimist/-/minimist-0.0.8.tgz",
+					"integrity": "sha1-hX/Kv8M5fSYluCKCYuhqp6ARsF0="
+				}
+			}
+		},
+		"ms": {
+			"version": "2.0.0",
+			"resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz",
+			"integrity": "sha1-VgiurfwAvmwpAd9fmGF4jeDVl8g="
+		},
+		"opener": {
+			"version": "1.4.3",
+			"resolved": "https://registry.npmjs.org/opener/-/opener-1.4.3.tgz",
+			"integrity": "sha1-XG2ixdflgx6P+jlklQ+NZnSskLg="
+		},
+		"optimist": {
+			"version": "0.6.1",
+			"resolved": "https://registry.npmjs.org/optimist/-/optimist-0.6.1.tgz",
+			"integrity": "sha1-2j6nRob6IaGaERwybpDrFaAZZoY=",
+			"requires": {
+				"minimist": "~0.0.1",
+				"wordwrap": "~0.0.2"
+			},
+			"dependencies": {
+				"minimist": {
+					"version": "0.0.10",
+					"resolved": "https://registry.npmjs.org/minimist/-/minimist-0.0.10.tgz",
+					"integrity": "sha1-3j+YVD2/lggr5IrRoMfNqDYwHc8="
+				}
+			}
+		},
+		"portfinder": {
+			"version": "1.0.13",
+			"resolved": "https://registry.npmjs.org/portfinder/-/portfinder-1.0.13.tgz",
+			"integrity": "sha1-uzLs2HwnEErm7kS1o8y/Drsa7ek=",
+			"requires": {
+				"async": "^1.5.2",
+				"debug": "^2.2.0",
+				"mkdirp": "0.5.x"
+			}
+		},
+		"qs": {
+			"version": "2.3.3",
+			"resolved": "https://registry.npmjs.org/qs/-/qs-2.3.3.tgz",
+			"integrity": "sha1-6eha2+ddoLvkyOBHaghikPhjtAQ="
+		},
+		"requires-port": {
+			"version": "1.0.0",
+			"resolved": "https://registry.npmjs.org/requires-port/-/requires-port-1.0.0.tgz",
+			"integrity": "sha1-kl0mAdOaxIXgkc8NpcbmlNw9yv8="
+		},
+		"union": {
+			"version": "0.4.6",
+			"resolved": "https://registry.npmjs.org/union/-/union-0.4.6.tgz",
+			"integrity": "sha1-GY+9rrolTniLDvy2MLwR8kopWeA=",
+			"requires": {
+				"qs": "~2.3.3"
+			}
+		},
+		"url-join": {
+			"version": "2.0.5",
+			"resolved": "https://registry.npmjs.org/url-join/-/url-join-2.0.5.tgz",
+			"integrity": "sha1-WvIvGMBSoACkjXuCxenC4v7tpyg="
+		},
+		"wordwrap": {
+			"version": "0.0.3",
+			"resolved": "https://registry.npmjs.org/wordwrap/-/wordwrap-0.0.3.tgz",
+			"integrity": "sha1-o9XabNXAvAAI03I0u68b7WMFkQc="
+		}
+	}
+}

package/demos/jsapi-integration/package.json ADDED Viewed

@@ -0,0 +1,19 @@
+{
+  "name": "@esri/jsapi-integration",
+  "version": "2.22.0",
+  "private": true,
+  "description": "to do",
+  "author": "",
+  "license": "Apache-2.0",
+  "dependencies": {
+    "@esri/arcgis-rest-auth": "^2.22.0",
+    "@esri/arcgis-rest-portal": "^2.22.0",
+    "@esri/arcgis-rest-request": "^2.22.0"
+  },
+  "devDependencies": {
+    "http-server": "*"
+  },
+  "scripts": {
+    "start": "http-server ."
+  }
+}

package/demos/node-cli-item-management/README.md ADDED Viewed

@@ -0,0 +1,10 @@
+# Node JS CLI Item Management
+Demo CLI application.
+## Running this demo
+1. Like all the other demo apps, run `npm run bootstrap` in the root directory.
+2. `cd demos/node-cli-item-management`
+3. `npm start`
+![CLI Screenshot](./screenshot.png)

package/demos/node-cli-item-management/index.js ADDED Viewed

@@ -0,0 +1,238 @@
+require('cross-fetch/polyfill');
+require("isomorphic-form-data");
+const prompts = require("prompts");
+const chalk = require("chalk");
+const { setDefaultRequestOptions } = require('@esri/arcgis-rest-request');
+const { UserSession } = require("@esri/arcgis-rest-auth");
+const {
+  searchItems,
+  removeItem,
+  SearchQueryBuilder
+} = require("@esri/arcgis-rest-portal");
+// 1. Promt the user for sign in. Create a `UserSession`
+authenticate()
+  .then(session => {
+    console.log(chalk.blue(`Signed in as ${session.username}`));
+    // once the user is signed in search for items
+    return searchForItems(session);
+  })
+  .then(({ response, session }) => {
+    console.log(chalk.blue(`Found ${response.results.length} items\n`));
+    // take the items that were found and prompt the user if they want to delete them
+    return deleteItems(response.results, session);
+  })
+  .then(() => {
+    console.log(chalk.blue(`Done!`));
+  });
+// Prompt the user for a `username` and `password` return a `UserSession`
+// This function will run again on any error so it will retry until it works
+function authenticate() {
+  const authPromtpts = [
+    {
+      type: "text",
+      name: "username",
+      message: "Username"
+    },
+    {
+      type: "password",
+      name: "password",
+      message: "Password"
+    }
+  ];
+  let session;
+  // prompts returns a `Promise` that resolves with the users input
+  return prompts(authPromtpts)
+    .then(({ username, password }) => {
+      session = new UserSession({
+        username,
+        password
+      });
+      // this will generate a token and use it to get into about a user
+      return session.getUser();
+    })
+    .then(self => {
+      return session;
+    })
+    .catch(error => {
+      // in case of an `ArcGISRequestError` assume the `username` and `password`
+      // are incorrect run the `authenticate` function again
+      if (error.name === "ArcGISRequestError") {
+        console.log(
+          chalk.bold.red("Incorrect username and/or password please try again")
+        );
+        return authenticate();
+      }
+      // if this is a different error just log the error message and exit
+      console.log(
+        `${chalk.bold.red(error.name)} ${chalk.bold.red(error.message)}`
+      );
+    });
+}
+// given a `UserSession` prompt the user for some search params and search for items
+function searchForItems(session) {
+  const searchPrompts = [
+    {
+      type: "text",
+      name: "searchText",
+      message: "Search Query"
+    },
+    {
+      type: "list",
+      name: "itemTypes",
+      message: "Item Types"
+    },
+    {
+      type: "list",
+      name: "itemTags",
+      message: "Tags"
+    },
+    {
+      type: "number",
+      name: "number",
+      message: "How Many?"
+    }
+  ];
+  // prompts returns a `Promise` that resolves with the users input
+  return prompts(searchPrompts).then(
+    //use ES2015 destructuring so we don't make any extra variables
+    ({ searchText, itemTypes, itemTags, number }) => {
+      const query = new SearchQueryBuilder()
+        .match(session.username)
+        .in("owner");
+      // format the search query for item types
+      const types = itemTypes.filter(type => type.length);
+      // format the search query for item types
+      if (types.length) {
+        query.and().startGroup();
+        types.forEach((type, index, types) => {
+          query.match(type).in("type");
+          if (index !== types.length - 1) {
+            query.or();
+          }
+        });
+        query.endGroup();
+      }
+      // format the search query for item tags
+      const tags = itemTags.filter(tag => tag.length);
+      if (tags.length) {
+        query.and().startGroup();
+        tags.forEach((tag, index, tags) => {
+          query.match(tag).in("tags");
+          if (index !== tags.length - 1) {
+            query.or();
+          }
+        });
+        query.endGroup();
+      }
+      // format the search query for the search text
+      if (searchText.length) {
+        query.and().match(searchText);
+      }
+      console.log(chalk.blue(`Searching ArcGIS Online: ${query.toParam()}`));
+      return searchItems({
+        authentication: session,
+        q: query,
+        num: number
+      })
+      .then(response => {
+        return { response, session };
+      })
+      .catch(err => {
+        console.warn(err);
+      })
+    }
+  );
+}
+// this give a list of `items` and a `UserSession` this will ask us 1 at a time
+// if we want to delte this item. This uses the new async iteration syntax with
+// `Symbol.asyncIterator` to perform an async function in a loop
+async function deleteItems(items, session) {
+  // create our iterator which should return a `Promise`
+  const asyncIterable = {
+    [Symbol.asyncIterator]: () => ({
+      // every time we ask for a new item
+      next: function() {
+        // remove the next item from the array
+        const item = items.pop();
+        // we are done if there is no item
+        if (!item) {
+          return Promise.resolve({ done: true });
+        }
+        // prompt to delete this item.
+        return deleteItem(item, session);
+      }
+    })
+  };
+  // lets get our `next` function so we can itterate over it
+  const { next } = asyncIterable[Symbol.asyncIterator]();
+  for (
+    let { done, deleted, item } = await next(); // start condition, call next and wait for the `Promise` to resolve, results are destructed.
+    !done; // end condition,
+    { done, deleted, item } = await next() // action on every loop, sets up the next round of checks
+  ) {
+    if (deleted) {
+      console.log(chalk.green(`${item.title} deleted successfuly\n`));
+    } else {
+      console.log(chalk.gray(`${item.title} skipped\n`));
+    }
+  }
+  // since this is inside an async function code execution is stopped at the loop
+  // this will return an empty resolved `Promise` when the loop is done.
+  return Promise.resolve();
+}
+function deleteItem(item, session) {
+  console.log(`Title:    ${chalk.bold.green(item.title)}`);
+  console.log(`Tags:     ${item.tags.join(", ")}`);
+  console.log(`Type:     ${item.type}`);
+  console.log(`ID:       ${item.id}`);
+  console.log(`Owner:    ${item.owner}`);
+  console.log(`Created:  ${new Date(item.created).toLocaleDateString("en")}`);
+  console.log(`Modified: ${new Date(item.modified).toLocaleDateString("en")}`);
+  const deleteQuestions = [
+    {
+      type: "toggle",
+      name: "del",
+      message: "Delete this item?",
+      initial: false,
+      active: "yes",
+      inactive: "no"
+    }
+  ];
+  return prompts(deleteQuestions).then(({ del }) => {
+    if (del) {
+      console.log(chalk.red.bold(`Deleting ${item.title}`));
+      return removeItem({
+        id: item.id,
+        authentication: session
+      }).then(() => {
+        return Promise.resolve({ done: false, deleted: del, item });
+      });
+    }
+    return Promise.resolve({ done: false, deleted: del, item });
+  });
+}