You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@streampipes.apache.org by oe...@apache.org on 2026/03/27 16:22:18 UTC

(streampipes) branch 4314-add-streampipesclient-to-javascript-transformation-context updated (870fc92669 -> 35bd6d6317)

This is an automated email from the ASF dual-hosted git repository.

oehler pushed a change to branch 4314-add-streampipesclient-to-javascript-transformation-context
in repository https://gitbox.apache.org/repos/asf/streampipes.git


    from 870fc92669 fix: stabilize asset filter test and update value rules expectation (#4313)
     new d50404eb82 Add client to adapter transformation context
     new 35bd6d6317 Add tests

The 2 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails.  The revisions
listed as "add" were already present in the repository and have only
been added to this reference.


Summary of changes:
 streampipes-connect-management/pom.xml             |  10 ++
 .../management/management/GuessManagement.java     |  20 ++-
 .../ScriptTransformationPipelineElement.java       |  11 +-
 streampipes-connect-transformer-js/pom.xml         |  11 ++
 .../transformer/js/StreamPipesScriptContext.java   |  26 ++--
 .../transformer/js/GraalJsScriptEngineTest.java    | 151 +++++++++++++++++++++
 streampipes-extensions-management/pom.xml          |  10 ++
 .../connect/adapter/AdapterPipelineGenerator.java  |   9 +-
 .../connect/adapter/ScriptContextResolver.java     |  55 ++++++++
 .../adapter/model/pipeline/AdapterPipeline.java    |  10 +-
 .../rest/impl/connect/GuessResource.java           |   2 +-
 11 files changed, 298 insertions(+), 17 deletions(-)
 copy streampipes-extensions-api/src/main/java/org/apache/streampipes/extensions/api/pe/context/RuntimeContext.java => streampipes-connect-transformer-js/src/main/java/org/apache/streampipes/connect/transformer/js/StreamPipesScriptContext.java (59%)
 create mode 100644 streampipes-extensions-management/src/main/java/org/apache/streampipes/extensions/management/connect/adapter/ScriptContextResolver.java


(streampipes) 01/02: Add client to adapter transformation context

Posted by oe...@apache.org.
This is an automated email from the ASF dual-hosted git repository.

oehler pushed a commit to branch 4314-add-streampipesclient-to-javascript-transformation-context
in repository https://gitbox.apache.org/repos/asf/streampipes.git

commit d50404eb82bc6f913c0f0d348c2df08c139d376c
Author: Sven Oehler <oe...@web.de>
AuthorDate: Fri Mar 27 17:21:44 2026 +0100

    Add client to adapter transformation context
---
 streampipes-connect-management/pom.xml             | 10 ++++
 .../management/management/GuessManagement.java     | 20 +++++++-
 .../ScriptTransformationPipelineElement.java       | 11 ++++-
 streampipes-connect-transformer-js/pom.xml         | 11 +++++
 .../transformer/js/StreamPipesScriptContext.java   | 41 ++++++++++++++++
 streampipes-extensions-management/pom.xml          | 10 ++++
 .../connect/adapter/AdapterPipelineGenerator.java  |  9 +++-
 .../connect/adapter/ScriptContextResolver.java     | 55 ++++++++++++++++++++++
 .../adapter/model/pipeline/AdapterPipeline.java    | 10 ++--
 .../rest/impl/connect/GuessResource.java           |  2 +-
 10 files changed, 172 insertions(+), 7 deletions(-)

diff --git a/streampipes-connect-management/pom.xml b/streampipes-connect-management/pom.xml
index 5a052bcd1f..b317a59c91 100644
--- a/streampipes-connect-management/pom.xml
+++ b/streampipes-connect-management/pom.xml
@@ -60,6 +60,16 @@
             <artifactId>streampipes-connect-transformer-api</artifactId>
             <version>0.99.0-SNAPSHOT</version>
         </dependency>
+        <dependency>
+            <groupId>org.apache.streampipes</groupId>
+            <artifactId>streampipes-connect-transformer-js</artifactId>
+            <version>0.99.0-SNAPSHOT</version>
+        </dependency>
+        <dependency>
+            <groupId>org.apache.streampipes</groupId>
+            <artifactId>streampipes-extensions-management</artifactId>
+            <version>0.99.0-SNAPSHOT</version>
+        </dependency>
 
         <!-- Test dependencies -->
         <dependency>
diff --git a/streampipes-connect-management/src/main/java/org/apache/streampipes/connect/management/management/GuessManagement.java b/streampipes-connect-management/src/main/java/org/apache/streampipes/connect/management/management/GuessManagement.java
index f550c1ce60..5019067cc9 100644
--- a/streampipes-connect-management/src/main/java/org/apache/streampipes/connect/management/management/GuessManagement.java
+++ b/streampipes-connect-management/src/main/java/org/apache/streampipes/connect/management/management/GuessManagement.java
@@ -22,10 +22,13 @@ import org.apache.streampipes.commons.exceptions.NoServiceEndpointsAvailableExce
 import org.apache.streampipes.commons.exceptions.connect.AdapterException;
 import org.apache.streampipes.connect.management.AdapterEventPreviewPipeline;
 import org.apache.streampipes.connect.management.util.EventSchemaUtils;
+import org.apache.streampipes.connect.transformer.api.Context;
 import org.apache.streampipes.connect.transformer.api.TransformationEngines;
 import org.apache.streampipes.connect.transformer.api.exception.ScriptCompilationException;
 import org.apache.streampipes.connect.transformer.api.exception.ScriptExecutionException;
+import org.apache.streampipes.connect.transformer.js.StreamPipesScriptContext;
 import org.apache.streampipes.extensions.api.connect.exception.WorkerAdapterException;
+import org.apache.streampipes.extensions.management.client.StreamPipesClientResolver;
 import org.apache.streampipes.manager.api.extensions.ExtensionServiceRequestManager;
 import org.apache.streampipes.manager.api.extensions.ExtensionServiceRequestTarget;
 import org.apache.streampipes.manager.api.extensions.ExtensionServiceRequestTargets;
@@ -100,6 +103,10 @@ public class GuessManagement {
   }
 
   public AdapterDescription transformSampleData(AdapterDescription adapterDescription) throws AdapterException {
+    return transformSampleData(adapterDescription, null);
+  }
+
+  public AdapterDescription transformSampleData(AdapterDescription adapterDescription, String userId) throws AdapterException {
     if (adapterDescription.getTransformationConfig()
                           .getScript() == null || adapterDescription.getTransformationConfig()
                                                                     .getLanguage() == null) {
@@ -112,12 +119,13 @@ public class GuessManagement {
         var transformationScript = adapterDescription.getTransformationConfig();
         var engine = TransformationEngines.INSTANCE.getTransformationEngine(transformationScript.getLanguage());
         var compiledScript = engine.compile(transformationScript.getScript());
+        var scriptContext = makeScriptContext(userId);
 
         var samples = adapterDescription.getTransformationConfig()
                                         .getInputs();
         if (!samples.isEmpty()) {
           List<Map<String, Object>> results = new ArrayList<>();
-          compiledScript.transform(samples.get(0), results::add, null);
+          compiledScript.transform(samples.get(0), results::add, scriptContext);
 
           adapterDescription.getTransformationConfig()
                             .setOutputs(results);
@@ -133,6 +141,16 @@ public class GuessManagement {
     return adapterDescription;
   }
 
+  private Context makeScriptContext(String userId) {
+    if (userId == null || userId.isBlank()) {
+      return null;
+    }
+
+    return new StreamPipesScriptContext(
+        new StreamPipesClientResolver().makeStreamPipesClientInstance().onBehalfOf(userId)
+    );
+  }
+
   private ExtensionServiceRequestTarget getWorkerRequestTarget(
       AdapterDescription adapterDescription
   ) throws NoServiceEndpointsAvailableException {
diff --git a/streampipes-connect-shared/src/main/java/org/apache/streampipes/connect/shared/preprocessing/elements/ScriptTransformationPipelineElement.java b/streampipes-connect-shared/src/main/java/org/apache/streampipes/connect/shared/preprocessing/elements/ScriptTransformationPipelineElement.java
index 3024d38019..b2c6e2e94d 100644
--- a/streampipes-connect-shared/src/main/java/org/apache/streampipes/connect/shared/preprocessing/elements/ScriptTransformationPipelineElement.java
+++ b/streampipes-connect-shared/src/main/java/org/apache/streampipes/connect/shared/preprocessing/elements/ScriptTransformationPipelineElement.java
@@ -18,6 +18,7 @@
 
 package org.apache.streampipes.connect.shared.preprocessing.elements;
 
+import org.apache.streampipes.connect.transformer.api.Context;
 import org.apache.streampipes.connect.transformer.api.ScriptTransformer;
 import org.apache.streampipes.connect.transformer.api.TransformationEngines;
 import org.apache.streampipes.connect.transformer.api.exception.ScriptCompilationException;
@@ -29,9 +30,17 @@ import java.util.Map;
 
 public class ScriptTransformationPipelineElement {
   ScriptTransformer scriptTransformer;
+  private final Context scriptContext;
 
   public ScriptTransformationPipelineElement(String language, String transformationScript) {
+    this(language, transformationScript, null);
+  }
+
+  public ScriptTransformationPipelineElement(String language,
+                                             String transformationScript,
+                                             Context scriptContext) {
     var engine = TransformationEngines.INSTANCE.getTransformationEngine(language);
+    this.scriptContext = scriptContext;
     try {
       scriptTransformer = engine.compile(transformationScript);
     } catch (ScriptCompilationException e) {
@@ -42,7 +51,7 @@ public class ScriptTransformationPipelineElement {
   public List<Map<String, Object>> process(Map<String, Object> event) {
     try {
       List<Map<String, Object>> out = new ArrayList<>();
-      scriptTransformer.transform(event, out::add, null);
+      scriptTransformer.transform(event, out::add, scriptContext);
       return out;
     } catch (ScriptExecutionException e) {
       throw new RuntimeException(e);
diff --git a/streampipes-connect-transformer-js/pom.xml b/streampipes-connect-transformer-js/pom.xml
index c8b07d1ca4..74404b5c0e 100644
--- a/streampipes-connect-transformer-js/pom.xml
+++ b/streampipes-connect-transformer-js/pom.xml
@@ -39,6 +39,17 @@
             <artifactId>streampipes-connect-transformer-api</artifactId>
             <version>0.99.0-SNAPSHOT</version>
         </dependency>
+        <dependency>
+            <groupId>org.apache.streampipes</groupId>
+            <artifactId>streampipes-client-api</artifactId>
+            <version>0.99.0-SNAPSHOT</version>
+        </dependency>
+        <dependency>
+            <groupId>org.apache.streampipes</groupId>
+            <artifactId>streampipes-client</artifactId>
+            <version>0.99.0-SNAPSHOT</version>
+            <scope>test</scope>
+        </dependency>
         <dependency>
             <groupId>org.graalvm.polyglot</groupId>
             <artifactId>js</artifactId>
diff --git a/streampipes-connect-transformer-js/src/main/java/org/apache/streampipes/connect/transformer/js/StreamPipesScriptContext.java b/streampipes-connect-transformer-js/src/main/java/org/apache/streampipes/connect/transformer/js/StreamPipesScriptContext.java
new file mode 100644
index 0000000000..be4e2375f5
--- /dev/null
+++ b/streampipes-connect-transformer-js/src/main/java/org/apache/streampipes/connect/transformer/js/StreamPipesScriptContext.java
@@ -0,0 +1,41 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ */
+
+package org.apache.streampipes.connect.transformer.js;
+
+import org.apache.streampipes.client.api.IStreamPipesClient;
+import org.apache.streampipes.connect.transformer.api.Context;
+import org.apache.streampipes.model.shared.annotation.ExposedToScripts;
+
+public class StreamPipesScriptContext implements Context {
+
+  private final Object scriptClient;
+
+  public StreamPipesScriptContext(IStreamPipesClient rawClient) {
+    this.scriptClient = ScriptHostObjectAdapter.wrap(rawClient);
+  }
+
+  public StreamPipesScriptContext(Object scriptClient) {
+    this.scriptClient = scriptClient;
+  }
+
+  @ExposedToScripts
+  public Object client() {
+    return scriptClient;
+  }
+}
diff --git a/streampipes-extensions-management/pom.xml b/streampipes-extensions-management/pom.xml
index 41f4a4f6af..e6fbf825d6 100644
--- a/streampipes-extensions-management/pom.xml
+++ b/streampipes-extensions-management/pom.xml
@@ -43,6 +43,16 @@
             <artifactId>streampipes-connect-shared</artifactId>
             <version>0.99.0-SNAPSHOT</version>
         </dependency>
+        <dependency>
+            <groupId>org.apache.streampipes</groupId>
+            <artifactId>streampipes-connect-transformer-js</artifactId>
+            <version>0.99.0-SNAPSHOT</version>
+        </dependency>
+        <dependency>
+            <groupId>org.apache.streampipes</groupId>
+            <artifactId>streampipes-resource-management</artifactId>
+            <version>0.99.0-SNAPSHOT</version>
+        </dependency>
         <dependency>
             <groupId>org.apache.streampipes</groupId>
             <artifactId>streampipes-dataformat</artifactId>
diff --git a/streampipes-extensions-management/src/main/java/org/apache/streampipes/extensions/management/connect/adapter/AdapterPipelineGenerator.java b/streampipes-extensions-management/src/main/java/org/apache/streampipes/extensions/management/connect/adapter/AdapterPipelineGenerator.java
index 0309814a69..779b6db526 100644
--- a/streampipes-extensions-management/src/main/java/org/apache/streampipes/extensions/management/connect/adapter/AdapterPipelineGenerator.java
+++ b/streampipes-extensions-management/src/main/java/org/apache/streampipes/extensions/management/connect/adapter/AdapterPipelineGenerator.java
@@ -27,15 +27,22 @@ public class AdapterPipelineGenerator extends AdapterPipelineGeneratorBase {
 
   public AdapterPipeline generatePipeline(AdapterDescription adapterDescription) {
     var pipelineElements = makeAdapterPipelineElements(true, adapterDescription);
+    var scriptContext = new ScriptContextResolver().resolve(adapterDescription);
 
     if (hasValidGrounding(adapterDescription)) {
       return new AdapterPipeline(
           pipelineElements,
           adapterDescription.getTransformationConfig(),
           getAdapterSink(adapterDescription),
+          scriptContext,
           adapterDescription.getEventSchema());
     } else {
-      return new AdapterPipeline(pipelineElements, adapterDescription.getTransformationConfig(), adapterDescription.getEventSchema());
+      return new AdapterPipeline(
+          pipelineElements,
+          adapterDescription.getTransformationConfig(),
+          scriptContext,
+          adapterDescription.getEventSchema()
+      );
     }
   }
 
diff --git a/streampipes-extensions-management/src/main/java/org/apache/streampipes/extensions/management/connect/adapter/ScriptContextResolver.java b/streampipes-extensions-management/src/main/java/org/apache/streampipes/extensions/management/connect/adapter/ScriptContextResolver.java
new file mode 100644
index 0000000000..99caf82913
--- /dev/null
+++ b/streampipes-extensions-management/src/main/java/org/apache/streampipes/extensions/management/connect/adapter/ScriptContextResolver.java
@@ -0,0 +1,55 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ */
+
+package org.apache.streampipes.extensions.management.connect.adapter;
+
+import org.apache.streampipes.connect.transformer.api.Context;
+import org.apache.streampipes.connect.transformer.js.StreamPipesScriptContext;
+import org.apache.streampipes.extensions.management.client.StreamPipesClientResolver;
+import org.apache.streampipes.model.connect.adapter.AdapterDescription;
+import org.apache.streampipes.resource.management.PermissionResourceManager;
+
+public class ScriptContextResolver {
+
+  public Context resolve(AdapterDescription adapterDescription) {
+    if (!adapterDescription.getTransformationConfig().isScriptActive()) {
+      return null;
+    }
+
+    if (adapterDescription.getCorrespondingDataStreamElementId() == null
+        || adapterDescription.getCorrespondingDataStreamElementId().isBlank()) {
+      return null;
+    }
+
+    var permissions = new PermissionResourceManager()
+        .findForObjectId(adapterDescription.getCorrespondingDataStreamElementId());
+
+    if (permissions.isEmpty()) {
+      return null;
+    }
+
+    var userId = permissions.get(0).getOwnerSid();
+    if (userId == null || userId.isBlank()) {
+      return null;
+    }
+
+    return new StreamPipesScriptContext(
+            new StreamPipesClientResolver().makeStreamPipesClientInstance().onBehalfOf(userId)
+    );
+  }
+}
diff --git a/streampipes-extensions-management/src/main/java/org/apache/streampipes/extensions/management/connect/adapter/model/pipeline/AdapterPipeline.java b/streampipes-extensions-management/src/main/java/org/apache/streampipes/extensions/management/connect/adapter/model/pipeline/AdapterPipeline.java
index 43ee703c26..4c924fd632 100644
--- a/streampipes-extensions-management/src/main/java/org/apache/streampipes/extensions/management/connect/adapter/model/pipeline/AdapterPipeline.java
+++ b/streampipes-extensions-management/src/main/java/org/apache/streampipes/extensions/management/connect/adapter/model/pipeline/AdapterPipeline.java
@@ -19,6 +19,7 @@
 package org.apache.streampipes.extensions.management.connect.adapter.model.pipeline;
 
 import org.apache.streampipes.connect.shared.preprocessing.elements.ScriptTransformationPipelineElement;
+import org.apache.streampipes.connect.transformer.api.Context;
 import org.apache.streampipes.extensions.api.connect.IAdapterPipeline;
 import org.apache.streampipes.extensions.api.connect.IAdapterPipelineElement;
 import org.apache.streampipes.model.connect.TransformationConfig;
@@ -38,13 +39,15 @@ public class AdapterPipeline implements IAdapterPipeline {
 
   public AdapterPipeline(List<IAdapterPipelineElement> pipelineElements,
                          TransformationConfig transformationConfig,
+                         Context scriptContext,
                          EventSchema resultingEventSchema) {
     this.pipelineElements = pipelineElements;
     this.resultingEventSchema = resultingEventSchema;
     if (transformationConfig.isScriptActive()) {
       var transformation = new ScriptTransformationPipelineElement(
-         transformationConfig.getLanguage(),
-          transformationConfig.getScript()
+          transformationConfig.getLanguage(),
+          transformationConfig.getScript(),
+          scriptContext
       );
       processingFn = transformation::process;
     } else {
@@ -55,8 +58,9 @@ public class AdapterPipeline implements IAdapterPipeline {
   public AdapterPipeline(List<IAdapterPipelineElement> pipelineElements,
                          TransformationConfig transformationConfig,
                          IAdapterPipelineElement pipelineSink,
+                         Context scriptContext,
                          EventSchema resultingEventSchema) {
-    this(pipelineElements, transformationConfig, resultingEventSchema);
+    this(pipelineElements, transformationConfig, scriptContext, resultingEventSchema);
     this.pipelineSink = pipelineSink;
   }
 
diff --git a/streampipes-rest/src/main/java/org/apache/streampipes/rest/impl/connect/GuessResource.java b/streampipes-rest/src/main/java/org/apache/streampipes/rest/impl/connect/GuessResource.java
index 1b57e21491..8dce2589a8 100644
--- a/streampipes-rest/src/main/java/org/apache/streampipes/rest/impl/connect/GuessResource.java
+++ b/streampipes-rest/src/main/java/org/apache/streampipes/rest/impl/connect/GuessResource.java
@@ -74,7 +74,7 @@ public class GuessResource extends AbstractAdapterResource<GuessManagement> {
   public ResponseEntity<AdapterDescription> transformSample(@RequestBody AdapterDescription adapterDescription) throws
                                                                                                                 AdapterException {
 
-    var sampleData = managementService.transformSampleData(adapterDescription);
+    var sampleData = managementService.transformSampleData(adapterDescription, getAuthenticatedUserSid());
 
     return ok(sampleData);
   }


(streampipes) 02/02: Add tests

Posted by oe...@apache.org.
This is an automated email from the ASF dual-hosted git repository.

oehler pushed a commit to branch 4314-add-streampipesclient-to-javascript-transformation-context
in repository https://gitbox.apache.org/repos/asf/streampipes.git

commit 35bd6d6317b91923bd1589f4ffedb3fa5bef79e2
Author: Sven Oehler <oe...@web.de>
AuthorDate: Fri Mar 27 17:22:03 2026 +0100

    Add tests
---
 .../transformer/js/GraalJsScriptEngineTest.java    | 151 +++++++++++++++++++++
 1 file changed, 151 insertions(+)

diff --git a/streampipes-connect-transformer-js/src/test/java/org/apache/streampipes/connect/transformer/js/GraalJsScriptEngineTest.java b/streampipes-connect-transformer-js/src/test/java/org/apache/streampipes/connect/transformer/js/GraalJsScriptEngineTest.java
index f308422095..04918cd5f5 100644
--- a/streampipes-connect-transformer-js/src/test/java/org/apache/streampipes/connect/transformer/js/GraalJsScriptEngineTest.java
+++ b/streampipes-connect-transformer-js/src/test/java/org/apache/streampipes/connect/transformer/js/GraalJsScriptEngineTest.java
@@ -18,9 +18,14 @@
 
 package org.apache.streampipes.connect.transformer.js;
 
+import org.apache.streampipes.client.StreamPipesClient;
+import org.apache.streampipes.client.api.credentials.CredentialsProvider;
+import org.apache.streampipes.connect.transformer.api.Context;
 import org.apache.streampipes.connect.transformer.api.exception.ScriptCompilationException;
 import org.apache.streampipes.connect.transformer.api.exception.ScriptExecutionException;
 
+import org.graalvm.polyglot.proxy.ProxyExecutable;
+import org.graalvm.polyglot.proxy.ProxyObject;
 import org.junit.jupiter.api.Test;
 
 import java.util.ArrayList;
@@ -136,4 +141,150 @@ public class GraalJsScriptEngineTest {
     assertEquals("Graal JS script execution failed", exception.getMessage());
     assertInstanceOf(Exception.class, exception.getCause());
   }
+
+  @Test
+  void executeClientThroughContext() throws ScriptCompilationException, ScriptExecutionException {
+    var transformer = engine.compile("""
+        function transform(event, out, ctx) {
+          out.collect({
+            hasClient: ctx.client() !== null
+          });
+        }
+        """);
+
+    var output = new ArrayList<Map<String, Object>>();
+    transformer.transform(
+        Map.of("value", 1),
+        output::add,
+        new StreamPipesScriptContext(offlineClient())
+    );
+
+    assertEquals(1, output.size());
+    assertEquals(true, output.get(0).get("hasClient"));
+  }
+
+  @Test
+  void executeCanReadClientResultsInsideVm() throws Exception {
+    var transformer = engine.compile("""
+        function transform(event, out, ctx) {
+          const adapters = ctx.client().adapters().all();
+          out.collect({
+            adapterId: adapters[0].elementId,
+            adapterName: adapters[0].name
+          });
+        }
+        """);
+
+    var output = executeSingleEvent(
+        transformer,
+        Map.of("input", "value"),
+        scriptContext(scriptClientWithAdapters("adapter-js", "JavaScript Adapter"))
+    );
+
+    assertEquals("adapter-js", output.get("adapterId"));
+    assertEquals("JavaScript Adapter", output.get("adapterName"));
+  }
+
+  @Test
+  void executeCanSendGuestObjectToClient() throws Exception {
+    var createdAdapters = new ArrayList<Map<String, Object>>();
+    var transformer = engine.compile("""
+        function transform(event, out, ctx) {
+          ctx.client().adapters().create({
+            elementId: "created-js",
+            name: "Created From JS",
+            running: false
+          });
+          out.collect({created: "created-js"});
+        }
+        """);
+
+    var output = executeSingleEvent(
+        transformer,
+        Map.of("input", "value"),
+        scriptContext(scriptClientWithCreateRecorder(createdAdapters))
+    );
+
+    assertEquals("created-js", output.get("created"));
+    assertEquals(1, createdAdapters.size());
+    assertEquals("created-js", createdAdapters.get(0).get("elementId"));
+    assertEquals("Created From JS", createdAdapters.get(0).get("name"));
+    assertEquals(false, createdAdapters.get(0).get("running"));
+  }
+
+  @Test
+  void executeExposesProxyClientMethodsThroughContext() throws ScriptCompilationException, ScriptExecutionException {
+    var transformer = engine.compile("""
+        function transform(event, out, ctx) {
+          out.collect({
+            ping: ctx.client().ping()
+          });
+        }
+        """);
+
+    var output = new ArrayList<Map<String, Object>>();
+    transformer.transform(
+        Map.of("value", 1),
+        output::add,
+        scriptContext(scriptClientWithPing())
+    );
+
+    assertEquals(1, output.size());
+    assertEquals("pong", output.get(0).get("ping"));
+  }
+
+  private static Map<String, Object> executeSingleEvent(org.apache.streampipes.connect.transformer.api.ScriptTransformer transformer,
+                                                        Map<String, Object> input,
+                                                        Context context)
+      throws ScriptExecutionException {
+    var output = new ArrayList<Map<String, Object>>();
+    transformer.transform(new LinkedHashMap<>(input), output::add, context);
+    return output.get(0);
+  }
+
+  private static StreamPipesScriptContext scriptContext(Object scriptClient) {
+    return new StreamPipesScriptContext(scriptClient);
+  }
+
+  private static Object scriptClientWithPing() {
+    return ProxyObject.fromMap(Map.of(
+        "ping", (ProxyExecutable) args -> "pong"
+    ));
+  }
+
+  private static Object scriptClientWithAdapters(String elementId, String name) {
+    Object adaptersApi = ProxyObject.fromMap(Map.of(
+        "all", (ProxyExecutable) args -> List.of(Map.of(
+            "elementId", elementId,
+            "name", name
+        ))
+    ));
+    return ProxyObject.fromMap(Map.of(
+        "adapters", (ProxyExecutable) args -> adaptersApi
+    ));
+  }
+
+  private static Object scriptClientWithCreateRecorder(List<Map<String, Object>> createdAdapters) {
+    Object adaptersApi = ProxyObject.fromMap(Map.of(
+        "create", (ProxyExecutable) args -> {
+          try {
+            createdAdapters.add(new LinkedHashMap<>(PolyglotTypeConverter.toEventMap(args[0])));
+          } catch (ScriptExecutionException e) {
+            throw new IllegalStateException("Failed to capture adapter payload", e);
+          }
+          return null;
+        }
+    ));
+    return ProxyObject.fromMap(Map.of(
+        "adapters", (ProxyExecutable) args -> adaptersApi
+    ));
+  }
+
+  private static CredentialsProvider emptyCredentials() {
+    return List::of;
+  }
+
+  private static StreamPipesClient offlineClient() {
+    return StreamPipesClient.create("localhost", 1, emptyCredentials(), true);
+  }
 }