Milestone 0: import zappier billing, Verae middleware, and Zapier research

Compose-ready workspace: packages/zappier (rate card, portal, Stripe),
packages/verae-zapier-middleware (timestamp + NATS), packages/verae-zapier
(CLI app), vendor/zapier-platform, and research/zapier vendor corpus.

Gate 0 structure checks pass. Product code and research are not yet wired.

vendor/zapier-platform/example-apps/trigger/.gitignore

@@ -0,0 +1,6 @@
+build
+docs
+node_modules
+*.log
+.environment
+.env

vendor/zapier-platform/example-apps/trigger/.travis.yml

@@ -0,0 +1,7 @@
+language: node_js
+node_js:
+  - 8.10.0
+before_script: 'npm install -g zapier-platform-cli'
+script: 'zapier test'
+notifications:
+  email: false

vendor/zapier-platform/example-apps/trigger/README.md

@@ -0,0 +1,5 @@
+# "Trigger" Example App For Zapier Platform
+
+[![Build Status](https://travis-ci.org/zapier/zapier-platform-example-app-trigger.svg?branch=master)](https://travis-ci.org/zapier/zapier-platform-example-app-trigger)
+
+A barebones app that has a trigger defined.

vendor/zapier-platform/example-apps/trigger/index.js

@@ -0,0 +1,35 @@
+const recipe = require('./triggers/recipe');
+
+const addAuthHeader = (request, z, bundle) => {
+  // Hard-coded auth header just for demo
+  request.headers['X-API-Key'] = 'secret';
+  return request;
+};
+
+// Now we can roll up all our behaviors in an App.
+const App = {
+  // This is just shorthand to reference the installed dependencies you have. Zapier will
+  // need to know these before we can upload
+  version: require('./package.json').version,
+  platformVersion: require('zapier-platform-core').version,
+
+  beforeRequest: [addAuthHeader],
+
+  afterResponse: [],
+
+  resources: {},
+
+  // If you want your trigger to show up, you better include it here!
+  triggers: {
+    [recipe.key]: recipe,
+  },
+
+  // If you want your searches to show up, you better include it here!
+  searches: {},
+
+  // If you want your creates to show up, you better include it here!
+  creates: {},
+};
+
+// Finally, export the app.
+module.exports = App;

vendor/zapier-platform/example-apps/trigger/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "zapier-platform-example-app-trigger",
+  "version": "1.0.0",
+  "description": "An example app for the Zapier platform.",
+  "repository": "zapier/zapier-platform-example-app-trigger",
+  "homepage": "https://zapier.com/",
+  "author": "Bryan Helmig <bryan@zapier.com>",
+  "license": "BSD-3-Clause",
+  "main": "index.js",
+  "scripts": {
+    "test": "mocha --recursive"
+  },
+  "engines": {
+    "node": ">=8.10.0",
+    "npm": ">=5.6.0"
+  },
+  "dependencies": {
+    "zapier-platform-core": "19.1.0"
+  },
+  "devDependencies": {
+    "mocha": "^5.2.0",
+    "should": "^13.2.0"
+  },
+  "private": true
+}

vendor/zapier-platform/example-apps/trigger/test/triggers.js

@@ -0,0 +1,46 @@
+/* globals describe, it */
+
+require('should');
+
+const zapier = require('zapier-platform-core');
+const App = require('../index');
+
+const appTester = zapier.createAppTester(App);
+
+describe('triggers', () => {
+  describe('new recipe trigger', () => {
+    it('should load recipes', async () => {
+      const bundle = {
+        inputData: {
+          style: 'style 2',
+        },
+      };
+
+      const results = await appTester(
+        App.triggers.recipe.operation.perform,
+        bundle,
+      );
+
+      results.length.should.above(0);
+
+      const firstRecipe = results[0];
+      firstRecipe.name.should.eql('name 2');
+      firstRecipe.directions.should.eql('directions 2');
+    });
+
+    it('should load recipes without filters', async () => {
+      const bundle = {};
+
+      const results = await appTester(
+        App.triggers.recipe.operation.perform,
+        bundle,
+      );
+
+      results.length.should.above(1);
+
+      const firstRecipe = results[0];
+      firstRecipe.name.should.eql('name 1');
+      firstRecipe.directions.should.eql('directions 1');
+    });
+  });
+});

vendor/zapier-platform/example-apps/trigger/triggers/recipe.js

@@ -0,0 +1,79 @@
+const listRecipes = async (z, bundle) => {
+  // `z.console.log()` is similar to `console.log()`.
+  z.console.log('console says hello world!');
+
+  const params = {};
+  if (bundle.inputData.style) {
+    params.style = bundle.inputData.style;
+  }
+
+  // You can build requests and our client will helpfully inject all the variables
+  // you need to complete. You can also register middleware to control this.
+  const requestOptions = {
+    url: 'https://auth-json-server.zapier-staging.com/recipes',
+    params: params,
+  };
+
+  // z.request() returns an HTTP Response Object https://github.com/zapier/zapier-platform/tree/main/packages/cli#http-response-object
+  const response = await z.request(requestOptions);
+
+  return response.data;
+};
+
+// We recommend writing your triggers separate like this and rolling them
+// into the App definition at the end.
+module.exports = {
+  key: 'recipe',
+
+  // You'll want to provide some helpful display labels and descriptions
+  // for users. Zapier will put them into the UX.
+  noun: 'Recipe',
+  display: {
+    label: 'New Recipe',
+    description: 'Triggers when a new recipe is added.',
+  },
+
+  // `operation` is where the business logic goes.
+  operation: {
+    // `inputFields` can define the fields a user could provide,
+    // we'll pass them in as `bundle.inputData` later.
+    inputFields: [
+      {
+        key: 'style',
+        type: 'string',
+        helpText: 'Which styles of cuisine this should trigger on.',
+      },
+    ],
+
+    perform: listRecipes,
+
+    // In cases where Zapier needs to show an example record to the user, but we are unable to get a live example
+    // from the API, Zapier will fallback to this hard-coded sample. It should reflect the data structure of
+    // returned records, and have obviously dummy values that we can show to any user.
+    sample: {
+      id: 1,
+      createdAt: 1472069465,
+      name: 'Best Spagetti Ever',
+      authorId: 1,
+      directions: '1. Boil Noodles\n2.Serve with sauce',
+      style: 'italian',
+    },
+
+    // If the resource can have fields that are custom on a per-user basis, define a function to fetch the custom
+    // field definitions. The result will be used to augment the sample.
+    //   outputFields: [
+    //    () => { return []; }
+    //   ]
+    // For a more complete example of using dynamic fields see
+    // https://github.com/zapier/zapier-platform/tree/main/packages/cli#customdynamic-fields.
+    // Alternatively, a static field definition should be provided, to specify labels for the fields
+    outputFields: [
+      { key: 'id', label: 'ID' },
+      { key: 'createdAt', label: 'Created At' },
+      { key: 'name', label: 'Name' },
+      { key: 'directions', label: 'Directions' },
+      { key: 'authorId', label: 'Author ID' },
+      { key: 'style', label: 'Style' },
+    ],
+  },
+};