cloudflare

cloudflare

Go/WASM runtime for Cloudflare Workers — the JS↔Go bridge, edge router, and storage adapters that compile into every deployed Worker. Extracted from tinywasm/goflare; goflare keeps the build/deploy CLI and imports this repo only for the runtime it ships.

Install

go get github.com/tinywasm/cloudflare/edge
go get github.com/tinywasm/cloudflare/workers
go get github.com/tinywasm/cloudflare/d1
go get github.com/tinywasm/cloudflare/r2
go get github.com/tinywasm/cloudflare/log

Requires Go 1.25+ and TinyGo for the //go:build wasm packages.

Minimal edge/main.go

//go:build wasm

package main

import (
	"github.com/tinywasm/cloudflare/d1"
	"github.com/tinywasm/cloudflare/edge"
	"github.com/tinywasm/fmt"
	"github.com/tinywasm/orm"
)

func main() {
	db, err := d1.NewEdge("DB")
	if err != nil {
		fmt.Println("d1:", err)
		return
	}
	// optional DDL sync: ddl.New(db.RawConn(), d1.DDLCompiler(db.RawConn())).Sync(&YourModel{})

	r := edge.NewRouter(edge.Config{
		// Authn establishes identity before the gate — see edge/edge.go
		// Authn: myAuthMiddleware,
		// Authorize: myAuthorizer,
	})
	r.Get("/api/ping", func(ctx edge.Context) {
		ctx.Write([]byte("pong"))
	}).Public()

	// register more routes...

	edge.Serve(r) // blocks forever, handles every request in this isolate
}

Built with goflare (or any bundler reading github.com/tinywasm/cloudflare/assets):

go install github.com/tinywasm/goflare/cmd/goflare@latest
goflare build   # → .build/edge.js + .build/edge.wasm
goflare deploy  # → Cloudflare Workers API

See tinywasm/goflare for the CLI, and docs/ARCHITECTURE.md for the isolate lifecycle contract (context.binding vs shared globals, runtime.ticks ABI).

Packages

Migrations from Outside a Worker (d1.NewMigrator)

For running DDL migrations from CI or outside a Worker (where NewEdge binding does not exist):

//go:build !wasm

package main

import (
	"github.com/tinywasm/cloudflare/d1"
	"github.com/tinywasm/ddl"
	"github.com/tinywasm/sqlt"
)

func main() {
	conn, err := d1.NewMigrator(accountID, databaseID, apiToken)
	if err != nil {
		// handle error
	}
	err = ddl.New(conn, sqlt.NewCompiler()).Sync(models...)
}

Constraints

• //go:build wasm files never import stdlib (fmt, strings, errors). Use github.com/tinywasm/fmt.
• The runtime lives alone — no os/exec, no net/http client. That stays in goflare.
• Isolate invariants documented in AGENTS.md — read before touching workers/ or assets/.

Testing

go install github.com/tinywasm/devflow/cmd/gotest@latest
gotest

gotest runs go vet, go test -race -cover, and the WASM suite in a real browser (auto-detected via //go:build wasm, wasmbrowsertest under the hood). See tinywasm/devflow/docs/GOTEST.md.

License

See LICENSE.