feat: JS Wrapper Around The Polywrap CLI

package.json

@@ -26,15 +26,15 @@
     "dependencies:install": "cd dependencies && yarn",
     "preinstall": "yarn dependencies:install",
     "build": "yarn build:core && yarn build:interfaces && yarn link:schema && yarn build:plugins && yarn build:resolver:plugins && yarn build:config && yarn build:core:client && yarn build:client && yarn build:test-env && yarn build:cli",
-    "build:core": "lerna run build --no-private --ignore @polywrap/*-plugin-js --ignore @polywrap/client-config-builder-js --ignore polywrap --ignore @polywrap/core-client-js --ignore @polywrap/client-js --ignore @polywrap/test-env-js --ignore @polywrap/*-interface",
+    "build:core": "lerna run build --no-private --ignore @polywrap/*-plugin-js --ignore @polywrap/client-config-builder-js --ignore polywrap --ignore @polywrap/core-client-js --ignore @polywrap/client-js --ignore @polywrap/test-env-js --ignore @polywrap/*-interface --ignore @polywrap/cli-js",
     "build:interfaces": "lerna run build --scope @polywrap/*-interface",
     "build:plugins": "lerna run build --scope @polywrap/*-plugin-js --ignore @polywrap/*-resolver-plugin-js",
     "build:resolver:plugins": "lerna run build --scope @polywrap/*-resolver-plugin-js",
     "build:config": "lerna run build --scope @polywrap/client-config-builder-js",
     "build:core:client": "lerna run build --scope @polywrap/core-client-js",
     "build:client": "lerna run build --scope @polywrap/client-js",
     "build:test-env": "lerna run build --scope @polywrap/test-env-js",
-    "build:cli": "lerna run build --scope polywrap",
+    "build:cli": "lerna run build --scope polywrap && lerna run build --scope @polywrap/cli-js",
     "link:interface:deps": "yarn link:manifests && yarn link:schema",
     "link:manifests": "yarn link:manifests:polywrap && yarn link:manifests:wrap",
     "link:manifests:polywrap": "cd packages/js/manifests/polywrap && (yarn unlink || true) && yarn link && cd ../../../../dependencies && yarn link @polywrap/polywrap-manifest-types-js && cd ../",

packages/cli/lang/en.json

@@ -21,7 +21,7 @@
   "commands_build_options_codegen": "Perform code generation before build",
   "commands_build_options_codegen_dir": "Codegen output directory (default: {default})",
   "commands_build_options_w": "Automatically rebuild when changes are made (default: false)",
-  "commands_build_options_s": "Strategy to use for building the wrapper",
+  "commands_build_options_s": "Strategy to use for building the wrapper (default: {default})",
   "commands_build_options_s_strategy": "strategy",
   "commands_build_options_l": "Log file to save console output to",
   "commands_build_error_codegen_failed": "Code generation failed",

packages/cli/lang/es.json

@@ -21,7 +21,7 @@
   "commands_build_options_codegen": "Perform code generation before build",
   "commands_build_options_codegen_dir": "Codegen output directory (default: {default})",
   "commands_build_options_w": "Automatically rebuild when changes are made (default: false)",
-  "commands_build_options_s": "Strategy to use for building the wrapper",
+  "commands_build_options_s": "Strategy to use for building the wrapper (default: {default})",
   "commands_build_options_s_strategy": "strategy",
   "commands_build_options_l": "Log file to save console output to",
   "commands_build_error_codegen_failed": "Code generation failed",

packages/cli/package.json

@@ -15,6 +15,8 @@
   "bin": {
     "polywrap": "bin/polywrap"
   },
+  "main": "build/index.js",
+  "types": "build/types/index.d.ts",
   "scripts": {
     "build": "yarn build:intl && yarn build:fast",
     "build:fast": "rimraf ./build && tsc --project tsconfig.build.json && yarn build:build-strategies && yarn build:deploy-modules && yarn build:infra-modules && yarn build:docgen-templates",

packages/cli/src/__tests__/e2e/build-rs.spec.ts

@@ -5,7 +5,7 @@ import { GetPathToCliTestFiles } from "@polywrap/test-cases";
 import fs from "fs";
 import path from "path";
 
-jest.setTimeout(700000);
+jest.setTimeout(1200000);
 
 describe("e2e tests for build command", () => {
   const testCaseRoot = path.join(GetPathToCliTestFiles(), "wasm/build-cmd/rust");

packages/cli/src/__tests__/e2e/build.wasm.spec.ts

@@ -12,25 +12,25 @@ const HELP = `Usage: polywrap build|b [options]
 Build Polywrap Projects (type: interface, wasm)
 
 Options:
-  -m, --manifest-file <path>         Path to the Polywrap Build manifest file
-                                     (default: polywrap.yaml | polywrap.yml)
-  -o, --output-dir <path>            Output directory for build results
-                                     (default: ./build)
-  -c, --client-config <config-path>  Add custom configuration to the
-                                     PolywrapClient
-  --codegen                          Perform code generation before build
-  --codegen-dir                      Codegen output directory (default:
-                                     ./src/wrap)
-  --wrapper-envs <envs-path>         Path to a JSON file containing wrapper
-                                     envs
-  -s, --strategy <strategy>          Strategy to use for building the wrapper
-                                     (default: "vm")
-  -w, --watch                        Automatically rebuild when changes are
-                                     made (default: false)
-  -v, --verbose                      Verbose output (default: false)
-  -q, --quiet                        Suppress output (default: false)
-  -l, --log-file [path]              Log file to save console output to
-  -h, --help                         display help for command
+  -m, --manifest-file <path>           Path to the Polywrap Build manifest file
+                                       (default: polywrap.yaml | polywrap.yml)
+  -o, --output-dir <path>              Output directory for build results
+                                       (default: ./build)
+  -c, --client-config <config-path>    Add custom configuration to the
+                                       PolywrapClient
+  --codegen                            Perform code generation before build
+  --codegen-dir                        Codegen output directory (default:
+                                       ./src/wrap)
+  --wrapper-envs <envs-path>           Path to a JSON file containing wrapper
+                                       envs
+  -s, --strategy <vm | image | local>  Strategy to use for building the wrapper
+                                       (default: vm)
+  -w, --watch                          Automatically rebuild when changes are
+                                       made (default: false)
+  -v, --verbose                        Verbose output (default: false)
+  -q, --quiet                          Suppress output (default: false)
+  -l, --log-file [path]                Log file to save console output to
+  -h, --help                           display help for command
 `;
 
 jest.setTimeout(500000);
@@ -228,7 +228,7 @@ describe("e2e tests for build command", () => {
     beforeAll(async () => {
       await cleanupYarnLockfiles();
     });
-    
+
     afterAll(async () => {
       await cleanupYarnLockfiles();
     });

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

@@ -14,7 +14,7 @@ Generate Code For Polywrap Projects
 Options:
   -m, --manifest-file <path>         Path to the Polywrap manifest file
                                      (default: polywrap.yaml | polywrap.yml)
-  -g, --codegen-dir <path>            Output directory for the generated code
+  -g, --codegen-dir <path>           Output directory for the generated code
                                      (default: ./src/wrap)
   -s, --script <path>                Path to a custom generation script
                                      (JavaScript | TypeScript)

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

@@ -13,10 +13,10 @@ Commands:
   codegen|g [options]          Generate Code For Polywrap Projects
   create|c                     Create New Projects
   deploy|d [options]           Deploys Polywrap Projects
-  infra|i [options] <action>   Modular Infrastructure-As-Code Orchestrator
-  test|t [options]             Execute Tests
   docgen|o [options] <action>  Generate wrapper documentation
+  infra|i [options] <action>   Modular Infrastructure-As-Code Orchestrator
   manifest|m                   Inspect & Migrade Polywrap Manifests
+  test|t [options]             Execute Tests
   help [command]               display help for command
 `;
 

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

@@ -19,7 +19,7 @@ const HELP = `Usage: polywrap infra|i <action> [options]
 Modular Infrastructure-As-Code Orchestrator
 
 Arguments:
-  action                         
+  action                       
     Infra allows you to execute the following commands:
     up      Start Polywrap infrastructure
     down    Stop Polywrap infrastructure
@@ -28,14 +28,14 @@ Arguments:
    (choices: "up", "down", "vars", "config")
 
 Options:
-  -m, --manifest-file  <path>    Path to the Polywrap Infra manifest file
-                                 (default: polywrap.infra.yaml |
-                                 polywrap.infra.yml)
-  -o, --modules <module,module>  Use only specified modules
-  -v, --verbose                  Verbose output (default: false)
-  -q, --quiet                    Suppress output (default: false)
-  -l, --log-file [path]          Log file to save console output to
-  -h, --help                     display help for command
+  -m, --manifest-file  <path>  Path to the Polywrap Infra manifest file
+                               (default: polywrap.infra.yaml |
+                               polywrap.infra.yml)
+  -o, --modules <module...>    Use only specified modules
+  -v, --verbose                Verbose output (default: false)
+  -q, --quiet                  Suppress output (default: false)
+  -l, --log-file [path]        Log file to save console output to
+  -h, --help                   display help for command
 `;
 
 const portInUse = (port: number) => {
@@ -119,7 +119,7 @@ describe("e2e tests for infra command", () => {
       );
 
       await runPolywrapCli(
-        ["infra", "down", "-v", "--modules=eth-ens-ipfs"],
+        ["infra", "down", "-v", "--modules eth-ens-ipfs"],
         getTestCaseDir(0),
       );
 
@@ -222,7 +222,7 @@ describe("e2e tests for infra command", () => {
 
     it("Should correctly open one process for default module because modules flag overwrites it", async () => {
       await runPolywrapCli(
-        ["infra", "up", "--modules=eth-ens-ipfs"],
+        ["infra", "up", "--modules eth-ens-ipfs"],
         getTestCaseDir(4),
       );
 
@@ -231,7 +231,7 @@ describe("e2e tests for infra command", () => {
       ]);
 
       await runPolywrapCli(
-        ["infra", "down", "--modules=eth-ens-ipfs"],
+        ["infra", "down", "--modules eth-ens-ipfs"],
         getTestCaseDir(4),
       );
     });
@@ -291,7 +291,7 @@ describe("e2e tests for infra command", () => {
 
     it("Should set environment up with only selected modules", async () => {
       await runPolywrapCli(
-        ["infra", "up", "--modules=ipfs"],
+        ["infra", "up", "--modules ipfs"],
         getTestCaseDir(0),
       );
 
@@ -302,7 +302,7 @@ describe("e2e tests for infra command", () => {
       ]);
 
       await runPolywrapCli(
-        ["infra", "down", "--modules=ipfs"],
+        ["infra", "down", "--modules ipfs"],
         getTestCaseDir(0),
       );
 
@@ -316,7 +316,7 @@ describe("e2e tests for infra command", () => {
         [
           "infra",
           "config",
-          "--modules=notExistingModule,alsoNotExisting",
+          "--modules notExistingModule alsoNotExisting",
         ],
         getTestCaseDir(0),
       );
@@ -332,7 +332,7 @@ describe("e2e tests for infra command", () => {
         [
           "infra",
           "up",
-          "--modules=eth-ens-ipfs",
+          "--modules eth-ens-ipfs",
           "--verbose"
         ],
         getTestCaseDir(0),
@@ -349,7 +349,7 @@ describe("e2e tests for infra command", () => {
         [
           "infra",
           "config",
-          "--modules=eth-ens-ipfs",
+          "--modules eth-ens-ipfs",
           "--verbose"
         ],
         getTestCaseDir(2),
@@ -363,7 +363,7 @@ describe("e2e tests for infra command", () => {
         [
           "infra",
           "config",
-          "--modules=eth-ens-ipfs",
+          "--modules eth-ens-ipfs",
           "--verbose"
         ],
         getTestCaseDir(0),
@@ -380,7 +380,7 @@ describe("e2e tests for infra command", () => {
         [
           "infra",
           "up",
-          "--modules=eth-ens-ipfs",
+          "--modules eth-ens-ipfs",
           "--verbose"
         ],
         getTestCaseDir(3),
@@ -430,7 +430,7 @@ describe("e2e tests for infra command", () => {
         [
           "infra",
           "up",
-          "--modules=ganache,dev-server"
+          "--modules ganache,dev-server"
         ],
         getTestCaseDir(1),
       );
@@ -441,7 +441,7 @@ describe("e2e tests for infra command", () => {
       ]);
 
       await runPolywrapCli(
-        ["infra", "down", "--modules=ganache,dev-server"],
+        ["infra", "down", "--modules ganache,dev-server"],
         getTestCaseDir(1),
       );
     });
@@ -451,7 +451,7 @@ describe("e2e tests for infra command", () => {
         [
           "infra",
           "up",
-          "--modules=ipfs,ipfs-duplicate"
+          "--modules ipfs,ipfs-duplicate"
         ],
         getTestCaseDir(1),
       );
@@ -461,7 +461,7 @@ describe("e2e tests for infra command", () => {
       ]);
 
       await runPolywrapCli(
-        ["infra", "down", "--modules=ipfs,ipfs-duplicate"],
+        ["infra", "down", "--modules ipfs,ipfs-duplicate"],
         getTestCaseDir(1),
       );
     });

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

@@ -51,7 +51,7 @@ Arguments:
                               \"infra\", \"workflow\", default: \"project\")
 
 Options:
-  -r, --raw                   Output raw JSON Schema (default: false)
+  -r, --raw                   Output raw JSON Schema
   -m, --manifest-file <path>  Path to the manifest file (default: polywrap.yaml
                               | polywrap.yml)
   -v, --verbose               Verbose output (default: false)

packages/cli/src/__tests__/e2e/no-command.spec.ts

@@ -13,10 +13,10 @@ Commands:
   codegen|g [options]          Generate Code For Polywrap Projects
   create|c                     Create New Projects
   deploy|d [options]           Deploys Polywrap Projects
-  infra|i [options] <action>   Modular Infrastructure-As-Code Orchestrator
-  test|t [options]             Execute Tests
   docgen|o [options] <action>  Generate wrapper documentation
+  infra|i [options] <action>   Modular Infrastructure-As-Code Orchestrator
   manifest|m                   Inspect & Migrade Polywrap Manifests
+  test|t [options]             Execute Tests
   help [command]               display help for command
 `;