Update go docs and examples

Author: tjholm

src/pages/apis.mdx

@@ -43,7 +43,7 @@ package main
 import (
 	"fmt"
 
-	"github.com/nitrictech/go-sdk/handler"
+	"github.com/nitrictech/go-sdk/nitric/apis"
 	"github.com/nitrictech/go-sdk/nitric"
 )
 
@@ -54,17 +54,13 @@ func main() {
 		return
 	}
 
-	galaxyApi.Get("/moon", func(ctx *handler.HttpContext, next handler.HttpHandler) (*handler.HttpContext, error) {
+	galaxyApi.Get("/moon", func(ctx *apis.Ctx) {
 		ctx.Response.Body = []byte("that's no moon, it's a space station.")
-
-		return next(ctx)
 	})
 
 	if err := nitric.Run(); err != nil {
 		fmt.Println(err)
 	}
-
-	fmt.Println("Service has started")
 }
 ```
 
@@ -128,7 +124,7 @@ package main
 import (
 	"fmt"
 
-	"github.com/nitrictech/go-sdk/handler"
+	"github.com/nitrictech/go-sdk/nitric/apis"
 	"github.com/nitrictech/go-sdk/nitric"
 	"github.com/your-org/your-repo/planets"
 )
@@ -140,25 +136,19 @@ func main() {
 		return
 	}
 
-	galaxyApi.Get("/planets", func(ctx *handler.HttpContext, next handler.HttpHandler) (*handler.HttpContext, error) {
+	galaxyApi.Get("/planets", func(ctx *apis.Ctx) {
 		ctx.Response.Headers = map[string][]string{"Content-Type": {"application/json"}}
 		ctx.Response.Body = []byte(GetPlanetList())
-
-		return next(ctx)
 	})
 
-	galaxyApi.Post("/planets", func(ctx *handler.HttpContext, next handler.HttpHandler) (*handler.HttpContext, error) {
+	galaxyApi.Post("/planets", func(ctx *apis.Ctx) {
 		CreatePlanet(ctx.Request.Data())
 		ctx.Response.Status = 201
-
-		return next(ctx)
 	})
 
 	if err := nitric.Run(); err != nil {
 		fmt.Println(err)
 	}
-
-	fmt.Println("Service has started")
 }
 
 ```
@@ -222,7 +212,7 @@ package main
 import (
 	"fmt"
 
-	"github.com/nitrictech/go-sdk/handler"
+	"github.com/nitrictech/go-sdk/nitric/apis"
 	"github.com/nitrictech/go-sdk/nitric"
 	"github.com/your-org/your-repo/planets"
 )
@@ -235,19 +225,15 @@ func main() {
 	}
 
 	// create a dynamic route and extract the parameter `name`
-	galaxyApi.Get("/planets/:name", func(ctx *handler.HttpContext, next handler.HttpHandler) (*handler.HttpContext, error) {
+	galaxyApi.Get("/planets/:name", func(ctx *apis.Ctx) {
 		name := ctx.Request.PathParams()["name"]
 
 		ctx.Response.Body = []byte(GetPlanet(name))
-
-		return next(ctx)
 	})
 
 	if err := nitric.Run(); err != nil {
 		fmt.Println(err)
 	}
-
-	fmt.Println("Service has started")
 }
 ```
 
@@ -290,11 +276,9 @@ async def find_alderaan(ctx):
 
 ```go
 // return a redirect response using status 301
-galaxyApi.Get("/planets/alderaan", func(ctx *handler.HttpContext, next handler.HttpHandler) (*handler.HttpContext, error) {
+galaxyApi.Get("/planets/alderaan", func(ctx *apis.Ctx) {
   ctx.Response.Status = 301
   ctx.Response.Location = "https://example.org/debris/alderaan"
-
-  return next(ctx)
 })
 ```
 
@@ -552,15 +536,13 @@ async def get_planet(ctx):
 
 ```go
 // override top level security to remove security from this route
-secureApi.Get("/planets/unsecured-planet", func(ctx *handler.HttpContext, next handler.HttpHandler) (*handler.HttpContext, error) {
+secureApi.Get("/planets/unsecured-planet", func(ctx *apis.Ctx) {
 	// Handle request
-	return next(ctx)
 }, nitric.WithNoMethodSecurity())
 
 // override top level security to require user.write scope to access
-secureApi.Get("/planets/unsecured-planet", func(ctx *handler.HttpContext, next handler.HttpHandler) (*handler.HttpContext, error) {
+secureApi.Get("/planets/unsecured-planet", func(ctx *apis.Ctx) {
 	// Handle request
-	return next(ctx)
 }, nitric.WithSecurity(customRule([]string{"users:write"})))
 ```
 
@@ -607,7 +589,7 @@ async def validate(ctx, nxt: HttpMiddleware):
 ```
 
 ```go
-func validate(ctx *handler.HttpContext, next handler.HttpHandler) (*handler.HttpContext, error) {
+func validate(ctx *apis.Ctx, next nitric.Handler[apis.Ctx]) (*handler.HttpContext, error) {
 	if ctx.Request.Headers()["content-type"] != nil {
 		ctx.Response.Status = 400
 		ctx.Response.Body = []byte("header Content-Type is required")
@@ -654,11 +636,11 @@ Nitric.run()
 import (
 	"fmt"
 
-	"github.com/nitrictech/go-sdk/handler"
+	"github.com/nitrictech/go-sdk/nitric/apis"
 	"github.com/nitrictech/go-sdk/nitric"
 )
 
-func validate(ctx *handler.HttpContext, next handler.HttpHandler) (*handler.HttpContext, error) {
+func validate(ctx *apis.Ctx, next nitric.Handler[apis.Ctx]) (*apis.Ctx, error) {
 	if ctx.Request.Headers()["content-type"] != nil {
 		ctx.Response.Status = 400
 		ctx.Response.Body = []byte("header Content-Type is required")
@@ -719,11 +701,11 @@ Route level middleware currently not supported in python
 import (
 	"fmt"
 
-	"github.com/nitrictech/go-sdk/handler"
+	"github.com/nitrictech/go-sdk/nitric/apis"
 	"github.com/nitrictech/go-sdk/nitric"
 )
 
-func validate(ctx *handler.HttpContext, next handler.HttpHandler) (*handler.HttpContext, error) {
+func validate(ctx *apis.Ctx, next nitric.Handler[apis.Ctx]) (*apis.Ctx, error) {
 	if ctx.Request.Headers()["content-type"] != nil {
 		ctx.Response.Status = 400
 		ctx.Response.Body = []byte("header Content-Type is required")
@@ -742,8 +724,8 @@ func main() {
 		return
 	}
 
-	customersApi.Get("/customers", handler.ComposeHttpMiddleware(validate, func(ctx *handler.HttpContext, next handler.HttpHandler) (*handler.HttpContext, error) {
-		return next(ctx)
+	customersApi.Get("/customers", nitric.Compose(validate, func(ctx *apis.Ctx) {
+		// handle request
 	}))
 
 	if err := nitric.Run(); err != nil {
@@ -917,7 +899,7 @@ package main
 import (
 	"fmt"
 
-	"github.com/nitrictech/go-sdk/handler"
+	"github.com/nitrictech/go-sdk/nitric/apis"
 	"github.com/nitrictech/go-sdk/nitric"
 )
 
@@ -928,9 +910,8 @@ func main() {
 		return
 	}
 
-	accountsApi.Get("/users/:id", func(ctx *handler.HttpContext, next handler.HttpHandler) (*handler.HttpContext, error) {
+	accountsApi.Get("/users/:id", func(ctx *apis.Ctx) {
 		// your logic here
-		return next(ctx)
 	})
 
 	if err := nitric.Run(); err != nil {
@@ -983,7 +964,7 @@ package main
 import (
 	"fmt"
 
-	"github.com/nitrictech/go-sdk/handler"
+	"github.com/nitrictech/go-sdk/nitric/apis"
 	"github.com/nitrictech/go-sdk/nitric"
 )
 
@@ -994,9 +975,8 @@ func main() {
 		return
 	}
 
-	accountsApi.Get("/orgs/:id", func(ctx *handler.HttpContext, next handler.HttpHandler) (*handler.HttpContext, error) {
+	accountsApi.Get("/orgs/:id", func(ctx *apis.Ctx) {
 		// your logic here
-		return next(ctx)
 	})
 
 	if err := nitric.Run(); err != nil {
@@ -1096,15 +1076,14 @@ package main
 import (
 	"fmt"
 
-	"github.com/nitrictech/go-sdk/handler"
+	"github.com/nitrictech/go-sdk/nitric/apis"
 	"github.com/nitrictech/go-sdk/nitric"
     "github.com/your-org/your-repo/resources"
 )
 
 func main() {
-	Resources.AccountsApi.Get("/users/:id", func(ctx *handler.HttpContext, next handler.HttpHandler) (*handler.HttpContext, error) {
+	Resources.AccountsApi.Get("/users/:id", func(ctx *apis.Ctx) {
 		// your logic here
-		return next(ctx)
 	})
 
 	if err := nitric.Run(); err != nil {
@@ -1152,15 +1131,14 @@ package main
 import (
 	"fmt"
 
-	"github.com/nitrictech/go-sdk/handler"
+	"github.com/nitrictech/go-sdk/nitric/apis"
 	"github.com/nitrictech/go-sdk/nitric"
     "github.com/your-org/your-repo/resources"
 )
 
 func main() {
-	Resources.AccountsApi.Get("/orgs/:id", func(ctx *handler.HttpContext, next handler.HttpHandler) (*handler.HttpContext, error) {
+	Resources.AccountsApi.Get("/orgs/:id", func(ctx *apis.Ctx) {
 		// your logic here
-		return next(ctx)
 	})
 
 	if err := nitric.Run(); err != nil {