chore: Aqua API example (#659)

api/aqua-api-example/index.js

@@ -0,0 +1,32 @@
+import {
+    Aqua,
+    Call,
+    Path,
+} from "@fluencelabs/aqua-api/aqua-api.js";
+
+const aquaPath = new Path("test.aqua")
+// write function that we want to call and arguments
+const args = {num: 42}
+const call = new Call("getNumber(num)", args, aquaPath)
+
+// compile call
+const compilationResult = await Aqua.compile(call, [])
+
+
+/*
+// Compilation result definition
+export class CompilationResult {
+    // List of service definitions to register in Fluence JS Client
+    services: Record<string, ServiceDef>
+    // List of function definitions to call in Fluence JS Client
+    functions: Record<string, AquaFunction>
+    // Definition of wrapped function to call in Fluence JS Client
+    functionCall?: AquaFunction
+    // List of errors. All other fields will be empty if `errors` not empty
+    errors: string[]
+}
+ */
+
+// get function definition, that describes types of arguments and results of a function
+// and AIR script
+const {funcDef, script} = compilationResult.functionCall

api/aqua-api-example/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "aqua-api-example",
+  "version": "1.0.0",
+  "description": "",
+  "main": "index.js",
+  "scripts": {
+    "call": "node index.js"
+  },
+  "author": "Fluence Labs",
+  "type": "module",
+  "license": "Apache-2.0",
+  "dependencies": {
+    "@fluencelabs/aqua-api": "0.9.4"
+  }
+}

api/aqua-api-example/readme.md

@@ -0,0 +1,4 @@
+## Aqua API Example
+
+An example of how to use Aqua API with Fluence Client.
+Documentation and description [here](https://fluence.dev/docs/aqua-book/aqua-js-api).

api/aqua-api-example/test.aqua

@@ -0,0 +1,2 @@
+func getNumber(number: u32) -> u32:
+    <- number

api/aqua-api-npm/readme.md

@@ -0,0 +1,3 @@
+# Aqua API
+
+[Documentation](https://fluence.dev/docs/aqua-book/aqua-js-api)

api/aqua-api/src/main/scala/aqua/api/AquaAPI.scala

@@ -99,7 +99,7 @@ object AquaAPI extends App with Logging {
 
       new FuncCompiler[IO](
         Some(RelativePath(Path(pathStr))),
-        imports.toList.map(Path.apply),
+        imports.map(Path.apply),
         transformConfig
       ).compile()
         .map { contextV =>