From 6e29506e8b43c5ea1efd9c200a5613a5d052c125 Mon Sep 17 00:00:00 2001
From: Kenny Parnell <kenny@heroku.com>
Date: Mon, 21 Oct 2024 14:15:58 -0400
Subject: [PATCH] Add example of middleware usage.

---
 dynoid/README.md                  | 33 +++++++++++++++++++++++++++++++
 dynoid/middleware/example_test.go | 22 +++++++++++++++++++++
 2 files changed, 55 insertions(+)
 create mode 100644 dynoid/middleware/example_test.go

diff --git a/dynoid/README.md b/dynoid/README.md
index a990b05..245e84e 100644
--- a/dynoid/README.md
+++ b/dynoid/README.md
@@ -778,6 +778,39 @@ func GenerateToken(audience string) (context.Context, string)
 import "github.com/heroku/x/dynoid/middleware"
 ```
 
+<details><summary>Example</summary>
+<p>
+
+
+
+```go
+package main
+
+import (
+	"io"
+	"log"
+	"net/http"
+
+	"github.com/heroku/x/dynoid/middleware"
+)
+
+const AUDIENCE = "testing"
+
+func main() {
+	authorized := middleware.AuthorizeSameSpace(AUDIENCE)
+	secureHandler := authorized(http.HandlerFunc(func(w http.ResponseWriter, _ *http.Request) {
+		io.WriteString(w, "Hello from a secure endpoint!\n")
+	}))
+
+	http.Handle("/secure", secureHandler)
+
+	log.Fatal(http.ListenAndServe(":8080", nil))
+}
+```
+
+</p>
+</details>
+
 ## Index
 
 - [Variables](<#variables>)
diff --git a/dynoid/middleware/example_test.go b/dynoid/middleware/example_test.go
new file mode 100644
index 0000000..dd37e3a
--- /dev/null
+++ b/dynoid/middleware/example_test.go
@@ -0,0 +1,22 @@
+package middleware_test
+
+import (
+	"io"
+	"log"
+	"net/http"
+
+	"github.com/heroku/x/dynoid/middleware"
+)
+
+const AUDIENCE = "testing"
+
+func Example() {
+	authorized := middleware.AuthorizeSameSpace(AUDIENCE)
+	secureHandler := authorized(http.HandlerFunc(func(w http.ResponseWriter, _ *http.Request) {
+		io.WriteString(w, "Hello from a secure endpoint!\n")
+	}))
+
+	http.Handle("/secure", secureHandler)
+
+	log.Fatal(http.ListenAndServe(":8080", nil))
+}