Tutorial: 10-Orchestration (#2677)

* feat(dispatcher): add production mode support for error handling and extend URI validation tests

- Introduced `productionRouter` in `DummyTestRouter` to enable production mode configuration.
- Updated `DispatchingInterceptor` to adjust error messages in production mode.
- Expanded `DispatchingInterceptorTest` with production-specific URI validation.

* feat(tutorials): add orchestration example combining multiple backend calls

- Introduced `10-Orchestration.yaml` to demonstrate creating an API that combines two backend calls.
- Added cross-platform `membrane.sh` and `membrane.cmd` scripts to locate and execute the Membrane runtime.

Author: predic8

distribution/tutorials/orchestration/10-Orchestration.yaml

@@ -0,0 +1,36 @@
+# yaml-language-server: $schema=https://www.membrane-api.io/v7.0.6.json
+#
+# Tutorial: Orchestration
+#
+# Shows how to create an API that combines two backend calls into one API.
+# 1) Fetch a book by id.
+# 2) Use the author key from the book payload to fetch the author.
+#
+# Try:
+#    curl localhost:2000/books/OL29474405M
+#    curl localhost:2000/books/OL26333978M
+
+api:
+  port: 2000
+  path:
+    uri: /books/{id}
+  flow:
+    - request:
+        - call:
+            url: https://openlibrary.org/books/${pathParam.id}.json
+        - setProperty:
+            name: title
+            value: ${$.title}
+            language: jsonpath
+        - call:
+            url: https://openlibrary.org${$.authors[0].key}.json
+            language: jsonpath
+        - template:
+            contentType: application/json
+            src: |
+              {
+                "title": "${property.title}",
+                "author": "${fn.jsonPath('$.name')}"
+              }
+    - return:
+        status: 200

distribution/tutorials/orchestration/membrane.cmd

@@ -0,0 +1,24 @@
+@echo off
+setlocal EnableExtensions
+
+set "SCRIPT_DIR=%~dp0"
+if "%SCRIPT_DIR:~-1%"=="\" set "SCRIPT_DIR=%SCRIPT_DIR:~0,-1%"
+
+set "dir=%SCRIPT_DIR%"
+
+:search_up
+if exist "%dir%\LICENSE.txt" if exist "%dir%\scripts\run-membrane.cmd" goto found
+for %%A in ("%dir%\..") do set "next=%%~fA"
+if /I "%next%"=="%dir%" goto notfound
+set "dir=%next%"
+goto search_up
+
+:found
+set "MEMBRANE_HOME=%dir%"
+set "MEMBRANE_CALLER_DIR=%SCRIPT_DIR%"
+call "%MEMBRANE_HOME%\scripts\run-membrane.cmd" %*
+exit /b %ERRORLEVEL%
+
+:notfound
+>&2 echo Could not locate Membrane root. Ensure directory structure is correct.
+exit /b 1

distribution/tutorials/orchestration/membrane.sh

@@ -0,0 +1,21 @@
+#!/bin/sh
+# Default: ./proxies.xml (next to this script); fallback -> $MEMBRANE_HOME/conf/proxies.xml
+# JAVA_OPTS: relative -D paths are auto-resolved against $MEMBRANE_HOME (absolute/URI unchanged).
+# Examples:
+#   export JAVA_OPTS='-Dlog4j.configurationFile=examples/logging/access/log4j2_access.xml'
+#   export JAVA_OPTS='-Dlog4j.configurationFile=/abs/path/log4j2.xml'
+
+SCRIPT_DIR=$(CDPATH= cd -- "$(dirname -- "$0")" && pwd -P)
+
+dir="$SCRIPT_DIR"
+while [ "$dir" != "/" ]; do
+  if [ -f "$dir/LICENSE.txt" ] && [ -f "$dir/scripts/run-membrane.sh" ]; then
+    export MEMBRANE_HOME="$dir"
+    export MEMBRANE_CALLER_DIR="$SCRIPT_DIR"
+    exec sh "$dir/scripts/run-membrane.sh" "$@"
+  fi
+  dir=$(dirname "$dir")
+done
+
+echo "Could not locate Membrane root. Ensure directory structure is correct." >&2
+exit 1