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/packages/schema/lib/schemas/PlainFieldSchema.js

@@ -0,0 +1,148 @@
+'use strict';
+
+const makeSchema = require('../utils/makeSchema');
+
+const { INCOMPATIBLE_FIELD_SCHEMA_KEYS } = require('../constants');
+
+// the following takes an array of string arrays (string[][]) and returns the follwing string:
+// * `a` & `b`
+// * `c` & `d`
+// ... etc
+const wrapInBackticks = (s) => `\`${s}\``;
+const formatBullet = (f) => `* ${f.map(wrapInBackticks).join(' & ')}`;
+const incompatibleFieldsList =
+  INCOMPATIBLE_FIELD_SCHEMA_KEYS.map(formatBullet).join('\n');
+
+module.exports = makeSchema({
+  id: '/PlainFieldSchema',
+  description: `In addition to the requirements below, the following keys are mutually exclusive:\n\n${incompatibleFieldsList}`,
+  type: 'object',
+  required: ['key'],
+  docAnnotation: { hide: true },
+  properties: {
+    key: {
+      description:
+        'A unique machine readable key for this value (IE: "fname").',
+      type: 'string',
+      minLength: 1,
+    },
+    label: {
+      description: 'A human readable label for this value (IE: "First Name").',
+      type: 'string',
+      minLength: 1,
+    },
+    type: {
+      description:
+        'The type of this value. Use `string` for basic text input, `text` for a large, `<textarea>` style box, and `code` for a `<textarea>` with a fixed-width font. Field type of `file` will accept either a file object or a string. If a URL is provided in the string, Zapier will automatically make a GET for that file. Otherwise, a .txt file will be generated.',
+      type: 'string',
+      // string == unicode
+      // text == a long textarea string
+      // integer == int
+      // number == float
+      enum: [
+        'string',
+        'text',
+        'integer',
+        'number',
+        'boolean',
+        'datetime',
+        'file',
+        'password',
+        'copy',
+        'code',
+        'json',
+      ],
+    },
+    required: {
+      description: 'If this value is required or not.',
+      type: 'boolean',
+    },
+    default: {
+      description:
+        'A default value that is saved the first time a Zap is created.',
+      type: 'string',
+      minLength: 1,
+    },
+    list: {
+      description:
+        'Acts differently when used in inputFields vs. when used in outputFields. In inputFields: Can a user provide multiples of this field? In outputFields: Does this field return an array of items of type `type`?',
+      type: 'boolean',
+    },
+    children: {
+      type: 'array',
+      items: { $ref: '/PlainFieldSchema' },
+      description:
+        'An array of child fields that define the structure of a sub-object for this field. Usually used for line items.',
+      minItems: 1,
+    },
+    dict: {
+      description: 'Is this field a key/value input?',
+      type: 'boolean',
+    },
+  },
+  examples: [
+    // 1. Minimal valid example
+    { key: 'abc' },
+
+    // 2. Has a label
+    { key: 'abc_label', label: 'First Name' },
+
+    // 3. Has a type and required
+    { key: 'abc_required', type: 'boolean', required: true },
+
+    // 4. Has a default
+    { key: 'abc_default', default: 'some default' },
+
+    // 5. Children array referencing PlainFieldSchema
+    { key: 'parent', children: [{ key: 'child' }] },
+
+    // 6. A field with type=integer
+    { key: 'abc_int', type: 'integer' },
+
+    // 7. A field with type=json
+    { key: 'abc_json', type: 'json' },
+  ],
+  antiExamples: [
+    {
+      example: {},
+      reason: 'Missing required key: key',
+    },
+    {
+      example: { key: 'abc', type: 'loltype' },
+      reason: 'Invalid value for key: type',
+    },
+    {
+      // If someone tries to add a "choices" property, it's invalid
+      example: { key: 'abc', choices: { mobile: 'Mobile Phone' } },
+      reason: 'Invalid extra property: choices (not in schema)',
+    },
+    {
+      // default must be at least 1 character long
+      example: { key: 'abc', default: '' },
+      reason: 'Invalid value for key: default (cannot be empty string)',
+    },
+    {
+      // key must be at least 1 character long
+      example: { key: '' },
+      reason: 'Invalid value for key: key (cannot be empty string)',
+    },
+    {
+      // children array must have at least one valid item
+      example: { key: 'abc', children: [] },
+      reason:
+        'Invalid value for key: children (array must have at least 1 item)',
+    },
+    {
+      // children must be objects that match the PlainFieldSchema
+      example: { key: 'abc', children: ['$func$2$f$'] },
+      reason:
+        'Invalid value for key: children (each item must be a valid PlainFieldSchema object)',
+    },
+    {
+      // Another example of an invalid extra property
+      example: { key: 'abc', helpText: 'Not allowed' },
+      reason: 'Invalid extra property: helpText',
+    },
+  ],
+  additionalProperties: false,
+});