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/BasicOperationSchema.js

@@ -0,0 +1,107 @@
+'use strict';
+
+const makeSchema = require('../utils/makeSchema');
+const { SKIP_KEY } = require('../constants');
+
+const FunctionSchema = require('./FunctionSchema');
+const RequestSchema = require('./RequestSchema');
+const ResultsSchema = require('./ResultsSchema');
+const KeySchema = require('./KeySchema');
+const LockObjectSchema = require('./LockObjectSchema');
+const ThrottleObjectSchema = require('./ThrottleObjectSchema');
+const InputFieldsSchema = require('./InputFieldsSchema');
+const InputFieldGroupsSchema = require('./InputFieldGroupsSchema');
+const OutputFieldsSchema = require('./OutputFieldsSchema');
+
+module.exports = makeSchema(
+  {
+    id: '/BasicOperationSchema',
+    description:
+      'Represents the fundamental mechanics of triggers, searches, or creates.',
+    type: 'object',
+    required: ['perform'],
+    properties: {
+      resource: {
+        description:
+          'Optionally reference and extends a resource. Allows Zapier to automatically tie together samples, lists and hooks, greatly improving the UX. EG: if you had another trigger reusing a resource but filtering the results.',
+        $ref: KeySchema.id,
+      },
+      perform: {
+        description:
+          "How will Zapier get the data? This can be a function like `(z) => [{id: 123}]` or a request like `{url: 'http...'}`.",
+        oneOf: [{ $ref: RequestSchema.id }, { $ref: FunctionSchema.id }],
+      },
+      inputFields: {
+        description:
+          'What should the form a user sees and configures look like?',
+        $ref: InputFieldsSchema.id,
+      },
+      inputFieldGroups: {
+        description:
+          'Defines groups for organizing input fields in the UI. Each group can have a key, label, and emphasis styling.',
+        $ref: InputFieldGroupsSchema.id,
+      },
+      outputFields: {
+        description:
+          'What fields of data will this return? Will use resource outputFields if missing, will also use sample if available.',
+        $ref: OutputFieldsSchema.id,
+      },
+      sample: {
+        description:
+          'What does a sample of data look like? Will use resource sample if missing. Requirement waived if `display.hidden` is true or if this belongs to a resource that has a top-level sample',
+        type: 'object',
+        // TODO: require id, ID, Id property?
+        minProperties: 1,
+        docAnnotation: {
+          required: {
+            type: 'replace', // replace or append
+            value: '**yes** (with exceptions, see description)',
+          },
+        },
+      },
+      lock: {
+        description:
+          'Zapier uses this configuration to ensure this action is performed one at a time per scope (avoid concurrency).',
+        $ref: LockObjectSchema.id,
+      },
+      throttle: {
+        description:
+          'Zapier uses this configuration to apply throttling when the limit for the window is exceeded.',
+        $ref: ThrottleObjectSchema.id,
+      },
+      cleanInputData: {
+        description:
+          'If true, Zapier removes empty strings, `null`, `undefined`, and empty Arrays or objects from `bundle.inputData` recursively before passing it to your `perform*` function. If you want to handle empty values yourself in your code, explicitly set this to false. There is also a global flag with the same name in `App.flags`. This one takes precedence over the global one.',
+        type: 'boolean',
+      },
+    },
+    examples: [
+      {
+        perform: { require: 'some/path/to/file.js' },
+        sample: { id: 42, name: 'Hooli' },
+      },
+    ],
+    antiExamples: [
+      {
+        [SKIP_KEY]: true, // Cannot validate that sample is only required if display isn't true / top-level resource doesn't have sample
+        example: {
+          perform: { require: 'some/path/to/file.js' },
+        },
+        reason:
+          'Missing required key: sample. Note - This is only invalid if `display` is not explicitly set to true and if it does not belong to a resource that has a sample.',
+      },
+    ],
+    additionalProperties: false,
+  },
+  [
+    InputFieldsSchema,
+    InputFieldGroupsSchema,
+    OutputFieldsSchema,
+    FunctionSchema,
+    KeySchema,
+    LockObjectSchema,
+    RequestSchema,
+    ResultsSchema,
+    ThrottleObjectSchema,
+  ],
+);