Merge pull request #23 from itowlson/header-meddling

Alter response headers example

Author: itowlson

README.md

@@ -13,6 +13,7 @@
 - [A/B Testing using Cookies](./samples/ab-testing-cookie/)
 - [A/B Testing using Key-Value Store](./samples/ab-testing-kv/)
 - [A/B Testing using HTTP Headers (e.g User Agent)](./samples/ab-testing-user-agent/)
+- [Alter Response Headers](./samples/alter-headers/)
 - [Auto-Complete API](./samples/auto-complete/e/)
 - [Traffic Filtering: Block By IP address](./samples/block-by-ip/)
 - [Traffic Filtering: Block By user country](./samples/block-by-country/)

samples/alter-headers/.gitignore

@@ -0,0 +1,5 @@
+node_modules
+dist
+target
+.spin/
+build/

samples/alter-headers/.npmrc

@@ -0,0 +1 @@
+KNITWIT_SOURCE=./config/knitwit.json

samples/alter-headers/README.md

@@ -0,0 +1,31 @@
+# Altering response headers
+
+This sample shows how to alter the headers as you stream a response from an origin
+server back to a client.
+
+You can set the origin site via the `origin_host` variable, either by editing `spin.toml`
+or by overriding it on the command line:
+
+```
+SPIN_VARIABLE_ORIGIN_HOST=example.com spin up --build
+```
+
+(Note this should _not_ include the `https://` prefix - just the host name.)
+
+The path on the origin site is taken unchanged from the request.
+
+## Try it out
+
+The sample defaults to a "random facts" origin site. To try it out, `cd` into the
+`alter-headers` directory and run `spin up --build`.  Then you can `curl` the
+`/animals/json` route, and use the `-i` option to see the altered response headers:
+
+```
+$ curl -i localhost:3000/animals/json
+HTTP/1.1 200 OK
+content-length: 77
+date: the eleventy-sixth of June
+friendly-message: Hello from FWF
+
+{"timestamp":1740943712057,"fact":"Sharks lay the biggest eggs in the world"}
+```

samples/alter-headers/config/knitwit.json

@@ -0,0 +1,14 @@
+{
+  "version": 1,
+  "project": {
+    "worlds": [
+      "spin-http"
+    ]
+  },
+  "packages": {
+    "@fermyon/spin-sdk": {
+      "witPath": "../../bin/wit",
+      "world": "spin-imports"
+    }
+  }
+}