feat: allow running workflows using cli command

.github/workflows/js-ci.yaml

@@ -169,6 +169,16 @@ jobs:
         with:
           node-version: '${{ steps.nvm.outputs.NVMRC }}'
 
+      - uses: actions/setup-go@v3
+        with:
+          go-version: '^1.13.1'
+
+      - name: Install cue lang
+        run: go install cuelang.org/go/cmd/cue@latest
+
+      - name: Check if cue is installed
+        run: cue version
+
       - name: Get yarn cache directory path
         id: yarn-cache-dir-path
         run: echo "::set-output name=dir::$(yarn cache dir)"

packages/cli/lang/en.json

@@ -102,7 +102,6 @@
   "commands_create_options_o": "Output directory for the new project",
   "commands_create_options_o_path": "path",
   "commands_create_options_projectName": "project-name",
-  "commands_query_options_recipeScript": "Path to recipe script",
   "commands_create_overwritePrompt": "Do you want to overwrite this directory?",
   "commands_create_overwriting": "Overwriting {dir}...",
   "commands_create_readyApp": "You are ready to build an app using Polywrap",
@@ -140,43 +139,51 @@
   "commands_plugin_options_path": "path",
   "commands_plugin_options_publish": "Output path for the built schema and manifest (default: {default})",
   "commands_plugin_options_codegen": "Output directory for the generated types (default: {default})",
-  "commands_query_options_configPath": "config-path",
-  "commands_query_options_outputFilePath": "output-file-path",
-  "commands_query_options_config": "Add custom configuration to the PolywrapClient",
-  "commands_query_options_outputFile": "Output file path for the query result",
-  "commands_query_options_quiet": "Suppress output",
-  "commands_query_error_outputFileMissing": "{option} option missing {argument} argument",
-  "commands_query_error_clientConfigMissingPath": "{option} option missing {argument} argument",
-  "commands_query_error_clientConfigModuleMissingExport": "Custom client config module missing named export 'getClientConfig' at {module}",
-  "commands_query_error_clientConfigInvalidFileExt": "Custom client config file: {module} must be a JS/TS file",
-  "commands_query_error_clientConfigNotObject": "Custom client config must be an object",
-  "commands_query_error_redirectsExportNotArray": "Exported redirects must be an array",
-  "commands_query_error_redirectsItemNotValid": "Redirect at index {index} must be an object with properties 'from' and 'to'",
-  "commands_query_error_redirectsItemFromNotString": "Redirect property 'from' at index {index} must be a valid wrap:// URI string",
-  "commands_query_error_redirectsItemToNotStringOrObject": "Redirect property 'to' at index {index} must be a valid wrap:// URI string, or a plugin",
-  "commands_query_error_redirectsItemToNotValidPlugin": "Redirect property 'to' at index {index} must be a valid plugin instance",
-  "commands_query_error_pluginsExportNotArray": "Exported plugins must be an array",
-  "commands_query_error_pluginsItemNotObject": "Plugin at index {index} must be an object with properties 'uri' and 'plugin'",
-  "commands_query_error_pluginsItemUriNotString": "Plugin property 'uri' at index {index} must be a valid wrap:// URI string",
-  "commands_query_error_pluginsItemPluginNotObject": "Plugin property 'plugin' at index {index} must be an object with properties 'factory' and 'manifest'",
-  "commands_query_error_pluginsItemPluginFactoryNotFunction": "Plugin property 'plugin.factory' at index {index} must be a function",
-  "commands_query_error_pluginsItemPluginManifestNotObject": "Plugin property 'plugin.manifest' at index {index} must be an object",
-  "commands_query_error_interfacesExportNotArray": "Exported interfaces must be an array",
-  "commands_query_error_interfacesItemNotObject": "Interface at index {index} must be an object with properties 'interface' and 'implementations'",
-  "commands_query_error_interfacesItemInterfaceNotString": "Interface property 'interface' at index {index} must be a valid wrap:// URI string",
-  "commands_query_error_interfacesItemImplementationsNotArray": "Interface property 'implementations' at index {index} must be an array",
-  "commands_query_error_interfacesItemImplementationsEmpty": "Interface property 'implementations' at index {index} must not be an empty array",
-  "commands_query_error_interfacesItemImplementationsItemNotString": "Implementation at index ({index}, {implementationIndex}) must be a valid wrap:// URI string",
-  "commands_query_error_envsExportNotArray": "Exported envs must be an array",
-  "commands_query_error_envsItemNotObject": "Env at index {index} must be an object with properties 'uri' and optional properties 'common', 'query', and 'mutation'",
-  "commands_query_error_envsItemUriNotString": "Env property 'uri' at index {index} must be a valid wrap:// URI string",
-  "commands_query_error_envsItemModuleNotObject": "Env property 'module' at index {index} must be an object",
-  "commands_query_description": "Query wrappers using recipe scripts",
-  "commands_query_error_missingScript": "Required argument {script} is missing",
-  "commands_query_error_noWrapper": "Wrapper needs to be initialized",
-  "commands_query_error_readFail": "Failed to read query {query}",
-  "commands_query_error_noRecipeScriptFound": "Recipe script not found at path: {path}",
-  "commands_query_error_noTestEnvFound": "polywrap test-env not found, please run 'polywrap infra up --modules=eth-ens-ipfs'",
+  "commands_run_options_workflow": "workflow",
+  "commands_run_options_workflowScript": "Path to workflow script",
+  "commands_run_options_configPath": "config-path",
+  "commands_run_options_outputFilePath": "output-file-path",
+  "commands_run_options_config": "Add custom configuration to the PolywrapClient",
+  "commands_run_options_validateScript": "Validate the output of the workflow jobs",
+  "commands_run_options_validate": "cue-file",
+  "commands_run_options_outputFile": "Output file path for the workflow result",
+  "commands_run_options_quiet": "Suppress output",
+  "commands_run_options_jobIds": "jobs",
+  "commands_run_options_jobs": "Specify ids of jobs that you want to run",
+  "commands_run_error_validatorNotFound": "validate script not found at: {path}",
+  "commands_run_error_outputFileMissing": "{option} option missing {argument} argument",
+  "commands_run_error_clientConfigMissingPath": "{option} option missing {argument} argument",
+  "commands_run_error_clientConfigModuleMissingExport": "Custom client config module missing named export 'getClientConfig' at {module}",
+  "commands_run_error_clientConfigInvalidFileExt": "Custom client config file: {module} must be a JS/TS file",
+  "commands_run_error_clientConfigNotObject": "Custom client config must be an object",
+  "commands_run_error_redirectsExportNotArray": "Exported redirects must be an array",
+  "commands_run_error_redirectsItemNotValid": "Redirect at index {index} must be an object with properties 'from' and 'to'",
+  "commands_run_error_redirectsItemFromNotString": "Redirect property 'from' at index {index} must be a valid wrap:// URI string",
+  "commands_run_error_redirectsItemToNotStringOrObject": "Redirect property 'to' at index {index} must be a valid wrap:// URI string, or a plugin",
+  "commands_run_error_redirectsItemToNotValidPlugin": "Redirect property 'to' at index {index} must be a valid plugin instance",
+  "commands_run_error_pluginsExportNotArray": "Exported plugins must be an array",
+  "commands_run_error_pluginsItemNotObject": "Plugin at index {index} must be an object with properties 'uri' and 'plugin'",
+  "commands_run_error_pluginsItemUriNotString": "Plugin property 'uri' at index {index} must be a valid wrap:// URI string",
+  "commands_run_error_pluginsItemPluginNotObject": "Plugin property 'plugin' at index {index} must be an object with properties 'factory' and 'manifest'",
+  "commands_run_error_pluginsItemPluginFactoryNotFunction": "Plugin property 'plugin.factory' at index {index} must be a function",
+  "commands_run_error_pluginsItemPluginManifestNotObject": "Plugin property 'plugin.manifest' at index {index} must be an object",
+  "commands_run_error_interfacesExportNotArray": "Exported interfaces must be an array",
+  "commands_run_error_interfacesItemNotObject": "Interface at index {index} must be an object with properties 'interface' and 'implementations'",
+  "commands_run_error_interfacesItemInterfaceNotString": "Interface property 'interface' at index {index} must be a valid wrap:// URI string",
+  "commands_run_error_interfacesItemImplementationsNotArray": "Interface property 'implementations' at index {index} must be an array",
+  "commands_run_error_interfacesItemImplementationsEmpty": "Interface property 'implementations' at index {index} must not be an empty array",
+  "commands_run_error_interfacesItemImplementationsItemNotString": "Implementation at index ({index}, {implementationIndex}) must be a valid wrap:// URI string",
+  "commands_run_error_envsExportNotArray": "Exported envs must be an array",
+  "commands_run_error_envsItemNotObject": "Env at index {index} must be an object with properties 'uri'",
+  "commands_run_error_envsItemUriNotString": "Env property 'uri' at index {index} must be a valid wrap:// URI string",
+  "commands_run_error_envsItemModuleNotObject": "Env property 'env' at index {index} must be an object",
+  "commands_run_description": "Runs workflow script",
+  "commands_run_error_missingScript": "Required argument {script} is missing",
+  "commands_run_error_noApi": "API needs to be initialized",
+  "commands_run_error_readFail": "Failed to read query {query}",
+  "commands_run_error_unsupportedOutputFileExt": "Unsupported outputFile extention: ${outputFileExt}",
+  "commands_run_error_noWorkflowScriptFound": "Workflow script not found at path: {path}",
+  "commands_run_error_noTestEnvFound": "polywrap test-env not found, please run 'polywrap infra up --modules=eth-ens-ipfs'",
   "commands_testEnv_description": "Manage a test environment for Polywrap",
   "commands_testEnv_error_never": "This should never happen...",
   "commands_testEnv_error_noCommand": "No command given",

packages/cli/lang/es.json

@@ -1,4 +1,3 @@
-
 {
   "commands_build_description": "Builds a wrapper",
   "commands_build_error_manifestPathMissing": "{option} option missing {argument} argument",
@@ -103,7 +102,6 @@
   "commands_create_options_o": "Output directory for the new project",
   "commands_create_options_o_path": "path",
   "commands_create_options_projectName": "project-name",
-  "commands_query_options_recipeScript": "Path to recipe script",
   "commands_create_overwritePrompt": "Do you want to overwrite this directory?",
   "commands_create_overwriting": "Overwriting {dir}...",
   "commands_create_readyApp": "You are ready to build an app using Polywrap",
@@ -141,43 +139,51 @@
   "commands_plugin_options_path": "path",
   "commands_plugin_options_publish": "Output path for the built schema and manifest (default: {default})",
   "commands_plugin_options_codegen": "Output directory for the generated types (default: {default})",
-  "commands_query_options_configPath": "config-path",
-  "commands_query_options_outputFilePath": "output-file-path",
-  "commands_query_options_config": "Add custom configuration to the PolywrapClient",
-  "commands_query_options_outputFile": "Output file path for the query result",
-  "commands_query_options_quiet": "Suppress output",
-  "commands_query_error_outputFileMissing": "{option} option missing {argument} argument",
-  "commands_query_error_clientConfigMissingPath": "{option} option missing {argument} argument",
-  "commands_query_error_clientConfigModuleMissingExport": "Custom client config module missing named export 'getClientConfig' at {module}",
-  "commands_query_error_clientConfigInvalidFileExt": "Custom client config file: {module} must be a JS/TS file",
-  "commands_query_error_clientConfigNotObject": "Custom client config must be an object",
-  "commands_query_error_redirectsExportNotArray": "Exported redirects must be an array",
-  "commands_query_error_redirectsItemNotValid": "Redirect at index {index} must be an object with properties 'from' and 'to'",
-  "commands_query_error_redirectsItemFromNotString": "Redirect property 'from' at index {index} must be a valid wrap:// URI string",
-  "commands_query_error_redirectsItemToNotStringOrObject": "Redirect property 'to' at index {index} must be a valid wrap:// URI string, or a plugin",
-  "commands_query_error_redirectsItemToNotValidPlugin": "Redirect property 'to' at index {index} must be a valid plugin instance",
-  "commands_query_error_pluginsExportNotArray": "Exported plugins must be an array",
-  "commands_query_error_pluginsItemNotObject": "Plugin at index {index} must be an object with properties 'uri' and 'plugin'",
-  "commands_query_error_pluginsItemUriNotString": "Plugin property 'uri' at index {index} must be a valid wrap:// URI string",
-  "commands_query_error_pluginsItemPluginNotObject": "Plugin property 'plugin' at index {index} must be an object with properties 'factory' and 'manifest'",
-  "commands_query_error_pluginsItemPluginFactoryNotFunction": "Plugin property 'plugin.factory' at index {index} must be a function",
-  "commands_query_error_pluginsItemPluginManifestNotObject": "Plugin property 'plugin.manifest' at index {index} must be an object",
-  "commands_query_error_interfacesExportNotArray": "Exported interfaces must be an array",
-  "commands_query_error_interfacesItemNotObject": "Interface at index {index} must be an object with properties 'interface' and 'implementations'",
-  "commands_query_error_interfacesItemInterfaceNotString": "Interface property 'interface' at index {index} must be a valid wrap:// URI string",
-  "commands_query_error_interfacesItemImplementationsNotArray": "Interface property 'implementations' at index {index} must be an array",
-  "commands_query_error_interfacesItemImplementationsEmpty": "Interface property 'implementations' at index {index} must not be an empty array",
-  "commands_query_error_interfacesItemImplementationsItemNotString": "Implementation at index ({index}, {implementationIndex}) must be a valid wrap:// URI string",
-  "commands_query_error_envsExportNotArray": "Exported envs must be an array",
-  "commands_query_error_envsItemNotObject": "Env at index {index} must be an object with properties 'uri'",
-  "commands_query_error_envsItemUriNotString": "Env property 'uri' at index {index} must be a valid wrap:// URI string",
-  "commands_query_error_envsItemModuleNotObject": "Env property 'common' at index {index} must be an object",
-  "commands_query_description": "Query wrappers using recipe scripts",
-  "commands_query_error_missingScript": "Required argument {script} is missing",
-  "commands_query_error_noWrapper": "Wrapper needs to be initialized",
-  "commands_query_error_readFail": "Failed to read query {query}",
-  "commands_query_error_noRecipeScriptFound": "Recipe script not found at path: {path}",
-  "commands_query_error_noTestEnvFound": "polywrap test-env not found, please run 'polywrap infra up --modules=eth-ens-ipfs'",
+  "commands_run_options_workflow": "workflow",
+  "commands_run_options_workflowScript": "Path to workflow script",
+  "commands_run_options_configPath": "config-path",
+  "commands_run_options_outputFilePath": "output-file-path",
+  "commands_run_options_config": "Add custom configuration to the PolywrapClient",
+  "commands_run_options_validateScript": "Validate the output of the workflow jobs",
+  "commands_run_options_validate": "cue-file",
+  "commands_run_options_outputFile": "Output file path for the workflow result",
+  "commands_run_options_quiet": "Suppress output",
+  "commands_run_options_jobIds": "jobs",
+  "commands_run_options_jobs": "Specify ids of jobs that you want to run",
+  "commands_run_error_validatorNotFound": "validate script not found at: {path}",
+  "commands_run_error_outputFileMissing": "{option} option missing {argument} argument",
+  "commands_run_error_clientConfigMissingPath": "{option} option missing {argument} argument",
+  "commands_run_error_clientConfigModuleMissingExport": "Custom client config module missing named export 'getClientConfig' at {module}",
+  "commands_run_error_clientConfigInvalidFileExt": "Custom client config file: {module} must be a JS/TS file",
+  "commands_run_error_clientConfigNotObject": "Custom client config must be an object",
+  "commands_run_error_redirectsExportNotArray": "Exported redirects must be an array",
+  "commands_run_error_redirectsItemNotValid": "Redirect at index {index} must be an object with properties 'from' and 'to'",
+  "commands_run_error_redirectsItemFromNotString": "Redirect property 'from' at index {index} must be a valid wrap:// URI string",
+  "commands_run_error_redirectsItemToNotStringOrObject": "Redirect property 'to' at index {index} must be a valid wrap:// URI string, or a plugin",
+  "commands_run_error_redirectsItemToNotValidPlugin": "Redirect property 'to' at index {index} must be a valid plugin instance",
+  "commands_run_error_pluginsExportNotArray": "Exported plugins must be an array",
+  "commands_run_error_pluginsItemNotObject": "Plugin at index {index} must be an object with properties 'uri' and 'plugin'",
+  "commands_run_error_pluginsItemUriNotString": "Plugin property 'uri' at index {index} must be a valid wrap:// URI string",
+  "commands_run_error_pluginsItemPluginNotObject": "Plugin property 'plugin' at index {index} must be an object with properties 'factory' and 'manifest'",
+  "commands_run_error_pluginsItemPluginFactoryNotFunction": "Plugin property 'plugin.factory' at index {index} must be a function",
+  "commands_run_error_pluginsItemPluginManifestNotObject": "Plugin property 'plugin.manifest' at index {index} must be an object",
+  "commands_run_error_interfacesExportNotArray": "Exported interfaces must be an array",
+  "commands_run_error_interfacesItemNotObject": "Interface at index {index} must be an object with properties 'interface' and 'implementations'",
+  "commands_run_error_interfacesItemInterfaceNotString": "Interface property 'interface' at index {index} must be a valid wrap:// URI string",
+  "commands_run_error_interfacesItemImplementationsNotArray": "Interface property 'implementations' at index {index} must be an array",
+  "commands_run_error_interfacesItemImplementationsEmpty": "Interface property 'implementations' at index {index} must not be an empty array",
+  "commands_run_error_interfacesItemImplementationsItemNotString": "Implementation at index ({index}, {implementationIndex}) must be a valid wrap:// URI string",
+  "commands_run_error_envsExportNotArray": "Exported envs must be an array",
+  "commands_run_error_envsItemNotObject": "Env at index {index} must be an object with properties 'uri'",
+  "commands_run_error_envsItemUriNotString": "Env property 'uri' at index {index} must be a valid wrap:// URI string",
+  "commands_run_error_envsItemModuleNotObject": "Env property 'env' at index {index} must be an object",
+  "commands_run_description": "Runs workflow script",
+  "commands_run_error_missingScript": "Required argument {script} is missing",
+  "commands_run_error_noApi": "API needs to be initialized",
+  "commands_run_error_readFail": "Failed to read query {query}",
+  "commands_run_error_unsupportedOutputFileExt": "Unsupported outputFile extention: ${outputFileExt}",
+  "commands_run_error_noWorkflowScriptFound": "Workflow script not found at path: {path}",
+  "commands_run_error_noTestEnvFound": "polywrap test-env not found, please run 'polywrap infra up --modules=eth-ens-ipfs'",
   "commands_testEnv_description": "Manage a test environment for Polywrap",
   "commands_testEnv_error_never": "This should never happen...",
   "commands_testEnv_error_noCommand": "No command given",

packages/cli/src/__tests__/e2e/help.spec.ts

@@ -15,8 +15,8 @@ Commands:
   create|c                    Create a new project with polywrap CLI
   deploy|d [options]          Deploys/Publishes a Polywrap
   plugin|p                    Build/generate types for the plugin
-  query|q [options] <recipe>  Query wrappers using recipe scripts
   infra|i [options] <action>  Manage infrastructure for your wrapper
+  run|r [options] <workflow>  Runs workflow script
   help [command]              display help for command
 `;