Update Go docs for v4

Signed-off-by: itowlson <ivan.towlson@fermyon.com>

Author: itowlson

content/v4/build.md

@@ -122,17 +122,15 @@ command = "componentize-py -w spin-http componentize app -o app.wasm"
 
 {{ blockEnd }}
 
-{{ startTab "TinyGo" }}
+{{ startTab "Go" }}
 
-For Go applications, you must use the TinyGo compiler, as the standard Go compiler does not yet support the WASI standard.  See the [TinyGo installation guide](https://tinygo.org/getting-started/install/).
-
-The build command calls TinyGo with the WASI backend and appropriate options:
+The build command calls `go tool` to run the `componentize-go` tool with appropriate options:
 
 <!-- @nocpy -->
 
 ```toml
 [component.hello.build]
-command = "tinygo build -target=wasip1 -gc=leaking -buildmode=c-shared -no-debug -o main.wasm ."
+command = "go tool componentize-go build"
 ```
 
 {{ blockEnd }}

content/v4/contributing-docs.md

@@ -216,7 +216,7 @@ test.sh
 - `macOS`
 - `Python`
 - `Rust`
-- `TinyGo`
+- `Go`
 - `TypeScript`
 - `v0.9.0`
 - `v0.10.0`

content/v4/go-components.md

@@ -14,26 +14,21 @@ url = "https://github.com/spinframework/spin-docs/blob/main/content/v4/go-compon
   - [Spawning Asynchronous Tasks](#spawning-asynchronous-tasks)
   - [Creating Futures and Streams](#creating-futures-and-streams)
 - [Storing Data in Redis From Go Components](#storing-data-in-redis-from-go-components)
-- [Using Go Packages in Spin Components](#using-go-packages-in-spin-components)
 - [Storing Data in the Spin Key-Value Store](#storing-data-in-the-spin-key-value-store)
 - [Storing Data in SQLite](#storing-data-in-sqlite)
 - [AI Inferencing From Go Components](#ai-inferencing-from-go-components)
 
 > This guide assumes you have Spin installed. If this is your first encounter with Spin, please see the [Quick Start](quickstart), which includes information about installing Spin with the Go templates, installing required tools, and creating Go applications.
 
-> This guide assumes you are familiar with the Go programming language, and that
-> you have
-> [configured the TinyGo toolchain locally](https://tinygo.org/getting-started/install/).
-Using TinyGo to compile components for Spin is currently required, as the
-[Go compiler doesn't currently have support for compiling to WASI](https://github.com/golang/go/issues/31105).
+> This guide assumes you are familiar with the Go programming language.
 
 > All examples from this page can be found in [the Spin Go SDK repository on GitHub](https://github.com/spinframework/spin-go-sdk/tree/main/examples).
 
-[**Want to go straight to the Spin SDK reference documentation?**  Find it here.](https://pkg.go.dev/github.com/spinframework/spin-go-sdk/v2)
+[**Want to go straight to the Spin SDK reference documentation?**  Find it here.](https://pkg.go.dev/github.com/spinframework/spin-go-sdk/v3)
 
 ## Versions
 
-TinyGo `0.35.0` is recommended, which requires Go `v1.22+`. Older versions of TinyGo may not support the command-line flags used when building Spin applications.
+You will need Go 1.25.5 or above.
 
 ## HTTP Components
 
@@ -152,7 +147,7 @@ import (
  "net/http"
  "os"
 
- spinhttp "github.com/spinframework/spin-go-sdk/v2/http"
+ spinhttp "github.com/spinframework/spin-go-sdk/v3/http"
 )
 
 func init() {
@@ -164,19 +159,19 @@ func init() {
 
   // `spin.toml` is not configured to allow outbound HTTP requests to this host,
   // so this request will fail.
-  if _, err := spinhttp.Get("https://fermyon.com"); err != nil {
+  if _, err := spinhttp.Get("https://forbidden.com"); err != nil {
    fmt.Fprintf(os.Stderr, "Cannot send HTTP request: %v", err)
   }
  })
 }
 ```
 
-The Outbound HTTP Request example above can be built using the `tingygo` toolchain:
+The Outbound HTTP Request example above can be built using `go tool componentize-go build`:
 
 <!-- @selectiveCpy -->
 
 ```bash
-$ tinygo build -target=wasip1 -gc=leaking -buildmode=c-shared -no-debug -o main.wasm .
+$ go tool componentize-go build
 ```
 
 Before we can execute this component, we need to add the
@@ -191,14 +186,14 @@ requests to:
 spin_manifest_version = 2
 
 [application]
-name = "spin-hello-tinygo"
+name = "spin-hello-go"
 version = "1.0.0"
 
 [[trigger.http]]
 route = "/hello"
-component = "tinygo-hello"
+component = "go-hello"
 
-[component.tinygo-hello]
+[component.go-hello]
 source = "main.wasm"
 allowed_outbound_hosts = [ "https://random-data-api.fermyon.app" ]
 ```
@@ -243,7 +238,7 @@ package main
 import (
  "fmt"
 
- "github.com/spinframework/spin-go-sdk/v2/redis"
+ "github.com/spinframework/spin-go-sdk/v3/redis"
 )
 
 func init() {
@@ -278,7 +273,7 @@ component = "echo-message"
 [component.echo-message]
 source = "main.wasm"
 [component.echo-message.build]
-command = "tinygo build -target=wasip1 -gc=leaking -buildmode=c-shared -no-debug -o main.wasm ."
+command = "go tool componentize-go build"
 ```
 
 The application will connect to `redis://localhost:6379`, and for every new message
@@ -348,8 +343,8 @@ import (
  "net/http"
  "os"
 
- spin_http "github.com/spinframework/spin-go-sdk/v2/http"
- "github.com/spinframework/spin-go-sdk/v2/redis"
+ spin_http "github.com/spinframework/spin-go-sdk/v3/http"
+ "github.com/spinframework/spin-go-sdk/v3/redis"
 )
 
 func init() {
@@ -365,7 +360,7 @@ func init() {
   channel := os.Getenv("REDIS_CHANNEL")
 
   // payload is the data publish to the redis channel.
-  payload := []byte(`Hello redis from tinygo!`)
+  payload := []byte(`Hello redis from Go!`)
 
   // create a new redis client.
   rdb := redis.NewClient(addr)
@@ -407,22 +402,14 @@ This HTTP component can be paired with a Redis component, triggered on new messa
 > You can find a complete example for using outbound Redis from an HTTP component
 > in the [Spin repository on GitHub](https://github.com/spinframework/spin-go-sdk/tree/main/examples/redis-outbound).
 
-## Using Go Packages in Spin Components
-
-Any [package from the Go standard library](https://tinygo.org/docs/reference/lang-support/stdlib/) that can be imported in TinyGo and that compiles to
-WASI can be used when implementing a Spin component.
-
-> Make sure to read [the page describing the HTTP trigger](./http-trigger.md) for more
-> details about building HTTP applications.
-
 ## Storing Data in the Spin Key-Value Store
 
-Spin has a key-value store built in. For information about using it from TinyGo, see [the key-value API guide](kv-store-api-guide).
+Spin has a key-value store built in. For information about using it from Go, see [the key-value API guide](kv-store-api-guide).
 
 ## Storing Data in SQLite
 
-For more information about using SQLite from TinyGo, see [SQLite storage](sqlite-api-guide).
+For more information about using SQLite from Go, see [SQLite storage](sqlite-api-guide).
 
 ## AI Inferencing From Go Components
 
-For more information about using Serverless AI from TinyGo, see the [Serverless AI](serverless-ai-api-guide) API guide.
+For more information about using Serverless AI from Go, see the [Serverless AI](serverless-ai-api-guide) API guide.

content/v4/http-outbound.md

@@ -201,15 +201,15 @@ You can find a complete example for using outbound HTTP in the [Python SDK repos
 
 {{ blockEnd }}
 
-{{ startTab "TinyGo"}}
+{{ startTab "Go"}}
 
-> [**Want to go straight to the reference documentation?**  Find it here.](https://pkg.go.dev/github.com/spinframework/spin-go-sdk/v2@v2.2.1/http)
+> [**Want to go straight to the reference documentation?**  Find it here.](https://pkg.go.dev/github.com/spinframework/spin-go-sdk/v3@v3.0.0/http)
 
-HTTP functions are available in the `github.com/spinframework/spin-go-sdk/v2/http` package. [See Go Packages for reference documentation.](https://pkg.go.dev/github.com/spinframework/spin-go-sdk/v2/http) The general function is named `Send`, but the Go SDK also surfaces individual functions, with request-specific parameters, for the `Get` and `Post` operations. For example:
+HTTP functions are available in the `github.com/spinframework/spin-go-sdk/v3/http` package. [See Go Packages for reference documentation.](https://pkg.go.dev/github.com/spinframework/spin-go-sdk/v3/http) The general function is named `Send`, but the Go SDK also surfaces individual functions, with request-specific parameters, for the `Get` and `Post` operations. For example:
 
 ```go
 import (
-	spinhttp "github.com/spinframework/spin-go-sdk/v2/http"
+	spinhttp "github.com/spinframework/spin-go-sdk/v3/http"
 )
 
 res1, err1 := spinhttp.Get("https://random-data-api.fermyon.app/animals/json")
@@ -218,13 +218,13 @@ res2, err2 := spinhttp.Post("https://example.com/users", "application/json", jso
 request, err := http.NewRequest("PUT", "https://example.com/users/1", bytes.NewBufferString(user1))
 request.Header.Add("content-type", "application/json")
 res3, err3 := spinhttp.Send(req)
-
 ```
 
 **Notes**
 
 * In the `Post` function, the body is an `io.Reader`. The Spin SDK reads this into the underlying Wasm byte array.
 * The `NewRequest` function is part of the standard library. The `Send` method adapts the standard request type to the underlying Wasm interface.
+* The response has a `Body` field of type `io.Reader`.
 * Errors are returned through the usual Go multiple return values mechanism.
 
 You can find a complete example for using outbound HTTP in the [Spin repository on GitHub](https://github.com/spinframework/spin-go-sdk/tree/main/examples/http-outbound).

content/v4/http-trigger.md

@@ -143,7 +143,7 @@ Other paths within the reserved space currently return 404 Not Found.
 
 ## Authoring HTTP Components
 
-> Spin has two ways of running HTTP components, depending on language support for the evolving WebAssembly component standards.  This section describes the default way, which is currently used by Rust, JavaScript/TypeScript, Python, and TinyGo components.  For other languages, see [HTTP Components with Wagi](#http-with-wagi-webassembly-gateway-interface) below.
+> Spin has two ways of running HTTP components, depending on language support for the evolving WebAssembly component standards.  This section describes the default way, which is currently used by Rust, JavaScript/TypeScript, Python, and Go components.  For other languages, see [HTTP Components with Wagi](#http-with-wagi-webassembly-gateway-interface) below.
 
 By default, Spin runs components using the [WebAssembly component model](https://component-model.bytecodealliance.org/).  In this model, the Wasm module exports a well-known interface that Spin calls to handle the HTTP request.
 
@@ -247,9 +247,9 @@ You can find a complete example for handling a HTTP request in the [Python SDK r
 
 {{ blockEnd }}
 
-{{ startTab "TinyGo"}}
+{{ startTab "Go"}}
 
-> [**Want to go straight to the reference documentation?**  Find it here.](https://pkg.go.dev/github.com/spinframework/spin-go-sdk/v2@v2.2.1/http)
+> [**Want to go straight to the reference documentation?**  Find it here.](https://pkg.go.dev/github.com/spinframework/spin-go-sdk/v3@v3.0.0/http)
 
 In Go, you register the handler as a callback in your program's `init` function.  Set `handler.Exports.Handle` to your handler function.  Your handler takes a `*Request` pointer, and returns a `Result[Response, ErrorCode]` with the response.
 

content/v4/kv-store-api-guide.md

@@ -176,21 +176,20 @@ You can find a complete Python code example using the Key Value store in the [Sp
 
 {{ blockEnd }}
 
-{{ startTab "TinyGo"}}
+{{ startTab "Go"}}
 
-> [**Want to go straight to the Spin SDK reference documentation?**  Find it here.](https://pkg.go.dev/github.com/spinframework/spin-go-sdk/v2@v2.2.1/kv)
+> [**Want to go straight to the Spin SDK reference documentation?**  Find it here.](https://pkg.go.dev/github.com/spinframework/spin-go-sdk/v3@v3.0.0/kv)
 
-Key value functions are provided by the `github.com/spinframework/spin-go-sdk/v2/kv` module. [See Go Packages for reference documentation.](https://pkg.go.dev/github.com/spinframework/spin-go-sdk/v2/kv) For example:
+Key value functions are provided by the `github.com/spinframework/spin-go-sdk/v3/kv` module. [See Go Packages for reference documentation.](https://pkg.go.dev/github.com/spinframework/spin-go-sdk/v3/kv) For example:
 
 ```go
-import "github.com/spinframework/spin-go-sdk/v2/kv"
+import "github.com/spinframework/spin-go-sdk/v3/kv"
 
 func example() error {
     store, err := kv.OpenStore("default")
     if err != nil {
         return err
     }
-    defer store.Close()
     previous, err := store.Get("mykey")
     return store.Set("mykey", []byte("myvalue"))
 }

content/v4/language-support-overview.md

@@ -83,9 +83,9 @@ This page contains information about language support for Spin features:
 
 {{ blockEnd }}
 
-{{ startTab "TinyGo"}}
+{{ startTab "Go"}}
 
-**[📄 Visit the TinyGo Spin SDK reference documentation](https://pkg.go.dev/github.com/spinframework/spin-go-sdk/v2) to see specific modules, functions, variables and syntax relating to the following TinyGo SDK.**
+**[📄 Visit the Go Spin SDK reference documentation](https://pkg.go.dev/github.com/spinframework/spin-go-sdk/v3) to see specific modules, functions, variables and syntax relating to the following Go SDK.**
 
 | Feature | SDK Supported? |
 |-----|-----|

content/v4/mqtt-outbound.md

@@ -103,7 +103,7 @@ You can find a complete Python code example for using outbound MQTT from an HTTP
 
 {{ blockEnd }}
 
-{{ startTab "TinyGo"}}
+{{ startTab "Go"}}
 
 MQTT is not available in the current version of the Go SDK.