@scout9/app 1.0.0-alpha.0.2.1 → 1.0.0-alpha.0.2.4

package/dist/{dev-df823c44.cjs → dev-73ac7343.cjs}

@@ -39939,7 +39939,7 @@ function _loadUserPackageJson() {
           targetPkgUrl = isTest ? packageTestJsonUrl : packageJsonUrl;
           _context2.t0 = JSON;
           _context2.next = 10;
-          return fs__default["default"].readFile(new URL(targetPkgUrl, (typeof document === 'undefined' ? new (require('u' + 'rl').URL)('file:' + __filename).href : (document.currentScript && document.currentScript.src || new URL('dev-df823c44.js', document.baseURI).href))), 'utf-8');
+          return fs__default["default"].readFile(new URL(targetPkgUrl, (typeof document === 'undefined' ? new (require('u' + 'rl').URL)('file:' + __filename).href : (document.currentScript && document.currentScript.src || new URL('dev-73ac7343.js', document.baseURI).href))), 'utf-8');
         case 10:
           _context2.t1 = _context2.sent;
           pkg = _context2.t0.parse.call(_context2.t0, _context2.t1);
@@ -40749,9 +40749,9 @@ var PersonaConfigurationSchema = AgentConfigurationSchema.extend({
   })
 });
 var AgentsConfigurationSchema = z.array(AgentConfigurationSchema);
-z.array(PersonaConfigurationSchema);
+var PersonasConfigurationSchema = z.array(PersonaConfigurationSchema);
 var AgentsSchema = z.array(AgentSchema);
-z.array(PersonaSchema);
+var PersonasSchema = z.array(PersonaSchema);
 var Bus = z.object({
   foo: z.string(),
   bar: z["boolean"]().optional()
@@ -40762,7 +40762,7 @@ var Baz = z.object({
     two: z.number().optional()
   })
 });
-z.object({
+var TestSchema = z.object({
   baz: Baz,
   bus: Bus
 });
@@ -40852,7 +40852,7 @@ var WorkflowResponseMessageApiRequest = z.object({
  * If its a string, it will be sent as a static string.
  * If it's a object or WorkflowResponseMessageAPI - it will use
  */
-z.union([z.string(),
+var WorkflowResponseMessage = z.union([z.string(),
 /**
  * An api call that should be called later, must return a string or {message: string}
  */
@@ -40861,7 +40861,7 @@ WorkflowResponseMessageApiRequest]);
 /**
  * The intended response provided by the WorkflowResponseMessageApiRequest
  */
-z.union([z.string(), z.object({
+var WorkflowResponseMessageApiResponse = z.union([z.string(), z.object({
   message: z.string()
 }), z.object({
   text: z.string()
@@ -40971,7 +40971,7 @@ var WorkflowResponseSlotSchema = WorkflowResponseSlotBaseSchema.extend({
  * The workflow response to send in any given workflow
  */
 var WorkflowResponseSchema = z.union([WorkflowResponseSlotSchema, z.array(WorkflowResponseSlotSchema)]);
-z["function"]().args(WorkflowEventSchema).returns(z.union([z.promise(WorkflowResponseSchema), WorkflowResponseSchema]));
+var WorkflowFunctionSchema = z["function"]().args(WorkflowEventSchema).returns(z.union([z.promise(WorkflowResponseSchema), WorkflowResponseSchema]));
 
 var _excluded$2 = ["success"];
 function MacroUtilsFactory() {
@@ -41443,7 +41443,7 @@ var EntityConfigurationSchema = _EntityConfigurationSchema.refine(function (data
   // Custom error message
   message: "If 'definitions' is provided, then 'training' must also be provided"
 });
-z.array(EntityConfigurationSchema);
+var EntitiesRootConfigurationSchema = z.array(EntityConfigurationSchema);
 var EntityExtendedProjectConfigurationSchema = z.object({
   entities: z.array(zId('Entity Folder', z.string()), {
     description: 'Entity id association, used to handle route params'
@@ -41563,13 +41563,70 @@ apiFunctionParamsSchema.extend({
  * @template Response
  * @typedef {function(IApiFunctionParams): Promise<EventResponse>} IApiFunction
  */
-z["function"]().args(apiFunctionParamsSchema).returns(z.promise(eventResponseSchema));
+var apiFunctionSchema = z["function"]().args(apiFunctionParamsSchema).returns(z.promise(eventResponseSchema));
+
+/**
+ * @template Params
+ * @template Response
+ * @typedef {IApiFunction<Params, Response>} IQueryApiFunction
+ */
+var queryApiFunctionSchema = apiFunctionSchema;
+
+/**
+ * @template Params
+ * @template Response
+ * @typedef {IApiFunction<Params, Response>} GetApiFunction
+ */
+var getApiFunctionSchema = apiFunctionSchema;
+
+/**
+ * @template Params
+ * @template RequestBody
+ * @template Response
+ * @typedef {function(IApiFunctionParams & {body: Partial<RequestBody>}): Promise<EventResponse<Response>>} IPostApiFunction
+ */
+var postApiFunctionSchema = function postApiFunctionSchema(requestBodySchema) {
+  return z["function"]().args(apiFunctionParamsSchema.extend({
+    body: requestBodySchema.partial()
+  })).returns(z.promise(eventResponseSchema));
+};
+
+/**
+ * @template Params
+ * @template RequestBody
+ * @template Response
+ * @typedef {function(IApiFunctionParams & {body: Partial<RequestBody>}): Promise<EventResponse<Response>>} IPutApiFunction
+ */
+var putApiFunctionSchema = function putApiFunctionSchema(requestBodySchema) {
+  return z["function"]().args(apiFunctionParamsSchema.extend({
+    body: requestBodySchema.partial()
+  })).returns(z.promise(eventResponseSchema));
+};
+
+/**
+ * @template Params
+ * @template RequestBody
+ * @template Response
+ * @typedef {function(IApiFunctionParams & {body: Partial<RequestBody>}): Promise<EventResponse<Response>>} IPatchApiFunction
+ */
+var patchApiFunctionSchema = function patchApiFunctionSchema(requestBodySchema) {
+  return z["function"]().args(apiFunctionParamsSchema.extend({
+    body: requestBodySchema.partial()
+  })).returns(z.promise(eventResponseSchema));
+};
+
+/**
+ * @template Params
+ * @template Response
+ * @typedef {IApiFunction<Params, Response>} IDeleteApiFunction
+ */
+var deleteApiFunctionSchema = apiFunctionSchema;
 
 var ContextExampleWithTrainingDataSchema = z.object({
   input: z.string(),
   output: z.array(z.record(z.string(), z.any()))
 });
-z.union([z.array(ContextExampleWithTrainingDataSchema), z.array(z.record(z.string(), z.any()))]);
+var ContextExampleSchema = z.union([z.array(ContextExampleWithTrainingDataSchema), z.array(z.record(z.string(), z.any()))]);
 
 let FORCE_COLOR,
   NODE_DISABLE_COLORS,
@@ -48204,16 +48261,51 @@ var Scout9Test = /*#__PURE__*/function () {
 }();
 
 exports.$ = $$1;
+exports.AgentConfigurationSchema = AgentConfigurationSchema;
+exports.AgentSchema = AgentSchema;
+exports.AgentsConfigurationSchema = AgentsConfigurationSchema;
+exports.AgentsSchema = AgentsSchema;
+exports.Baz = Baz;
+exports.Bus = Bus;
+exports.ContextExampleSchema = ContextExampleSchema;
+exports.ContextExampleWithTrainingDataSchema = ContextExampleWithTrainingDataSchema;
+exports.ConversationAnticipateSchema = ConversationAnticipateSchema;
+exports.ConversationContext = ConversationContext;
+exports.ConversationSchema = ConversationSchema;
+exports.CustomerSchema = CustomerSchema;
+exports.CustomerValueSchema = CustomerValueSchema;
+exports.EntitiesRootConfigurationSchema = EntitiesRootConfigurationSchema;
 exports.EntitiesRootProjectConfigurationSchema = EntitiesRootProjectConfigurationSchema;
 exports.EntityApiConfigurationSchema = EntityApiConfigurationSchema;
 exports.EntityConfigurationSchema = EntityConfigurationSchema;
 exports.EntityRootProjectConfigurationSchema = EntityRootProjectConfigurationSchema;
+exports.FollowupBaseSchema = FollowupBaseSchema;
+exports.FollowupSchema = FollowupSchema;
+exports.ForwardSchema = ForwardSchema;
+exports.InstructionObjectSchema = InstructionObjectSchema;
+exports.InstructionSchema = InstructionSchema;
+exports.IntentWorkflowEventSchema = IntentWorkflowEventSchema;
+exports.MessageSchema = MessageSchema;
+exports.PersonaConfigurationSchema = PersonaConfigurationSchema;
+exports.PersonaSchema = PersonaSchema;
+exports.PersonasConfigurationSchema = PersonasConfigurationSchema;
+exports.PersonasSchema = PersonasSchema;
 exports.ProgressLogger = ProgressLogger;
 exports.Scout9ProjectBuildConfigSchema = Scout9ProjectBuildConfigSchema;
+exports.Scout9ProjectConfigSchema = Scout9ProjectConfigSchema;
 exports.Scout9Test = Scout9Test;
+exports.TestSchema = TestSchema;
 exports.WorkflowConfigurationSchema = WorkflowConfigurationSchema;
 exports.WorkflowEventSchema = WorkflowEventSchema;
+exports.WorkflowFunctionSchema = WorkflowFunctionSchema;
+exports.WorkflowResponseMessage = WorkflowResponseMessage;
+exports.WorkflowResponseMessageApiRequest = WorkflowResponseMessageApiRequest;
+exports.WorkflowResponseMessageApiResponse = WorkflowResponseMessageApiResponse;
+exports.WorkflowResponseSchema = WorkflowResponseSchema;
+exports.WorkflowResponseSlotBaseSchema = WorkflowResponseSlotBaseSchema;
+exports.WorkflowResponseSlotSchema = WorkflowResponseSlotSchema;
 exports.WorkflowsConfigurationSchema = WorkflowsConfigurationSchema;
+exports.apiFunctionSchema = apiFunctionSchema;
 exports.balancedMatch = balancedMatch;
 exports.build = build;
 exports.checkVariableType = checkVariableType;
@@ -48224,7 +48316,10 @@ exports.createMockConversation = createMockConversation;
 exports.createMockCustomer = createMockCustomer;
 exports.createMockMessage = createMockMessage;
 exports.createMockWorkflowEvent = createMockWorkflowEvent;
+exports.deleteApiFunctionSchema = deleteApiFunctionSchema;
+exports.eventResponseSchema = eventResponseSchema;
 exports.forward = forward;
+exports.getApiFunctionSchema = getApiFunctionSchema;
 exports.getAugmentedNamespace = getAugmentedNamespace;
 exports.getDefaultExportFromCjs = getDefaultExportFromCjs;
 exports.globSync = globSync;
@@ -48233,7 +48328,11 @@ exports.loadConfig = loadConfig;
 exports.loadEnvConfig = loadEnvConfig;
 exports.loadUserPackageJson = loadUserPackageJson;
 exports.logUserValidationError = logUserValidationError;
+exports.patchApiFunctionSchema = patchApiFunctionSchema;
+exports.postApiFunctionSchema = postApiFunctionSchema;
 exports.projectTemplates = projectTemplates;
+exports.putApiFunctionSchema = putApiFunctionSchema;
+exports.queryApiFunctionSchema = queryApiFunctionSchema;
 exports.reply = reply;
 exports.report = report;
 exports.requireOptionalProjectFile = requireOptionalProjectFile;

package/dist/{index-332067ab.cjs → index-6fd2c8cd.cjs}

@@ -1,7 +1,7 @@
 'use strict';
 
 var spirits = require("./spirits-76855e30.cjs");
-var dev = require("./dev-df823c44.cjs");
+var dev = require("./dev-73ac7343.cjs");
 var require$$0 = require('fs');
 var require$$2$1 = require('events');
 var require$$1 = require('path');
@@ -29482,7 +29482,7 @@ class Body {
     }
     const {
       toFormData
-    } = await Promise.resolve().then(function () { return require("./multipart-parser-50a82502.cjs"); });
+    } = await Promise.resolve().then(function () { return require("./multipart-parser-a55dfbdc.cjs"); });
     return toFormData(this.body, ct);
   }
 
@@ -41891,7 +41891,7 @@ function _loadUserPackageJson() {
           targetPkgUrl = isTest ? packageTestJsonUrl : packageJsonUrl;
           _context.t0 = JSON;
           _context.next = 10;
-          return fs__default["default"].readFile(new URL(targetPkgUrl, (typeof document === 'undefined' ? new (require('u' + 'rl').URL)('file:' + __filename).href : (document.currentScript && document.currentScript.src || new URL('index-332067ab.js', document.baseURI).href))), 'utf-8');
+          return fs__default["default"].readFile(new URL(targetPkgUrl, (typeof document === 'undefined' ? new (require('u' + 'rl').URL)('file:' + __filename).href : (document.currentScript && document.currentScript.src || new URL('index-6fd2c8cd.js', document.baseURI).href))), 'utf-8');
         case 10:
           _context.t1 = _context.sent;
           pkg = _context.t0.parse.call(_context.t0, _context.t1);
@@ -43097,7 +43097,7 @@ var ProjectFiles = /*#__PURE__*/function () {
   return ProjectFiles;
 }();
 
-var __filename$1 = node_url.fileURLToPath((typeof document === 'undefined' ? new (require('u' + 'rl').URL)('file:' + __filename).href : (document.currentScript && document.currentScript.src || new URL('index-332067ab.js', document.baseURI).href)));
+var __filename$1 = node_url.fileURLToPath((typeof document === 'undefined' ? new (require('u' + 'rl').URL)('file:' + __filename).href : (document.currentScript && document.currentScript.src || new URL('index-6fd2c8cd.js', document.baseURI).href)));
 var __dirname$1 = path__default["default"].dirname(__filename$1);
 function zipDirectory(source, out) {
   var archive = archiver$1('tar', {
@@ -43312,7 +43312,7 @@ function _buildApp() {
         case 11:
           _context4.t0 = JSON;
           _context4.next = 14;
-          return fs__default["default"].readFile(new URL(templatePackagePath, (typeof document === 'undefined' ? new (require('u' + 'rl').URL)('file:' + __filename).href : (document.currentScript && document.currentScript.src || new URL('index-332067ab.js', document.baseURI).href))), 'utf-8');
+          return fs__default["default"].readFile(new URL(templatePackagePath, (typeof document === 'undefined' ? new (require('u' + 'rl').URL)('file:' + __filename).href : (document.currentScript && document.currentScript.src || new URL('index-6fd2c8cd.js', document.baseURI).href))), 'utf-8');
         case 14:
           _context4.t1 = _context4.sent;
           packageTemplate = _context4.t0.parse.call(_context4.t0, _context4.t1);

package/dist/index.cjs

@@ -2,8 +2,8 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var index = require("./index-332067ab.cjs");
-var dev = require("./dev-df823c44.cjs");
+var index = require("./index-6fd2c8cd.cjs");
+var dev = require("./dev-73ac7343.cjs");
 require("./spirits-76855e30.cjs");
 require('fs');
 require('events');
@@ -47,12 +47,62 @@ exports.did = index.did;
 exports.json = index.json;
 exports.run = index.run;
 exports.sendEvent = index.sendEvent;
+exports.AgentConfigurationSchema = dev.AgentConfigurationSchema;
+exports.AgentSchema = dev.AgentSchema;
+exports.AgentsConfigurationSchema = dev.AgentsConfigurationSchema;
+exports.AgentsSchema = dev.AgentsSchema;
+exports.Baz = dev.Baz;
+exports.Bus = dev.Bus;
+exports.ContextExampleSchema = dev.ContextExampleSchema;
+exports.ContextExampleWithTrainingDataSchema = dev.ContextExampleWithTrainingDataSchema;
+exports.ConversationAnticipateSchema = dev.ConversationAnticipateSchema;
+exports.ConversationContext = dev.ConversationContext;
+exports.ConversationSchema = dev.ConversationSchema;
+exports.CustomerSchema = dev.CustomerSchema;
+exports.CustomerValueSchema = dev.CustomerValueSchema;
+exports.EntitiesRootConfigurationSchema = dev.EntitiesRootConfigurationSchema;
+exports.EntitiesRootProjectConfigurationSchema = dev.EntitiesRootProjectConfigurationSchema;
+exports.EntityApiConfigurationSchema = dev.EntityApiConfigurationSchema;
+exports.EntityConfigurationSchema = dev.EntityConfigurationSchema;
+exports.EntityRootProjectConfigurationSchema = dev.EntityRootProjectConfigurationSchema;
+exports.FollowupBaseSchema = dev.FollowupBaseSchema;
+exports.FollowupSchema = dev.FollowupSchema;
+exports.ForwardSchema = dev.ForwardSchema;
+exports.InstructionObjectSchema = dev.InstructionObjectSchema;
+exports.InstructionSchema = dev.InstructionSchema;
+exports.IntentWorkflowEventSchema = dev.IntentWorkflowEventSchema;
+exports.MessageSchema = dev.MessageSchema;
+exports.PersonaConfigurationSchema = dev.PersonaConfigurationSchema;
+exports.PersonaSchema = dev.PersonaSchema;
+exports.PersonasConfigurationSchema = dev.PersonasConfigurationSchema;
+exports.PersonasSchema = dev.PersonasSchema;
+exports.Scout9ProjectBuildConfigSchema = dev.Scout9ProjectBuildConfigSchema;
+exports.Scout9ProjectConfigSchema = dev.Scout9ProjectConfigSchema;
 exports.Scout9Test = dev.Scout9Test;
+exports.TestSchema = dev.TestSchema;
+exports.WorkflowConfigurationSchema = dev.WorkflowConfigurationSchema;
+exports.WorkflowEventSchema = dev.WorkflowEventSchema;
+exports.WorkflowFunctionSchema = dev.WorkflowFunctionSchema;
+exports.WorkflowResponseMessage = dev.WorkflowResponseMessage;
+exports.WorkflowResponseMessageApiRequest = dev.WorkflowResponseMessageApiRequest;
+exports.WorkflowResponseMessageApiResponse = dev.WorkflowResponseMessageApiResponse;
+exports.WorkflowResponseSchema = dev.WorkflowResponseSchema;
+exports.WorkflowResponseSlotBaseSchema = dev.WorkflowResponseSlotBaseSchema;
+exports.WorkflowResponseSlotSchema = dev.WorkflowResponseSlotSchema;
+exports.WorkflowsConfigurationSchema = dev.WorkflowsConfigurationSchema;
+exports.apiFunctionSchema = dev.apiFunctionSchema;
 exports.createMockAgent = dev.createMockAgent;
 exports.createMockConversation = dev.createMockConversation;
 exports.createMockCustomer = dev.createMockCustomer;
 exports.createMockMessage = dev.createMockMessage;
 exports.createMockWorkflowEvent = dev.createMockWorkflowEvent;
+exports.deleteApiFunctionSchema = dev.deleteApiFunctionSchema;
+exports.eventResponseSchema = dev.eventResponseSchema;
 exports.forward = dev.forward;
+exports.getApiFunctionSchema = dev.getApiFunctionSchema;
 exports.instruct = dev.instruct;
+exports.patchApiFunctionSchema = dev.patchApiFunctionSchema;
+exports.postApiFunctionSchema = dev.postApiFunctionSchema;
+exports.putApiFunctionSchema = dev.putApiFunctionSchema;
+exports.queryApiFunctionSchema = dev.queryApiFunctionSchema;
 exports.reply = dev.reply;

package/dist/{multipart-parser-50a82502.cjs → multipart-parser-a55dfbdc.cjs}

@@ -2,9 +2,9 @@
 
 require('node:fs');
 require('node:path');
-var index = require("./index-332067ab.cjs");
+var index = require("./index-6fd2c8cd.cjs");
 require("./spirits-76855e30.cjs");
-require("./dev-df823c44.cjs");
+require("./dev-73ac7343.cjs");
 require('util');
 require('stream');
 require('path');

package/dist/testing-tools.cjs

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var dev = require("./dev-df823c44.cjs");
+var dev = require("./dev-73ac7343.cjs");
 require("./spirits-76855e30.cjs");
 require('util');
 require('stream');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scout9/app",
-  "version": "1.0.0-alpha.0.2.1",
+  "version": "1.0.0-alpha.0.2.4",
   "description": "Build and deploy your Scout9 app for SMS auto replies",
   "publishConfig": {
     "access": "public"
@@ -19,7 +19,7 @@
     "postinstall": "node postinstall.js",
     "prepublishOnly": "npm run build",
     "generate:types": "node scripts/generate-dts.js",
-    "prebuild": "rimraf dist/",
+    "prebuild": "rimraf dist/ && rimraf types/index.d.ts && rimraf types/index.d.ts.map",
     "build": "rollup -c",
     "postbuild": "npm run generate:types && node scripts/post-build.js && npx tsc --noEmit",
     "build-no-test": "npm run prebuild && rollup -c"

package/src/core/templates/app.js

@@ -6,12 +6,14 @@ import colors from 'kleur';
 import { config as dotenv } from 'dotenv';
 import { Configuration, Scout9Api } from '@scout9/admin';
 import { EventResponse, WorkflowEventSchema } from '@scout9/app';
-import path from 'node:path';
+import path, { resolve } from 'node:path';
 import fs from 'node:fs';
 import https from 'node:https';
 import { fileURLToPath, pathToFileURL } from 'node:url';
 import projectApp from './src/app.js';
 import config from './config.js';
+import { readdir } from 'fs/promises';
+import { ZodError } from 'zod';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -92,6 +94,10 @@ const handleError = (e, res = undefined) => {
     }
   }
   console.log(colors.red(`${colors.bold(`${code} Error`)}: ${message}`));
+  if ('stack' in e) {
+    console.log(colors.grey(e.stack));
+  }
+  console.log(colors)
   if (res) {
     res.writeHead(code, {'Content-Type': 'application/json'});
     res.end(JSON.stringify({
@@ -161,17 +167,43 @@ if (dev) {
 
 // Root application POST endpoint will run the scout9 app
 app.post(dev ? '/dev/workflow' : '/', async (req, res) => {
+  let workflowEvent;
   try {
-    const event = WorkflowEventSchema.parse(req.body.event);
+    workflowEvent = WorkflowEventSchema.parse(req.body.event);
     globalThis.SCOUT9 = {
-      ...event,
+      ...workflowEvent,
       $convo: req.body.$convo,
     }
-    const response = await projectApp(event);
+  } catch (error) {
+    if (error instanceof ZodError) {
+      const formattedErrors = error.format();
+      res.writeHead(400, {'Content-Type': 'application/json'});
+      res.end(JSON.stringify({
+        status: 'WorkflowInvalidResponseType',
+        errors: formattedErrors
+      }));
+      console.log(colors.red(`${colors.bold(`Bad Input Event:`)}: Received: ${JSON.stringify(req.body.event, null, 2)}\n\nErrors:\n\n${JSON.stringify(formattedErrors, null, 2)}`));
+    } else {
+      error.message = `Workflow Template Event Parse Error: ` + error.message;
+      handleError(error, res);
+    }
+    return;
+  }
+  if (!workflowEvent) {
+    handleError(new Error('No workflowEvent defined'), res);
+  }
+
+  try {
+    const response = await projectApp(workflowEvent);
+    if (dev) {
+      console.log(colors.green(`Workflow Sending Response:`));
+      console.log(colors.grey(JSON.stringify(response, null, 2)));
+    }
     res.writeHead(200, {'Content-Type': 'application/json'});
     res.end(JSON.stringify(response));
-  } catch (e) {
-    handleError(e, res);
+  } catch (error) {
+    error.message = `Workflow Template Runtime Error: ` + error.message
+    handleError(error, res);
   }
 });
 
@@ -229,6 +261,7 @@ async function resolveEntityApi(entity, method) {
 
 }
 
+
 function extractParamsFromPath(path) {
   const segments = path.split('/').filter(Boolean); // Split and remove empty segments
   let params = {};
@@ -284,6 +317,86 @@ async function runEntityApi(req, res) {
   }
 }
 
+async function getFilesRecursive(dir) {
+  let results = [];
+  const list = await readdir(dir, { withFileTypes: true });
+
+  for (const dirent of list) {
+    const res = resolve(dir, dirent.name);
+    if (dirent.isDirectory()) {
+      results = results.concat(await getFilesRecursive(res)); // Recursively get files from subdirectories
+    } else {
+      results.push(res); // Add file to results
+    }
+  }
+
+  return results;
+}
+
+async function runCommandApi(req, res) {
+  let file;
+  const {body, url} = req;
+  const params = url.split('/').slice(2).filter(Boolean);
+  const commandsDir = resolve(__dirname, `./src/commands`);
+
+  try {
+    const files = await getFilesRecursive(commandsDir).then(files => files.map(file => file.replace(commandsDir, '.')).filter(file => params.every(p => file.includes(p))))
+    file = files?.[0];
+  } catch (e) {
+    console.log('No commands found', e.message)
+  }
+
+
+  if (!file) {
+    throw new Error(`Unable to find command for ${url}`);
+  }
+
+  let mod;
+  try {
+    mod = await import(pathToFileURL(path.resolve(commandsDir, file)).href)
+    console.log(mod);
+  } catch (e) {
+    if ('code' in e) {
+      switch (e.code) {
+        case 'ERR_MODULE_NOT_FOUND':
+        case 'MODULE_NOT_FOUND':
+          console.error(e);
+          throw new Error(`Invalid command: no API method`);
+      }
+    }
+    console.error(e);
+    throw new Error(`Invalid command: Internal system error`);
+  }
+
+  if (!mod || !mod.default) {
+    throw new Error(`Command file "${file}" does not export a default command function`);
+  }
+
+  console.log(mod);
+
+  let result;
+
+  try {
+    result = await mod.default(body);
+  } catch (e) {
+    console.error('Failed to run command', e);
+    throw new Error(`Failed to run command: ${e.message}`)
+  }
+
+  if (result) {
+    if (typeof result === 'string') {
+      return {message: result};
+    } else if (typeof result === 'object' && 'message' in result) {
+      return result;
+    } else {
+      throw new Error(`Invalid Command Response, must either return a string or {"message": "<your message>"}`);
+    }
+  }
+  return {message: `${mod.default.name} Complete`};
+}
+
+app.post('/commands/:command', runCommandApi);
+app.post('/commands/:command/*', runCommandApi);
 app.get('/entity/:entity', runEntityApi);
 app.put('/entity/:entity', runEntityApi);
 app.patch('/entity/:entity', runEntityApi);

package/src/exports.js

@@ -5,6 +5,7 @@ export { EventResponse } from './runtime/index.js';
 
 export * from './testing-tools/index.js';
 export * from './runtime/client/index.js';
+export * from './runtime/schemas/index.js';
 export * from './runtime/macros/index.js';
 
 /**