fix go version in dockerfile

remove specific filter processors

.github/workflows/release-showbridge.yaml

@@ -21,7 +21,7 @@ jobs:
         with:
           go-version-file: 'go.mod'
       - name: release
-        uses: goreleaser/goreleaser-action@v6
+        uses: goreleaser/goreleaser-action@v7
         with:
           workdir: cmd/showbridge
           distribution: goreleaser
@@ -56,7 +56,7 @@ jobs:
             jwetzell/showbridge
 
       - name: Build and push
-        uses: docker/build-push-action@263435318d21b8e681c14492fe198d362a7d2c83 # v6.18.0
+        uses: docker/build-push-action@10e90e3645eae34f1e60eeb005ba3a3d33f178e8 # v6.19.2
         with:
           push: true
           context: ./
@@ -65,4 +65,4 @@ jobs:
           labels: ${{ steps.meta.outputs.labels }}
           cache-from: type=gha
           cache-to: type=gha,mode=max
-          platforms: linux/amd64,linux/arm64,linux/arm/v7
+          platforms: linux/amd64

.github/workflows/test-showbridge.yaml

@@ -17,7 +17,7 @@ on:
       - 'go.sum'
 
 permissions:
-  contents: read
+  contents: write
 
 jobs:
   test:
@@ -34,4 +34,16 @@ jobs:
         run: go mod tidy
 
       - name: run tests
-        run: go test ./...
+        run: go test ./... -count=1 -coverpkg "github.com/jwetzell/showbridge-go/..." -coverprofile coverage.out
+
+      - name: clean up coverage report
+        run: cat coverage.out | grep -v "github.com/jwetzell/showbridge-go/cmd" > coverage.nocmd.out       
+      - name: Update coverage report
+        uses: ncruces/go-coverage-report@v0.3.2
+        with:
+          coverage-file: coverage.nocmd.out
+          report: true
+          chart: true
+          amend: true
+        if: github.event_name == 'push'  
+        continue-on-error: true

Dockerfile

@@ -1,4 +1,4 @@
-ARG GO_VERSION=1.25.5
+ARG GO_VERSION=1.26.0
 FROM golang:${GO_VERSION}-alpine AS build
 RUN apk --no-cache add ca-certificates tzdata
 WORKDIR /build

README.md

@@ -1,6 +1,8 @@
 <div align="center">
 
-  # showbridge (go edition)
+# showbridge (go edition)
+
+[![Coverage](https://github.com/jwetzell/showbridge-go/wiki/coverage.svg)](https://raw.githack.com/wiki/jwetzell/showbridge-go/coverage.html)
 	
 Simple protocol router _/s_
 

cmd/showbridge/main.go

@@ -9,15 +9,22 @@ import (
 	"os/signal"
 	"slices"
 	"sync"
+	"syscall"
 
 	"github.com/jwetzell/showbridge-go"
 	"github.com/jwetzell/showbridge-go/internal/config"
 	"github.com/urfave/cli/v3"
+	"go.opentelemetry.io/otel"
+	"go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp"
+	"go.opentelemetry.io/otel/sdk/resource"
+	sdktrace "go.opentelemetry.io/otel/sdk/trace"
+	semconv "go.opentelemetry.io/otel/semconv/v1.39.0"
 	"sigs.k8s.io/yaml"
 )
 
 var (
 	version   = "dev"
+	sigHangup = make(chan os.Signal, 1)
 )
 
 func main() {
@@ -55,11 +62,18 @@ func main() {
 					return nil
 				},
 			},
+			&cli.BoolFlag{
+				Name:  "trace",
+				Value: false,
+				Usage: "enable OpenTelemetry tracing",
+			},
 		},
 		Action: run,
 	}
 
 	ctx, cancel := signal.NotifyContext(context.Background(), os.Interrupt)
+
+	signal.Notify(sigHangup, syscall.SIGHUP)
 	defer cancel()
 	err := cmd.Run(ctx, os.Args)
 
@@ -69,6 +83,15 @@ func main() {
 
 }
 
+type showbridgeApp struct {
+	ctx          context.Context
+	configPath   string
+	logger       *slog.Logger
+	router       *showbridge.Router
+	routerRunner *sync.WaitGroup
+	routerMutex  sync.Mutex
+}
+
 func readConfig(configPath string) (config.Config, error) {
 	cfg := config.Config{}
 
@@ -89,12 +112,7 @@ func readConfig(configPath string) (config.Config, error) {
 func run(ctx context.Context, c *cli.Command) error {
 	configPath := c.String("config")
 	if configPath == "" {
-		return errors.New("config value cannot be empty")
-	}
-
-	config, err := readConfig(configPath)
-	if err != nil {
-		return err
+		return errors.New("config path cannot be empty")
 	}
 
 	logLevel := slog.LevelInfo
@@ -135,28 +153,113 @@ func run(ctx context.Context, c *cli.Command) error {
 
 	slog.SetDefault(slog.New(logHandler))
 
-	commandLogger := slog.Default().With("component", "cmd")
+	if c.Bool("trace") {
+		exporter, err := otlptracehttp.New(ctx)
+		if err != nil {
+			return fmt.Errorf("failed to create trace exporter: %w", err)
+		}
+
+		tracerProvider := newTracerProvider(exporter)
+		otel.SetTracerProvider(tracerProvider)
+		defer tracerProvider.Shutdown(ctx)
+
+		otel.SetTracerProvider(tracerProvider)
+	}
+
+	showbridgeApp := &showbridgeApp{
+		ctx:          ctx,
+		configPath:   configPath,
+		logger:       slog.Default().With("component", "cmd"),
+		routerRunner: &sync.WaitGroup{},
+	}
+
+	router, err := showbridgeApp.getNewRouter()
+	if err != nil {
+		return fmt.Errorf("failed to initialize router: %w", err)
+	}
+	showbridgeApp.routerMutex.Lock()
+	showbridgeApp.router = router
+
+	showbridgeApp.routerRunner.Go(func() {
+		router.Start(context.Background())
+	})
+	showbridgeApp.routerMutex.Unlock()
+
+	go showbridgeApp.handleHangup()
+
+	<-showbridgeApp.ctx.Done()
+	showbridgeApp.logger.Debug("shutting down router")
+	showbridgeApp.router.Stop()
+	showbridgeApp.logger.Debug("waiting for router to exit")
+	showbridgeApp.routerRunner.Wait()
+	return nil
+}
+
+func (app *showbridgeApp) handleHangup() {
+	for {
+		select {
+		case <-sigHangup:
+			app.logger.Info("received SIGHUP, reloading configuration")
+			newRouter, err := app.getNewRouter()
+			if err != nil {
+				app.logger.Error("failed to reload configuration", "error", err)
+				continue
+			}
+			app.routerMutex.Lock()
+			app.router.Stop()
+			app.routerRunner.Wait()
+			app.router = newRouter
+			app.routerRunner.Go(func() {
+				app.router.Start(context.Background())
+			})
+			app.logger.Info("configuration reloaded successfully")
+			app.routerMutex.Unlock()
+		case <-app.ctx.Done():
+			return
+		}
+	}
+}
+
+func (app *showbridgeApp) getNewRouter() (*showbridge.Router, error) {
+	// TODO(jwetzell): what should happen when the config file is unchanged?
+	config, err := readConfig(app.configPath)
+	if err != nil {
+		return nil, err
+	}
 
 	router, moduleErrors, routeErrors := showbridge.NewRouter(config)
 
 	for _, moduleError := range moduleErrors {
-		commandLogger.Error("problem initializing module", "index", moduleError.Index, "error", moduleError.Error)
+		app.logger.Error("problem initializing module", "index", moduleError.Index, "error", moduleError.Error)
 	}
 
 	for _, routeError := range routeErrors {
-		commandLogger.Error("problem initializing route", "index", routeError.Index, "error", routeError.Error)
+		app.logger.Error("problem initializing route", "index", routeError.Index, "error", routeError.Error)
 	}
 
-	routerRunner := sync.WaitGroup{}
+	if moduleErrors != nil || routeErrors != nil {
+		return nil, fmt.Errorf("errors initializing modules or routes")
+	}
 
-	routerRunner.Go(func() {
-		router.Run(context.Background())
-	})
-
-	<-ctx.Done()
-	commandLogger.Debug("shutting down router")
-	router.Stop()
-	commandLogger.Debug("waiting for router to exit")
-	routerRunner.Wait()
-	return nil
+	return router, nil
+}
+
+func newTracerProvider(exp sdktrace.SpanExporter) *sdktrace.TracerProvider {
+	r, err := resource.Merge(
+		resource.Default(),
+		resource.NewWithAttributes(
+			semconv.SchemaURL,
+			semconv.ServiceName("showbridge"),
+			semconv.ServiceVersion(version),
+		),
+	)
+
+	if err != nil {
+		panic(err)
+	}
+
+	return sdktrace.NewTracerProvider(
+		sdktrace.WithBatcher(exp),
+		sdktrace.WithResource(r),
+	)
 }

config.yaml

@@ -13,6 +13,8 @@ routes:
     processors:
       - type: osc.message.create
         params:
-          address: "{{.URL.Path}}"
+          address: "{{.Payload.URL.Path}}"
       - type: osc.message.encode
-    output: udp
+      - type: router.output
+        params:
+          module: udp

go.mod

@@ -1,42 +1,56 @@
 module github.com/jwetzell/showbridge-go
 
-go 1.25.5
+go 1.26.0
 
 require (
 	github.com/eclipse/paho.mqtt.golang v1.5.1
-	github.com/emiago/diago v0.26.2
-	github.com/emiago/sipgo v1.1.2
-	github.com/expr-lang/expr v1.17.7
+	github.com/emiago/diago v0.27.0
+	github.com/emiago/sipgo v1.2.0
+	github.com/expr-lang/expr v1.17.8
 	github.com/extism/go-sdk v1.7.1
 	github.com/jwetzell/artnet-go v0.2.1
 	github.com/jwetzell/free-d-go v0.1.0
-	github.com/jwetzell/osc-go v0.1.0
+	github.com/jwetzell/osc-go v0.2.0
 	github.com/jwetzell/psn-go v0.3.0
-	github.com/nats-io/nats.go v1.48.0
-	github.com/urfave/cli/v3 v3.6.2
-	gitlab.com/gomidi/midi/v2 v2.3.18
+	github.com/nats-io/nats-server/v2 v2.12.4
+	github.com/nats-io/nats.go v1.49.0
+	github.com/urfave/cli/v3 v3.7.0
+	gitlab.com/gomidi/midi/v2 v2.3.23
 	go.bug.st/serial v1.6.4
+	go.opentelemetry.io/otel v1.41.0
+	go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp v1.41.0
+	go.opentelemetry.io/otel/sdk v1.41.0
+	go.opentelemetry.io/otel/trace v1.41.0
 	modernc.org/quickjs v0.17.1
 	sigs.k8s.io/yaml v1.6.0
 )
 
 require (
+	github.com/antithesishq/antithesis-sdk-go v0.5.0-default-no-op // indirect
+	github.com/cenkalti/backoff/v5 v5.0.3 // indirect
+	github.com/cespare/xxhash/v2 v2.3.0 // indirect
 	github.com/creack/goselect v0.1.2 // indirect
 	github.com/dustin/go-humanize v1.0.1 // indirect
 	github.com/dylibso/observe-sdk/go v0.0.0-20240819160327-2d926c5d788a // indirect
 	github.com/emiago/dtls/v3 v3.0.0-20260122183559-8b8d23e359c0 // indirect
 	github.com/go-audio/riff v1.0.0 // indirect
+	github.com/go-logr/logr v1.4.3 // indirect
+	github.com/go-logr/stdr v1.2.2 // indirect
 	github.com/gobwas/glob v0.2.3 // indirect
 	github.com/gobwas/httphead v0.1.0 // indirect
 	github.com/gobwas/pool v0.2.1 // indirect
 	github.com/gobwas/ws v1.4.0 // indirect
+	github.com/google/go-tpm v0.9.8 // indirect
 	github.com/google/uuid v1.6.0 // indirect
 	github.com/gorilla/websocket v1.5.3 // indirect
+	github.com/grpc-ecosystem/grpc-gateway/v2 v2.28.0 // indirect
 	github.com/ianlancetaylor/demangle v0.0.0-20240805132620-81f5be970eca // indirect
 	github.com/icholy/digest v1.1.0 // indirect
-	github.com/klauspost/compress v1.18.0 // indirect
+	github.com/klauspost/compress v1.18.3 // indirect
 	github.com/mattn/go-isatty v0.0.20 // indirect
-	github.com/nats-io/nkeys v0.4.11 // indirect
+	github.com/minio/highwayhash v1.0.4-0.20251030100505-070ab1a87a76 // indirect
+	github.com/nats-io/jwt/v2 v2.8.0 // indirect
+	github.com/nats-io/nkeys v0.4.12 // indirect
 	github.com/nats-io/nuid v1.0.1 // indirect
 	github.com/ncruces/go-strftime v1.0.0 // indirect
 	github.com/pion/logging v0.2.4 // indirect
@@ -50,14 +64,22 @@ require (
 	github.com/tetratelabs/wabin v0.0.0-20230304001439-f6f874872834 // indirect
 	github.com/tetratelabs/wazero v1.9.0 // indirect
 	github.com/zaf/g711 v1.4.0 // indirect
-	go.opentelemetry.io/proto/otlp v1.3.1 // indirect
+	go.opentelemetry.io/auto/sdk v1.2.1 // indirect
+	go.opentelemetry.io/otel/exporters/otlp/otlptrace v1.41.0 // indirect
+	go.opentelemetry.io/otel/metric v1.41.0 // indirect
+	go.opentelemetry.io/proto/otlp v1.9.0 // indirect
 	go.yaml.in/yaml/v2 v2.4.2 // indirect
-	golang.org/x/crypto v0.42.0 // indirect
+	golang.org/x/crypto v0.48.0 // indirect
 	golang.org/x/exp v0.0.0-20251023183803-a4bb9ffd2546 // indirect
-	golang.org/x/net v0.44.0 // indirect
+	golang.org/x/net v0.50.0 // indirect
 	golang.org/x/sync v0.19.0 // indirect
-	golang.org/x/sys v0.39.0 // indirect
-	google.golang.org/protobuf v1.34.2 // indirect
+	golang.org/x/sys v0.41.0 // indirect
+	golang.org/x/text v0.34.0 // indirect
+	golang.org/x/time v0.14.0 // indirect
+	google.golang.org/genproto/googleapis/api v0.0.0-20260209200024-4cfbd4190f57 // indirect
+	google.golang.org/genproto/googleapis/rpc v0.0.0-20260209200024-4cfbd4190f57 // indirect
+	google.golang.org/grpc v1.79.1 // indirect
+	google.golang.org/protobuf v1.36.11 // indirect
 	gopkg.in/hraban/opus.v2 v2.0.0-20230925203106-0188a62cb302 // indirect
 	modernc.org/libc v1.67.1 // indirect
 	modernc.org/libquickjs v0.12.3 // indirect

go.sum

@@ -1,3 +1,9 @@
+github.com/antithesishq/antithesis-sdk-go v0.5.0-default-no-op h1:Ucf+QxEKMbPogRO5guBNe5cgd9uZgfoJLOYs8WWhtjM=
+github.com/antithesishq/antithesis-sdk-go v0.5.0-default-no-op/go.mod h1:IUpT2DPAKh6i/YhSbt6Gl3v2yvUZjmKncl7U91fup7E=
+github.com/cenkalti/backoff/v5 v5.0.3 h1:ZN+IMa753KfX5hd8vVaMixjnqRZ3y8CuJKRKj1xcsSM=
+github.com/cenkalti/backoff/v5 v5.0.3/go.mod h1:rkhZdG3JZukswDf7f0cwqPNk4K0sa+F97BxZthm/crw=
+github.com/cespare/xxhash/v2 v2.3.0 h1:UL815xU9SqsFlibzuggzjXhog7bL6oX9BbNZnL2UFvs=
+github.com/cespare/xxhash/v2 v2.3.0/go.mod h1:VGX0DQ3Q6kWi7AoAeZDth3/j3BFtOZR5XLFGgcrjCOs=
 github.com/creack/goselect v0.1.2 h1:2DNy14+JPjRBgPzAd1thbQp4BSIihxcBf0IXhQXDRa0=
 github.com/creack/goselect v0.1.2/go.mod h1:a/NhLweNvqIYMuxcMOuWY516Cimucms3DglDzQP3hKY=
 github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
@@ -8,18 +14,23 @@ github.com/dylibso/observe-sdk/go v0.0.0-20240819160327-2d926c5d788a h1:UwSIFv5g
 github.com/dylibso/observe-sdk/go v0.0.0-20240819160327-2d926c5d788a/go.mod h1:C8DzXehI4zAbrdlbtOByKX6pfivJTBiV9Jjqv56Yd9Q=
 github.com/eclipse/paho.mqtt.golang v1.5.1 h1:/VSOv3oDLlpqR2Epjn1Q7b2bSTplJIeV2ISgCl2W7nE=
 github.com/eclipse/paho.mqtt.golang v1.5.1/go.mod h1:1/yJCneuyOoCOzKSsOTUc0AJfpsItBGWvYpBLimhArU=
-github.com/emiago/diago v0.26.2 h1:3QL03V0drX96eIBFBpfueNcywydRgYqffKihluGL0gA=
-github.com/emiago/diago v0.26.2/go.mod h1:jZ+7EnKcmgqKnLjCHPqfbP4Y/9Q/JLSLxMflDrp2J1M=
+github.com/emiago/diago v0.27.0 h1:5SQBbcLR9ooxhSMlTkU9QSuDv/2nhMO9lxuWJTd/7rE=
+github.com/emiago/diago v0.27.0/go.mod h1:8hUxCDPJY2p32hh+4ed7vHW/3yTMmEa3BjNctUPeGD0=
 github.com/emiago/dtls/v3 v3.0.0-20260122183559-8b8d23e359c0 h1:o4LxpUnZ1zxiQ+Qjc9kLwXcjz31NGAHmnZ7xoJto3VM=
 github.com/emiago/dtls/v3 v3.0.0-20260122183559-8b8d23e359c0/go.mod h1:ydcZ977eS1I6uOWodzMuw30BwvNAzT9su/xcNYSJqjA=
-github.com/emiago/sipgo v1.1.2 h1:JvLqEvqNSQm2mBX40qZ7O0WC3Ee67Z0UrfmBI7y6Beo=
-github.com/emiago/sipgo v1.1.2/go.mod h1:DuwAxBZhKMqIzQFPGZb1MVAGU6Wuxj64oTOhd5dx/FY=
-github.com/expr-lang/expr v1.17.7 h1:Q0xY/e/2aCIp8g9s/LGvMDCC5PxYlvHgDZRQ4y16JX8=
-github.com/expr-lang/expr v1.17.7/go.mod h1:8/vRC7+7HBzESEqt5kKpYXxrxkr31SaO8r40VO/1IT4=
+github.com/emiago/sipgo v1.2.0 h1:rmHFdCu9zu2Cabfd8+/eC9HQWyooqk8x+ti550z5lBw=
+github.com/emiago/sipgo v1.2.0/go.mod h1:DuwAxBZhKMqIzQFPGZb1MVAGU6Wuxj64oTOhd5dx/FY=
+github.com/expr-lang/expr v1.17.8 h1:W1loDTT+0PQf5YteHSTpju2qfUfNoBt4yw9+wOEU9VM=
+github.com/expr-lang/expr v1.17.8/go.mod h1:8/vRC7+7HBzESEqt5kKpYXxrxkr31SaO8r40VO/1IT4=
 github.com/extism/go-sdk v1.7.1 h1:lWJos6uY+tRFdlIHR+SJjwFDApY7OypS/2nMhiVQ9Sw=
 github.com/extism/go-sdk v1.7.1/go.mod h1:IT+Xdg5AZM9hVtpFUA+uZCJMge/hbvshl8bwzLtFyKA=
 github.com/go-audio/riff v1.0.0 h1:d8iCGbDvox9BfLagY94fBynxSPHO80LmZCaOsmKxokA=
 github.com/go-audio/riff v1.0.0/go.mod h1:l3cQwc85y79NQFCRB7TiPoNiaijp6q8Z0Uv38rVG498=
+github.com/go-logr/logr v1.2.2/go.mod h1:jdQByPbusPIv2/zmleS9BjJVeZ6kBagPoEUsqbVz/1A=
+github.com/go-logr/logr v1.4.3 h1:CjnDlHq8ikf6E492q6eKboGOC0T8CDaOvkHCIg8idEI=
+github.com/go-logr/logr v1.4.3/go.mod h1:9T104GzyrTigFIr8wt5mBrctHMim0Nb2HLGrmQ40KvY=
+github.com/go-logr/stdr v1.2.2 h1:hSWxHoqTgW2S2qGc0LTAI563KZ5YKYRhT3MFKZMbjag=
+github.com/go-logr/stdr v1.2.2/go.mod h1:mMo/vtBO5dYbehREoey6XUKy/eSumjCCveDpRre4VKE=
 github.com/gobwas/glob v0.2.3 h1:A4xDbljILXROh+kObIiy5kIaPYD8e96x1tgBhUI5J+Y=
 github.com/gobwas/glob v0.2.3/go.mod h1:d3Ez4x06l9bZtSvzIay5+Yzi0fmZzPgnTbPcKjJAkT8=
 github.com/gobwas/httphead v0.1.0 h1:exrUm0f4YX0L7EBwZHuCF4GDp8aJfVeBrlLQrs6NqWU=
@@ -28,12 +39,18 @@ github.com/gobwas/pool v0.2.1 h1:xfeeEhW7pwmX8nuLVlqbzVc7udMDrwetjEv+TZIz1og=
 github.com/gobwas/pool v0.2.1/go.mod h1:q8bcK0KcYlCgd9e7WYLm9LpyS+YeLd8JVDW6WezmKEw=
 github.com/gobwas/ws v1.4.0 h1:CTaoG1tojrh4ucGPcoJFiAQUAsEWekEWvLy7GsVNqGs=
 github.com/gobwas/ws v1.4.0/go.mod h1:G3gNqMNtPppf5XUz7O4shetPpcZ1VJ7zt18dlUeakrc=
+github.com/golang/protobuf v1.5.4 h1:i7eJL8qZTpSEXOPTxNKhASYpMn+8e5Q6AdndVa1dWek=
+github.com/golang/protobuf v1.5.4/go.mod h1:lnTiLA8Wa4RWRcIUkrtSVa5nRhsEGBg48fD6rSs7xps=
 github.com/google/go-cmp v0.7.0 h1:wk8382ETsv4JYUZwIsn6YpYiWiBsYLSJiTsyBybVuN8=
 github.com/google/go-cmp v0.7.0/go.mod h1:pXiqmnSA92OHEEa9HXL2W4E7lf9JzCmGVUdgjX3N/iU=
+github.com/google/go-tpm v0.9.8 h1:slArAR9Ft+1ybZu0lBwpSmpwhRXaa85hWtMinMyRAWo=
+github.com/google/go-tpm v0.9.8/go.mod h1:h9jEsEECg7gtLis0upRBQU+GhYVH6jMjrFxI8u6bVUY=
 github.com/google/uuid v1.6.0 h1:NIvaJDMOsjHA8n1jAhLSgzrAzy1Hgr+hNrb57e+94F0=
 github.com/google/uuid v1.6.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo=
 github.com/gorilla/websocket v1.5.3 h1:saDtZ6Pbx/0u+bgYQ3q96pZgCzfhKXGPqt7kZ72aNNg=
 github.com/gorilla/websocket v1.5.3/go.mod h1:YR8l580nyteQvAITg2hZ9XVh4b55+EU/adAjf1fMHhE=
+github.com/grpc-ecosystem/grpc-gateway/v2 v2.28.0 h1:HWRh5R2+9EifMyIHV7ZV+MIZqgz+PMpZ14Jynv3O2Zs=
+github.com/grpc-ecosystem/grpc-gateway/v2 v2.28.0/go.mod h1:JfhWUomR1baixubs02l85lZYYOm7LV6om4ceouMv45c=
 github.com/hashicorp/golang-lru/v2 v2.0.7 h1:a+bsQ5rvGLjzHuww6tVxozPZFVghXaHOwFs4luLUK2k=
 github.com/hashicorp/golang-lru/v2 v2.0.7/go.mod h1:QeFd9opnmA6QUJc5vARoKUSoFhyfM2/ZepoAG6RGpeM=
 github.com/ianlancetaylor/demangle v0.0.0-20240805132620-81f5be970eca h1:T54Ema1DU8ngI+aef9ZhAhNGQhcRTrWxVeG07F+c/Rw=
@@ -44,22 +61,28 @@ github.com/jwetzell/artnet-go v0.2.1 h1:iYTKWcwYrF5kBkYfkw2UbWvoueeA23iKEn7fR27m
 github.com/jwetzell/artnet-go v0.2.1/go.mod h1:gli97Z32a0kMkZ6taoTiK7/lqHcF/dhiGjGJdx/PxqA=
 github.com/jwetzell/free-d-go v0.1.0 h1:xHt6dvyit98X+OC3jVzV0aLidxbyzi3vI9QiYkteEtA=
 github.com/jwetzell/free-d-go v0.1.0/go.mod h1:KmrkooRARRaxJTBSPvwt/6IMAIaHH1R8bSA8cwbbELw=
-github.com/jwetzell/osc-go v0.1.0 h1:EXxup5VWBErHot2Ri4MFToPf6KCzLDTbCt2x6GLfw8I=
-github.com/jwetzell/osc-go v0.1.0/go.mod h1:xLz0jTwebSxtx1TkKN1YVdeRqvpFNweDhTut5TE393A=
+github.com/jwetzell/osc-go v0.2.0 h1:4as+BYCeZhEddFczGveP5yZZxvY728Uavz+ZSLZfOII=
+github.com/jwetzell/osc-go v0.2.0/go.mod h1:D3ZIXYB12bt4S35lKFUqgCFbF1Y+9Ld0sOhHA9mGZZM=
 github.com/jwetzell/psn-go v0.3.0 h1:WVpCEmExYE8a+I5hQak5jNJJp2x35VdGX/VuMUKPmhY=
 github.com/jwetzell/psn-go v0.3.0/go.mod h1:bcEAeti4sQM375buujb3mIfmUstD4Aby18gq3ENb6+o=
-github.com/klauspost/compress v1.18.0 h1:c/Cqfb0r+Yi+JtIEq73FWXVkRonBlf0CRNYc8Zttxdo=
-github.com/klauspost/compress v1.18.0/go.mod h1:2Pp+KzxcywXVXMr50+X0Q/Lsb43OQHYWRCY2AiWywWQ=
+github.com/klauspost/compress v1.18.3 h1:9PJRvfbmTabkOX8moIpXPbMMbYN60bWImDDU7L+/6zw=
+github.com/klauspost/compress v1.18.3/go.mod h1:R0h/fSBs8DE4ENlcrlib3PsXS61voFxhIs2DeRhCvJ4=
 github.com/kr/pretty v0.3.1 h1:flRD4NNwYAUpkphVc1HcthR4KEIFJ65n8Mw5qdRn3LE=
 github.com/kr/pretty v0.3.1/go.mod h1:hoEshYVHaxMs3cyo3Yncou5ZscifuDolrwPKZanG3xk=
 github.com/kr/text v0.2.0 h1:5Nx0Ya0ZqY2ygV366QzturHI13Jq95ApcVaJBhpS+AY=
 github.com/kr/text v0.2.0/go.mod h1:eLer722TekiGuMkidMxC/pM04lWEeraHUUmBw8l2grE=
 github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWEY=
 github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y=
-github.com/nats-io/nats.go v1.48.0 h1:pSFyXApG+yWU/TgbKCjmm5K4wrHu86231/w84qRVR+U=
-github.com/nats-io/nats.go v1.48.0/go.mod h1:iRWIPokVIFbVijxuMQq4y9ttaBTMe0SFdlZfMDd+33g=
-github.com/nats-io/nkeys v0.4.11 h1:q44qGV008kYd9W1b1nEBkNzvnWxtRSQ7A8BoqRrcfa0=
-github.com/nats-io/nkeys v0.4.11/go.mod h1:szDimtgmfOi9n25JpfIdGw12tZFYXqhGxjhVxsatHVE=
+github.com/minio/highwayhash v1.0.4-0.20251030100505-070ab1a87a76 h1:KGuD/pM2JpL9FAYvBrnBBeENKZNh6eNtjqytV6TYjnk=
+github.com/minio/highwayhash v1.0.4-0.20251030100505-070ab1a87a76/go.mod h1:GGYsuwP/fPD6Y9hMiXuapVvlIUEhFhMTh0rxU3ik1LQ=
+github.com/nats-io/jwt/v2 v2.8.0 h1:K7uzyz50+yGZDO5o772eRE7atlcSEENpL7P+b74JV1g=
+github.com/nats-io/jwt/v2 v2.8.0/go.mod h1:me11pOkwObtcBNR8AiMrUbtVOUGkqYjMQZ6jnSdVUIA=
+github.com/nats-io/nats-server/v2 v2.12.4 h1:ZnT10v2LU2Xcoiy8ek9X6Se4YG8EuMfIfvAEuFVx1Ts=
+github.com/nats-io/nats-server/v2 v2.12.4/go.mod h1:5MCp/pqm5SEfsvVZ31ll1088ZTwEUdvRX1Hmh/mTTDg=
+github.com/nats-io/nats.go v1.49.0 h1:yh/WvY59gXqYpgl33ZI+XoVPKyut/IcEaqtsiuTJpoE=
+github.com/nats-io/nats.go v1.49.0/go.mod h1:fDCn3mN5cY8HooHwE2ukiLb4p4G4ImmzvXyJt+tGwdw=
+github.com/nats-io/nkeys v0.4.12 h1:nssm7JKOG9/x4J8II47VWCL1Ds29avyiQDRn0ckMvDc=
+github.com/nats-io/nkeys v0.4.12/go.mod h1:MT59A1HYcjIcyQDJStTfaOY6vhy9XTUjOFo+SVsvpBg=
 github.com/nats-io/nuid v1.0.1 h1:5iA8DT8V7q8WK2EScv2padNa/rTESc1KdnPw4TC2paw=
 github.com/nats-io/nuid v1.0.1/go.mod h1:19wcPz3Ph3q0Jbyiqsd0kePYG7A95tJPxeL+1OSON2c=
 github.com/ncruces/go-strftime v1.0.0 h1:HMFp8mLCTPp341M/ZnA4qaf7ZlsbTc+miZjCLOFAw7w=
@@ -82,45 +105,76 @@ github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZb
 github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
 github.com/remyoudompheng/bigfft v0.0.0-20230129092748-24d4a6f8daec h1:W09IVJc94icq4NjY3clb7Lk8O1qJ8BdBEF8z0ibU0rE=
 github.com/remyoudompheng/bigfft v0.0.0-20230129092748-24d4a6f8daec/go.mod h1:qqbHyh8v60DhA7CoWK5oRCqLrMHRGoxYCSS9EjAz6Eo=
-github.com/rogpeppe/go-internal v1.13.1 h1:KvO1DLK/DRN07sQ1LQKScxyZJuNnedQ5/wKSR38lUII=
-github.com/rogpeppe/go-internal v1.13.1/go.mod h1:uMEvuHeurkdAXX61udpOXGD/AzZDWNMNyH2VO9fmH0o=
+github.com/rogpeppe/go-internal v1.14.1 h1:UQB4HGPB6osV0SQTLymcB4TgvyWu6ZyliaW0tI/otEQ=
+github.com/rogpeppe/go-internal v1.14.1/go.mod h1:MaRKkUm5W0goXpeCfT7UZI6fk/L7L7so1lCWt35ZSgc=
 github.com/stretchr/testify v1.11.1 h1:7s2iGBzp5EwR7/aIZr8ao5+dra3wiQyKjjFuvgVKu7U=
 github.com/stretchr/testify v1.11.1/go.mod h1:wZwfW3scLgRK+23gO65QZefKpKQRnfz6sD981Nm4B6U=
 github.com/tetratelabs/wabin v0.0.0-20230304001439-f6f874872834 h1:ZF+QBjOI+tILZjBaFj3HgFonKXUcwgJ4djLb6i42S3Q=
 github.com/tetratelabs/wabin v0.0.0-20230304001439-f6f874872834/go.mod h1:m9ymHTgNSEjuxvw8E7WWe4Pl4hZQHXONY8wE6dMLaRk=
 github.com/tetratelabs/wazero v1.9.0 h1:IcZ56OuxrtaEz8UYNRHBrUa9bYeX9oVY93KspZZBf/I=
 github.com/tetratelabs/wazero v1.9.0/go.mod h1:TSbcXCfFP0L2FGkRPxHphadXPjo1T6W+CseNNY7EkjM=
-github.com/urfave/cli/v3 v3.6.2 h1:lQuqiPrZ1cIz8hz+HcrG0TNZFxU70dPZ3Yl+pSrH9A8=
-github.com/urfave/cli/v3 v3.6.2/go.mod h1:ysVLtOEmg2tOy6PknnYVhDoouyC/6N42TMeoMzskhso=
+github.com/urfave/cli/v3 v3.7.0 h1:AGSnbUyjtLiM+WJUb4dzXKldl/gL+F8OwmRDtVr6g2U=
+github.com/urfave/cli/v3 v3.7.0/go.mod h1:ysVLtOEmg2tOy6PknnYVhDoouyC/6N42TMeoMzskhso=
 github.com/zaf/g711 v1.4.0 h1:XZYkjjiAg9QTBnHqEg37m2I9q3IIDv5JRYXs2N8ma7c=
 github.com/zaf/g711 v1.4.0/go.mod h1:eCDXt3dSp/kYYAoooba7ukD/Q75jvAaS4WOMr0l1Roo=
-gitlab.com/gomidi/midi/v2 v2.3.18 h1:sj2fOhtvOe+zI8YJe8qTxLw5zv0ntULLUDwcFOaZQbI=
-gitlab.com/gomidi/midi/v2 v2.3.18/go.mod h1:jDpP4O4skYi+7iVwt6Zyp18bd2M4hkjtMuw2cmgKgfw=
+gitlab.com/gomidi/midi/v2 v2.3.23 h1:P8NxV4EzV9c+BjpwTeB+G/qa+Xdq/UTazS2fKxY0O0g=
+gitlab.com/gomidi/midi/v2 v2.3.23/go.mod h1:jDpP4O4skYi+7iVwt6Zyp18bd2M4hkjtMuw2cmgKgfw=
 go.bug.st/serial v1.6.4 h1:7FmqNPgVp3pu2Jz5PoPtbZ9jJO5gnEnZIvnI1lzve8A=
 go.bug.st/serial v1.6.4/go.mod h1:nofMJxTeNVny/m6+KaafC6vJGj3miwQZ6vW4BZUGJPI=
-go.opentelemetry.io/proto/otlp v1.3.1 h1:TrMUixzpM0yuc/znrFTP9MMRh8trP93mkCiDVeXrui0=
-go.opentelemetry.io/proto/otlp v1.3.1/go.mod h1:0X1WI4de4ZsLrrJNLAQbFeLCm3T7yBkR0XqQ7niQU+8=
+go.opentelemetry.io/auto/sdk v1.2.1 h1:jXsnJ4Lmnqd11kwkBV2LgLoFMZKizbCi5fNZ/ipaZ64=
+go.opentelemetry.io/auto/sdk v1.2.1/go.mod h1:KRTj+aOaElaLi+wW1kO/DZRXwkF4C5xPbEe3ZiIhN7Y=
+go.opentelemetry.io/otel v1.41.0 h1:YlEwVsGAlCvczDILpUXpIpPSL/VPugt7zHThEMLce1c=
+go.opentelemetry.io/otel v1.41.0/go.mod h1:Yt4UwgEKeT05QbLwbyHXEwhnjxNO6D8L5PQP51/46dE=
+go.opentelemetry.io/otel/exporters/otlp/otlptrace v1.41.0 h1:ao6Oe+wSebTlQ1OEht7jlYTzQKE+pnx/iNywFvTbuuI=
+go.opentelemetry.io/otel/exporters/otlp/otlptrace v1.41.0/go.mod h1:u3T6vz0gh/NVzgDgiwkgLxpsSF6PaPmo2il0apGJbls=
+go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp v1.41.0 h1:inYW9ZhgqiDqh6BioM7DVHHzEGVq76Db5897WLGZ5Go=
+go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp v1.41.0/go.mod h1:Izur+Wt8gClgMJqO/cZ8wdeeMryJ/xxiOVgFSSfpDTY=
+go.opentelemetry.io/otel/metric v1.41.0 h1:rFnDcs4gRzBcsO9tS8LCpgR0dxg4aaxWlJxCno7JlTQ=
+go.opentelemetry.io/otel/metric v1.41.0/go.mod h1:xPvCwd9pU0VN8tPZYzDZV/BMj9CM9vs00GuBjeKhJps=
+go.opentelemetry.io/otel/sdk v1.41.0 h1:YPIEXKmiAwkGl3Gu1huk1aYWwtpRLeskpV+wPisxBp8=
+go.opentelemetry.io/otel/sdk v1.41.0/go.mod h1:ahFdU0G5y8IxglBf0QBJXgSe7agzjE4GiTJ6HT9ud90=
+go.opentelemetry.io/otel/sdk/metric v1.41.0 h1:siZQIYBAUd1rlIWQT2uCxWJxcCO7q3TriaMlf08rXw8=
+go.opentelemetry.io/otel/sdk/metric v1.41.0/go.mod h1:HNBuSvT7ROaGtGI50ArdRLUnvRTRGniSUZbxiWxSO8Y=
+go.opentelemetry.io/otel/trace v1.41.0 h1:Vbk2co6bhj8L59ZJ6/xFTskY+tGAbOnCtQGVVa9TIN0=
+go.opentelemetry.io/otel/trace v1.41.0/go.mod h1:U1NU4ULCoxeDKc09yCWdWe+3QoyweJcISEVa1RBzOis=
+go.opentelemetry.io/proto/otlp v1.9.0 h1:l706jCMITVouPOqEnii2fIAuO3IVGBRPV5ICjceRb/A=
+go.opentelemetry.io/proto/otlp v1.9.0/go.mod h1:xE+Cx5E/eEHw+ISFkwPLwCZefwVjY+pqKg1qcK03+/4=
+go.uber.org/goleak v1.3.0 h1:2K3zAYmnTNqV73imy9J1T3WC+gmCePx2hEGkimedGto=
+go.uber.org/goleak v1.3.0/go.mod h1:CoHD4mav9JJNrW/WLlf7HGZPjdw8EucARQHekz1X6bE=
 go.yaml.in/yaml/v2 v2.4.2 h1:DzmwEr2rDGHl7lsFgAHxmNz/1NlQ7xLIrlN2h5d1eGI=
 go.yaml.in/yaml/v2 v2.4.2/go.mod h1:081UH+NErpNdqlCXm3TtEran0rJZGxAYx9hb/ELlsPU=
-go.yaml.in/yaml/v3 v3.0.3 h1:bXOww4E/J3f66rav3pX3m8w6jDE4knZjGOw8b5Y6iNE=
-go.yaml.in/yaml/v3 v3.0.3/go.mod h1:tBHosrYAkRZjRAOREWbDnBXUf08JOwYq++0QNwQiWzI=
-golang.org/x/crypto v0.42.0 h1:chiH31gIWm57EkTXpwnqf8qeuMUi0yekh6mT2AvFlqI=
-golang.org/x/crypto v0.42.0/go.mod h1:4+rDnOTJhQCx2q7/j6rAN5XDw8kPjeaXEUR2eL94ix8=
+go.yaml.in/yaml/v3 v3.0.4 h1:tfq32ie2Jv2UxXFdLJdh3jXuOzWiL1fo0bu/FbuKpbc=
+go.yaml.in/yaml/v3 v3.0.4/go.mod h1:DhzuOOF2ATzADvBadXxruRBLzYTpT36CKvDb3+aBEFg=
+golang.org/x/crypto v0.48.0 h1:/VRzVqiRSggnhY7gNRxPauEQ5Drw9haKdM0jqfcCFts=
+golang.org/x/crypto v0.48.0/go.mod h1:r0kV5h3qnFPlQnBSrULhlsRfryS2pmewsg+XfMgkVos=
 golang.org/x/exp v0.0.0-20251023183803-a4bb9ffd2546 h1:mgKeJMpvi0yx/sU5GsxQ7p6s2wtOnGAHZWCHUM4KGzY=
 golang.org/x/exp v0.0.0-20251023183803-a4bb9ffd2546/go.mod h1:j/pmGrbnkbPtQfxEe5D0VQhZC6qKbfKifgD0oM7sR70=
-golang.org/x/mod v0.30.0 h1:fDEXFVZ/fmCKProc/yAXXUijritrDzahmwwefnjoPFk=
-golang.org/x/mod v0.30.0/go.mod h1:lAsf5O2EvJeSFMiBxXDki7sCgAxEUcZHXoXMKT4GJKc=
-golang.org/x/net v0.44.0 h1:evd8IRDyfNBMBTTY5XRF1vaZlD+EmWx6x8PkhR04H/I=
-golang.org/x/net v0.44.0/go.mod h1:ECOoLqd5U3Lhyeyo/QDCEVQ4sNgYsqvCZ722XogGieY=
+golang.org/x/mod v0.32.0 h1:9F4d3PHLljb6x//jOyokMv3eX+YDeepZSEo3mFJy93c=
+golang.org/x/mod v0.32.0/go.mod h1:SgipZ/3h2Ci89DlEtEXWUk/HteuRin+HHhN+WbNhguU=
+golang.org/x/net v0.50.0 h1:ucWh9eiCGyDR3vtzso0WMQinm2Dnt8cFMuQa9K33J60=
+golang.org/x/net v0.50.0/go.mod h1:UgoSli3F/pBgdJBHCTc+tp3gmrU4XswgGRgtnwWTfyM=
 golang.org/x/sync v0.19.0 h1:vV+1eWNmZ5geRlYjzm2adRgW2/mcpevXNg50YZtPCE4=
 golang.org/x/sync v0.19.0/go.mod h1:9KTHXmSnoGruLpwFjVSX0lNNA75CykiMECbovNTZqGI=
 golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
-golang.org/x/sys v0.39.0 h1:CvCKL8MeisomCi6qNZ+wbb0DN9E5AATixKsvNtMoMFk=
-golang.org/x/sys v0.39.0/go.mod h1:OgkHotnGiDImocRcuBABYBEXf8A9a87e/uXjp9XT3ks=
-golang.org/x/tools v0.38.0 h1:Hx2Xv8hISq8Lm16jvBZ2VQf+RLmbd7wVUsALibYI/IQ=
-golang.org/x/tools v0.38.0/go.mod h1:yEsQ/d/YK8cjh0L6rZlY8tgtlKiBNTL14pGDJPJpYQs=
-google.golang.org/protobuf v1.34.2 h1:6xV6lTsCfpGD21XK49h7MhtcApnLqkfYgPcdHftf6hg=
-google.golang.org/protobuf v1.34.2/go.mod h1:qYOHts0dSfpeUzUFpOMr/WGzszTmLH+DiWniOlNbLDw=
+golang.org/x/sys v0.21.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA=
+golang.org/x/sys v0.41.0 h1:Ivj+2Cp/ylzLiEU89QhWblYnOE9zerudt9Ftecq2C6k=
+golang.org/x/sys v0.41.0/go.mod h1:OgkHotnGiDImocRcuBABYBEXf8A9a87e/uXjp9XT3ks=
+golang.org/x/text v0.34.0 h1:oL/Qq0Kdaqxa1KbNeMKwQq0reLCCaFtqu2eNuSeNHbk=
+golang.org/x/text v0.34.0/go.mod h1:homfLqTYRFyVYemLBFl5GgL/DWEiH5wcsQ5gSh1yziA=
+golang.org/x/time v0.14.0 h1:MRx4UaLrDotUKUdCIqzPC48t1Y9hANFKIRpNx+Te8PI=
+golang.org/x/time v0.14.0/go.mod h1:eL/Oa2bBBK0TkX57Fyni+NgnyQQN4LitPmob2Hjnqw4=
+golang.org/x/tools v0.41.0 h1:a9b8iMweWG+S0OBnlU36rzLp20z1Rp10w+IY2czHTQc=
+golang.org/x/tools v0.41.0/go.mod h1:XSY6eDqxVNiYgezAVqqCeihT4j1U2CCsqvH3WhQpnlg=
+gonum.org/v1/gonum v0.16.0 h1:5+ul4Swaf3ESvrOnidPp4GZbzf0mxVQpDCYUQE7OJfk=
+gonum.org/v1/gonum v0.16.0/go.mod h1:fef3am4MQ93R2HHpKnLk4/Tbh/s0+wqD5nfa6Pnwy4E=
+google.golang.org/genproto/googleapis/api v0.0.0-20260209200024-4cfbd4190f57 h1:JLQynH/LBHfCTSbDWl+py8C+Rg/k1OVH3xfcaiANuF0=
+google.golang.org/genproto/googleapis/api v0.0.0-20260209200024-4cfbd4190f57/go.mod h1:kSJwQxqmFXeo79zOmbrALdflXQeAYcUbgS7PbpMknCY=
+google.golang.org/genproto/googleapis/rpc v0.0.0-20260209200024-4cfbd4190f57 h1:mWPCjDEyshlQYzBpMNHaEof6UX1PmHcaUODUywQ0uac=
+google.golang.org/genproto/googleapis/rpc v0.0.0-20260209200024-4cfbd4190f57/go.mod h1:j9x/tPzZkyxcgEFkiKEEGxfvyumM01BEtsW8xzOahRQ=
+google.golang.org/grpc v1.79.1 h1:zGhSi45ODB9/p3VAawt9a+O/MULLl9dpizzNNpq7flY=
+google.golang.org/grpc v1.79.1/go.mod h1:KmT0Kjez+0dde/v2j9vzwoAScgEPx/Bw1CYChhHLrHQ=
+google.golang.org/protobuf v1.36.11 h1:fV6ZwhNocDyBLK0dj+fg8ektcVegBBuEolpbTQyBNVE=
+google.golang.org/protobuf v1.36.11/go.mod h1:HTf+CrKn2C3g5S8VImy6tdcUvCska2kB7j23XfzDpco=
 gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
 gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c h1:Hei/4ADfdWqJk1ZMxUNpqntNwaWcugrBjAiHlqqRiVk=
 gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c/go.mod h1:JHkPIbrfpd72SG/EVd6muEfDQjcINNoR0C8j2r3qZ4Q=

internal/common/common.go

@@ -0,0 +1,22 @@
+package common
+
+import "context"
+
+type contextKey string
+
+const RouterContextKey contextKey = contextKey("router")
+const SourceContextKey contextKey = contextKey("source")
+const ModulesContextKey contextKey = contextKey("modules")
+const SenderContextKey contextKey = contextKey("sender")
+
+type RouteIO interface {
+	HandleInput(ctx context.Context, sourceId string, payload any) (bool, []RouteIOError)
+	HandleOutput(ctx context.Context, destinationId string, payload any) error
+}
+
+type RouteIOError struct {
+	Index        int
+	OutputError  error
+	ProcessError error
+	InputError   error
+}

internal/config/config.go

@@ -1,23 +1,281 @@
 package config
 
+import (
+	"errors"
+	"fmt"
+	"math"
+	"reflect"
+)
+
 type Config struct {
 	Modules []ModuleConfig `json:"modules"`
 	Routes  []RouteConfig  `json:"routes"`
 }
 
+type Params map[string]any
+
+var (
+	ErrParamNotFound   = errors.New("not found")
+	ErrParamNotString  = errors.New("not a string")
+	ErrParamNotNumber  = errors.New("not a number")
+	ErrParamNotInteger = errors.New("not an integer")
+	ErrParamNotBool    = errors.New("not a boolean")
+	ErrParamNotSlice   = errors.New("not a slice")
+)
+
+func (p Params) GetString(key string) (string, error) {
+	value, ok := p[key]
+	if !ok {
+		return "", ErrParamNotFound
+	}
+
+	stringValue, ok := value.(string)
+	if !ok {
+		return "", ErrParamNotString
+	}
+	return stringValue, nil
+}
+
+func (p Params) GetInt(key string) (int, error) {
+	value, ok := p[key]
+	if !ok {
+		return 0, ErrParamNotFound
+	}
+
+	intValue, ok := value.(int)
+	if ok {
+		return intValue, nil
+	}
+
+	uintValue, ok := value.(uint)
+	if ok {
+		return int(uintValue), nil
+	}
+
+	byteValue, ok := value.(byte)
+	if ok {
+		return int(byteValue), nil
+	}
+
+	floatValue, ok := value.(float64)
+	if ok {
+		if floatValue != math.Floor(floatValue) {
+			return 0, ErrParamNotInteger
+		}
+		return int(floatValue), nil
+	}
+
+	return 0, ErrParamNotNumber
+}
+
+func (p Params) GetFloat32(key string) (float32, error) {
+	value, ok := p[key]
+	if !ok {
+		return 0, ErrParamNotFound
+	}
+
+	float32Value, ok := value.(float32)
+	if ok {
+		return float32Value, nil
+	}
+
+	float64Value, ok := value.(float64)
+	if ok {
+		return float32(float64Value), nil
+	}
+
+	intValue, ok := value.(int)
+	if ok {
+		return float32(intValue), nil
+	}
+
+	uintValue, ok := value.(uint)
+	if ok {
+		return float32(uintValue), nil
+	}
+
+	byteValue, ok := value.(byte)
+	if ok {
+		return float32(byteValue), nil
+	}
+
+	return 0, ErrParamNotNumber
+}
+
+func (p Params) GetFloat64(key string) (float64, error) {
+	value, ok := p[key]
+	if !ok {
+		return 0, ErrParamNotFound
+	}
+
+	float64Value, ok := value.(float64)
+	if ok {
+		return float64Value, nil
+	}
+
+	float32Value, ok := value.(float32)
+	if ok {
+		return float64(float32Value), nil
+	}
+
+	intValue, ok := value.(int)
+	if ok {
+		return float64(intValue), nil
+	}
+
+	uintValue, ok := value.(uint)
+	if ok {
+		return float64(uintValue), nil
+	}
+
+	byteValue, ok := value.(byte)
+	if ok {
+		return float64(byteValue), nil
+	}
+
+	return 0, ErrParamNotNumber
+}
+
+func (p Params) GetBool(key string) (bool, error) {
+	value, ok := p[key]
+	if !ok {
+		return false, ErrParamNotFound
+	}
+
+	boolValue, ok := value.(bool)
+	if !ok {
+		return false, ErrParamNotBool
+	}
+	return boolValue, nil
+}
+
+func (p Params) GetStringSlice(key string) ([]string, error) {
+	value, ok := p[key]
+	if !ok {
+		return nil, ErrParamNotFound
+	}
+
+	interfaceSlice, ok := value.([]any)
+	if !ok {
+		return nil, ErrParamNotSlice
+	}
+
+	stringSlice := make([]string, len(interfaceSlice))
+	for i, v := range interfaceSlice {
+		str, ok := v.(string)
+		if !ok {
+			return nil, fmt.Errorf("element at index %d is not a string", i)
+		}
+		stringSlice[i] = str
+	}
+	return stringSlice, nil
+}
+
+func (p Params) GetIntSlice(key string) ([]int, error) {
+	value, ok := p[key]
+	if !ok {
+		return nil, ErrParamNotFound
+	}
+
+	v := reflect.ValueOf(value)
+	if v.Kind() != reflect.Slice {
+		return nil, ErrParamNotSlice
+	}
+
+	result := make([]int, v.Len())
+	for i := 0; i < v.Len(); i++ {
+		elem := v.Index(i).Interface()
+		byteValue, ok := elem.(byte)
+		if ok {
+			result[i] = int(byteValue)
+			continue
+		}
+		uintValue, ok := elem.(uint)
+		if ok {
+			result[i] = int(uintValue)
+			continue
+		}
+		intValue, ok := elem.(int)
+		if ok {
+			result[i] = int(intValue)
+			continue
+		}
+		floatValue, ok := elem.(float64)
+		if ok {
+			if floatValue != math.Floor(floatValue) {
+				return nil, fmt.Errorf("element at index %d is not an integer", i)
+			}
+			result[i] = int(floatValue)
+			continue
+		}
+		return nil, fmt.Errorf("element at index %d is not a number", i)
+	}
+	return result, nil
+}
+
+func (p Params) GetByteSlice(key string) ([]byte, error) {
+	value, ok := p[key]
+	if !ok {
+		return nil, ErrParamNotFound
+	}
+
+	v := reflect.ValueOf(value)
+	if v.Kind() != reflect.Slice {
+		return nil, ErrParamNotSlice
+	}
+
+	result := make([]byte, v.Len())
+	for i := 0; i < v.Len(); i++ {
+		elem := v.Index(i).Interface()
+		byteValue, ok := elem.(byte)
+		if ok {
+			result[i] = byteValue
+			continue
+		}
+		uintValue, ok := elem.(uint)
+		if ok {
+			if uintValue > 255 {
+				return nil, fmt.Errorf("element at index %d is out of byte range", i)
+			}
+			result[i] = byte(uintValue)
+			continue
+		}
+		intValue, ok := elem.(int)
+		if ok {
+			if intValue < 0 || intValue > 255 {
+				return nil, fmt.Errorf("element at index %d is out of byte range", i)
+			}
+			result[i] = byte(intValue)
+			continue
+		}
+		floatValue, ok := elem.(float64)
+		if ok {
+			if floatValue != math.Floor(floatValue) {
+				return nil, fmt.Errorf("element at index %d is not an integer", i)
+			}
+			if floatValue < 0 || floatValue > 255 {
+				return nil, fmt.Errorf("element at index %d is out of byte range", i)
+			}
+			result[i] = byte(floatValue)
+			continue
+		}
+		return nil, fmt.Errorf("element at index %d is not a number", i)
+	}
+	return result, nil
+}
+
 type ModuleConfig struct {
 	Id     string `json:"id"`
 	Type   string `json:"type"`
-	Params map[string]any `json:"params"`
+	Params Params `json:"params"`
 }
 
 type RouteConfig struct {
 	Input      string            `json:"input"`
 	Processors []ProcessorConfig `json:"processors"`
-	Output     string            `json:"output"`
 }
 
 type ProcessorConfig struct {
 	Type   string `json:"type"`
-	Params map[string]any `json:"params"`
+	Params Params `json:"params"`
 }

internal/config/config_test.go

@@ -0,0 +1,297 @@
+package config_test
+
+import (
+	"encoding/json"
+	"slices"
+	"testing"
+
+	"github.com/jwetzell/showbridge-go/internal/config"
+)
+
+func TestGoodStringParamsJSON(t *testing.T) {
+	testCases := []struct {
+		name       string
+		paramsJSON string
+		key        string
+		expected   string
+	}{
+		{
+			name:       "string param",
+			paramsJSON: `{"key": "value"}`,
+			key:        "key",
+			expected:   "value",
+		},
+	}
+
+	for _, testCase := range testCases {
+		t.Run(testCase.name, func(t *testing.T) {
+			params := config.Params{}
+			err := json.Unmarshal([]byte(testCase.paramsJSON), &params)
+			if err != nil {
+				t.Fatalf("Failed to unmarshal params JSON: %v", err)
+			}
+			value, err := params.GetString(testCase.key)
+			if err != nil {
+				t.Fatalf("GetString returned error: %v", err)
+			}
+			if value != testCase.expected {
+				t.Fatalf("GetString	 got %s, expected %s", value, testCase.expected)
+			}
+		})
+	}
+}
+
+func TestGoodIntParamsJSON(t *testing.T) {
+	testCases := []struct {
+		name       string
+		paramsJSON string
+		key        string
+		expected   int
+	}{
+		{
+			name:       "int param",
+			paramsJSON: `{"key": 1}`,
+			key:        "key",
+			expected:   1,
+		},
+	}
+
+	for _, testCase := range testCases {
+		t.Run(testCase.name, func(t *testing.T) {
+			params := config.Params{}
+			err := json.Unmarshal([]byte(testCase.paramsJSON), &params)
+			if err != nil {
+				t.Fatalf("Failed to unmarshal params JSON: %v", err)
+			}
+			value, err := params.GetInt(testCase.key)
+			if err != nil {
+				t.Fatalf("GetInt returned error: %v", err)
+			}
+			if value != testCase.expected {
+				t.Fatalf("GetInt got %d, expected %d", value, testCase.expected)
+			}
+		})
+	}
+}
+
+func TestGoodFloat32ParamsJSON(t *testing.T) {
+	testCases := []struct {
+		name       string
+		paramsJSON string
+		key        string
+		expected   float32
+	}{
+		{
+			name:       "no decimal param",
+			paramsJSON: `{"key": 1}`,
+			key:        "key",
+			expected:   1,
+		},
+		{
+			name:       "float param",
+			paramsJSON: `{"key": 1.23}`,
+			key:        "key",
+			expected:   1.23,
+		},
+	}
+
+	for _, testCase := range testCases {
+		t.Run(testCase.name, func(t *testing.T) {
+			params := config.Params{}
+			err := json.Unmarshal([]byte(testCase.paramsJSON), &params)
+			if err != nil {
+				t.Fatalf("Failed to unmarshal params JSON: %v", err)
+			}
+			value, err := params.GetFloat32(testCase.key)
+			if err != nil {
+				t.Fatalf("GetFloat32 returned error: %v", err)
+			}
+			if value != testCase.expected {
+				t.Fatalf("GetFloat32 got %f, expected %f", value, testCase.expected)
+			}
+		})
+	}
+}
+
+func TestGoodFloat64ParamsJSON(t *testing.T) {
+	testCases := []struct {
+		name       string
+		paramsJSON string
+		key        string
+		expected   float64
+	}{
+		{
+			name:       "no decimal param",
+			paramsJSON: `{"key": 1}`,
+			key:        "key",
+			expected:   1,
+		},
+		{
+			name:       "float param",
+			paramsJSON: `{"key": 1.23}`,
+			key:        "key",
+			expected:   1.23,
+		},
+	}
+
+	for _, testCase := range testCases {
+		t.Run(testCase.name, func(t *testing.T) {
+			params := config.Params{}
+			err := json.Unmarshal([]byte(testCase.paramsJSON), &params)
+			if err != nil {
+				t.Fatalf("Failed to unmarshal params JSON: %v", err)
+			}
+			value, err := params.GetFloat64(testCase.key)
+			if err != nil {
+				t.Fatalf("GetFloat64 returned error: %v", err)
+			}
+			if value != testCase.expected {
+				t.Fatalf("GetFloat64 got %f, expected %f", value, testCase.expected)
+			}
+		})
+	}
+}
+
+func TestGoodBoolParamsJSON(t *testing.T) {
+	testCases := []struct {
+		name       string
+		paramsJSON string
+		key        string
+		expected   bool
+	}{
+		{
+			name:       "bool param",
+			paramsJSON: `{"key": true}`,
+			key:        "key",
+			expected:   true,
+		},
+	}
+
+	for _, testCase := range testCases {
+		t.Run(testCase.name, func(t *testing.T) {
+			params := config.Params{}
+			err := json.Unmarshal([]byte(testCase.paramsJSON), &params)
+			if err != nil {
+				t.Fatalf("Failed to unmarshal params JSON: %v", err)
+			}
+			value, err := params.GetBool(testCase.key)
+			if err != nil {
+				t.Fatalf("GetBool returned error: %v", err)
+			}
+			if value != testCase.expected {
+				t.Fatalf("GetBool got %t, expected %t", value, testCase.expected)
+			}
+		})
+	}
+}
+
+func TestGoodStringSliceParamsJSON(t *testing.T) {
+	testCases := []struct {
+		name       string
+		paramsJSON string
+		key        string
+		expected   []string
+	}{
+		{
+			name:       "string array",
+			paramsJSON: `{"key": ["value1", "value2"]}`,
+			key:        "key",
+			expected:   []string{"value1", "value2"},
+		},
+	}
+
+	for _, testCase := range testCases {
+		t.Run(testCase.name, func(t *testing.T) {
+			params := config.Params{}
+			err := json.Unmarshal([]byte(testCase.paramsJSON), &params)
+			if err != nil {
+				t.Fatalf("Failed to unmarshal params JSON: %v", err)
+			}
+			value, err := params.GetStringSlice(testCase.key)
+			if err != nil {
+				t.Fatalf("GetStringSlice returned error: %v", err)
+			}
+			if !slices.Equal(value, testCase.expected) {
+				t.Fatalf("GetStringSlice got %v, expected %v", value, testCase.expected)
+			}
+		})
+	}
+}
+
+func TestGoodIntSliceParamsJSON(t *testing.T) {
+	testCases := []struct {
+		name       string
+		paramsJSON string
+		key        string
+		expected   []int
+	}{
+		{
+			name:       "int array",
+			paramsJSON: `{"key": [1, 2, 3]}`,
+			key:        "key",
+			expected:   []int{1, 2, 3},
+		},
+		{
+			name:       "int array with floats",
+			paramsJSON: `{"key": [1.0, 2.0, 3.0]}`,
+			key:        "key",
+			expected:   []int{1, 2, 3},
+		},
+	}
+
+	for _, testCase := range testCases {
+		t.Run(testCase.name, func(t *testing.T) {
+			params := config.Params{}
+			err := json.Unmarshal([]byte(testCase.paramsJSON), &params)
+			if err != nil {
+				t.Fatalf("Failed to unmarshal params JSON: %v", err)
+			}
+			value, err := params.GetIntSlice(testCase.key)
+			if err != nil {
+				t.Fatalf("GetIntSlice returned error: %v", err)
+			}
+			if !slices.Equal(value, testCase.expected) {
+				t.Fatalf("GetIntSlice got %v, expected %v", value, testCase.expected)
+			}
+		})
+	}
+}
+
+func TestGoodByteSliceParamsJSON(t *testing.T) {
+	testCases := []struct {
+		name       string
+		paramsJSON string
+		key        string
+		expected   []byte
+	}{
+		{
+			name:       "byte array",
+			paramsJSON: `{"key": [1,2,3,4]}`,
+			key:        "key",
+			expected:   []byte{1, 2, 3, 4},
+		},
+		{
+			name:       "byte array with floats",
+			paramsJSON: `{"key": [1.0,2.0,3.0,4.0]}`,
+			key:        "key",
+			expected:   []byte{1, 2, 3, 4},
+		},
+	}
+
+	for _, testCase := range testCases {
+		t.Run(testCase.name, func(t *testing.T) {
+			params := config.Params{}
+			err := json.Unmarshal([]byte(testCase.paramsJSON), &params)
+			if err != nil {
+				t.Fatalf("Failed to unmarshal params JSON: %v", err)
+			}
+			value, err := params.GetByteSlice(testCase.key)
+			if err != nil {
+				t.Fatalf("GetByteSlice returned error: %v", err)
+			}
+			if !slices.Equal(value, testCase.expected) {
+				t.Fatalf("GetByteSlice got %v, expected %v", value, testCase.expected)
+			}
+		})
+	}
+}

internal/module/http-client.go

@@ -1,81 +0,0 @@
-package module
-
-import (
-	"context"
-	"errors"
-	"log/slog"
-	"net/http"
-	"time"
-
-	"github.com/jwetzell/showbridge-go/internal/config"
-	"github.com/jwetzell/showbridge-go/internal/route"
-)
-
-type HTTPClient struct {
-	config config.ModuleConfig
-	ctx    context.Context
-	client *http.Client
-	router route.RouteIO
-	logger *slog.Logger
-}
-
-func init() {
-	RegisterModule(ModuleRegistration{
-		Type: "http.client",
-		New: func(config config.ModuleConfig) (Module, error) {
-
-			return &HTTPClient{config: config, logger: CreateLogger(config)}, nil
-		},
-	})
-}
-
-func (hc *HTTPClient) Id() string {
-	return hc.config.Id
-}
-
-func (hc *HTTPClient) Type() string {
-	return hc.config.Type
-}
-
-func (hc *HTTPClient) Run(ctx context.Context) error {
-	router, ok := ctx.Value(route.RouterContextKey).(route.RouteIO)
-
-	if !ok {
-		return errors.New("http.client unable to get router from context")
-	}
-	hc.router = router
-	hc.ctx = ctx
-
-	hc.client = &http.Client{
-		Timeout: 10 * time.Second,
-	}
-
-	<-hc.ctx.Done()
-	hc.logger.Debug("done")
-	return nil
-}
-
-func (hc *HTTPClient) Output(ctx context.Context, payload any) error {
-
-	payloadRequest, ok := payload.(*http.Request)
-
-	if !ok {
-		return errors.New("http.client is only able to output an http.Request")
-	}
-
-	if hc.client == nil {
-		return errors.New("http.client client is nil")
-	}
-
-	response, err := hc.client.Do(payloadRequest)
-
-	if err != nil {
-		return err
-	}
-
-	if hc.router != nil {
-		hc.router.HandleInput(hc.ctx, hc.Id(), response)
-	}
-
-	return nil
-}

internal/module/http-server.go

@@ -6,24 +6,26 @@ import (
 	"errors"
 	"fmt"
 	"log/slog"
+	"net"
 	"net/http"
 
+	"github.com/jwetzell/showbridge-go/internal/common"
 	"github.com/jwetzell/showbridge-go/internal/config"
 	"github.com/jwetzell/showbridge-go/internal/processor"
-	"github.com/jwetzell/showbridge-go/internal/route"
 )
 
 type HTTPServer struct {
 	config config.ModuleConfig
 	Port   uint16
 	ctx    context.Context
-	router route.RouteIO
+	router common.RouteIO
 	logger *slog.Logger
+	cancel context.CancelFunc
 }
 
 type ResponseIOError struct {
 	Index        int     `json:"index"`
-	OutputErrors []string `json:"outputErrors"`
+	OutputError  *string `json:"outputError"`
 	ProcessError *string `json:"processError"`
 	InputError   *string `json:"inputError"`
 }
@@ -56,17 +58,10 @@ func init() {
 		Type: "http.server",
 		New: func(config config.ModuleConfig) (Module, error) {
 			params := config.Params
-			port, ok := params["port"]
-			if !ok {
-				return nil, errors.New("http.server requires a port parameter")
+			portNum, err := params.GetInt("port")
+			if err != nil {
+				return nil, fmt.Errorf("http.server port error: %w", err)
 			}
-
-			portNum, ok := port.(float64)
-
-			if !ok {
-				return nil, errors.New("http.server port must be uint16")
-			}
-
 			return &HTTPServer{Port: uint16(portNum), config: config, logger: CreateLogger(config)}, nil
 		},
 	})
@@ -89,6 +84,10 @@ func (hs *HTTPServer) ServeHTTP(w http.ResponseWriter, r *http.Request) {
 	}
 	if hs.router != nil {
 		inputContext := context.WithValue(hs.ctx, httpServerContextKey("responseWriter"), &responseWriter)
+		senderAddr, err := net.ResolveTCPAddr("tcp", r.RemoteAddr)
+		if err == nil {
+			inputContext = context.WithValue(inputContext, common.SenderContextKey, senderAddr)
+		}
 		aRouteFound, routingErrors := hs.router.HandleInput(inputContext, hs.Id(), r)
 		if !responseWriter.done {
 			if aRouteFound {
@@ -113,14 +112,9 @@ func (hs *HTTPServer) ServeHTTP(w http.ResponseWriter, r *http.Request) {
 							errorToAdd.ProcessError = &errorMsg
 						}
 
-						if responseIOError.OutputErrors != nil {
-							outputErrorMsgs := []string{}
-
-							for _, outputError := range responseIOError.OutputErrors {
-								outputErrorMsgs = append(outputErrorMsgs, outputError.Error())
-							}
-
-							errorToAdd.OutputErrors = outputErrorMsgs
+						if responseIOError.OutputError != nil {
+							errorMsg := responseIOError.OutputError.Error()
+							errorToAdd.OutputError = &errorMsg
 						}
 
 						response.IOErrors = append(response.IOErrors, errorToAdd)
@@ -151,14 +145,17 @@ func (hs *HTTPServer) ServeHTTP(w http.ResponseWriter, r *http.Request) {
 	}
 }
 
-func (hs *HTTPServer) Run(ctx context.Context) error {
-	router, ok := ctx.Value(route.RouterContextKey).(route.RouteIO)
+func (hs *HTTPServer) Start(ctx context.Context) error {
+	hs.logger.Debug("running")
+	router, ok := ctx.Value(common.RouterContextKey).(common.RouteIO)
 
 	if !ok {
 		return errors.New("http.server unable to get router from context")
 	}
 	hs.router = router
-	hs.ctx = ctx
+	moduleContext, cancel := context.WithCancel(ctx)
+	hs.ctx = moduleContext
+	hs.cancel = cancel
 
 	httpServer := &http.Server{
 		Addr:    fmt.Sprintf(":%d", hs.Port),
@@ -190,7 +187,7 @@ func (hs *HTTPServer) Output(ctx context.Context, payload any) error {
 		return errors.New("http.server output must originate from an http.server input")
 	}
 
-	payloadResponse, ok := payload.(processor.HTTPResponse)
+	payloadResponse, ok := processor.GetAnyAs[processor.HTTPResponse](payload)
 
 	if !ok {
 		return errors.New("http.server is only able to output HTTPResponse")
@@ -204,3 +201,11 @@ func (hs *HTTPServer) Output(ctx context.Context, payload any) error {
 	responseWriter.Write(payloadResponse.Body)
 	return nil
 }
+
+func (hs *HTTPServer) Stop() {
+	hs.cancel()
+}
+
+func (hs *HTTPServer) Get(key string) (any, error) {
+	return nil, errors.New("http.server does not support Get")
+}

internal/module/midi-input.go

@@ -8,8 +8,8 @@ import (
 	"fmt"
 	"log/slog"
 
+	"github.com/jwetzell/showbridge-go/internal/common"
 	"github.com/jwetzell/showbridge-go/internal/config"
-	"github.com/jwetzell/showbridge-go/internal/route"
 	"gitlab.com/gomidi/midi/v2"
 	_ "gitlab.com/gomidi/midi/v2/drivers/rtmididrv"
 )
@@ -17,10 +17,11 @@ import (
 type MIDIInput struct {
 	config   config.ModuleConfig
 	ctx      context.Context
-	router   route.RouteIO
+	router   common.RouteIO
 	Port     string
 	SendFunc func(midi.Message) error
 	logger   *slog.Logger
+	cancel   context.CancelFunc
 }
 
 func init() {
@@ -28,16 +29,9 @@ func init() {
 		Type: "midi.input",
 		New: func(config config.ModuleConfig) (Module, error) {
 			params := config.Params
-			port, ok := params["port"]
-
-			if !ok {
-				return nil, errors.New("midi.input requires a port parameter")
-			}
-
-			portString, ok := port.(string)
-
-			if !ok {
-				return nil, errors.New("midi.input port must be a string")
+			portString, err := params.GetString("port")
+			if err != nil {
+				return nil, fmt.Errorf("midi.input port error: %w", err)
 			}
 
 			return &MIDIInput{config: config, Port: portString, logger: CreateLogger(config)}, nil
@@ -53,15 +47,18 @@ func (mi *MIDIInput) Type() string {
 	return mi.config.Type
 }
 
-func (mi *MIDIInput) Run(ctx context.Context) error {
+func (mi *MIDIInput) Start(ctx context.Context) error {
+	mi.logger.Debug("running")
 	defer midi.CloseDriver()
-	router, ok := ctx.Value(route.RouterContextKey).(route.RouteIO)
+	router, ok := ctx.Value(common.RouterContextKey).(common.RouteIO)
 
 	if !ok {
 		return errors.New("midi.input unable to get router from context")
 	}
 	mi.router = router
-	mi.ctx = ctx
+	moduleContext, cancel := context.WithCancel(ctx)
+	mi.ctx = moduleContext
+	mi.cancel = cancel
 
 	in, err := midi.FindInPort(mi.Port)
 	if err != nil {
@@ -88,3 +85,16 @@ func (mi *MIDIInput) Run(ctx context.Context) error {
 func (mi *MIDIInput) Output(ctx context.Context, payload any) error {
 	return errors.New("midi.input output is not implemented")
 }
+
+func (mi *MIDIInput) Stop() {
+	mi.cancel()
+}
+
+func (mi *MIDIInput) Get(key string) (any, error) {
+	switch key {
+	case "port":
+		return mi.Port, nil
+	default:
+		return nil, errors.New("midi.input key not found")
+	}
+}

internal/module/midi-output.go

@@ -8,8 +8,9 @@ import (
 	"fmt"
 	"log/slog"
 
+	"github.com/jwetzell/showbridge-go/internal/common"
 	"github.com/jwetzell/showbridge-go/internal/config"
-	"github.com/jwetzell/showbridge-go/internal/route"
+	"github.com/jwetzell/showbridge-go/internal/processor"
 	"gitlab.com/gomidi/midi/v2"
 	_ "gitlab.com/gomidi/midi/v2/drivers/rtmididrv"
 )
@@ -17,10 +18,11 @@ import (
 type MIDIOutput struct {
 	config   config.ModuleConfig
 	ctx      context.Context
-	router   route.RouteIO
+	router   common.RouteIO
 	Port     string
 	SendFunc func(midi.Message) error
 	logger   *slog.Logger
+	cancel   context.CancelFunc
 }
 
 func init() {
@@ -29,16 +31,9 @@ func init() {
 		New: func(config config.ModuleConfig) (Module, error) {
 			params := config.Params
 
-			port, ok := params["port"]
-
-			if !ok {
-				return nil, errors.New("midi.output requires a port parameter")
-			}
-
-			portString, ok := port.(string)
-
-			if !ok {
-				return nil, errors.New("midi.output port must be a string")
+			portString, err := params.GetString("port")
+			if err != nil {
+				return nil, fmt.Errorf("midi.output port error: %w", err)
 			}
 
 			return &MIDIOutput{config: config, Port: portString, logger: CreateLogger(config)}, nil
@@ -54,15 +49,18 @@ func (mo *MIDIOutput) Type() string {
 	return mo.config.Type
 }
 
-func (mo *MIDIOutput) Run(ctx context.Context) error {
+func (mo *MIDIOutput) Start(ctx context.Context) error {
+	mo.logger.Debug("running")
 	defer midi.CloseDriver()
-	router, ok := ctx.Value(route.RouterContextKey).(route.RouteIO)
+	router, ok := ctx.Value(common.RouterContextKey).(common.RouteIO)
 
 	if !ok {
 		return errors.New("midi.output unable to get router from context")
 	}
 	mo.router = router
-	mo.ctx = ctx
+	moduleContext, cancel := context.WithCancel(ctx)
+	mo.ctx = moduleContext
+	mo.cancel = cancel
 
 	out, err := midi.FindOutPort(mo.Port)
 
@@ -87,7 +85,7 @@ func (mo *MIDIOutput) Output(ctx context.Context, payload any) error {
 		return errors.New("midi.output output is not setup")
 	}
 
-	payloadMessage, ok := payload.(midi.Message)
+	payloadMessage, ok := processor.GetAnyAs[midi.Message](payload)
 
 	if !ok {
 		return errors.New("midi.output can only ouptut midi.Message")
@@ -95,3 +93,16 @@ func (mo *MIDIOutput) Output(ctx context.Context, payload any) error {
 
 	return mo.SendFunc(payloadMessage)
 }
+
+func (mo *MIDIOutput) Stop() {
+	mo.cancel()
+}
+
+func (mo *MIDIOutput) Get(key string) (any, error) {
+	switch key {
+	case "port":
+		return mo.Port, nil
+	default:
+		return nil, errors.New("midi.output key not found")
+	}
+}

internal/module/module.go

@@ -18,8 +18,10 @@ type ModuleError struct {
 type Module interface {
 	Id() string
 	Type() string
-	Run(context.Context) error
+	Start(context.Context) error
+	Stop()
 	Output(context.Context, any) error
+	Get(key string) (any, error)
 }
 
 type ModuleRegistration struct {

internal/module/mqtt-client.go

@@ -3,22 +3,25 @@ package module
 import (
 	"context"
 	"errors"
+	"fmt"
 	"log/slog"
 
 	mqtt "github.com/eclipse/paho.mqtt.golang"
+	"github.com/jwetzell/showbridge-go/internal/common"
 	"github.com/jwetzell/showbridge-go/internal/config"
-	"github.com/jwetzell/showbridge-go/internal/route"
+	"github.com/jwetzell/showbridge-go/internal/processor"
 )
 
 type MQTTClient struct {
 	config   config.ModuleConfig
 	ctx      context.Context
-	router   route.RouteIO
+	router   common.RouteIO
 	Broker   string
 	ClientID string
 	Topic    string
 	client   mqtt.Client
 	logger   *slog.Logger
+	cancel   context.CancelFunc
 }
 
 func init() {
@@ -26,40 +29,22 @@ func init() {
 		Type: "mqtt.client",
 		New: func(config config.ModuleConfig) (Module, error) {
 			params := config.Params
-			broker, ok := params["broker"]
+			brokerString, err := params.GetString("broker")
 
-			if !ok {
-				return nil, errors.New("mqtt.client requires a broker parameter")
+			if err != nil {
+				return nil, fmt.Errorf("mqtt.client broker error: %w", err)
 			}
 
-			brokerString, ok := broker.(string)
+			topicString, err := params.GetString("topic")
 
-			if !ok {
-				return nil, errors.New("mqtt.client broker must be string")
+			if err != nil {
+				return nil, fmt.Errorf("mqtt.client topic error: %w", err)
 			}
 
-			topic, ok := params["topic"]
+			clientIdString, err := params.GetString("clientId")
 
-			if !ok {
-				return nil, errors.New("mqtt.client requires a topic parameter")
-			}
-
-			topicString, ok := topic.(string)
-
-			if !ok {
-				return nil, errors.New("mqtt.client topic must be string")
-			}
-
-			clientId, ok := params["clientId"]
-
-			if !ok {
-				return nil, errors.New("mqtt.client requires a clientId parameter")
-			}
-
-			clientIdString, ok := clientId.(string)
-
-			if !ok {
-				return nil, errors.New("mqtt.client clientId must be string")
+			if err != nil {
+				return nil, fmt.Errorf("mqtt.client clientId error: %w", err)
 			}
 
 			return &MQTTClient{config: config, Broker: brokerString, Topic: topicString, ClientID: clientIdString, logger: CreateLogger(config)}, nil
@@ -75,14 +60,17 @@ func (mc *MQTTClient) Type() string {
 	return mc.config.Type
 }
 
-func (mc *MQTTClient) Run(ctx context.Context) error {
-	router, ok := ctx.Value(route.RouterContextKey).(route.RouteIO)
+func (mc *MQTTClient) Start(ctx context.Context) error {
+	mc.logger.Debug("running")
+	router, ok := ctx.Value(common.RouterContextKey).(common.RouteIO)
 
 	if !ok {
 		return errors.New("mqtt.client unable to get router from context")
 	}
 	mc.router = router
-	mc.ctx = ctx
+	moduleContext, cancel := context.WithCancel(ctx)
+	mc.ctx = moduleContext
+	mc.cancel = cancel
 
 	opts := mqtt.NewClientOptions()
 	opts.AddBroker(mc.Broker)
@@ -98,6 +86,7 @@ func (mc *MQTTClient) Run(ctx context.Context) error {
 	}
 
 	mc.client = mqtt.NewClient(opts)
+	defer mc.client.Disconnect(250)
 
 	token := mc.client.Connect()
 
@@ -113,7 +102,7 @@ func (mc *MQTTClient) Run(ctx context.Context) error {
 }
 
 func (mc *MQTTClient) Output(ctx context.Context, payload any) error {
-	payloadMessage, ok := payload.(mqtt.Message)
+	payloadMessage, ok := processor.GetAnyAs[mqtt.Message](payload)
 
 	if !ok {
 		return errors.New("mqtt.client is only able to output a MQTTMessage")
@@ -133,3 +122,11 @@ func (mc *MQTTClient) Output(ctx context.Context, payload any) error {
 
 	return token.Error()
 }
+
+func (mc *MQTTClient) Stop() {
+	mc.cancel()
+}
+
+func (mc *MQTTClient) Get(key string) (any, error) {
+	return nil, errors.New("mqtt.client does not support Get")
+}

internal/module/nats-client.go

@@ -5,20 +5,21 @@ import (
 	"errors"
 	"log/slog"
 
+	"github.com/jwetzell/showbridge-go/internal/common"
 	"github.com/jwetzell/showbridge-go/internal/config"
 	"github.com/jwetzell/showbridge-go/internal/processor"
-	"github.com/jwetzell/showbridge-go/internal/route"
 	"github.com/nats-io/nats.go"
 )
 
 type NATSClient struct {
 	config  config.ModuleConfig
 	ctx     context.Context
-	router  route.RouteIO
+	router  common.RouteIO
 	URL     string
 	Subject string
 	client  *nats.Conn
 	logger  *slog.Logger
+	cancel  context.CancelFunc
 }
 
 func init() {
@@ -26,28 +27,15 @@ func init() {
 		Type: "nats.client",
 		New: func(config config.ModuleConfig) (Module, error) {
 			params := config.Params
-			url, ok := params["url"]
-
-			if !ok {
-				return nil, errors.New("nats.client requires a url parameter")
+			urlString, err := params.GetString("url")
+			if err != nil {
+				return nil, errors.New("nats.client url error: " + err.Error())
 			}
 
-			urlString, ok := url.(string)
+			subjectString, err := params.GetString("subject")
 
-			if !ok {
-				return nil, errors.New("nats.client url must be string")
-			}
-
-			subject, ok := params["subject"]
-
-			if !ok {
-				return nil, errors.New("nats.client requires a subject parameter")
-			}
-
-			subjectString, ok := subject.(string)
-
-			if !ok {
-				return nil, errors.New("nats.client subject must be string")
+			if err != nil {
+				return nil, errors.New("nats.client subject error: " + err.Error())
 			}
 
 			return &NATSClient{config: config, URL: urlString, Subject: subjectString, logger: CreateLogger(config)}, nil
@@ -63,15 +51,18 @@ func (nc *NATSClient) Type() string {
 	return nc.config.Type
 }
 
-func (nc *NATSClient) Run(ctx context.Context) error {
-	router, ok := ctx.Value(route.RouterContextKey).(route.RouteIO)
+func (nc *NATSClient) Start(ctx context.Context) error {
+	nc.logger.Debug("running")
+	router, ok := ctx.Value(common.RouterContextKey).(common.RouteIO)
 
 	if !ok {
 		return errors.New("nats.client unable to get router from context")
 	}
 
 	nc.router = router
-	nc.ctx = ctx
+	moduleContext, cancel := context.WithCancel(ctx)
+	nc.ctx = moduleContext
+	nc.cancel = cancel
 
 	client, err := nats.Connect(nc.URL, nats.RetryOnFailedConnect(true))
 
@@ -103,7 +94,7 @@ func (nc *NATSClient) Run(ctx context.Context) error {
 
 func (nc *NATSClient) Output(ctx context.Context, payload any) error {
 
-	payloadMessage, ok := payload.(processor.NATSMessage)
+	payloadMessage, ok := processor.GetAnyAs[processor.NATSMessage](payload)
 
 	if !ok {
 		return errors.New("nats.client is only able to output NATSMessage")
@@ -121,3 +112,11 @@ func (nc *NATSClient) Output(ctx context.Context, payload any) error {
 
 	return err
 }
+
+func (nc *NATSClient) Stop() {
+	nc.cancel()
+}
+
+func (nc *NATSClient) Get(key string) (any, error) {
+	return nil, errors.New("nats.client does not support Get")
+}

internal/module/nats-server.go

@@ -0,0 +1,118 @@
+package module
+
+import (
+	"context"
+	"errors"
+	"fmt"
+	"log/slog"
+	"net"
+	"time"
+
+	"github.com/jwetzell/showbridge-go/internal/common"
+	"github.com/jwetzell/showbridge-go/internal/config"
+	"github.com/nats-io/nats-server/v2/server"
+)
+
+type NATSServer struct {
+	config config.ModuleConfig
+	ctx    context.Context
+	Ip     string
+	Port   int
+	router common.RouteIO
+	server *server.Server
+	logger *slog.Logger
+	cancel context.CancelFunc
+}
+
+func init() {
+	RegisterModule(ModuleRegistration{
+		Type: "nats.server",
+		New: func(moduleConfig config.ModuleConfig) (Module, error) {
+			params := moduleConfig.Params
+			portNum, err := params.GetInt("port")
+			if err != nil {
+				if errors.Is(err, config.ErrParamNotFound) {
+					portNum = 4222
+				} else {
+					return nil, fmt.Errorf("nats.server port error: %w", err)
+				}
+			}
+
+			ipString, err := params.GetString("ip")
+			if err != nil {
+				if errors.Is(err, config.ErrParamNotFound) {
+					ipString = "0.0.0.0"
+				} else {
+					return nil, fmt.Errorf("nats.server ip error: %w", err)
+				}
+			}
+
+			_, err = net.ResolveTCPAddr("tcp", fmt.Sprintf("%s:%d", ipString, uint16(portNum)))
+			if err != nil {
+				return nil, err
+			}
+			return &NATSServer{config: moduleConfig, logger: CreateLogger(moduleConfig), Ip: ipString, Port: portNum}, nil
+		},
+	})
+}
+
+func (ns *NATSServer) Id() string {
+	return ns.config.Id
+}
+
+func (ns *NATSServer) Type() string {
+	return ns.config.Type
+}
+
+func (ns *NATSServer) Start(ctx context.Context) error {
+	ns.logger.Debug("running")
+	router, ok := ctx.Value(common.RouterContextKey).(common.RouteIO)
+
+	if !ok {
+		return errors.New("nats.server unable to get router from context")
+	}
+
+	ns.router = router
+	moduleContext, cancel := context.WithCancel(ctx)
+	ns.ctx = moduleContext
+	ns.cancel = cancel
+
+	natsServer, err := server.NewServer(&server.Options{
+		Host:  ns.Ip,
+		Port:  ns.Port,
+		NoLog: true,
+	})
+
+	if err != nil {
+		return err
+	}
+
+	ns.server = natsServer
+	natsServer.Start()
+	defer natsServer.Shutdown()
+
+	if !natsServer.ReadyForConnections(5 * time.Second) {
+		return errors.New("nats.server failed to start")
+	}
+	ns.logger.Info("NATS server started", "client_url", natsServer.ClientURL())
+
+	<-ns.ctx.Done()
+
+	ns.logger.Debug("done")
+	return nil
+}
+
+func (ns *NATSServer) Output(ctx context.Context, payload any) error {
+	return errors.New("nats.server does not support output")
+}
+
+func (ns *NATSServer) Stop() {
+	ns.cancel()
+	if ns.server != nil {
+		ns.server.Shutdown()
+	}
+}
+
+func (ns *NATSServer) Get(key string) (any, error) {
+	return nil, errors.New("nats.server does not support Get")
+}

internal/module/psn-client.go

@@ -9,17 +9,18 @@ import (
 	"time"
 
 	"github.com/jwetzell/psn-go"
+	"github.com/jwetzell/showbridge-go/internal/common"
 	"github.com/jwetzell/showbridge-go/internal/config"
-	"github.com/jwetzell/showbridge-go/internal/route"
 )
 
 type PSNClient struct {
 	config  config.ModuleConfig
 	conn    *net.UDPConn
 	ctx     context.Context
-	router  route.RouteIO
+	router  common.RouteIO
 	decoder *psn.Decoder
 	logger  *slog.Logger
+	cancel  context.CancelFunc
 }
 
 func init() {
@@ -40,14 +41,17 @@ func (pc *PSNClient) Type() string {
 	return pc.config.Type
 }
 
-func (pc *PSNClient) Run(ctx context.Context) error {
-	router, ok := ctx.Value(route.RouterContextKey).(route.RouteIO)
+func (pc *PSNClient) Start(ctx context.Context) error {
+	pc.logger.Debug("running")
+	router, ok := ctx.Value(common.RouterContextKey).(common.RouteIO)
 
 	if !ok {
 		return errors.New("psn.client unable to get router from context")
 	}
 	pc.router = router
-	pc.ctx = ctx
+	moduleContext, cancel := context.WithCancel(ctx)
+	pc.ctx = moduleContext
+	pc.cancel = cancel
 
 	addr, err := net.ResolveUDPAddr("udp", "236.10.10.10:56565")
 	if err != nil {
@@ -104,3 +108,18 @@ func (pc *PSNClient) Run(ctx context.Context) error {
 func (pc *PSNClient) Output(ctx context.Context, payload any) error {
 	return fmt.Errorf("psn.client output is not implemented")
 }
+
+func (pc *PSNClient) Stop() {
+	pc.cancel()
+}
+
+func (pc *PSNClient) Get(key string) (any, error) {
+	switch key {
+	case "trackers":
+		return pc.decoder.Trackers, nil
+	case "name":
+		return pc.decoder.SystemName, nil
+	default:
+		return nil, errors.New("psn.client key not found")
+	}
+}

internal/module/serial-client.go

@@ -9,21 +9,23 @@ import (
 	"log/slog"
 	"time"
 
+	"github.com/jwetzell/showbridge-go/internal/common"
 	"github.com/jwetzell/showbridge-go/internal/config"
 	"github.com/jwetzell/showbridge-go/internal/framer"
-	"github.com/jwetzell/showbridge-go/internal/route"
+	"github.com/jwetzell/showbridge-go/internal/processor"
 	"go.bug.st/serial"
 )
 
 type SerialClient struct {
 	config config.ModuleConfig
 	ctx    context.Context
-	router route.RouteIO
+	router common.RouteIO
 	Port   string
 	Framer framer.Framer
 	Mode   *serial.Mode
 	port   serial.Port
 	logger *slog.Logger
+	cancel context.CancelFunc
 }
 
 func init() {
@@ -31,48 +33,29 @@ func init() {
 		Type: "serial.client",
 		New: func(config config.ModuleConfig) (Module, error) {
 			params := config.Params
-			port, ok := params["port"]
-
-			if !ok {
-				return nil, errors.New("serial.client requires a port parameter")
+			portString, err := params.GetString("port")
+			if err != nil {
+				return nil, fmt.Errorf("serial.client port error: %w", err)
 			}
 
-			portString, ok := port.(string)
-
-			if !ok {
-				return nil, errors.New("serial.client port must be a string")
-			}
-
-			framingMethod, ok := params["framing"]
-
-			if !ok {
-				return nil, errors.New("serial.client requires a framing parameter")
-			}
-
-			framingMethodString, ok := framingMethod.(string)
-
-			if !ok {
-				return nil, errors.New("serial.client framing method must be a string")
+			framingMethodString, err := params.GetString("framing")
+			if err != nil {
+				return nil, fmt.Errorf("serial.client framing error: %w", err)
 			}
 
 			framer := framer.GetFramer(framingMethodString)
 
 			if framer == nil {
-				return nil, fmt.Errorf("serial.client unknown framing method: %s", framingMethod)
+				return nil, fmt.Errorf("serial.client unknown framing method: %s", framingMethodString)
 			}
 
-			buadRate, ok := params["baudRate"]
-			if !ok {
-				return nil, errors.New("serial.client requires a baudRate parameter")
-			}
-
-			baudRateNum, ok := buadRate.(float64)
-			if !ok {
-				return nil, errors.New("serial.client baudRate must be a number")
+			baudRateInt, err := params.GetInt("baudRate")
+			if err != nil {
+				return nil, fmt.Errorf("serial.client baudRate error: %w", err)
 			}
 
 			mode := serial.Mode{
-				BaudRate: int(baudRateNum),
+				BaudRate: baudRateInt,
 			}
 
 			return &SerialClient{config: config, Port: portString, Framer: framer, Mode: &mode, logger: CreateLogger(config)}, nil
@@ -100,15 +83,18 @@ func (sc *SerialClient) SetupPort() error {
 	return nil
 }
 
-func (sc *SerialClient) Run(ctx context.Context) error {
-	router, ok := ctx.Value(route.RouterContextKey).(route.RouteIO)
+func (sc *SerialClient) Start(ctx context.Context) error {
+	sc.logger.Debug("running")
+	router, ok := ctx.Value(common.RouterContextKey).(common.RouteIO)
 
 	if !ok {
 		return errors.New("serial.client unable to get router from context")
 	}
 
 	sc.router = router
-	sc.ctx = ctx
+	moduleContext, cancel := context.WithCancel(ctx)
+	sc.ctx = moduleContext
+	sc.cancel = cancel
 
 	// TODO(jwetzell): shutdown with router.Context properly
 	go func() {
@@ -171,7 +157,7 @@ func (sc *SerialClient) Run(ctx context.Context) error {
 
 func (sc *SerialClient) Output(ctx context.Context, payload any) error {
 
-	payloadBytes, ok := payload.([]byte)
+	payloadBytes, ok := processor.GetAnyAs[[]byte](payload)
 
 	if !ok {
 		return errors.New("serial.client can only ouptut bytes")
@@ -180,3 +166,16 @@ func (sc *SerialClient) Output(ctx context.Context, payload any) error {
 	_, err := sc.port.Write(sc.Framer.Encode(payloadBytes))
 	return err
 }
+
+func (sc *SerialClient) Stop() {
+	sc.cancel()
+}
+
+func (sc *SerialClient) Get(key string) (any, error) {
+	switch key {
+	case "port":
+		return sc.Port, nil
+	default:
+		return nil, errors.New("serial.client key not found")
+	}
+}

internal/module/sip-call-server.go

@@ -14,21 +14,22 @@ import (
 	"github.com/emiago/diago/media"
 	"github.com/emiago/sipgo"
 	"github.com/emiago/sipgo/sip"
+	"github.com/jwetzell/showbridge-go/internal/common"
 	"github.com/jwetzell/showbridge-go/internal/config"
 	"github.com/jwetzell/showbridge-go/internal/processor"
-	"github.com/jwetzell/showbridge-go/internal/route"
 )
 
 type SIPCallServer struct {
 	config    config.ModuleConfig
 	ctx       context.Context
-	router    route.RouteIO
+	router    common.RouteIO
 	IP        string
 	Port      int
 	Transport string
 	UserAgent string
 	dg        *diago.Diago
 	logger    *slog.Logger
+	cancel    context.CancelFunc
 }
 
 type SIPCallMessage struct {
@@ -45,60 +46,46 @@ type sipCallContextKey string
 func init() {
 	RegisterModule(ModuleRegistration{
 		Type: "sip.call.server",
-		New: func(config config.ModuleConfig) (Module, error) {
-			params := config.Params
-			portNum := 5060
+		New: func(moduleConfig config.ModuleConfig) (Module, error) {
+			params := moduleConfig.Params
+			portNum, err := params.GetInt("port")
+			if err != nil {
 
-			port, ok := params["port"]
-			if ok {
-				specificPortNum, ok := port.(float64)
-
-				if !ok {
-					return nil, errors.New("sip.call.server port must be a number")
+				if errors.Is(err, config.ErrParamNotFound) {
+					portNum = 5060
+				} else {
+					return nil, fmt.Errorf("sip.call.server port error: %w", err)
 				}
-				portNum = int(specificPortNum)
 			}
 
-			ipString := "0.0.0.0"
-
-			ip, ok := params["ip"]
-			if ok {
-
-				specificIpString, ok := ip.(string)
-
-				if !ok {
-					return nil, errors.New("sip.call.server ip must be a string")
+			ipString, err := params.GetString("ip")
+			if err != nil {
+				if errors.Is(err, config.ErrParamNotFound) {
+					ipString = "0.0.0.0"
+				} else {
+					return nil, fmt.Errorf("sip.call.server ip error: %w", err)
 				}
-				ipString = specificIpString
 			}
 
-			transportString := "udp"
-
-			transport, ok := params["transport"]
-			if ok {
-
-				specificTransportString, ok := transport.(string)
-
-				if !ok {
-					return nil, errors.New("sip.call.server transport must be a string")
+			transportString, err := params.GetString("transport")
+			if err != nil {
+				if errors.Is(err, config.ErrParamNotFound) {
+					transportString = "udp"
+				} else {
+					return nil, fmt.Errorf("sip.call.server transport error: %w", err)
 				}
-				transportString = specificTransportString
 			}
 
-			userAgentString := "showbridge"
-
-			userAgent, ok := params["userAgent"]
-			if ok {
-
-				specificTransportString, ok := userAgent.(string)
-
-				if !ok {
-					return nil, errors.New("sip.call.server userAgent must be a string")
+			userAgentString, err := params.GetString("userAgent")
+			if err != nil {
+				if errors.Is(err, config.ErrParamNotFound) {
+					userAgentString = "showbridge"
+				} else {
+					return nil, fmt.Errorf("sip.call.server userAgent error: %w", err)
 				}
-				userAgentString = specificTransportString
 			}
 
-			return &SIPCallServer{config: config, IP: ipString, Port: int(portNum), Transport: transportString, UserAgent: userAgentString, logger: CreateLogger(config)}, nil
+			return &SIPCallServer{config: moduleConfig, IP: ipString, Port: int(portNum), Transport: transportString, UserAgent: userAgentString, logger: CreateLogger(moduleConfig)}, nil
 		},
 	})
 }
@@ -111,14 +98,17 @@ func (scs *SIPCallServer) Type() string {
 	return scs.config.Type
 }
 
-func (scs *SIPCallServer) Run(ctx context.Context) error {
-	router, ok := ctx.Value(route.RouterContextKey).(route.RouteIO)
+func (scs *SIPCallServer) Start(ctx context.Context) error {
+	scs.logger.Debug("running")
+	router, ok := ctx.Value(common.RouterContextKey).(common.RouteIO)
 
 	if !ok {
 		return errors.New("sip.call.server unable to get router from context")
 	}
 	scs.router = router
-	scs.ctx = ctx
+	moduleContext, cancel := context.WithCancel(ctx)
+	scs.ctx = moduleContext
+	scs.cancel = cancel
 
 	diagoLogger := slog.New(slog.NewJSONHandler(io.Discard, nil))
 
@@ -183,11 +173,10 @@ func (scs *SIPCallServer) Output(ctx context.Context, payload any) error {
 		return errors.New("sip.call.server inDialog already ended")
 	}
 
-	payloadDTMFResponse, ok := payload.(processor.SipDTMFResponse)
+	payloadDTMFResponse, ok := processor.GetAnyAs[processor.SipDTMFResponse](payload)
 
 	if ok {
 		dtmfWriter := call.inDialog.AudioWriterDTMF()
-
 		time.Sleep(time.Millisecond * time.Duration(payloadDTMFResponse.PreWait))
 		for i, dtmfRune := range payloadDTMFResponse.Digits {
 			err := dtmfWriter.WriteDTMF(dtmfRune)
@@ -196,11 +185,11 @@ func (scs *SIPCallServer) Output(ctx context.Context, payload any) error {
 				return fmt.Errorf("sip.dtmf.server error output dtmf digit at index %d", i)
 			}
 		}
-		time.Sleep(time.Millisecond * time.Duration(payloadDTMFResponse.PreWait))
+		time.Sleep(time.Millisecond * time.Duration(payloadDTMFResponse.PostWait))
 		return nil
 	}
 
-	payloadAudioFileResponse, ok := payload.(processor.SipAudioFileResponse)
+	payloadAudioFileResponse, ok := processor.GetAnyAs[processor.SipAudioFileResponse](payload)
 
 	if ok {
 		audioFile, err := os.Open(payloadAudioFileResponse.AudioFile)
@@ -228,3 +217,11 @@ func (scs *SIPCallServer) Output(ctx context.Context, payload any) error {
 	}
 	return errors.New("sip.dtmf.server can only output SipDTMFResponse or SipAudioFileResponse")
 }
+
+func (scs *SIPCallServer) Stop() {
+	scs.cancel()
+}
+
+func (scs *SIPCallServer) Get(key string) (any, error) {
+	return nil, errors.New("sip.call.server does not support Get")
+}

internal/module/sip-dtmf-server.go

@@ -15,20 +15,22 @@ import (
 	"github.com/emiago/diago/media"
 	"github.com/emiago/sipgo"
 	"github.com/emiago/sipgo/sip"
+	"github.com/jwetzell/showbridge-go/internal/common"
 	"github.com/jwetzell/showbridge-go/internal/config"
 	"github.com/jwetzell/showbridge-go/internal/processor"
-	"github.com/jwetzell/showbridge-go/internal/route"
 )
 
 type SIPDTMFServer struct {
 	config    config.ModuleConfig
 	ctx       context.Context
-	router    route.RouteIO
+	router    common.RouteIO
 	IP        string
 	Port      int
 	Transport string
+	UserAgent string
 	Separator string
 	logger    *slog.Logger
+	cancel    context.CancelFunc
 }
 
 type SIPDTMFMessage struct {
@@ -44,53 +46,49 @@ type SIPDTMFCall struct {
 func init() {
 	RegisterModule(ModuleRegistration{
 		Type: "sip.dtmf.server",
-		New: func(config config.ModuleConfig) (Module, error) {
-			params := config.Params
-			portNum := 5060
+		New: func(moduleConfig config.ModuleConfig) (Module, error) {
+			params := moduleConfig.Params
 
-			port, ok := params["port"]
-			if ok {
-				specificPortNum, ok := port.(float64)
+			portNum, err := params.GetInt("port")
+			if err != nil {
 
-				if !ok {
-					return nil, errors.New("sip.dtmf.server port must be a number")
+				if errors.Is(err, config.ErrParamNotFound) {
+					portNum = 5060
+				} else {
+					return nil, fmt.Errorf("sip.dtmf.server port error: %w", err)
 				}
-				portNum = int(specificPortNum)
 			}
 
-			ipString := "0.0.0.0"
-
-			ip, ok := params["ip"]
-			if ok {
-
-				specificIpString, ok := ip.(string)
-
-				if !ok {
-					return nil, errors.New("sip.dtmf.server ip must be a string")
+			ipString, err := params.GetString("ip")
+			if err != nil {
+				if errors.Is(err, config.ErrParamNotFound) {
+					ipString = "0.0.0.0"
+				} else {
+					return nil, fmt.Errorf("sip.dtmf.server ip error: %w", err)
 				}
-				ipString = specificIpString
 			}
 
-			transportString := "udp"
-
-			transport, ok := params["transport"]
-			if ok {
-
-				specificTransportString, ok := transport.(string)
-
-				if !ok {
-					return nil, errors.New("sip.dtmf.server transport must be a string")
+			transportString, err := params.GetString("transport")
+			if err != nil {
+				if errors.Is(err, config.ErrParamNotFound) {
+					transportString = "udp"
+				} else {
+					return nil, fmt.Errorf("sip.dtmf.server transport error: %w", err)
 				}
-				transportString = specificTransportString
 			}
 
-			separator, ok := params["separator"]
-			if !ok {
-				return nil, errors.New("sip.dtmf.server requires a separator parameter")
+			userAgentString, err := params.GetString("userAgent")
+			if err != nil {
+				if errors.Is(err, config.ErrParamNotFound) {
+					userAgentString = "showbridge"
+				} else {
+					return nil, fmt.Errorf("sip.dtmf.server userAgent error: %w", err)
 				}
-			separatorString, ok := separator.(string)
-			if !ok {
-				return nil, errors.New("sip.dtmf.server separator must be a string")
+			}
+
+			separatorString, err := params.GetString("separator")
+			if err != nil {
+				return nil, fmt.Errorf("sip.dtmf.server separator error: %w", err)
 			}
 
 			if len(separatorString) != 1 {
@@ -100,7 +98,7 @@ func init() {
 			if !strings.ContainsRune("0123456789*#ABCD", rune(separatorString[0])) {
 				return nil, errors.New("sip.dtmf.server separator must be a valid DTMF character")
 			}
-			return &SIPDTMFServer{config: config, IP: ipString, Port: int(portNum), Transport: transportString, Separator: separatorString, logger: CreateLogger(config)}, nil
+			return &SIPDTMFServer{config: moduleConfig, IP: ipString, Port: int(portNum), Transport: transportString, UserAgent: userAgentString, Separator: separatorString, logger: CreateLogger(moduleConfig)}, nil
 		},
 	})
 }
@@ -113,18 +111,22 @@ func (sds *SIPDTMFServer) Type() string {
 	return sds.config.Type
 }
 
-func (sds *SIPDTMFServer) Run(ctx context.Context) error {
-	router, ok := ctx.Value(route.RouterContextKey).(route.RouteIO)
+func (sds *SIPDTMFServer) Start(ctx context.Context) error {
+	sds.logger.Debug("running")
+	router, ok := ctx.Value(common.RouterContextKey).(common.RouteIO)
 
 	if !ok {
 		return errors.New("sip.dtmf.server unable to get router from context")
 	}
 	sds.router = router
-	sds.ctx = ctx
+	moduleContext, cancel := context.WithCancel(ctx)
+	sds.ctx = moduleContext
+	sds.cancel = cancel
 
 	diagoLogger := slog.New(slog.NewJSONHandler(io.Discard, nil))
 
 	ua, _ := sipgo.NewUA(
+		sipgo.WithUserAgent(sds.UserAgent),
 		sipgo.WithUserAgentTransportLayerOptions(sip.WithTransportLayerLogger(diagoLogger)),
 		sipgo.WithUserAgentTransactionLayerOptions(sip.WithTransactionLayerLogger(diagoLogger)),
 	)
@@ -197,7 +199,7 @@ func (sds *SIPDTMFServer) Output(ctx context.Context, payload any) error {
 		return errors.New("sip.dtmf.server inDialog already ended")
 	}
 
-	payloadDTMFResponse, ok := payload.(processor.SipDTMFResponse)
+	payloadDTMFResponse, ok := processor.GetAnyAs[processor.SipDTMFResponse](payload)
 
 	if ok {
 		dtmfWriter := call.inDialog.AudioWriterDTMF()
@@ -210,11 +212,11 @@ func (sds *SIPDTMFServer) Output(ctx context.Context, payload any) error {
 				return fmt.Errorf("sip.dtmf.server error output dtmf digit at index %d", i)
 			}
 		}
-		time.Sleep(time.Millisecond * time.Duration(payloadDTMFResponse.PreWait))
+		time.Sleep(time.Millisecond * time.Duration(payloadDTMFResponse.PostWait))
 		return nil
 	}
 
-	payloadAudioFileResponse, ok := payload.(processor.SipAudioFileResponse)
+	payloadAudioFileResponse, ok := processor.GetAnyAs[processor.SipAudioFileResponse](payload)
 
 	if ok {
 		audioFile, err := os.Open(payloadAudioFileResponse.AudioFile)
@@ -243,3 +245,11 @@ func (sds *SIPDTMFServer) Output(ctx context.Context, payload any) error {
 
 	return errors.New("sip.dtmf.server can only output SipDTMFResponse or SipAudioFileResponse")
 }
+
+func (sds *SIPDTMFServer) Stop() {
+	sds.cancel()
+}
+
+func (sds *SIPDTMFServer) Get(key string) (any, error) {
+	return nil, errors.New("sip.dtmf.server does not support Get")
+}

internal/module/tcp-client.go

@@ -8,9 +8,10 @@ import (
 	"net"
 	"time"
 
+	"github.com/jwetzell/showbridge-go/internal/common"
 	"github.com/jwetzell/showbridge-go/internal/config"
 	"github.com/jwetzell/showbridge-go/internal/framer"
-	"github.com/jwetzell/showbridge-go/internal/route"
+	"github.com/jwetzell/showbridge-go/internal/processor"
 )
 
 type TCPClient struct {
@@ -18,9 +19,10 @@ type TCPClient struct {
 	framer framer.Framer
 	conn   *net.TCPConn
 	ctx    context.Context
-	router route.RouteIO
+	router common.RouteIO
 	Addr   *net.TCPAddr
 	logger *slog.Logger
+	cancel context.CancelFunc
 }
 
 func init() {
@@ -28,27 +30,14 @@ func init() {
 		Type: "net.tcp.client",
 		New: func(config config.ModuleConfig) (Module, error) {
 			params := config.Params
-			host, ok := params["host"]
-
-			if !ok {
-				return nil, errors.New("net.tcp.client requires a host parameter")
+			hostString, err := params.GetString("host")
+			if err != nil {
+				return nil, fmt.Errorf("net.tcp.client host error: %w", err)
 			}
 
-			hostString, ok := host.(string)
-
-			if !ok {
-				return nil, errors.New("net.tcp.client host must be string")
-			}
-
-			port, ok := params["port"]
-			if !ok {
-				return nil, errors.New("net.tcp.client requires a port parameter")
-			}
-
-			portNum, ok := port.(float64)
-
-			if !ok {
-				return nil, errors.New("net.tcp.client port must be a number")
+			portNum, err := params.GetInt("port")
+			if err != nil {
+				return nil, fmt.Errorf("net.tcp.client port error: %w", err)
 			}
 
 			addr, err := net.ResolveTCPAddr("tcp", fmt.Sprintf("%s:%d", hostString, uint16(portNum)))
@@ -56,22 +45,15 @@ func init() {
 				return nil, err
 			}
 
-			framingMethod, ok := params["framing"]
-
-			if !ok {
-				return nil, errors.New("net.tcp.client requires a framing parameter")
-			}
-
-			framingMethodString, ok := framingMethod.(string)
-
-			if !ok {
-				return nil, errors.New("net.tcp.client framing method must be a string")
+			framingMethodString, err := params.GetString("framing")
+			if err != nil {
+				return nil, fmt.Errorf("net.tcp.client framing error: %w", err)
 			}
 
 			framer := framer.GetFramer(framingMethodString)
 
 			if framer == nil {
-				return nil, fmt.Errorf("net.tcp.client unknown framing method: %s", framingMethod)
+				return nil, fmt.Errorf("net.tcp.client unknown framing method: %s", framingMethodString)
 			}
 			return &TCPClient{framer: framer, Addr: addr, config: config, logger: CreateLogger(config)}, nil
 		},
@@ -86,15 +68,17 @@ func (tc *TCPClient) Type() string {
 	return tc.config.Type
 }
 
-func (tc *TCPClient) Run(ctx context.Context) error {
-
-	router, ok := ctx.Value(route.RouterContextKey).(route.RouteIO)
+func (tc *TCPClient) Start(ctx context.Context) error {
+	tc.logger.Debug("running")
+	router, ok := ctx.Value(common.RouterContextKey).(common.RouteIO)
 
 	if !ok {
 		return errors.New("net.tcp.client unable to get router from context")
 	}
 	tc.router = router
-	tc.ctx = ctx
+	moduleContext, cancel := context.WithCancel(ctx)
+	tc.ctx = moduleContext
+	tc.cancel = cancel
 
 	// TODO(jwetzell): shutdown with router.Context properly
 	go func() {
@@ -169,10 +153,31 @@ func (tc *TCPClient) Output(ctx context.Context, payload any) error {
 			return err
 		}
 	}
-	payloadBytes, ok := payload.([]byte)
+	payloadBytes, ok := processor.GetAnyAs[[]byte](payload)
 	if !ok {
 		return errors.New("net.tcp.client is only able to output bytes")
 	}
 	_, err := tc.conn.Write(tc.framer.Encode(payloadBytes))
 	return err
 }
+
+func (tc *TCPClient) Stop() {
+	tc.cancel()
+}
+
+func (tc *TCPClient) Get(key string) (any, error) {
+	switch key {
+	case "host":
+		host, err := tc.config.Params.GetString("host")
+		if err != nil {
+			return nil, fmt.Errorf("net.tcp.client host error: %w", err)
+		}
+		return host, nil
+	case "ip":
+		return tc.Addr.IP.String(), nil
+	case "port":
+		return tc.Addr.Port, nil
+	default:
+		return nil, errors.New("net.tcp.client key not found")
+	}
+}

internal/module/tcp-server.go

@@ -11,9 +11,10 @@ import (
 	"syscall"
 	"time"
 
+	"github.com/jwetzell/showbridge-go/internal/common"
 	"github.com/jwetzell/showbridge-go/internal/config"
 	"github.com/jwetzell/showbridge-go/internal/framer"
-	"github.com/jwetzell/showbridge-go/internal/route"
+	"github.com/jwetzell/showbridge-go/internal/processor"
 )
 
 type TCPServer struct {
@@ -21,66 +22,50 @@ type TCPServer struct {
 	Addr          *net.TCPAddr
 	Framer        framer.Framer
 	ctx           context.Context
-	router        route.RouteIO
+	router        common.RouteIO
 	quit          chan interface{}
 	wg            sync.WaitGroup
 	connections   []*net.TCPConn
 	connectionsMu sync.RWMutex
 	logger        *slog.Logger
+	cancel        context.CancelFunc
 }
 
 func init() {
 	RegisterModule(ModuleRegistration{
 		Type: "net.tcp.server",
-		New: func(config config.ModuleConfig) (Module, error) {
-			params := config.Params
-			port, ok := params["port"]
-			if !ok {
-				return nil, errors.New("net.tcp.server requires a port parameter")
+		New: func(moduleConfig config.ModuleConfig) (Module, error) {
+			params := moduleConfig.Params
+			portNum, err := params.GetInt("port")
+			if err != nil {
+				return nil, fmt.Errorf("net.tcp.server port error: %w", err)
 			}
 
-			portNum, ok := port.(float64)
-
-			if !ok {
-				return nil, errors.New("net.tcp.server port must be a number")
-			}
-
-			framingMethod, ok := params["framing"]
-
-			if !ok {
-				return nil, errors.New("net.tcp.server requires a framing parameter")
-			}
-
-			framingMethodString, ok := framingMethod.(string)
-
-			if !ok {
-				return nil, errors.New("net.tcp.server framing method must be a string")
+			framingMethodString, err := params.GetString("framing")
+			if err != nil {
+				return nil, fmt.Errorf("net.tcp.server framing error: %w", err)
 			}
 
 			framer := framer.GetFramer(framingMethodString)
 
 			if framer == nil {
-				return nil, fmt.Errorf("net.tcp.server unknown framing method: %s", framingMethod)
+				return nil, fmt.Errorf("net.tcp.server unknown framing method: %s", framingMethodString)
 			}
 
-			ipString := "0.0.0.0"
-
-			ip, ok := params["ip"]
-			if ok {
-
-				specificIpString, ok := ip.(string)
-
-				if !ok {
-					return nil, errors.New("net.tcp.server ip must be a string")
+			ipString, err := params.GetString("ip")
+			if err != nil {
+				if errors.Is(err, config.ErrParamNotFound) {
+					ipString = "0.0.0.0"
+				} else {
+					return nil, fmt.Errorf("net.tcp.server ip error: %w", err)
 				}
-				ipString = specificIpString
 			}
 
 			addr, err := net.ResolveTCPAddr("tcp", fmt.Sprintf("%s:%d", ipString, uint16(portNum)))
 			if err != nil {
 				return nil, err
 			}
-			return &TCPServer{Framer: framer, Addr: addr, config: config, quit: make(chan interface{}), logger: CreateLogger(config)}, nil
+			return &TCPServer{Framer: framer, Addr: addr, config: moduleConfig, quit: make(chan interface{}), logger: CreateLogger(moduleConfig)}, nil
 		},
 	})
 }
@@ -105,6 +90,15 @@ ClientRead:
 	for {
 		select {
 		case <-ts.quit:
+			client.Close()
+			ts.connectionsMu.Lock()
+			for i := 0; i < len(ts.connections); i++ {
+				if ts.connections[i] == client {
+					ts.connections = slices.Delete(ts.connections, i, i+1)
+					break
+				}
+			}
+			ts.connectionsMu.Unlock()
 			return
 		default:
 			client.SetDeadline(time.Now().Add(time.Millisecond * 200))
@@ -147,7 +141,13 @@ ClientRead:
 					messages := ts.Framer.Decode(buffer[0:byteCount])
 					for _, message := range messages {
 						if ts.router != nil {
+							senderAddr, ok := client.RemoteAddr().(*net.TCPAddr)
+							if ok {
+								senderCtx := context.WithValue(ts.ctx, common.SenderContextKey, senderAddr)
+								ts.router.HandleInput(senderCtx, ts.Id(), message)
+							} else {
 								ts.router.HandleInput(ts.ctx, ts.Id(), message)
+							}
 						} else {
 							ts.logger.Error("input received but no router is configured")
 						}
@@ -158,15 +158,17 @@ ClientRead:
 	}
 }
 
-func (ts *TCPServer) Run(ctx context.Context) error {
-
-	router, ok := ctx.Value(route.RouterContextKey).(route.RouteIO)
+func (ts *TCPServer) Start(ctx context.Context) error {
+	ts.logger.Debug("running")
+	router, ok := ctx.Value(common.RouterContextKey).(common.RouteIO)
 
 	if !ok {
 		return errors.New("net.tcp.server unable to get router from context")
 	}
 	ts.router = router
-	ts.ctx = ctx
+	moduleContext, cancel := context.WithCancel(ctx)
+	ts.ctx = moduleContext
+	ts.cancel = cancel
 
 	listener, err := net.ListenTCP("tcp", ts.Addr)
 	if err != nil {
@@ -205,7 +207,7 @@ AcceptLoop:
 }
 
 func (ts *TCPServer) Output(ctx context.Context, payload any) error {
-	payloadBytes, ok := payload.([]byte)
+	payloadBytes, ok := processor.GetAnyAs[[]byte](payload)
 
 	if !ok {
 		return errors.New("net.tcp.server is only able to output bytes")
@@ -226,3 +228,19 @@ func (ts *TCPServer) Output(ctx context.Context, payload any) error {
 	}
 	return fmt.Errorf("net.tcp.server error during output: %s", errorString)
 }
+
+func (ts *TCPServer) Stop() {
+	ts.cancel()
+	ts.wg.Wait()
+}
+
+func (ts *TCPServer) Get(key string) (any, error) {
+	switch key {
+	case "ip":
+		return ts.Addr.IP.String(), nil
+	case "port":
+		return ts.Addr.Port, nil
+	default:
+		return nil, errors.New("net.tcp.server key not found")
+	}
+}

internal/module/test/http-server_test.go

@@ -0,0 +1,87 @@
+package module_test
+
+import (
+	"testing"
+
+	"github.com/jwetzell/showbridge-go/internal/config"
+	"github.com/jwetzell/showbridge-go/internal/module"
+)
+
+func TestHTTPServerFromRegistry(t *testing.T) {
+	registration, ok := module.ModuleRegistry["http.server"]
+	if !ok {
+		t.Fatalf("http.server module not registered")
+	}
+
+	moduleInstance, err := registration.New(config.ModuleConfig{
+		Id:   "test",
+		Type: "http.server",
+		Params: map[string]any{
+			"port": 3000,
+		},
+	})
+
+	if err != nil {
+		t.Fatalf("failed to create http.server module: %s", err)
+	}
+
+	if moduleInstance.Id() != "test" {
+		t.Fatalf("http.server module has wrong id: %s", moduleInstance.Id())
+	}
+
+	if moduleInstance.Type() != "http.server" {
+		t.Fatalf("http.server module has wrong type: %s", moduleInstance.Type())
+	}
+}
+
+func TestBadHTTPServer(t *testing.T) {
+	tests := []struct {
+		name        string
+		params      map[string]any
+		errorString string
+	}{
+		{
+			name:        "no port param",
+			params:      map[string]any{},
+			errorString: "http.server port error: not found",
+		},
+		{
+			name:        "non-numeric port",
+			params:      map[string]any{"port": "3000"},
+			errorString: "http.server port error: not a number",
+		},
+	}
+
+	for _, test := range tests {
+		t.Run(test.name, func(t *testing.T) {
+
+			registration, ok := module.ModuleRegistry["http.server"]
+			if !ok {
+				t.Fatalf("http.server module not registered")
+			}
+
+			moduleInstance, err := registration.New(config.ModuleConfig{
+				Id:     "test",
+				Type:   "http.server",
+				Params: test.params,
+			})
+
+			if err != nil {
+				if test.errorString != err.Error() {
+					t.Fatalf("http.server got error '%s', expected '%s'", err.Error(), test.errorString)
+				}
+				return
+			}
+
+			err = moduleInstance.Start(t.Context())
+
+			if err == nil {
+				t.Fatalf("http.server expected to fail")
+			}
+
+			if err.Error() != test.errorString {
+				t.Fatalf("http.server got error '%s', expected '%s'", err.Error(), test.errorString)
+			}
+		})
+	}
+}

internal/module/test/midi-input_test.go

@@ -0,0 +1,87 @@
+package module_test
+
+import (
+	"testing"
+
+	"github.com/jwetzell/showbridge-go/internal/config"
+	"github.com/jwetzell/showbridge-go/internal/module"
+)
+
+func TestMIDIInputFromRegistry(t *testing.T) {
+	registration, ok := module.ModuleRegistry["midi.input"]
+	if !ok {
+		t.Fatalf("midi.input module not registered")
+	}
+
+	moduleInstance, err := registration.New(config.ModuleConfig{
+		Id:   "test",
+		Type: "midi.input",
+		Params: map[string]any{
+			"port": "test",
+		},
+	})
+
+	if err != nil {
+		t.Fatalf("failed to create midi.input module: %s", err)
+	}
+
+	if moduleInstance.Id() != "test" {
+		t.Fatalf("midi.input module has wrong id: %s", moduleInstance.Id())
+	}
+
+	if moduleInstance.Type() != "midi.input" {
+		t.Fatalf("midi.input module has wrong type: %s", moduleInstance.Type())
+	}
+}
+
+func TestBadMIDIInput(t *testing.T) {
+	tests := []struct {
+		name        string
+		params      map[string]any
+		errorString string
+	}{
+		{
+			name:        "no port param",
+			params:      map[string]any{},
+			errorString: "midi.input port error: not found",
+		},
+		{
+			name:        "non-string port",
+			params:      map[string]any{"port": 123},
+			errorString: "midi.input port error: not a string",
+		},
+	}
+
+	for _, test := range tests {
+		t.Run(test.name, func(t *testing.T) {
+
+			registration, ok := module.ModuleRegistry["midi.input"]
+			if !ok {
+				t.Fatalf("midi.input module not registered")
+			}
+
+			moduleInstance, err := registration.New(config.ModuleConfig{
+				Id:     "test",
+				Type:   "midi.input",
+				Params: test.params,
+			})
+
+			if err != nil {
+				if test.errorString != err.Error() {
+					t.Fatalf("midi.input got error '%s', expected '%s'", err.Error(), test.errorString)
+				}
+				return
+			}
+
+			err = moduleInstance.Start(t.Context())
+
+			if err == nil {
+				t.Fatalf("midi.input expected to fail")
+			}
+
+			if err.Error() != test.errorString {
+				t.Fatalf("midi.input got error '%s', expected '%s'", err.Error(), test.errorString)
+			}
+		})
+	}
+}

internal/module/test/midi-output_test.go

@@ -0,0 +1,87 @@
+package module_test
+
+import (
+	"testing"
+
+	"github.com/jwetzell/showbridge-go/internal/config"
+	"github.com/jwetzell/showbridge-go/internal/module"
+)
+
+func TestMIDIOutputFromRegistry(t *testing.T) {
+	registration, ok := module.ModuleRegistry["midi.output"]
+	if !ok {
+		t.Fatalf("midi.output module not registered")
+	}
+
+	moduleInstance, err := registration.New(config.ModuleConfig{
+		Id:   "test",
+		Type: "midi.output",
+		Params: map[string]any{
+			"port": "test",
+		},
+	})
+
+	if err != nil {
+		t.Fatalf("failed to create midi.output module: %s", err)
+	}
+
+	if moduleInstance.Id() != "test" {
+		t.Fatalf("midi.output module has wrong id: %s", moduleInstance.Id())
+	}
+
+	if moduleInstance.Type() != "midi.output" {
+		t.Fatalf("midi.output module has wrong type: %s", moduleInstance.Type())
+	}
+}
+
+func TestBadMIDIOutput(t *testing.T) {
+	tests := []struct {
+		name        string
+		params      map[string]any
+		errorString string
+	}{
+		{
+			name:        "no port param",
+			params:      map[string]any{},
+			errorString: "midi.output port error: not found",
+		},
+		{
+			name:        "non-string port",
+			params:      map[string]any{"port": 123},
+			errorString: "midi.output port error: not a string",
+		},
+	}
+
+	for _, test := range tests {
+		t.Run(test.name, func(t *testing.T) {
+
+			registration, ok := module.ModuleRegistry["midi.output"]
+			if !ok {
+				t.Fatalf("midi.output module not registered")
+			}
+
+			moduleInstance, err := registration.New(config.ModuleConfig{
+				Id:     "test",
+				Type:   "midi.output",
+				Params: test.params,
+			})
+
+			if err != nil {
+				if test.errorString != err.Error() {
+					t.Fatalf("midi.output got error '%s', expected '%s'", err.Error(), test.errorString)
+				}
+				return
+			}
+
+			err = moduleInstance.Start(t.Context())
+
+			if err == nil {
+				t.Fatalf("midi.output expected to fail")
+			}
+
+			if err.Error() != test.errorString {
+				t.Fatalf("midi.output got error '%s', expected '%s'", err.Error(), test.errorString)
+			}
+		})
+	}
+}

internal/module/test/module_test.go

@@ -0,0 +1,85 @@
+package module_test
+
+import (
+	"context"
+	"testing"
+
+	"github.com/jwetzell/showbridge-go/internal/config"
+	"github.com/jwetzell/showbridge-go/internal/module"
+)
+
+type TestModule struct {
+}
+
+func (m *TestModule) Output(ctx context.Context, payload any) error {
+	return nil
+}
+
+func (m *TestModule) Start(ctx context.Context) error {
+	<-ctx.Done()
+	return nil
+}
+
+func (m *TestModule) Stop() {}
+
+func (m *TestModule) Type() string {
+	return "module.test"
+}
+
+func (m *TestModule) Id() string {
+	return "test"
+}
+
+func (m *TestModule) Get(key string) (any, error) {
+	return nil, nil
+}
+
+func TestModuleBadRegistrationNoType(t *testing.T) {
+	defer func() {
+		if r := recover(); r == nil {
+			t.Fatalf("module registration should have panicked but did not")
+		}
+	}()
+
+	module.RegisterModule(module.ModuleRegistration{
+		Type: "",
+		New: func(config config.ModuleConfig) (module.Module, error) {
+			return &TestModule{}, nil
+		},
+	})
+}
+
+func TestModuleBadRegistrationNoNew(t *testing.T) {
+	defer func() {
+		if r := recover(); r == nil {
+			t.Fatalf("processor registration should have panicked but did not")
+		}
+	}()
+
+	module.RegisterModule(module.ModuleRegistration{
+		Type: "module.test",
+		New:  nil,
+	})
+}
+
+func TestModuleBadRegistrationExistingType(t *testing.T) {
+	defer func() {
+		if r := recover(); r == nil {
+			t.Fatalf("processor registration should have panicked but did not")
+		}
+	}()
+
+	module.RegisterModule(module.ModuleRegistration{
+		Type: "module.test",
+		New: func(config config.ModuleConfig) (module.Module, error) {
+			return &TestModule{}, nil
+		},
+	})
+
+	module.RegisterModule(module.ModuleRegistration{
+		Type: "module.test",
+		New: func(config config.ModuleConfig) (module.Module, error) {
+			return &TestModule{}, nil
+		},
+	})
+}

internal/module/test/mqtt-client_test.go

@@ -0,0 +1,130 @@
+package module_test
+
+import (
+	"testing"
+
+	"github.com/jwetzell/showbridge-go/internal/config"
+	"github.com/jwetzell/showbridge-go/internal/module"
+)
+
+func TestMQTTClientFromRegistry(t *testing.T) {
+	registration, ok := module.ModuleRegistry["mqtt.client"]
+	if !ok {
+		t.Fatalf("mqtt.client module not registered")
+	}
+
+	moduleInstance, err := registration.New(config.ModuleConfig{
+		Id:   "test",
+		Type: "mqtt.client",
+		Params: map[string]any{
+			"broker":   "mqtt://localhost:1883",
+			"topic":    "test/topic",
+			"clientId": "test",
+		},
+	})
+
+	if err != nil {
+		t.Fatalf("failed to create mqtt.client module: %s", err)
+	}
+
+	if moduleInstance.Id() != "test" {
+		t.Fatalf("mqtt.client module has wrong id: %s", moduleInstance.Id())
+	}
+
+	if moduleInstance.Type() != "mqtt.client" {
+		t.Fatalf("mqtt.client module has wrong type: %s", moduleInstance.Type())
+	}
+}
+
+func TestBadMQTTClient(t *testing.T) {
+	tests := []struct {
+		name        string
+		params      map[string]any
+		errorString string
+	}{
+		{
+			name: "no broker param",
+			params: map[string]any{
+				"topic":    "test/topic",
+				"clientId": "test",
+			},
+			errorString: "mqtt.client broker error: not found",
+		},
+		{
+			name: "non-string broker",
+			params: map[string]any{
+				"broker":   123,
+				"topic":    "test/topic",
+				"clientId": "test",
+			},
+			errorString: "mqtt.client broker error: not a string",
+		},
+		{
+			name: "no topic param",
+			params: map[string]any{
+				"broker":   "mqtt://localhost:1883",
+				"clientId": "test",
+			},
+			errorString: "mqtt.client topic error: not found",
+		},
+		{
+			name: "non-string topic",
+			params: map[string]any{
+				"broker":   "mqtt://localhost:1883",
+				"topic":    123,
+				"clientId": "test",
+			},
+			errorString: "mqtt.client topic error: not a string",
+		},
+		{
+			name: "no clientId param",
+			params: map[string]any{
+				"broker": "mqtt://localhost:1883",
+				"topic":  "test/topic",
+			},
+			errorString: "mqtt.client clientId error: not found",
+		},
+		{
+			name: "non-string clientId",
+			params: map[string]any{
+				"broker":   "mqtt://localhost:1883",
+				"topic":    "test/topic",
+				"clientId": 123,
+			},
+			errorString: "mqtt.client clientId error: not a string",
+		},
+	}
+
+	for _, test := range tests {
+		t.Run(test.name, func(t *testing.T) {
+
+			registration, ok := module.ModuleRegistry["mqtt.client"]
+			if !ok {
+				t.Fatalf("mqtt.client module not registered")
+			}
+
+			moduleInstance, err := registration.New(config.ModuleConfig{
+				Id:     "test",
+				Type:   "mqtt.client",
+				Params: test.params,
+			})
+
+			if err != nil {
+				if test.errorString != err.Error() {
+					t.Fatalf("mqtt.client got error '%s', expected '%s'", err.Error(), test.errorString)
+				}
+				return
+			}
+
+			err = moduleInstance.Start(t.Context())
+
+			if err == nil {
+				t.Fatalf("mqtt.client expected to fail")
+			}
+
+			if err.Error() != test.errorString {
+				t.Fatalf("mqtt.client got error '%s', expected '%s'", err.Error(), test.errorString)
+			}
+		})
+	}
+}

internal/module/test/nats-client_test.go

@@ -0,0 +1,108 @@
+package module_test
+
+import (
+	"testing"
+
+	"github.com/jwetzell/showbridge-go/internal/config"
+	"github.com/jwetzell/showbridge-go/internal/module"
+)
+
+func TestNATSClientFromRegistry(t *testing.T) {
+	registration, ok := module.ModuleRegistry["nats.client"]
+	if !ok {
+		t.Fatalf("nats.client module not registered")
+	}
+
+	moduleInstance, err := registration.New(config.ModuleConfig{
+		Id:   "test",
+		Type: "nats.client",
+		Params: map[string]any{
+			"url":     "nats://127.0.0.1:4222",
+			"subject": "test",
+		},
+	})
+
+	if err != nil {
+		t.Fatalf("failed to create nats.client module: %s", err)
+	}
+
+	if moduleInstance.Id() != "test" {
+		t.Fatalf("nats.client module has wrong id: %s", moduleInstance.Id())
+	}
+
+	if moduleInstance.Type() != "nats.client" {
+		t.Fatalf("nats.client module has wrong type: %s", moduleInstance.Type())
+	}
+}
+
+func TestBadNATSClient(t *testing.T) {
+	tests := []struct {
+		name        string
+		params      map[string]any
+		errorString string
+	}{
+		{
+			name: "no url param",
+			params: map[string]any{
+				"subject": "test/subject",
+			},
+			errorString: "nats.client url error: not found",
+		},
+		{
+			name: "non-string url",
+			params: map[string]any{
+				"url":     123,
+				"subject": "test/subject",
+			},
+			errorString: "nats.client url error: not a string",
+		},
+		{
+			name: "no subject param",
+			params: map[string]any{
+				"url": "nats://127.0.0.1:4222",
+			},
+			errorString: "nats.client subject error: not found",
+		},
+		{
+			name: "non-string subject",
+			params: map[string]any{
+				"url":     "nats://127.0.0.1:4222",
+				"subject": 123,
+			},
+			errorString: "nats.client subject error: not a string",
+		},
+	}
+
+	for _, test := range tests {
+		t.Run(test.name, func(t *testing.T) {
+
+			registration, ok := module.ModuleRegistry["nats.client"]
+			if !ok {
+				t.Fatalf("nats.client module not registered")
+			}
+
+			moduleInstance, err := registration.New(config.ModuleConfig{
+				Id:     "test",
+				Type:   "nats.client",
+				Params: test.params,
+			})
+
+			if err != nil {
+				if test.errorString != err.Error() {
+					t.Fatalf("nats.client got error '%s', expected '%s'", err.Error(), test.errorString)
+				}
+				return
+			}
+
+			err = moduleInstance.Start(t.Context())
+
+			if err == nil {
+				t.Fatalf("nats.client expected to fail")
+			}
+
+			if err.Error() != test.errorString {
+				t.Fatalf("nats.client got error '%s', expected '%s'", err.Error(), test.errorString)
+			}
+		})
+	}
+}

internal/module/test/nats-server_test.go

@@ -0,0 +1,85 @@
+package module_test
+
+import (
+	"testing"
+
+	"github.com/jwetzell/showbridge-go/internal/config"
+	"github.com/jwetzell/showbridge-go/internal/module"
+)
+
+func TestNATSServerFromRegistry(t *testing.T) {
+	registration, ok := module.ModuleRegistry["nats.server"]
+	if !ok {
+		t.Fatalf("nats.server module not registered")
+	}
+
+	moduleInstance, err := registration.New(config.ModuleConfig{
+		Id:   "test",
+		Type: "nats.server",
+		Params: map[string]any{
+			"ip":   "127.0.0.1",
+			"port": 4222,
+		},
+	})
+
+	if err != nil {
+		t.Fatalf("failed to create nats.server module: %s", err)
+	}
+
+	if moduleInstance.Id() != "test" {
+		t.Fatalf("nats.server module has wrong id: %s", moduleInstance.Id())
+	}
+
+	if moduleInstance.Type() != "nats.server" {
+		t.Fatalf("nats.server module has wrong type: %s", moduleInstance.Type())
+	}
+}
+
+func TestBadNATSServer(t *testing.T) {
+	tests := []struct {
+		name        string
+		params      map[string]any
+		errorString string
+	}{
+		{
+			name: "non-string ip",
+			params: map[string]any{
+				"ip": 123,
+			},
+			errorString: "nats.server ip error: not a string",
+		},
+	}
+
+	for _, test := range tests {
+		t.Run(test.name, func(t *testing.T) {
+
+			registration, ok := module.ModuleRegistry["nats.server"]
+			if !ok {
+				t.Fatalf("nats.server module not registered")
+			}
+
+			moduleInstance, err := registration.New(config.ModuleConfig{
+				Id:     "test",
+				Type:   "nats.server",
+				Params: test.params,
+			})
+
+			if err != nil {
+				if test.errorString != err.Error() {
+					t.Fatalf("nats.server got error '%s', expected '%s'", err.Error(), test.errorString)
+				}
+				return
+			}
+
+			err = moduleInstance.Start(t.Context())
+
+			if err == nil {
+				t.Fatalf("nats.server expected to fail")
+			}
+
+			if err.Error() != test.errorString {
+				t.Fatalf("nats.server got error '%s', expected '%s'", err.Error(), test.errorString)
+			}
+		})
+	}
+}

internal/module/test/psn-client_test.go

@@ -0,0 +1,73 @@
+package module_test
+
+import (
+	"testing"
+
+	"github.com/jwetzell/showbridge-go/internal/config"
+	"github.com/jwetzell/showbridge-go/internal/module"
+)
+
+func TestPSNClientFromRegistry(t *testing.T) {
+	registration, ok := module.ModuleRegistry["psn.client"]
+	if !ok {
+		t.Fatalf("psn.client module not registered")
+	}
+
+	moduleInstance, err := registration.New(config.ModuleConfig{
+		Id:   "test",
+		Type: "psn.client",
+	})
+
+	if err != nil {
+		t.Fatalf("failed to create psn.client module: %s", err)
+	}
+
+	if moduleInstance.Id() != "test" {
+		t.Fatalf("psn.client module has wrong id: %s", moduleInstance.Id())
+	}
+
+	if moduleInstance.Type() != "psn.client" {
+		t.Fatalf("psn.client module has wrong type: %s", moduleInstance.Type())
+	}
+}
+
+func TestBadPSNClient(t *testing.T) {
+	tests := []struct {
+		name        string
+		params      map[string]any
+		errorString string
+	}{}
+
+	for _, test := range tests {
+		t.Run(test.name, func(t *testing.T) {
+
+			registration, ok := module.ModuleRegistry["psn.client"]
+			if !ok {
+				t.Fatalf("psn.client module not registered")
+			}
+
+			moduleInstance, err := registration.New(config.ModuleConfig{
+				Id:     "test",
+				Type:   "psn.client",
+				Params: test.params,
+			})
+
+			if err != nil {
+				if test.errorString != err.Error() {
+					t.Fatalf("psn.client got error '%s', expected '%s'", err.Error(), test.errorString)
+				}
+				return
+			}
+
+			err = moduleInstance.Start(t.Context())
+
+			if err == nil {
+				t.Fatalf("psn.client expected to fail")
+			}
+
+			if err.Error() != test.errorString {
+				t.Fatalf("psn.client got error '%s', expected '%s'", err.Error(), test.errorString)
+			}
+		})
+	}
+}

internal/module/test/serial-client_test.go

@@ -0,0 +1,117 @@
+package module_test
+
+import (
+	"testing"
+
+	"github.com/jwetzell/showbridge-go/internal/config"
+	"github.com/jwetzell/showbridge-go/internal/module"
+)
+
+func TestSerialClientFromRegistry(t *testing.T) {
+	registration, ok := module.ModuleRegistry["serial.client"]
+	if !ok {
+		t.Fatalf("serial.client module not registered")
+	}
+
+	moduleInstance, err := registration.New(config.ModuleConfig{
+		Id:   "test",
+		Type: "serial.client",
+		Params: map[string]any{
+			"port":     "/dev/ttyUSB0",
+			"framing":  "LF",
+			"baudRate": 9600,
+		},
+	})
+
+	if err != nil {
+		t.Fatalf("failed to create serial.client module: %s", err)
+	}
+
+	if moduleInstance.Id() != "test" {
+		t.Fatalf("serial.client module has wrong id: %s", moduleInstance.Id())
+	}
+
+	if moduleInstance.Type() != "serial.client" {
+		t.Fatalf("serial.client module has wrong type: %s", moduleInstance.Type())
+	}
+}
+
+func TestBadSerialClient(t *testing.T) {
+	tests := []struct {
+		name        string
+		params      map[string]any
+		errorString string
+	}{
+		{
+			name: "no port param",
+			params: map[string]any{
+				"framing": "LF",
+			},
+			errorString: "serial.client port error: not found",
+		},
+		{
+			name: "non-string port param",
+			params: map[string]any{
+				"port":    8000,
+				"framing": "LF",
+			},
+			errorString: "serial.client port error: not a string",
+		},
+		{
+			name: "no framing param",
+			params: map[string]any{
+				"port": "/dev/ttyUSB0",
+			},
+			errorString: "serial.client framing error: not found",
+		},
+		{
+			name: "non-string framing param",
+			params: map[string]any{
+				"port":    "/dev/ttyUSB0",
+				"framing": 1,
+			},
+			errorString: "serial.client framing error: not a string",
+		},
+		{
+			name: "unkown framing method",
+			params: map[string]any{
+				"port":    "/dev/ttyUSB0",
+				"framing": "asdfasdfasdfasdflkj",
+			},
+			errorString: "serial.client unknown framing method: asdfasdfasdfasdflkj",
+		},
+	}
+
+	for _, test := range tests {
+		t.Run(test.name, func(t *testing.T) {
+
+			registration, ok := module.ModuleRegistry["serial.client"]
+			if !ok {
+				t.Fatalf("serial.client module not registered")
+			}
+
+			moduleInstance, err := registration.New(config.ModuleConfig{
+				Id:     "test",
+				Type:   "serial.client",
+				Params: test.params,
+			})
+
+			if err != nil {
+				if test.errorString != err.Error() {
+					t.Fatalf("serial.client got error '%s', expected '%s'", err.Error(), test.errorString)
+				}
+				return
+			}
+
+			err = moduleInstance.Start(t.Context())
+
+			if err == nil {
+				t.Fatalf("serial.client expected to fail")
+			}
+
+			if err.Error() != test.errorString {
+				t.Fatalf("serial.client got error '%s', expected '%s'", err.Error(), test.errorString)
+			}
+		})
+	}
+}

internal/module/test/sip-call-server_test.go

@@ -0,0 +1,102 @@
+package module_test
+
+import (
+	"testing"
+
+	"github.com/jwetzell/showbridge-go/internal/config"
+	"github.com/jwetzell/showbridge-go/internal/module"
+)
+
+func TestSIPCallServerFromRegistry(t *testing.T) {
+	registration, ok := module.ModuleRegistry["sip.call.server"]
+	if !ok {
+		t.Fatalf("sip.call.server module not registered")
+	}
+
+	moduleInstance, err := registration.New(config.ModuleConfig{
+		Id:   "test",
+		Type: "sip.call.server",
+	})
+
+	if err != nil {
+		t.Fatalf("failed to create sip.call.server module: %s", err)
+	}
+
+	if moduleInstance.Id() != "test" {
+		t.Fatalf("sip.call.server module has wrong id: %s", moduleInstance.Id())
+	}
+
+	if moduleInstance.Type() != "sip.call.server" {
+		t.Fatalf("sip.call.server module has wrong type: %s", moduleInstance.Type())
+	}
+}
+
+func TestBadSIPCallServer(t *testing.T) {
+	tests := []struct {
+		name        string
+		params      map[string]any
+		errorString string
+	}{
+		{
+			name: "non-number port param",
+			params: map[string]any{
+				"port": "8000",
+			},
+			errorString: "sip.call.server port error: not a number",
+		},
+		{
+			name: "non-string ip param",
+			params: map[string]any{
+				"ip": 123,
+			},
+			errorString: "sip.call.server ip error: not a string",
+		},
+		{
+			name: "non-string transport param",
+			params: map[string]any{
+				"transport": 123,
+			},
+			errorString: "sip.call.server transport error: not a string",
+		},
+		{
+			name: "non-string userAgent param",
+			params: map[string]any{
+				"userAgent": 123,
+			},
+			errorString: "sip.call.server userAgent error: not a string",
+		},
+	}
+
+	for _, test := range tests {
+		t.Run(test.name, func(t *testing.T) {
+
+			registration, ok := module.ModuleRegistry["sip.call.server"]
+			if !ok {
+				t.Fatalf("sip.call.server module not registered")
+			}
+
+			moduleInstance, err := registration.New(config.ModuleConfig{
+				Id:     "test",
+				Type:   "sip.call.server",
+				Params: test.params,
+			})
+
+			if err != nil {
+				if test.errorString != err.Error() {
+					t.Fatalf("sip.call.server got error '%s', expected '%s'", err.Error(), test.errorString)
+				}
+				return
+			}
+
+			err = moduleInstance.Start(t.Context())
+
+			if err == nil {
+				t.Fatalf("sip.call.server expected to fail")
+			}
+
+			if err.Error() != test.errorString {
+				t.Fatalf("sip.call.server got error '%s', expected '%s'", err.Error(), test.errorString)
+			}
+		})
+	}
+}

internal/module/test/sip-dtmf-server_test.go

@@ -0,0 +1,121 @@
+package module_test
+
+import (
+	"testing"
+
+	"github.com/jwetzell/showbridge-go/internal/config"
+	"github.com/jwetzell/showbridge-go/internal/module"
+)
+
+func TestSIPDTMFServerFromRegistry(t *testing.T) {
+	registration, ok := module.ModuleRegistry["sip.dtmf.server"]
+	if !ok {
+		t.Fatalf("sip.dtmf.server module not registered")
+	}
+
+	moduleInstance, err := registration.New(config.ModuleConfig{
+		Id:   "test",
+		Type: "sip.dtmf.server",
+		Params: map[string]any{
+			"separator": "#",
+		},
+	})
+
+	if err != nil {
+		t.Fatalf("failed to create sip.dtmf.server module: %s", err)
+	}
+
+	if moduleInstance.Id() != "test" {
+		t.Fatalf("sip.dtmf.server module has wrong id: %s", moduleInstance.Id())
+	}
+
+	if moduleInstance.Type() != "sip.dtmf.server" {
+		t.Fatalf("sip.dtmf.server module has wrong type: %s", moduleInstance.Type())
+	}
+}
+
+func TestBadSIPDTMFServer(t *testing.T) {
+	tests := []struct {
+		name        string
+		params      map[string]any
+		errorString string
+	}{
+		{
+			name:        "no separator param",
+			params:      map[string]any{},
+			errorString: "sip.dtmf.server separator error: not found",
+		},
+		{
+			name: "non-string separator param",
+			params: map[string]any{
+				"separator": 123,
+			},
+			errorString: "sip.dtmf.server separator error: not a string",
+		},
+		{
+			name: "non-number port param",
+			params: map[string]any{
+				"separator": "#",
+				"port":      "8000",
+			},
+			errorString: "sip.dtmf.server port error: not a number",
+		},
+		{
+			name: "non-string ip param",
+			params: map[string]any{
+				"separator": "#",
+				"ip":        123,
+			},
+			errorString: "sip.dtmf.server ip error: not a string",
+		},
+		{
+			name: "non-string transport param",
+			params: map[string]any{
+				"separator": "#",
+				"transport": 123,
+			},
+			errorString: "sip.dtmf.server transport error: not a string",
+		},
+		{
+			name: "non-string userAgent param",
+			params: map[string]any{
+				"separator": "#",
+				"userAgent": 123,
+			},
+			errorString: "sip.dtmf.server userAgent error: not a string",
+		},
+	}
+
+	for _, test := range tests {
+		t.Run(test.name, func(t *testing.T) {
+
+			registration, ok := module.ModuleRegistry["sip.dtmf.server"]
+			if !ok {
+				t.Fatalf("sip.dtmf.server module not registered")
+			}
+
+			moduleInstance, err := registration.New(config.ModuleConfig{
+				Id:     "test",
+				Type:   "sip.dtmf.server",
+				Params: test.params,
+			})
+
+			if err != nil {
+				if test.errorString != err.Error() {
+					t.Fatalf("sip.dtmf.server got error '%s', expected '%s'", err.Error(), test.errorString)
+				}
+				return
+			}
+
+			err = moduleInstance.Start(t.Context())
+
+			if err == nil {
+				t.Fatalf("sip.dtmf.server expected to fail")
+			}
+
+			if err.Error() != test.errorString {
+				t.Fatalf("sip.dtmf.server got error '%s', expected '%s'", err.Error(), test.errorString)
+			}
+		})
+	}
+}

internal/module/test/tcp-client_test.go

@@ -0,0 +1,109 @@
+package module_test
+
+import (
+	"testing"
+
+	"github.com/jwetzell/showbridge-go/internal/config"
+	"github.com/jwetzell/showbridge-go/internal/module"
+)
+
+func TestTCPClientFromRegistry(t *testing.T) {
+	registration, ok := module.ModuleRegistry["net.tcp.client"]
+	if !ok {
+		t.Fatalf("net.tcp.client module not registered")
+	}
+
+	moduleInstance, err := registration.New(config.ModuleConfig{
+		Id:   "test",
+		Type: "net.tcp.client",
+		Params: map[string]any{
+			"host":    "localhost",
+			"port":    8000,
+			"framing": "LF",
+		},
+	})
+
+	if err != nil {
+		t.Fatalf("failed to create net.tcp.client module: %s", err)
+	}
+
+	if moduleInstance.Id() != "test" {
+		t.Fatalf("net.tcp.client module has wrong id: %s", moduleInstance.Id())
+	}
+
+	if moduleInstance.Type() != "net.tcp.client" {
+		t.Fatalf("net.tcp.client module has wrong type: %s", moduleInstance.Type())
+	}
+}
+
+func TestBadTCPClient(t *testing.T) {
+	tests := []struct {
+		name        string
+		params      map[string]any
+		errorString string
+	}{
+		{
+			name: "no port param",
+			params: map[string]any{
+				"host": "localhost",
+			},
+			errorString: "net.tcp.client port error: not found",
+		},
+		{
+			name: "non-number port param",
+			params: map[string]any{
+				"host": "localhost",
+				"port": "8000",
+			},
+			errorString: "net.tcp.client port error: not a number",
+		},
+		{
+			name: "no host param",
+			params: map[string]any{
+				"port": 8000,
+			},
+			errorString: "net.tcp.client host error: not found",
+		},
+		{
+			name: "non-string host param",
+			params: map[string]any{
+				"host": 123,
+				"port": 8000,
+			},
+			errorString: "net.tcp.client host error: not a string",
+		},
+	}
+
+	for _, test := range tests {
+		t.Run(test.name, func(t *testing.T) {
+
+			registration, ok := module.ModuleRegistry["net.tcp.client"]
+			if !ok {
+				t.Fatalf("net.tcp.client module not registered")
+			}
+
+			moduleInstance, err := registration.New(config.ModuleConfig{
+				Id:     "test",
+				Type:   "net.tcp.client",
+				Params: test.params,
+			})
+
+			if err != nil {
+				if test.errorString != err.Error() {
+					t.Fatalf("net.tcp.client got error '%s', expected '%s'", err.Error(), test.errorString)
+				}
+				return
+			}
+
+			err = moduleInstance.Start(t.Context())
+
+			if err == nil {
+				t.Fatalf("net.tcp.client expected to fail")
+			}
+
+			if err.Error() != test.errorString {
+				t.Fatalf("net.tcp.client got error '%s', expected '%s'", err.Error(), test.errorString)
+			}
+		})
+	}
+}

internal/module/test/tcp-server_test.go

@@ -0,0 +1,134 @@
+package module_test
+
+import (
+	"testing"
+
+	"github.com/jwetzell/showbridge-go/internal/config"
+	"github.com/jwetzell/showbridge-go/internal/module"
+)
+
+func TestTCPServerFromRegistry(t *testing.T) {
+	registration, ok := module.ModuleRegistry["net.tcp.server"]
+	if !ok {
+		t.Fatalf("net.tcp.server module not registered")
+	}
+
+	moduleInstance, err := registration.New(config.ModuleConfig{
+		Id:   "test",
+		Type: "net.tcp.server",
+		Params: map[string]any{
+			"port":    8000,
+			"framing": "LF",
+		},
+	})
+
+	if err != nil {
+		t.Fatalf("failed to create net.tcp.server module: %s", err)
+	}
+
+	if moduleInstance.Id() != "test" {
+		t.Fatalf("net.tcp.server module has wrong id: %s", moduleInstance.Id())
+	}
+
+	if moduleInstance.Type() != "net.tcp.server" {
+		t.Fatalf("net.tcp.server module has wrong type: %s", moduleInstance.Type())
+	}
+}
+
+func TestBadTCPServer(t *testing.T) {
+	tests := []struct {
+		name        string
+		params      map[string]any
+		errorString string
+	}{
+		{
+			name: "no port param",
+			params: map[string]any{
+				"framing": "LF",
+			},
+			errorString: "net.tcp.server port error: not found",
+		},
+		{
+			name: "non-number port param",
+			params: map[string]any{
+				"port":    "8000",
+				"framing": "LF",
+			},
+			errorString: "net.tcp.server port error: not a number",
+		},
+		{
+			name: "no framing param",
+			params: map[string]any{
+				"port": 8000,
+			},
+			errorString: "net.tcp.server framing error: not found",
+		},
+		{
+			name: "non-string framing param",
+			params: map[string]any{
+				"port":    8000,
+				"framing": 1,
+			},
+			errorString: "net.tcp.server framing error: not a string",
+		},
+		{
+			name: "unkown framing method",
+			params: map[string]any{
+				"port":    8000,
+				"framing": "asdfasdfasdfasdflkj",
+			},
+			errorString: "net.tcp.server unknown framing method: asdfasdfasdfasdflkj",
+		},
+		{
+			name: "non-string ip param",
+			params: map[string]any{
+				"port":    8000,
+				"framing": "LF",
+				"ip":      123,
+			},
+			errorString: "net.tcp.server ip error: not a string",
+		},
+		{
+			name: "invalid addr",
+			params: map[string]any{
+				"ip":      "127.0.0.",
+				"port":    8000,
+				"framing": "LF",
+			},
+			errorString: "lookup 127.0.0.: no such host",
+		},
+	}
+
+	for _, test := range tests {
+		t.Run(test.name, func(t *testing.T) {
+
+			registration, ok := module.ModuleRegistry["net.tcp.server"]
+			if !ok {
+				t.Fatalf("net.tcp.server module not registered")
+			}
+
+			moduleInstance, err := registration.New(config.ModuleConfig{
+				Id:     "test",
+				Type:   "net.tcp.server",
+				Params: test.params,
+			})
+
+			if err != nil {
+				if test.errorString != err.Error() {
+					t.Fatalf("net.tcp.server got error '%s', expected '%s'", err.Error(), test.errorString)
+				}
+				return
+			}
+
+			err = moduleInstance.Start(t.Context())
+
+			if err == nil {
+				t.Fatalf("net.tcp.server expected to fail")
+			}
+
+			if err.Error() != test.errorString {
+				t.Fatalf("net.tcp.server got error '%s', expected '%s'", err.Error(), test.errorString)
+			}
+		})
+	}
+}

internal/module/test/time-interval_test.go

@@ -0,0 +1,89 @@
+package module_test
+
+import (
+	"testing"
+
+	"github.com/jwetzell/showbridge-go/internal/config"
+	"github.com/jwetzell/showbridge-go/internal/module"
+)
+
+func TestTimeIntervalFromRegistry(t *testing.T) {
+	registration, ok := module.ModuleRegistry["time.interval"]
+	if !ok {
+		t.Fatalf("time.interval module not registered")
+	}
+
+	moduleInstance, err := registration.New(config.ModuleConfig{
+		Id:   "test",
+		Type: "time.interval",
+		Params: map[string]any{
+			"duration": 1000,
+		},
+	})
+
+	if err != nil {
+		t.Fatalf("failed to create time.interval module: %s", err)
+	}
+
+	if moduleInstance.Id() != "test" {
+		t.Fatalf("time.interval module has wrong id: %s", moduleInstance.Id())
+	}
+
+	if moduleInstance.Type() != "time.interval" {
+		t.Fatalf("time.interval module has wrong type: %s", moduleInstance.Type())
+	}
+}
+
+func TestBadTimeInterval(t *testing.T) {
+	tests := []struct {
+		name        string
+		params      map[string]any
+		errorString string
+	}{
+		{
+			name:        "no duration param",
+			params:      map[string]any{},
+			errorString: "time.interval duration error: not found",
+		},
+		{
+			name: "non-number duration param",
+			params: map[string]any{
+				"duration": "8000",
+			},
+			errorString: "time.interval duration error: not a number",
+		},
+	}
+
+	for _, test := range tests {
+		t.Run(test.name, func(t *testing.T) {
+
+			registration, ok := module.ModuleRegistry["time.interval"]
+			if !ok {
+				t.Fatalf("time.interval module not registered")
+			}
+
+			moduleInstance, err := registration.New(config.ModuleConfig{
+				Id:     "test",
+				Type:   "time.interval",
+				Params: test.params,
+			})
+
+			if err != nil {
+				if test.errorString != err.Error() {
+					t.Fatalf("time.interval got error '%s', expected '%s'", err.Error(), test.errorString)
+				}
+				return
+			}
+
+			err = moduleInstance.Start(t.Context())
+
+			if err == nil {
+				t.Fatalf("time.interval expected to fail")
+			}
+
+			if err.Error() != test.errorString {
+				t.Fatalf("time.interval got error '%s', expected '%s'", err.Error(), test.errorString)
+			}
+		})
+	}
+}

internal/module/test/time-timer_test.go

@@ -0,0 +1,89 @@
+package module_test
+
+import (
+	"testing"
+
+	"github.com/jwetzell/showbridge-go/internal/config"
+	"github.com/jwetzell/showbridge-go/internal/module"
+)
+
+func TestTimeTimerFromRegistry(t *testing.T) {
+	registration, ok := module.ModuleRegistry["time.timer"]
+	if !ok {
+		t.Fatalf("time.timer module not registered")
+	}
+
+	moduleInstance, err := registration.New(config.ModuleConfig{
+		Id:   "test",
+		Type: "time.timer",
+		Params: map[string]any{
+			"duration": 1000,
+		},
+	})
+
+	if err != nil {
+		t.Fatalf("failed to create time.timer module: %s", err)
+	}
+
+	if moduleInstance.Id() != "test" {
+		t.Fatalf("time.timer module has wrong id: %s", moduleInstance.Id())
+	}
+
+	if moduleInstance.Type() != "time.timer" {
+		t.Fatalf("time.timer module has wrong type: %s", moduleInstance.Type())
+	}
+}
+
+func TestBadTimeTimer(t *testing.T) {
+	tests := []struct {
+		name        string
+		params      map[string]any
+		errorString string
+	}{
+		{
+			name:        "no duration param",
+			params:      map[string]any{},
+			errorString: "time.timer duration error: not found",
+		},
+		{
+			name: "non-number duration param",
+			params: map[string]any{
+				"duration": "8000",
+			},
+			errorString: "time.timer duration error: not a number",
+		},
+	}
+
+	for _, test := range tests {
+		t.Run(test.name, func(t *testing.T) {
+
+			registration, ok := module.ModuleRegistry["time.timer"]
+			if !ok {
+				t.Fatalf("time.timer module not registered")
+			}
+
+			moduleInstance, err := registration.New(config.ModuleConfig{
+				Id:     "test",
+				Type:   "time.timer",
+				Params: test.params,
+			})
+
+			if err != nil {
+				if test.errorString != err.Error() {
+					t.Fatalf("time.timer got error '%s', expected '%s'", err.Error(), test.errorString)
+				}
+				return
+			}
+
+			err = moduleInstance.Start(t.Context())
+
+			if err == nil {
+				t.Fatalf("time.timer expected to fail")
+			}
+
+			if err.Error() != test.errorString {
+				t.Fatalf("time.timer got error '%s', expected '%s'", err.Error(), test.errorString)
+			}
+		})
+	}
+}

internal/module/test/udp-client_test.go

@@ -0,0 +1,109 @@
+package module_test
+
+import (
+	"testing"
+
+	"github.com/jwetzell/showbridge-go/internal/config"
+	"github.com/jwetzell/showbridge-go/internal/module"
+)
+
+func TestUDPClientFromRegistry(t *testing.T) {
+	registration, ok := module.ModuleRegistry["net.udp.client"]
+	if !ok {
+		t.Fatalf("udp.client module not registered")
+	}
+
+	moduleInstance, err := registration.New(config.ModuleConfig{
+		Id:   "test",
+		Type: "net.udp.client",
+		Params: map[string]any{
+			"host":    "localhost",
+			"port":    8000,
+			"framing": "LF",
+		},
+	})
+
+	if err != nil {
+		t.Fatalf("failed to create net.udp.client module: %s", err)
+	}
+
+	if moduleInstance.Id() != "test" {
+		t.Fatalf("net.udp.client module has wrong id: %s", moduleInstance.Id())
+	}
+
+	if moduleInstance.Type() != "net.udp.client" {
+		t.Fatalf("net.udp.client module has wrong type: %s", moduleInstance.Type())
+	}
+}
+
+func TestBadUDPClient(t *testing.T) {
+	tests := []struct {
+		name        string
+		params      map[string]any
+		errorString string
+	}{
+		{
+			name: "no port param",
+			params: map[string]any{
+				"host": "localhost",
+			},
+			errorString: "net.udp.client port error: not found",
+		},
+		{
+			name: "non-number port param",
+			params: map[string]any{
+				"host": "localhost",
+				"port": "8000",
+			},
+			errorString: "net.udp.client port error: not a number",
+		},
+		{
+			name: "no host param",
+			params: map[string]any{
+				"port": 8000,
+			},
+			errorString: "net.udp.client host error: not found",
+		},
+		{
+			name: "non-string host param",
+			params: map[string]any{
+				"host": 123,
+				"port": 8000,
+			},
+			errorString: "net.udp.client host error: not a string",
+		},
+	}
+
+	for _, test := range tests {
+		t.Run(test.name, func(t *testing.T) {
+
+			registration, ok := module.ModuleRegistry["net.udp.client"]
+			if !ok {
+				t.Fatalf("net.udp.client module not registered")
+			}
+
+			moduleInstance, err := registration.New(config.ModuleConfig{
+				Id:     "test",
+				Type:   "net.udp.client",
+				Params: test.params,
+			})
+
+			if err != nil {
+				if test.errorString != err.Error() {
+					t.Fatalf("net.udp.client got error '%s', expected '%s'", err.Error(), test.errorString)
+				}
+				return
+			}
+
+			err = moduleInstance.Start(t.Context())
+
+			if err == nil {
+				t.Fatalf("net.udp.client expected to fail")
+			}
+
+			if err.Error() != test.errorString {
+				t.Fatalf("net.udp.client got error '%s', expected '%s'", err.Error(), test.errorString)
+			}
+		})
+	}
+}

internal/module/test/udp-multicast_test.go

@@ -0,0 +1,116 @@
+package module_test
+
+import (
+	"testing"
+
+	"github.com/jwetzell/showbridge-go/internal/config"
+	"github.com/jwetzell/showbridge-go/internal/module"
+)
+
+func TestUDPMulticastFromRegistry(t *testing.T) {
+	registration, ok := module.ModuleRegistry["net.udp.multicast"]
+	if !ok {
+		t.Fatalf("udp.multicast module not registered")
+	}
+
+	moduleInstance, err := registration.New(config.ModuleConfig{
+		Id:   "test",
+		Type: "net.udp.multicast",
+		Params: map[string]any{
+			"ip":   "236.10.10.10",
+			"port": 56565,
+		},
+	})
+
+	if err != nil {
+		t.Fatalf("failed to create net.udp.multicast module: %s", err)
+	}
+
+	if moduleInstance.Id() != "test" {
+		t.Fatalf("net.udp.multicast module has wrong id: %s", moduleInstance.Id())
+	}
+
+	if moduleInstance.Type() != "net.udp.multicast" {
+		t.Fatalf("net.udp.multicast module has wrong type: %s", moduleInstance.Type())
+	}
+}
+
+func TestBadUDPMulticast(t *testing.T) {
+	tests := []struct {
+		name        string
+		params      map[string]any
+		errorString string
+	}{
+		{
+			name: "no port param",
+			params: map[string]any{
+				"ip": "localhost",
+			},
+			errorString: "net.udp.multicast port error: not found",
+		},
+		{
+			name: "non-number port param",
+			params: map[string]any{
+				"ip":   "localhost",
+				"port": "8000",
+			},
+			errorString: "net.udp.multicast port error: not a number",
+		},
+		{
+			name: "no ip param",
+			params: map[string]any{
+				"port": 8000,
+			},
+			errorString: "net.udp.multicast ip error: not found",
+		},
+		{
+			name: "non-string ip param",
+			params: map[string]any{
+				"ip":   123,
+				"port": 8000,
+			},
+			errorString: "net.udp.multicast ip error: not a string",
+		},
+		{
+			name: "invalid addr",
+			params: map[string]any{
+				"ip":   "127.0.0.",
+				"port": 8000,
+			},
+			errorString: "lookup 127.0.0.: no such host",
+		},
+	}
+
+	for _, test := range tests {
+		t.Run(test.name, func(t *testing.T) {
+
+			registration, ok := module.ModuleRegistry["net.udp.multicast"]
+			if !ok {
+				t.Fatalf("net.udp.multicast module not registered")
+			}
+
+			moduleInstance, err := registration.New(config.ModuleConfig{
+				Id:     "test",
+				Type:   "net.udp.multicast",
+				Params: test.params,
+			})
+
+			if err != nil {
+				if test.errorString != err.Error() {
+					t.Fatalf("net.udp.multicast got error '%s', expected '%s'", err.Error(), test.errorString)
+				}
+				return
+			}
+
+			err = moduleInstance.Start(t.Context())
+
+			if err == nil {
+				t.Fatalf("net.udp.multicast expected to fail")
+			}
+
+			if err.Error() != test.errorString {
+				t.Fatalf("net.udp.multicast got error '%s', expected '%s'", err.Error(), test.errorString)
+			}
+		})
+	}
+}

internal/module/test/udp-server_test.go

@@ -0,0 +1,113 @@
+package module_test
+
+import (
+	"testing"
+
+	"github.com/jwetzell/showbridge-go/internal/config"
+	"github.com/jwetzell/showbridge-go/internal/module"
+)
+
+func TestUDPServerFromRegistry(t *testing.T) {
+	registration, ok := module.ModuleRegistry["net.udp.server"]
+	if !ok {
+		t.Fatalf("net.udp.server module not registered")
+	}
+
+	moduleInstance, err := registration.New(config.ModuleConfig{
+		Id:   "test",
+		Type: "net.udp.server",
+		Params: map[string]any{
+			"port": 8000,
+		},
+	})
+
+	if err != nil {
+		t.Fatalf("failed to create udp.server module: %s", err)
+	}
+
+	if moduleInstance.Id() != "test" {
+		t.Fatalf("udp.server module has wrong id: %s", moduleInstance.Id())
+	}
+
+	if moduleInstance.Type() != "net.udp.server" {
+		t.Fatalf("net.udp.server module has wrong type: %s", moduleInstance.Type())
+	}
+}
+
+func TestBadUDPServer(t *testing.T) {
+	tests := []struct {
+		name        string
+		params      map[string]any
+		errorString string
+	}{
+		{
+			name:        "no port param",
+			params:      map[string]any{},
+			errorString: "net.udp.server port error: not found",
+		},
+		{
+			name: "non-number port param",
+			params: map[string]any{
+				"port": "8000",
+			},
+			errorString: "net.udp.server port error: not a number",
+		},
+		{
+			name: "non-string ip param",
+			params: map[string]any{
+				"port": 8000,
+				"ip":   123,
+			},
+			errorString: "net.udp.server ip error: not a string",
+		},
+		{
+			name: "non-number bufferSize param",
+			params: map[string]any{
+				"port":       8000,
+				"bufferSize": "1024",
+			},
+			errorString: "net.udp.server bufferSize error: not a number",
+		},
+		{
+			name: "invalid addr",
+			params: map[string]any{
+				"ip":   "127.0.0.",
+				"port": 8000,
+			},
+			errorString: "lookup 127.0.0.: no such host",
+		},
+	}
+
+	for _, test := range tests {
+		t.Run(test.name, func(t *testing.T) {
+
+			registration, ok := module.ModuleRegistry["net.udp.server"]
+			if !ok {
+				t.Fatalf("net.udp.server module not registered")
+			}
+
+			moduleInstance, err := registration.New(config.ModuleConfig{
+				Id:     "test",
+				Type:   "net.udp.server",
+				Params: test.params,
+			})
+
+			if err != nil {
+				if test.errorString != err.Error() {
+					t.Fatalf("net.udp.server got error '%s', expected '%s'", err.Error(), test.errorString)
+				}
+				return
+			}
+
+			err = moduleInstance.Start(t.Context())
+
+			if err == nil {
+				t.Fatalf("net.udp.server expected to fail")
+			}
+
+			if err.Error() != test.errorString {
+				t.Fatalf("net.udp.server got error '%s', expected '%s'", err.Error(), test.errorString)
+			}
+		})
+	}
+}

internal/module/time-interval.go

@@ -3,20 +3,22 @@ package module
 import (
 	"context"
 	"errors"
+	"fmt"
 	"log/slog"
 	"time"
 
+	"github.com/jwetzell/showbridge-go/internal/common"
 	"github.com/jwetzell/showbridge-go/internal/config"
-	"github.com/jwetzell/showbridge-go/internal/route"
 )
 
 type TimeInterval struct {
 	config   config.ModuleConfig
 	Duration uint32
 	ctx      context.Context
-	router   route.RouteIO
+	router   common.RouteIO
 	ticker   *time.Ticker
 	logger   *slog.Logger
+	cancel   context.CancelFunc
 }
 
 func init() {
@@ -25,17 +27,11 @@ func init() {
 		New: func(config config.ModuleConfig) (Module, error) {
 			params := config.Params
 
-			duration, ok := params["duration"]
-			if !ok {
-				return nil, errors.New("time.interval requires a duration parameter")
+			durationInt, err := params.GetInt("duration")
+			if err != nil {
+				return nil, fmt.Errorf("time.interval duration error: %w", err)
 			}
-
-			durationNum, ok := duration.(float64)
-
-			if !ok {
-				return nil, errors.New("time.interval duration must be number")
-			}
-			return &TimeInterval{Duration: uint32(durationNum), config: config, logger: CreateLogger(config)}, nil
+			return &TimeInterval{Duration: uint32(durationInt), config: config, logger: CreateLogger(config)}, nil
 		},
 	})
 }
@@ -48,15 +44,17 @@ func (i *TimeInterval) Type() string {
 	return i.config.Type
 }
 
-func (i *TimeInterval) Run(ctx context.Context) error {
-
-	router, ok := ctx.Value(route.RouterContextKey).(route.RouteIO)
+func (i *TimeInterval) Start(ctx context.Context) error {
+	i.logger.Debug("running")
+	router, ok := ctx.Value(common.RouterContextKey).(common.RouteIO)
 
 	if !ok {
 		return errors.New("time.interval unable to get router from context")
 	}
 	i.router = router
-	i.ctx = ctx
+	moduleContext, cancel := context.WithCancel(ctx)
+	i.ctx = moduleContext
+	i.cancel = cancel
 
 	ticker := time.NewTicker(time.Millisecond * time.Duration(i.Duration))
 	i.ticker = ticker
@@ -80,3 +78,16 @@ func (i *TimeInterval) Output(ctx context.Context, payload any) error {
 	i.ticker.Reset(time.Millisecond * time.Duration(i.Duration))
 	return nil
 }
+
+func (i *TimeInterval) Stop() {
+	i.cancel()
+}
+
+func (i *TimeInterval) Get(key string) (any, error) {
+	switch key {
+	case "duration":
+		return i.Duration, nil
+	default:
+		return nil, errors.New("time.interval key not found")
+	}
+}

internal/module/time-timer.go

@@ -3,20 +3,22 @@ package module
 import (
 	"context"
 	"errors"
+	"fmt"
 	"log/slog"
 	"time"
 
+	"github.com/jwetzell/showbridge-go/internal/common"
 	"github.com/jwetzell/showbridge-go/internal/config"
-	"github.com/jwetzell/showbridge-go/internal/route"
 )
 
 type TimeTimer struct {
 	config   config.ModuleConfig
 	Duration uint32
 	ctx      context.Context
-	router   route.RouteIO
+	router   common.RouteIO
 	timer    *time.Timer
 	logger   *slog.Logger
+	cancel   context.CancelFunc
 }
 
 func init() {
@@ -25,15 +27,9 @@ func init() {
 		New: func(config config.ModuleConfig) (Module, error) {
 			params := config.Params
 
-			duration, ok := params["duration"]
-			if !ok {
-				return nil, errors.New("time.timer requires a duration parameter")
-			}
-
-			durationNum, ok := duration.(float64)
-
-			if !ok {
-				return nil, errors.New("time.timer duration must be a number")
+			durationNum, err := params.GetInt("duration")
+			if err != nil {
+				return nil, fmt.Errorf("time.timer duration error: %w", err)
 			}
 
 			return &TimeTimer{Duration: uint32(durationNum), config: config, logger: CreateLogger(config)}, nil
@@ -49,15 +45,17 @@ func (t *TimeTimer) Type() string {
 	return t.config.Type
 }
 
-func (t *TimeTimer) Run(ctx context.Context) error {
-
-	router, ok := ctx.Value(route.RouterContextKey).(route.RouteIO)
+func (t *TimeTimer) Start(ctx context.Context) error {
+	t.logger.Debug("running")
+	router, ok := ctx.Value(common.RouterContextKey).(common.RouteIO)
 
 	if !ok {
 		return errors.New("net.tcp.client unable to get router from context")
 	}
 	t.router = router
-	t.ctx = ctx
+	moduleContext, cancel := context.WithCancel(ctx)
+	t.ctx = moduleContext
+	t.cancel = cancel
 
 	t.timer = time.NewTimer(time.Millisecond * time.Duration(t.Duration))
 	defer t.timer.Stop()
@@ -79,3 +77,16 @@ func (t *TimeTimer) Output(ctx context.Context, payload any) error {
 	t.timer.Reset(time.Millisecond * time.Duration(t.Duration))
 	return nil
 }
+
+func (t *TimeTimer) Stop() {
+	t.cancel()
+}
+
+func (t *TimeTimer) Get(key string) (any, error) {
+	switch key {
+	case "duration":
+		return t.Duration, nil
+	default:
+		return nil, errors.New("time.timer key not found")
+	}
+}

internal/module/udp-client.go

@@ -7,8 +7,9 @@ import (
 	"log/slog"
 	"net"
 
+	"github.com/jwetzell/showbridge-go/internal/common"
 	"github.com/jwetzell/showbridge-go/internal/config"
-	"github.com/jwetzell/showbridge-go/internal/route"
+	"github.com/jwetzell/showbridge-go/internal/processor"
 )
 
 type UDPClient struct {
@@ -17,8 +18,9 @@ type UDPClient struct {
 	Port   uint16
 	conn   *net.UDPConn
 	ctx    context.Context
-	router route.RouteIO
+	router common.RouteIO
 	logger *slog.Logger
+	cancel context.CancelFunc
 }
 
 func init() {
@@ -26,27 +28,14 @@ func init() {
 		Type: "net.udp.client",
 		New: func(config config.ModuleConfig) (Module, error) {
 			params := config.Params
-			host, ok := params["host"]
-
-			if !ok {
-				return nil, errors.New("net.udp.client requires a host parameter")
+			hostString, err := params.GetString("host")
+			if err != nil {
+				return nil, fmt.Errorf("net.udp.client host error: %w", err)
 			}
 
-			hostString, ok := host.(string)
-
-			if !ok {
-				return nil, errors.New("net.udp.client host must be a string")
-			}
-
-			port, ok := params["port"]
-			if !ok {
-				return nil, errors.New("net.udp.client requires a port parameter")
-			}
-
-			portNum, ok := port.(float64)
-
-			if !ok {
-				return nil, errors.New("net.udp.client port must be a number")
+			portNum, err := params.GetInt("port")
+			if err != nil {
+				return nil, fmt.Errorf("net.udp.client port error: %w", err)
 			}
 
 			addr, err := net.ResolveUDPAddr("udp", fmt.Sprintf("%s:%d", hostString, uint16(portNum)))
@@ -72,15 +61,17 @@ func (uc *UDPClient) SetupConn() error {
 	return err
 }
 
-func (uc *UDPClient) Run(ctx context.Context) error {
-
-	router, ok := ctx.Value(route.RouterContextKey).(route.RouteIO)
+func (uc *UDPClient) Start(ctx context.Context) error {
+	uc.logger.Debug("running")
+	router, ok := ctx.Value(common.RouterContextKey).(common.RouteIO)
 
 	if !ok {
 		return errors.New("net.udp.client unable to get router from context")
 	}
 	uc.router = router
-	uc.ctx = ctx
+	moduleContext, cancel := context.WithCancel(ctx)
+	uc.ctx = moduleContext
+	uc.cancel = cancel
 
 	err := uc.SetupConn()
 	if err != nil {
@@ -97,7 +88,7 @@ func (uc *UDPClient) Run(ctx context.Context) error {
 
 func (uc *UDPClient) Output(ctx context.Context, payload any) error {
 
-	payloadBytes, ok := payload.([]byte)
+	payloadBytes, ok := processor.GetAnyAs[[]byte](payload)
 	if !ok {
 		return errors.New("net.udp.client is only able to output bytes")
 	}
@@ -112,3 +103,24 @@ func (uc *UDPClient) Output(ctx context.Context, payload any) error {
 	}
 	return nil
 }
+
+func (uc *UDPClient) Stop() {
+	uc.cancel()
+}
+
+func (uc *UDPClient) Get(key string) (any, error) {
+	switch key {
+	case "host":
+		host, err := uc.config.Params.GetString("host")
+		if err != nil {
+			return nil, fmt.Errorf("net.udp.client host error: %w", err)
+		}
+		return host, nil
+	case "ip":
+		return uc.Addr.IP.String(), nil
+	case "port":
+		return uc.Addr.Port, nil
+	default:
+		return nil, errors.New("net.udp.client key not found")
+	}
+}

internal/module/udp-multicast.go

@@ -8,52 +8,41 @@ import (
 	"net"
 	"time"
 
+	"github.com/jwetzell/showbridge-go/internal/common"
 	"github.com/jwetzell/showbridge-go/internal/config"
-	"github.com/jwetzell/showbridge-go/internal/route"
+	"github.com/jwetzell/showbridge-go/internal/processor"
 )
 
 type UDPMulticast struct {
 	config config.ModuleConfig
 	conn   *net.UDPConn
 	ctx    context.Context
-	router route.RouteIO
+	router common.RouteIO
 	Addr   *net.UDPAddr
 	logger *slog.Logger
+	cancel context.CancelFunc
 }
 
 func init() {
 	RegisterModule(ModuleRegistration{
 		Type: "net.udp.multicast",
-		New: func(config config.ModuleConfig) (Module, error) {
-			params := config.Params
-			ip, ok := params["ip"]
-
-			if !ok {
-				return nil, errors.New("net.udp.multicast requires an ip parameter")
+		New: func(moduleConfig config.ModuleConfig) (Module, error) {
+			params := moduleConfig.Params
+			ipString, err := params.GetString("ip")
+			if err != nil {
+				return nil, fmt.Errorf("net.udp.multicast ip error: %w", err)
 			}
 
-			ipString, ok := ip.(string)
-
-			if !ok {
-				return nil, errors.New("net.udp.multicast ip must be a string")
-			}
-
-			port, ok := params["port"]
-			if !ok {
-				return nil, errors.New("net.udp.multicast requires a port parameter")
-			}
-
-			portNum, ok := port.(float64)
-
-			if !ok {
-				return nil, errors.New("net.udp.multicast port must be a number")
+			portNum, err := params.GetInt("port")
+			if err != nil {
+				return nil, fmt.Errorf("net.udp.multicast port error: %w", err)
 			}
 
 			addr, err := net.ResolveUDPAddr("udp", fmt.Sprintf("%s:%d", ipString, uint16(portNum)))
 			if err != nil {
 				return nil, err
 			}
-			return &UDPMulticast{config: config, Addr: addr, logger: CreateLogger(config)}, nil
+			return &UDPMulticast{config: moduleConfig, Addr: addr, logger: CreateLogger(moduleConfig)}, nil
 		},
 	})
 }
@@ -66,15 +55,17 @@ func (um *UDPMulticast) Type() string {
 	return um.config.Type
 }
 
-func (um *UDPMulticast) Run(ctx context.Context) error {
-
-	router, ok := ctx.Value(route.RouterContextKey).(route.RouteIO)
+func (um *UDPMulticast) Start(ctx context.Context) error {
+	um.logger.Debug("running")
+	router, ok := ctx.Value(common.RouterContextKey).(common.RouteIO)
 
 	if !ok {
 		return errors.New("net.udp.multicast unable to get router from context")
 	}
 	um.router = router
-	um.ctx = ctx
+	moduleContext, cancel := context.WithCancel(ctx)
+	um.ctx = moduleContext
+	um.cancel = cancel
 
 	client, err := net.ListenMulticastUDP("udp", nil, um.Addr)
 	if err != nil {
@@ -118,7 +109,7 @@ func (um *UDPMulticast) Run(ctx context.Context) error {
 
 func (um *UDPMulticast) Output(ctx context.Context, payload any) error {
 
-	payloadBytes, ok := payload.([]byte)
+	payloadBytes, ok := processor.GetAnyAs[[]byte](payload)
 	if !ok {
 		return errors.New("net.udp.multicast can only output bytes")
 	}
@@ -130,3 +121,18 @@ func (um *UDPMulticast) Output(ctx context.Context, payload any) error {
 	_, err := um.conn.Write(payloadBytes)
 	return err
 }
+
+func (um *UDPMulticast) Stop() {
+	um.cancel()
+}
+
+func (um *UDPMulticast) Get(key string) (any, error) {
+	switch key {
+	case "ip":
+		return um.Addr.IP.String(), nil
+	case "port":
+		return um.Addr.Port, nil
+	default:
+		return nil, errors.New("net.udp.multicast key not found")
+	}
+}

internal/module/udp-server.go

@@ -4,13 +4,12 @@ import (
 	"context"
 	"errors"
 	"fmt"
-	"log"
 	"log/slog"
 	"net"
 	"time"
 
+	"github.com/jwetzell/showbridge-go/internal/common"
 	"github.com/jwetzell/showbridge-go/internal/config"
-	"github.com/jwetzell/showbridge-go/internal/route"
 )
 
 type UDPServer struct {
@@ -18,56 +17,44 @@ type UDPServer struct {
 	BufferSize int
 	config     config.ModuleConfig
 	ctx        context.Context
-	router     route.RouteIO
+	router     common.RouteIO
 	logger     *slog.Logger
+	cancel     context.CancelFunc
 }
 
 func init() {
 	RegisterModule(ModuleRegistration{
 		Type: "net.udp.server",
-		New: func(config config.ModuleConfig) (Module, error) {
-			params := config.Params
-			port, ok := params["port"]
-			if !ok {
-				return nil, errors.New("net.udp.server requires a port parameter")
+		New: func(moduleConfig config.ModuleConfig) (Module, error) {
+			params := moduleConfig.Params
+			portNum, err := params.GetInt("port")
+			if err != nil {
+				return nil, fmt.Errorf("net.udp.server port error: %w", err)
 			}
 
-			portNum, ok := port.(float64)
-
-			if !ok {
-				return nil, errors.New("net.udp.server port must be a number")
+			ipString, err := params.GetString("ip")
+			if err != nil {
+				if errors.Is(err, config.ErrParamNotFound) {
+					ipString = "0.0.0.0"
+				} else {
+					return nil, fmt.Errorf("net.udp.server ip error: %w", err)
 				}
-
-			ipString := "0.0.0.0"
-
-			ip, ok := params["ip"]
-			if ok {
-
-				specificIpString, ok := ip.(string)
-
-				if !ok {
-					return nil, errors.New("net.udp.server ip must be a string")
-				}
-				ipString = specificIpString
 			}
 
 			addr, err := net.ResolveUDPAddr("udp", fmt.Sprintf("%s:%d", ipString, uint16(portNum)))
 			if err != nil {
-				log.Fatalf("error resolving UDP address: %v", err)
+				return nil, err
 			}
 
-			bufferSizeNum := 2048
-			bufferSize, ok := params["bufferSize"]
-
-			if ok {
-				bufferSizeFloat, ok := bufferSize.(float64)
-
-				if !ok {
-					return nil, errors.New("net.udp.server bufferSize must be a number")
+			bufferSizeNum, err := params.GetInt("bufferSize")
+			if err != nil {
+				if errors.Is(err, config.ErrParamNotFound) {
+					bufferSizeNum = 2048
+				} else {
+					return nil, fmt.Errorf("net.udp.server bufferSize error: %w", err)
 				}
-				bufferSizeNum = int(bufferSizeFloat)
 			}
-			return &UDPServer{Addr: addr, BufferSize: bufferSizeNum, config: config, logger: CreateLogger(config)}, nil
+			return &UDPServer{Addr: addr, BufferSize: bufferSizeNum, config: moduleConfig, logger: CreateLogger(moduleConfig)}, nil
 		},
 	})
 }
@@ -77,18 +64,20 @@ func (us *UDPServer) Id() string {
 }
 
 func (us *UDPServer) Type() string {
-	return us.config.Id
+	return us.config.Type
 }
 
-func (us *UDPServer) Run(ctx context.Context) error {
-
-	router, ok := ctx.Value(route.RouterContextKey).(route.RouteIO)
+func (us *UDPServer) Start(ctx context.Context) error {
+	us.logger.Debug("running")
+	router, ok := ctx.Value(common.RouterContextKey).(common.RouteIO)
 
 	if !ok {
 		return errors.New("net.udp.server unable to get router from context")
 	}
 	us.router = router
-	us.ctx = ctx
+	moduleContext, cancel := context.WithCancel(ctx)
+	us.ctx = moduleContext
+	us.cancel = cancel
 
 	listener, err := net.ListenUDP("udp", us.Addr)
 	if err != nil {
@@ -107,7 +96,7 @@ func (us *UDPServer) Run(ctx context.Context) error {
 		default:
 			listener.SetDeadline(time.Now().Add(time.Millisecond * 200))
 
-			numBytes, _, err := listener.ReadFromUDP(buffer)
+			numBytes, senderAddr, err := listener.ReadFromUDP(buffer)
 			if err != nil {
 				//NOTE(jwetzell) we hit deadline
 				if opErr, ok := err.(*net.OpError); ok && opErr.Timeout() {
@@ -117,7 +106,8 @@ func (us *UDPServer) Run(ctx context.Context) error {
 			}
 			message := buffer[:numBytes]
 			if us.router != nil {
-				us.router.HandleInput(us.ctx, us.Id(), message)
+				senderCtx := context.WithValue(us.ctx, common.SenderContextKey, senderAddr)
+				us.router.HandleInput(senderCtx, us.Id(), message)
 			} else {
 				us.logger.Error("input received but no router is configured")
 			}
@@ -129,3 +119,18 @@ func (us *UDPServer) Run(ctx context.Context) error {
 func (us *UDPServer) Output(ctx context.Context, payload any) error {
 	return errors.New("net.udp.server output is not implemented")
 }
+
+func (us *UDPServer) Stop() {
+	us.cancel()
+}
+
+func (us *UDPServer) Get(key string) (any, error) {
+	switch key {
+	case "ip":
+		return us.Addr.IP.String(), nil
+	case "port":
+		return us.Addr.Port, nil
+	default:
+		return nil, errors.New("net.udp.server key not found")
+	}
+}

internal/processor/artnet-packet-decode.go

@@ -13,7 +13,7 @@ type ArtNetPacketDecode struct {
 }
 
 func (apd *ArtNetPacketDecode) Process(ctx context.Context, payload any) (any, error) {
-	payloadBytes, ok := payload.([]byte)
+	payloadBytes, ok := GetAnyAs[[]byte](payload)
 
 	if !ok {
 		return nil, fmt.Errorf("artnet.packet.decode processor only accepts a []byte")

internal/processor/artnet-packet-encode.go

@@ -13,7 +13,7 @@ type ArtNetPacketEncode struct {
 }
 
 func (ape *ArtNetPacketEncode) Process(ctx context.Context, payload any) (any, error) {
-	payloadPacket, ok := payload.(artnet.ArtNetPacket)
+	payloadPacket, ok := GetAnyAs[artnet.ArtNetPacket](payload)
 
 	if !ok {
 		return nil, fmt.Errorf("artnet.packet.encode processor only accepts an ArtNetPacket")

internal/processor/artnet-packet-filter.go

@@ -1,52 +0,0 @@
-package processor
-
-import (
-	"context"
-	"fmt"
-
-	"github.com/jwetzell/artnet-go"
-	"github.com/jwetzell/showbridge-go/internal/config"
-)
-
-type ArtNetPacketFilter struct {
-	config config.ProcessorConfig
-	OpCode uint16
-}
-
-func (apf *ArtNetPacketFilter) Process(ctx context.Context, payload any) (any, error) {
-	payloadPacket, ok := payload.(artnet.ArtNetPacket)
-
-	if !ok {
-		return nil, fmt.Errorf("artnet.packet.filter processor only accepts an ArtNetPacket")
-	}
-
-	if payloadPacket.GetOpCode() != apf.OpCode {
-		return nil, nil
-	}
-
-	return payloadPacket, nil
-}
-
-func (apf *ArtNetPacketFilter) Type() string {
-	return apf.config.Type
-}
-
-func init() {
-	RegisterProcessor(ProcessorRegistration{
-		Type: "artnet.packet.filter",
-		New: func(config config.ProcessorConfig) (Processor, error) {
-			params := config.Params
-
-			opCode, ok := params["opCode"]
-			if !ok {
-				return nil, fmt.Errorf("artnet.packet.filter requires an opCode parameter")
-			}
-			opCodeNum, ok := opCode.(float64)
-			if !ok {
-				return nil, fmt.Errorf("artnet.packet.filter opCode must be a number")
-			}
-
-			return &ArtNetPacketFilter{config: config, OpCode: uint16(opCodeNum)}, nil
-		},
-	})
-}

internal/processor/filter-expr.go

@@ -0,0 +1,61 @@
+package processor
+
+import (
+	"context"
+	"fmt"
+
+	"github.com/expr-lang/expr"
+	"github.com/expr-lang/expr/vm"
+	"github.com/jwetzell/showbridge-go/internal/config"
+)
+
+// NOTE(jwetzell): see language definition https://expr-lang.org/docs/language-definition
+type FilterExpr struct {
+	config  config.ProcessorConfig
+	Program *vm.Program
+}
+
+func (fe *FilterExpr) Process(ctx context.Context, payload any) (any, error) {
+
+	exprEnv := GetEnvData(ctx, payload)
+
+	output, err := expr.Run(fe.Program, exprEnv)
+	if err != nil {
+		return nil, err
+	}
+
+	outputBool, ok := output.(bool)
+	if !ok {
+		return nil, fmt.Errorf("filter.expr expression did not return a boolean")
+	}
+	if !outputBool {
+		return nil, nil
+	}
+
+	return payload, nil
+}
+
+func (fe *FilterExpr) Type() string {
+	return fe.config.Type
+}
+
+func init() {
+	RegisterProcessor(ProcessorRegistration{
+		Type: "filter.expr",
+		New: func(config config.ProcessorConfig) (Processor, error) {
+			params := config.Params
+
+			expressionString, err := params.GetString("expression")
+			if err != nil {
+				return nil, fmt.Errorf("filter.expr expression error: %w", err)
+			}
+
+			program, err := expr.Compile(expressionString)
+			if err != nil {
+				return nil, err
+			}
+
+			return &FilterExpr{config: config, Program: program}, nil
+		},
+	})
+}

internal/processor/float-parse.go

@@ -3,6 +3,7 @@ package processor
 import (
 	"context"
 	"errors"
+	"fmt"
 	"strconv"
 
 	"github.com/jwetzell/showbridge-go/internal/config"
@@ -14,7 +15,7 @@ type FloatParse struct {
 }
 
 func (fp *FloatParse) Process(ctx context.Context, payload any) (any, error) {
-	payloadString, ok := payload.(string)
+	payloadString, ok := GetAnyAs[string](payload)
 
 	if !ok {
 		return nil, errors.New("float.parse processor only accepts a string")
@@ -34,20 +35,18 @@ func (fp *FloatParse) Type() string {
 func init() {
 	RegisterProcessor(ProcessorRegistration{
 		Type: "float.parse",
-		New: func(config config.ProcessorConfig) (Processor, error) {
-			params := config.Params
-			bitSizeNum := 64
-			bitSize, ok := params["bitSize"]
-			if ok {
-				bitSizeFloat, ok := bitSize.(float64)
+		New: func(moduleConfig config.ProcessorConfig) (Processor, error) {
+			params := moduleConfig.Params
 
-				if !ok {
-					return nil, errors.New("float.parse bitSize must be a number")
+			bitSizeNum, err := params.GetInt("bitSize")
+			if err != nil {
+				if errors.Is(err, config.ErrParamNotFound) {
+					bitSizeNum = 64
+				} else {
+					return nil, fmt.Errorf("float.parse bitSize error: %w", err)
 				}
-
-				bitSizeNum = int(bitSizeFloat)
 			}
-			return &FloatParse{config: config, BitSize: bitSizeNum}, nil
+			return &FloatParse{config: moduleConfig, BitSize: bitSizeNum}, nil
 		},
 	})
 }

internal/processor/float-random.go

@@ -0,0 +1,71 @@
+package processor
+
+import (
+	"context"
+	"errors"
+	"fmt"
+	"math/rand/v2"
+
+	"github.com/jwetzell/showbridge-go/internal/config"
+)
+
+type FloatRandom struct {
+	BitSize int
+	Min     float64
+	Max     float64
+	config  config.ProcessorConfig
+}
+
+func (fr *FloatRandom) Process(ctx context.Context, payload any) (any, error) {
+	if fr.BitSize == 32 {
+		payloadFloat := rand.Float32()*(float32(fr.Max)-float32(fr.Min)) + float32(fr.Min)
+		return payloadFloat, nil
+	}
+	if fr.BitSize == 64 {
+		payloadFloat := rand.Float64()*(fr.Max-fr.Min) + fr.Min
+		return payloadFloat, nil
+	}
+	return nil, errors.New("float.random bitSize error: must be 32 or 64")
+}
+
+func (fr *FloatRandom) Type() string {
+	return fr.config.Type
+}
+
+func init() {
+	RegisterProcessor(ProcessorRegistration{
+		Type: "float.random",
+		New: func(processorConfig config.ProcessorConfig) (Processor, error) {
+			params := processorConfig.Params
+
+			bitSizeInt, err := params.GetInt("bitSize")
+			if err != nil {
+				if errors.Is(err, config.ErrParamNotFound) {
+					bitSizeInt = 32
+				} else {
+					return nil, fmt.Errorf("float.random bitSize error: %w", err)
+				}
+			}
+
+			if bitSizeInt != 32 && bitSizeInt != 64 {
+				return nil, errors.New("float.random bitSize error: must be 32 or 64")
+			}
+
+			minFloat, err := params.GetFloat64("min")
+			if err != nil {
+				return nil, fmt.Errorf("float.random min error: %w", err)
+			}
+
+			maxFloat, err := params.GetFloat64("max")
+			if err != nil {
+				return nil, fmt.Errorf("float.random max error: %w", err)
+			}
+
+			if maxFloat < minFloat {
+				return nil, errors.New("float.random max must be greater than min")
+			}
+
+			return &FloatRandom{config: processorConfig, Min: minFloat, Max: maxFloat, BitSize: bitSizeInt}, nil
+		},
+	})
+}

internal/processor/free-d-create.go

@@ -3,7 +3,7 @@ package processor
 import (
 	"bytes"
 	"context"
-	"errors"
+	"fmt"
 	"strconv"
 	"text/template"
 
@@ -26,8 +26,10 @@ type FreeDCreate struct {
 
 func (fc *FreeDCreate) Process(ctx context.Context, payload any) (any, error) {
 
+	templateData := GetTemplateData(ctx, payload)
+
 	var idBuffer bytes.Buffer
-	err := fc.Id.Execute(&idBuffer, payload)
+	err := fc.Id.Execute(&idBuffer, templateData)
 
 	if err != nil {
 		return nil, err
@@ -42,7 +44,7 @@ func (fc *FreeDCreate) Process(ctx context.Context, payload any) (any, error) {
 	}
 
 	var panBuffer bytes.Buffer
-	err = fc.Pan.Execute(&panBuffer, payload)
+	err = fc.Pan.Execute(&panBuffer, templateData)
 
 	if err != nil {
 		return nil, err
@@ -57,7 +59,7 @@ func (fc *FreeDCreate) Process(ctx context.Context, payload any) (any, error) {
 	}
 
 	var tiltBuffer bytes.Buffer
-	err = fc.Tilt.Execute(&tiltBuffer, payload)
+	err = fc.Tilt.Execute(&tiltBuffer, templateData)
 
 	if err != nil {
 		return nil, err
@@ -72,7 +74,7 @@ func (fc *FreeDCreate) Process(ctx context.Context, payload any) (any, error) {
 	}
 
 	var rollBuffer bytes.Buffer
-	err = fc.Tilt.Execute(&rollBuffer, payload)
+	err = fc.Tilt.Execute(&rollBuffer, templateData)
 
 	if err != nil {
 		return nil, err
@@ -87,7 +89,7 @@ func (fc *FreeDCreate) Process(ctx context.Context, payload any) (any, error) {
 	}
 
 	var posXBuffer bytes.Buffer
-	err = fc.PosX.Execute(&posXBuffer, payload)
+	err = fc.PosX.Execute(&posXBuffer, templateData)
 
 	if err != nil {
 		return nil, err
@@ -102,7 +104,7 @@ func (fc *FreeDCreate) Process(ctx context.Context, payload any) (any, error) {
 	}
 
 	var posYBuffer bytes.Buffer
-	err = fc.PosY.Execute(&posYBuffer, payload)
+	err = fc.PosY.Execute(&posYBuffer, templateData)
 
 	if err != nil {
 		return nil, err
@@ -117,7 +119,7 @@ func (fc *FreeDCreate) Process(ctx context.Context, payload any) (any, error) {
 	}
 
 	var posZBuffer bytes.Buffer
-	err = fc.PosZ.Execute(&posZBuffer, payload)
+	err = fc.PosZ.Execute(&posZBuffer, templateData)
 
 	if err != nil {
 		return nil, err
@@ -132,7 +134,7 @@ func (fc *FreeDCreate) Process(ctx context.Context, payload any) (any, error) {
 	}
 
 	var zoomBuffer bytes.Buffer
-	err = fc.Zoom.Execute(&zoomBuffer, payload)
+	err = fc.Zoom.Execute(&zoomBuffer, templateData)
 
 	if err != nil {
 		return nil, err
@@ -147,7 +149,7 @@ func (fc *FreeDCreate) Process(ctx context.Context, payload any) (any, error) {
 	}
 
 	var focusBuffer bytes.Buffer
-	err = fc.Zoom.Execute(&focusBuffer, payload)
+	err = fc.Focus.Execute(&focusBuffer, templateData)
 
 	if err != nil {
 		return nil, err
@@ -187,16 +189,9 @@ func init() {
 
 			// TODO(jwetzell): make some params optional
 			params := config.Params
-			id, ok := params["id"]
-
-			if !ok {
-				return nil, errors.New("freed.create requires an id parameter")
-			}
-
-			idString, ok := id.(string)
-
-			if !ok {
-				return nil, errors.New("freed.create id must be a string")
+			idString, err := params.GetString("id")
+			if err != nil {
+				return nil, fmt.Errorf("freed.create id error: %w", err)
 			}
 
 			idTemplate, err := template.New("id").Parse(idString)
@@ -205,44 +200,23 @@ func init() {
 				return nil, err
 			}
 
-			pan, ok := params["pan"]
-
-			if !ok {
-				return nil, errors.New("freed.create requires a pan parameter")
-			}
-
-			panString, ok := pan.(string)
-
-			if !ok {
-				return nil, errors.New("freed.create pan must be a string")
+			panString, err := params.GetString("pan")
+			if err != nil {
+				return nil, fmt.Errorf("freed.create pan error: %w", err)
 			}
 
 			panTemplate, err := template.New("pan").Parse(panString)
 
-			tilt, ok := params["tilt"]
-
-			if !ok {
-				return nil, errors.New("freed.create requires a tilt parameter")
-			}
-
-			tiltString, ok := tilt.(string)
-
-			if !ok {
-				return nil, errors.New("freed.create tilt must be a string")
+			tiltString, err := params.GetString("tilt")
+			if err != nil {
+				return nil, fmt.Errorf("freed.create tilt error: %w", err)
 			}
 
 			tiltTemplate, err := template.New("tilt").Parse(tiltString)
 
-			roll, ok := params["roll"]
-
-			if !ok {
-				return nil, errors.New("freed.create requires a roll parameter")
-			}
-
-			rollString, ok := roll.(string)
-
-			if !ok {
-				return nil, errors.New("freed.create roll must be a string")
+			rollString, err := params.GetString("roll")
+			if err != nil {
+				return nil, fmt.Errorf("freed.create roll error: %w", err)
 			}
 
 			rollTemplate, err := template.New("roll").Parse(rollString)
@@ -251,16 +225,9 @@ func init() {
 				return nil, err
 			}
 
-			posX, ok := params["posX"]
-
-			if !ok {
-				return nil, errors.New("freed.create requires a posX parameter")
-			}
-
-			posXString, ok := posX.(string)
-
-			if !ok {
-				return nil, errors.New("freed.create posX must be a string")
+			posXString, err := params.GetString("posX")
+			if err != nil {
+				return nil, fmt.Errorf("freed.create posX error: %w", err)
 			}
 
 			posXTemplate, err := template.New("posX").Parse(posXString)
@@ -269,16 +236,9 @@ func init() {
 				return nil, err
 			}
 
-			posY, ok := params["posY"]
-
-			if !ok {
-				return nil, errors.New("freed.create requires a posY parameter")
-			}
-
-			posYString, ok := posY.(string)
-
-			if !ok {
-				return nil, errors.New("freed.create posY must be a string")
+			posYString, err := params.GetString("posY")
+			if err != nil {
+				return nil, fmt.Errorf("freed.create posY error: %w", err)
 			}
 
 			posYTemplate, err := template.New("posY").Parse(posYString)
@@ -287,16 +247,9 @@ func init() {
 				return nil, err
 			}
 
-			posZ, ok := params["posZ"]
-
-			if !ok {
-				return nil, errors.New("freed.create requires a posZ parameter")
-			}
-
-			posZString, ok := posZ.(string)
-
-			if !ok {
-				return nil, errors.New("freed.create posZ must be a string")
+			posZString, err := params.GetString("posZ")
+			if err != nil {
+				return nil, fmt.Errorf("freed.create posZ error: %w", err)
 			}
 
 			posZTemplate, err := template.New("posZ").Parse(posZString)
@@ -305,30 +258,16 @@ func init() {
 				return nil, err
 			}
 
-			zoom, ok := params["zoom"]
-
-			if !ok {
-				return nil, errors.New("freed.create requires a zoom parameter")
-			}
-
-			zoomString, ok := zoom.(string)
-
-			if !ok {
-				return nil, errors.New("freed.create zoom must be a string")
+			zoomString, err := params.GetString("zoom")
+			if err != nil {
+				return nil, fmt.Errorf("freed.create zoom error: %w", err)
 			}
 
 			zoomTemplate, err := template.New("zoom").Parse(zoomString)
 
-			focus, ok := params["focus"]
-
-			if !ok {
-				return nil, errors.New("freed.create requires a focus parameter")
-			}
-
-			focusString, ok := focus.(string)
-
-			if !ok {
-				return nil, errors.New("freed.create focus must be a string")
+			focusString, err := params.GetString("focus")
+			if err != nil {
+				return nil, fmt.Errorf("freed.create focus error: %w", err)
 			}
 
 			focusTemplate, err := template.New("focus").Parse(focusString)

internal/processor/free-d-decode.go

@@ -12,8 +12,8 @@ type FreeDDecode struct {
 	config config.ProcessorConfig
 }
 
-func (fdd *FreeDDecode) Process(ctx context.Context, payload any) (any, error) {
-	payloadBytes, ok := payload.([]byte)
+func (fd *FreeDDecode) Process(ctx context.Context, payload any) (any, error) {
+	payloadBytes, ok := GetAnyAs[[]byte](payload)
 
 	if !ok {
 		return nil, errors.New("freed.decode processor only accepts a []byte")
@@ -26,8 +26,8 @@ func (fdd *FreeDDecode) Process(ctx context.Context, payload any) (any, error) {
 	return payloadMessage, nil
 }
 
-func (fdd *FreeDDecode) Type() string {
-	return fdd.config.Type
+func (fd *FreeDDecode) Type() string {
+	return fd.config.Type
 }
 
 func init() {

internal/processor/free-d-encode.go

@@ -12,8 +12,8 @@ type FreeDEncode struct {
 	config config.ProcessorConfig
 }
 
-func (fde *FreeDEncode) Process(ctx context.Context, payload any) (any, error) {
-	payloadPosition, ok := payload.(freeD.FreeDPosition)
+func (fe *FreeDEncode) Process(ctx context.Context, payload any) (any, error) {
+	payloadPosition, ok := GetAnyAs[freeD.FreeDPosition](payload)
 
 	if !ok {
 		return nil, errors.New("freed.decode processor only accepts a FreeDEncode")
@@ -23,8 +23,8 @@ func (fde *FreeDEncode) Process(ctx context.Context, payload any) (any, error) {
 	return payloadBytes, nil
 }
 
-func (fde *FreeDEncode) Type() string {
-	return fde.config.Type
+func (fe *FreeDEncode) Type() string {
+	return fe.config.Type
 }
 
 func init() {

internal/processor/http-request-create.go

@@ -1,82 +0,0 @@
-package processor
-
-import (
-	"bytes"
-	"context"
-	"errors"
-	"net/http"
-	"text/template"
-
-	"github.com/jwetzell/showbridge-go/internal/config"
-)
-
-type HTTPRequestCreate struct {
-	config config.ProcessorConfig
-	Method string
-	URL    *template.Template
-}
-
-func (hrc *HTTPRequestCreate) Process(ctx context.Context, payload any) (any, error) {
-
-	var urlBuffer bytes.Buffer
-	err := hrc.URL.Execute(&urlBuffer, payload)
-
-	if err != nil {
-		return nil, err
-	}
-
-	urlString := urlBuffer.String()
-
-	//TODO(jwetzell): support body
-	request, err := http.NewRequest(hrc.Method, urlString, bytes.NewBuffer([]byte{}))
-
-	if err != nil {
-		return nil, err
-	}
-
-	return request, nil
-}
-
-func (hrc *HTTPRequestCreate) Type() string {
-	return hrc.config.Type
-}
-
-func init() {
-	RegisterProcessor(ProcessorRegistration{
-		Type: "http.request.create",
-		New: func(config config.ProcessorConfig) (Processor, error) {
-			params := config.Params
-
-			method, ok := params["method"]
-
-			if !ok {
-				return nil, errors.New("http.request.create requires a method parameter")
-			}
-
-			methodString, ok := method.(string)
-
-			if !ok {
-				return nil, errors.New("http.request.create url must be a string")
-			}
-
-			url, ok := params["url"]
-
-			if !ok {
-				return nil, errors.New("http.request.create requires a url parameter")
-			}
-
-			urlString, ok := url.(string)
-
-			if !ok {
-				return nil, errors.New("http.request.create url must be a string")
-			}
-
-			urlTemplate, err := template.New("url").Parse(urlString)
-
-			if err != nil {
-				return nil, err
-			}
-			return &HTTPRequestCreate{config: config, URL: urlTemplate, Method: methodString}, nil
-		},
-	})
-}

internal/processor/http-request-do.go

@@ -0,0 +1,93 @@
+package processor
+
+import (
+	"bytes"
+	"context"
+	"fmt"
+	"io"
+	"net/http"
+	"text/template"
+	"time"
+
+	"github.com/jwetzell/showbridge-go/internal/config"
+)
+
+type HTTPRequestDo struct {
+	config config.ProcessorConfig
+	client *http.Client
+	Method string
+	URL    *template.Template
+}
+
+func (hrd *HTTPRequestDo) Process(ctx context.Context, payload any) (any, error) {
+
+	templateData := GetTemplateData(ctx, payload)
+
+	var urlBuffer bytes.Buffer
+	err := hrd.URL.Execute(&urlBuffer, templateData)
+
+	if err != nil {
+		return nil, err
+	}
+
+	urlString := urlBuffer.String()
+
+	//TODO(jwetzell): support body
+	request, err := http.NewRequest(hrd.Method, urlString, bytes.NewBuffer([]byte{}))
+
+	if err != nil {
+		return nil, err
+	}
+
+	response, err := hrd.client.Do(request)
+
+	if err != nil {
+		return nil, err
+	}
+
+	body, err := io.ReadAll(response.Body)
+
+	if err != nil {
+		return nil, err
+	}
+
+	//TODO(jwetzell): support headers, etc
+	return HTTPResponse{
+		Status: response.StatusCode,
+		Body:   body,
+	}, nil
+}
+
+func (hrd *HTTPRequestDo) Type() string {
+	return hrd.config.Type
+}
+
+func init() {
+	RegisterProcessor(ProcessorRegistration{
+		Type: "http.request.do",
+		New: func(config config.ProcessorConfig) (Processor, error) {
+			params := config.Params
+
+			methodString, err := params.GetString("method")
+			if err != nil {
+				return nil, fmt.Errorf("http.request.do method error: %w", err)
+			}
+
+			urlString, err := params.GetString("url")
+			if err != nil {
+				return nil, fmt.Errorf("http.request.do url error: %w", err)
+			}
+
+			urlTemplate, err := template.New("url").Parse(urlString)
+
+			if err != nil {
+				return nil, err
+			}
+			client := &http.Client{
+				Timeout: 10 * time.Second,
+			}
+
+			return &HTTPRequestDo{config: config, URL: urlTemplate, Method: methodString, client: client}, nil
+		},
+	})
+}

internal/processor/http-request-encode.go

@@ -1,42 +0,0 @@
-package processor
-
-import (
-	"context"
-	"errors"
-	"io"
-	"net/http"
-
-	"github.com/jwetzell/showbridge-go/internal/config"
-)
-
-type HTTPRequestEncode struct {
-	config config.ProcessorConfig
-}
-
-func (hre *HTTPRequestEncode) Process(ctx context.Context, payload any) (any, error) {
-	payloadRequest, ok := payload.(*http.Request)
-
-	if !ok {
-		return nil, errors.New("http.request.encode processor only accepts an http.Request")
-	}
-
-	bytes, err := io.ReadAll(payloadRequest.Body)
-	if err != nil {
-		return nil, err
-	}
-
-	return bytes, nil
-}
-
-func (hre *HTTPRequestEncode) Type() string {
-	return hre.config.Type
-}
-
-func init() {
-	RegisterProcessor(ProcessorRegistration{
-		Type: "http.request.encode",
-		New: func(config config.ProcessorConfig) (Processor, error) {
-			return &HTTPRequestEncode{config: config}, nil
-		},
-	})
-}

internal/processor/http-request-filter.go

@@ -1,81 +0,0 @@
-package processor
-
-import (
-	"context"
-	"errors"
-	"fmt"
-	"net/http"
-	"regexp"
-
-	"github.com/jwetzell/showbridge-go/internal/config"
-)
-
-type HTTPRequestFilter struct {
-	config config.ProcessorConfig
-	Path   *regexp.Regexp
-	Method string
-}
-
-func (hrf *HTTPRequestFilter) Process(ctx context.Context, payload any) (any, error) {
-
-	payloadRequest, ok := payload.(*http.Request)
-
-	if !ok {
-		return nil, errors.New("http.request.filter can only operate on http.Request payloads")
-	}
-
-	if hrf.Method != "" {
-		if payloadRequest.Method != hrf.Method {
-			return nil, nil
-		}
-	}
-
-	if !hrf.Path.MatchString(payloadRequest.URL.Path) {
-		return nil, nil
-	}
-
-	return payloadRequest, nil
-}
-
-func (hrf *HTTPRequestFilter) Type() string {
-	return hrf.config.Type
-}
-
-func init() {
-	RegisterProcessor(ProcessorRegistration{
-		Type: "http.request.filter",
-		New: func(config config.ProcessorConfig) (Processor, error) {
-			params := config.Params
-			path, ok := params["path"]
-
-			if !ok {
-				return nil, errors.New("http.request.filter requires a path parameter")
-			}
-
-			pathString, ok := path.(string)
-
-			if !ok {
-				return nil, errors.New("http.request.filter path must be a string")
-			}
-
-			pathRegexp, err := regexp.Compile(fmt.Sprintf("^%s$", pathString))
-
-			if err != nil {
-				return nil, err
-			}
-
-			method, ok := params["method"]
-
-			if ok {
-				methodString, ok := method.(string)
-
-				if !ok {
-					return nil, errors.New("http.request.filter method must be a string")
-				}
-				return &HTTPRequestFilter{config: config, Path: pathRegexp, Method: methodString}, nil
-			}
-
-			return &HTTPRequestFilter{config: config, Path: pathRegexp}, nil
-		},
-	})
-}

internal/processor/http-response-create.go

@@ -3,7 +3,7 @@ package processor
 import (
 	"bytes"
 	"context"
-	"errors"
+	"fmt"
 	"text/template"
 
 	"github.com/jwetzell/showbridge-go/internal/config"
@@ -20,22 +20,24 @@ type HTTPResponse struct {
 	Body   []byte
 }
 
-func (hre *HTTPResponseCreate) Process(ctx context.Context, payload any) (any, error) {
+func (hrc *HTTPResponseCreate) Process(ctx context.Context, payload any) (any, error) {
+	templateData := GetTemplateData(ctx, payload)
+
 	var bodyBuffer bytes.Buffer
-	err := hre.BodyTmpl.Execute(&bodyBuffer, payload)
+	err := hrc.BodyTmpl.Execute(&bodyBuffer, templateData)
 
 	if err != nil {
 		return nil, err
 	}
 
 	return HTTPResponse{
-		Status: hre.Status,
+		Status: hrc.Status,
 		Body:   bodyBuffer.Bytes(),
 	}, nil
 }
 
-func (hre *HTTPResponseCreate) Type() string {
-	return hre.config.Type
+func (hrc *HTTPResponseCreate) Type() string {
+	return hrc.config.Type
 }
 
 func init() {
@@ -44,28 +46,14 @@ func init() {
 		New: func(config config.ProcessorConfig) (Processor, error) {
 			params := config.Params
 
-			status, ok := params["status"]
-
-			if !ok {
-				return nil, errors.New("http.response.create requires a status parameter")
+			statusNum, err := params.GetInt("status")
+			if err != nil {
+				return nil, fmt.Errorf("http.response.create status error: %w", err)
 			}
 
-			statusNum, ok := status.(float64)
-
-			if !ok {
-				return nil, errors.New("http.response.create status must be a number")
-			}
-
-			bodyTmpl, ok := params["bodyTemplate"]
-
-			if !ok {
-				return nil, errors.New("http.response.create requires a bodyTemplate parameter")
-			}
-
-			bodyTemplateString, ok := bodyTmpl.(string)
-
-			if !ok {
-				return nil, errors.New("http.response.create bodyTemplate must be a string")
+			bodyTemplateString, err := params.GetString("bodyTemplate")
+			if err != nil {
+				return nil, fmt.Errorf("http.response.create bodyTemplate error: %w", err)
 			}
 
 			bodyTemplate, err := template.New("body").Parse(bodyTemplateString)

internal/processor/http-response-encode.go

@@ -1,43 +0,0 @@
-package processor
-
-import (
-	"context"
-	"errors"
-	"io"
-	"net/http"
-
-	"github.com/jwetzell/showbridge-go/internal/config"
-)
-
-type HTTPResponseEncode struct {
-	config config.ProcessorConfig
-}
-
-func (hre *HTTPResponseEncode) Process(ctx context.Context, payload any) (any, error) {
-	payloadResponse, ok := payload.(*http.Response)
-
-	if !ok {
-		return nil, errors.New("http.response.encode processor only accepts an http.Response")
-	}
-	defer payloadResponse.Body.Close()
-
-	bytes, err := io.ReadAll(payloadResponse.Body)
-	if err != nil {
-		return nil, err
-	}
-
-	return bytes, nil
-}
-
-func (hre *HTTPResponseEncode) Type() string {
-	return hre.config.Type
-}
-
-func init() {
-	RegisterProcessor(ProcessorRegistration{
-		Type: "http.response.encode",
-		New: func(config config.ProcessorConfig) (Processor, error) {
-			return &HTTPResponseEncode{config: config}, nil
-		},
-	})
-}

internal/processor/int-parse.go

@@ -3,6 +3,7 @@ package processor
 import (
 	"context"
 	"errors"
+	"fmt"
 	"strconv"
 
 	"github.com/jwetzell/showbridge-go/internal/config"
@@ -15,7 +16,7 @@ type IntParse struct {
 }
 
 func (ip *IntParse) Process(ctx context.Context, payload any) (any, error) {
-	payloadString, ok := payload.(string)
+	payloadString, ok := GetAnyAs[string](payload)
 
 	if !ok {
 		return nil, errors.New("int.parse processor only accepts a string")
@@ -35,33 +36,27 @@ func (ip *IntParse) Type() string {
 func init() {
 	RegisterProcessor(ProcessorRegistration{
 		Type: "int.parse",
-		New: func(config config.ProcessorConfig) (Processor, error) {
-			params := config.Params
+		New: func(moduleConfig config.ProcessorConfig) (Processor, error) {
+			params := moduleConfig.Params
 
-			baseNum := 10
-			base, ok := params["base"]
-			if ok {
-				baseFloat, ok := base.(float64)
-
-				if !ok {
-					return nil, errors.New("int.parse base must be a number")
+			baseNum, err := params.GetInt("base")
+			if err != nil {
+				if errors.Is(err, config.ErrParamNotFound) {
+					baseNum = 10
+				} else {
+					return nil, fmt.Errorf("int.parse base error: %w", err)
+				}
 			}
 
-				baseNum = int(baseFloat)
+			bitSizeNum, err := params.GetInt("bitSize")
+			if err != nil {
+				if errors.Is(err, config.ErrParamNotFound) {
+					bitSizeNum = 64
+				} else {
+					return nil, fmt.Errorf("int.parse bitSize error: %w", err)
 				}
-
-			bitSizeNum := 64
-			bitSize, ok := params["bitSize"]
-			if ok {
-				bitSizeFloat, ok := bitSize.(float64)
-
-				if !ok {
-					return nil, errors.New("int.parse bitSize must be a number")
 			}
-
-				bitSizeNum = int(bitSizeFloat)
-			}
-			return &IntParse{config: config, Base: baseNum, BitSize: bitSizeNum}, nil
+			return &IntParse{config: moduleConfig, Base: baseNum, BitSize: bitSizeNum}, nil
 		},
 	})
 }

internal/processor/int-parse_test.go

@@ -1,219 +0,0 @@
-package processor_test
-
-import (
-	"testing"
-
-	"github.com/jwetzell/showbridge-go/internal/config"
-	"github.com/jwetzell/showbridge-go/internal/processor"
-)
-
-func TestIntParseFromRegistry(t *testing.T) {
-	registration, ok := processor.ProcessorRegistry["int.parse"]
-	if !ok {
-		t.Fatalf("int.parse processor not registered")
-	}
-
-	processorInstance, err := registration.New(config.ProcessorConfig{
-		Type: "int.parse",
-	})
-
-	if err != nil {
-		t.Fatalf("failed to create int.parse processor: %s", err)
-	}
-
-	if processorInstance.Type() != "int.parse" {
-		t.Fatalf("int.parse processor has wrong type: %s", processorInstance.Type())
-	}
-}
-
-func TestIntParseBadConfigBaseString(t *testing.T) {
-	registration, ok := processor.ProcessorRegistry["int.parse"]
-	if !ok {
-		t.Fatalf("int.parse processor not registered")
-	}
-
-	_, err := registration.New(config.ProcessorConfig{
-		Type: "int.parse",
-		Params: map[string]any{
-			"base": "10",
-		},
-	})
-
-	if err == nil {
-		t.Fatalf("int.parse should have returned an error for bad base config")
-	}
-}
-
-func TestIntParseBadConfigBitSizeString(t *testing.T) {
-	registration, ok := processor.ProcessorRegistry["int.parse"]
-	if !ok {
-		t.Fatalf("int.parse processor not registered")
-	}
-
-	_, err := registration.New(config.ProcessorConfig{
-		Type: "int.parse",
-		Params: map[string]any{
-			"bitSize": "64",
-		},
-	})
-
-	if err == nil {
-		t.Fatalf("int.parse should have returned an error for bad bitSize config")
-	}
-}
-
-func TestIntParseGoodConfig(t *testing.T) {
-	registration, ok := processor.ProcessorRegistry["int.parse"]
-	if !ok {
-		t.Fatalf("int.parse processor not registered")
-	}
-
-	processorInstance, err := registration.New(config.ProcessorConfig{
-		Type: "int.parse",
-		Params: map[string]any{
-			"base":    10.0,
-			"bitSize": 64.0,
-		},
-	})
-
-	if err != nil {
-		t.Fatalf("int.parse should have created processor but got error: %s", err)
-	}
-
-	payload := "12345"
-	expected := int64(12345)
-
-	got, err := processorInstance.Process(t.Context(), payload)
-	if err != nil {
-		t.Fatalf("int.parse processing failed: %s", err)
-	}
-
-	gotInt, ok := got.(int64)
-	if !ok {
-		t.Fatalf("int.parse returned a %T payload: %s", got, got)
-	}
-
-	if gotInt != expected {
-		t.Fatalf("int.parse got %d, expected %d", gotInt, expected)
-	}
-}
-
-func TestGoodIntParse(t *testing.T) {
-	tests := []struct {
-		processor processor.Processor
-		name      string
-		payload   any
-		expected  int64
-		base      int
-		bitSize   int
-	}{
-		{
-			name:     "positive number",
-			payload:  "12345",
-			expected: 12345,
-			base:     10,
-			bitSize:  64,
-		},
-		{
-			name:     "negative number",
-			payload:  "-12345",
-			expected: -12345,
-			base:     10,
-			bitSize:  64,
-		},
-		{
-			name:     "zero",
-			payload:  "0",
-			expected: 0,
-			base:     10,
-			bitSize:  64,
-		},
-		{
-			name:     "binary",
-			payload:  "1010101",
-			expected: 85,
-			base:     2,
-			bitSize:  64,
-		},
-		{
-			name:     "hex",
-			payload:  "15F",
-			expected: 351,
-			base:     16,
-			bitSize:  64,
-		},
-	}
-
-	for _, test := range tests {
-		t.Run(test.name, func(t *testing.T) {
-			intParser := processor.IntParse{
-				Base:    test.base,
-				BitSize: test.bitSize,
-			}
-
-			got, err := intParser.Process(t.Context(), test.payload)
-
-			gotInt, ok := got.(int64)
-			if !ok {
-				t.Fatalf("int.parse returned a %T payload: %s", got, got)
-			}
-			if err != nil {
-				t.Fatalf("int.parse failed: %s", err)
-			}
-			if gotInt != test.expected {
-				t.Fatalf("int.parse got %d, expected %d", gotInt, test.expected)
-			}
-		})
-	}
-}
-
-func TestBadIntParse(t *testing.T) {
-	tests := []struct {
-		processor   processor.Processor
-		name        string
-		payload     any
-		base        int
-		bitSize     int
-		errorString string
-	}{
-		{
-			name:        "non-string input",
-			payload:     []byte{0x01},
-			base:        10,
-			bitSize:     64,
-			errorString: "int.parse processor only accepts a string",
-		},
-		{
-			name:        "not int string",
-			payload:     "123.46",
-			base:        10,
-			bitSize:     64,
-			errorString: "strconv.ParseInt: parsing \"123.46\": invalid syntax",
-		},
-		{
-			name:        "bit overflow",
-			payload:     "12345678901234567890",
-			base:        10,
-			bitSize:     32,
-			errorString: "strconv.ParseInt: parsing \"12345678901234567890\": value out of range",
-		},
-	}
-
-	for _, test := range tests {
-		t.Run(test.name, func(t *testing.T) {
-			intParser := processor.IntParse{
-				Base:    test.base,
-				BitSize: test.bitSize,
-			}
-			got, err := intParser.Process(t.Context(), test.payload)
-
-			if err == nil {
-				t.Fatalf("int.parse expected to fail but succeeded, got: %v", got)
-
-			}
-			if err.Error() != test.errorString {
-				t.Fatalf("int.parse got error '%s', expected '%s'", err.Error(), test.errorString)
-			}
-		})
-	}
-}

internal/processor/int-random.go

@@ -3,6 +3,7 @@ package processor
 import (
 	"context"
 	"errors"
+	"fmt"
 	"math/rand/v2"
 
 	"github.com/jwetzell/showbridge-go/internal/config"
@@ -14,13 +15,13 @@ type IntRandom struct {
 	config config.ProcessorConfig
 }
 
-func (up *IntRandom) Process(ctx context.Context, payload any) (any, error) {
-	payloadInt := rand.IntN(up.Max-up.Min+1) + up.Min
+func (ir *IntRandom) Process(ctx context.Context, payload any) (any, error) {
+	payloadInt := rand.IntN(ir.Max-ir.Min+1) + ir.Min
 	return payloadInt, nil
 }
 
-func (up *IntRandom) Type() string {
-	return up.config.Type
+func (ir *IntRandom) Type() string {
+	return ir.config.Type
 }
 
 func init() {
@@ -29,33 +30,21 @@ func init() {
 		New: func(config config.ProcessorConfig) (Processor, error) {
 			params := config.Params
 
-			min, ok := params["min"]
-			if !ok {
-				return nil, errors.New("int.random requires a min parameter")
+			minInt, err := params.GetInt("min")
+			if err != nil {
+				return nil, fmt.Errorf("int.random min error: %w", err)
 			}
 
-			minFloat, ok := min.(float64)
-
-			if !ok {
-				return nil, errors.New("int.random min must be a number")
+			maxInt, err := params.GetInt("max")
+			if err != nil {
+				return nil, fmt.Errorf("int.random max error: %w", err)
 			}
 
-			max, ok := params["max"]
-			if !ok {
-				return nil, errors.New("int.random requires a max parameter")
-			}
-
-			maxFloat, ok := max.(float64)
-
-			if !ok {
-				return nil, errors.New("int.random max must be a number")
-			}
-
-			if maxFloat < minFloat {
+			if maxInt < minInt {
 				return nil, errors.New("int.random max must be greater than min")
 			}
 
-			return &IntRandom{config: config, Min: int(minFloat), Max: int(maxFloat)}, nil
+			return &IntRandom{config: config, Min: int(minInt), Max: int(maxInt)}, nil
 		},
 	})
 }

internal/processor/json-decode.go

@@ -0,0 +1,49 @@
+package processor
+
+import (
+	"context"
+	"encoding/json"
+	"errors"
+
+	"github.com/jwetzell/showbridge-go/internal/config"
+)
+
+type JsonDecode struct {
+	config config.ProcessorConfig
+}
+
+func (jd *JsonDecode) Process(ctx context.Context, payload any) (any, error) {
+
+	payloadBytes, ok := GetAnyAsByteSlice(payload)
+
+	if !ok {
+		payloadString, ok := GetAnyAs[string](payload)
+		if !ok {
+			return nil, errors.New("json.decode can only process a string or []byte")
+		}
+		payloadBytes = []byte(payloadString)
+	}
+
+	payloadJson := make(map[string]any)
+
+	err := json.Unmarshal(payloadBytes, &payloadJson)
+	if err != nil {
+		return nil, err
+	}
+
+	return payloadJson, nil
+
+}
+
+func (jd *JsonDecode) Type() string {
+	return jd.config.Type
+}
+
+func init() {
+	RegisterProcessor(ProcessorRegistration{
+		Type: "json.decode",
+		New: func(config config.ProcessorConfig) (Processor, error) {
+			return &JsonDecode{config: config}, nil
+		},
+	})
+}

internal/processor/json-encode_test.go

@@ -1,45 +0,0 @@
-package processor_test
-
-import (
-	"slices"
-	"testing"
-
-	"github.com/jwetzell/osc-go"
-	"github.com/jwetzell/showbridge-go/internal/processor"
-)
-
-func TestGoodJsonEncode(t *testing.T) {
-	stringEncoder := processor.JsonEncode{}
-	tests := []struct {
-		processor processor.Processor
-		name      string
-		payload   any
-		expected  []byte
-	}{
-		{
-			processor: &stringEncoder,
-			name:      "hello",
-			payload: osc.OSCMessage{
-				Address: "/hello",
-			},
-			expected: []byte("{\"address\":\"/hello\",\"args\":null}"),
-		},
-	}
-
-	for _, test := range tests {
-		t.Run(test.name, func(t *testing.T) {
-			got, err := test.processor.Process(t.Context(), test.payload)
-
-			gotBytes, ok := got.([]byte)
-			if !ok {
-				t.Fatalf("json.encode returned a %T payload: %s", got, got)
-			}
-			if err != nil {
-				t.Fatalf("json.encode failed: %s", err)
-			}
-			if !slices.Equal(gotBytes, test.expected) {
-				t.Fatalf("json.encode got %x, expected %s", got, test.expected)
-			}
-		})
-	}
-}

internal/processor/midi-message-create.go

@@ -5,7 +5,6 @@ package processor
 import (
 	"bytes"
 	"context"
-	"errors"
 	"fmt"
 	"strconv"
 	"text/template"
@@ -32,16 +31,9 @@ func newMidiNoteOnCreate(config config.ProcessorConfig) (Processor, error) {
 
 	params := config.Params
 
-	channel, ok := params["channel"]
-
-	if !ok {
-		return nil, errors.New("midi.message.create NoteOn requires a channel parameter")
-	}
-
-	channelString, ok := channel.(string)
-
-	if !ok {
-		return nil, errors.New("midi.message.create NoteOn channel must be a string")
+	channelString, err := params.GetString("channel")
+	if err != nil {
+		return nil, fmt.Errorf("midi.message.create channel error: %w", err)
 	}
 
 	channelTemplate, err := template.New("channel").Parse(channelString)
@@ -50,16 +42,9 @@ func newMidiNoteOnCreate(config config.ProcessorConfig) (Processor, error) {
 		return nil, err
 	}
 
-	note, ok := params["note"]
-
-	if !ok {
-		return nil, errors.New("midi.message.create NoteOn requires a note parameter")
-	}
-
-	noteString, ok := note.(string)
-
-	if !ok {
-		return nil, errors.New("midi.message.create NoteOn note must be a string")
+	noteString, err := params.GetString("note")
+	if err != nil {
+		return nil, fmt.Errorf("midi.message.create note error: %w", err)
 	}
 
 	noteTemplate, err := template.New("note").Parse(noteString)
@@ -68,16 +53,9 @@ func newMidiNoteOnCreate(config config.ProcessorConfig) (Processor, error) {
 		return nil, err
 	}
 
-	velocity, ok := params["velocity"]
-
-	if !ok {
-		return nil, errors.New("midi.message.create NoteOn requires a velocity parameter")
-	}
-
-	velocityString, ok := velocity.(string)
-
-	if !ok {
-		return nil, errors.New("midi.message.create NoteOn velocity must be a string")
+	velocityString, err := params.GetString("velocity")
+	if err != nil {
+		return nil, fmt.Errorf("midi.message.create velocity error: %w", err)
 	}
 
 	velocityTemplate, err := template.New("velocity").Parse(velocityString)
@@ -87,9 +65,10 @@ func newMidiNoteOnCreate(config config.ProcessorConfig) (Processor, error) {
 	}
 
 	return &MIDIMessageCreate{config: config, ProcessFunc: func(ctx context.Context, payload any) (any, error) {
+		templateData := GetTemplateData(ctx, payload)
 
 		var channelBuffer bytes.Buffer
-		err := channelTemplate.Execute(&channelBuffer, payload)
+		err := channelTemplate.Execute(&channelBuffer, templateData)
 
 		if err != nil {
 			return nil, err
@@ -98,7 +77,7 @@ func newMidiNoteOnCreate(config config.ProcessorConfig) (Processor, error) {
 		channelValue, err := strconv.ParseUint(channelBuffer.String(), 10, 8)
 
 		var noteBuffer bytes.Buffer
-		err = noteTemplate.Execute(&noteBuffer, payload)
+		err = noteTemplate.Execute(&noteBuffer, templateData)
 
 		if err != nil {
 			return nil, err
@@ -107,7 +86,7 @@ func newMidiNoteOnCreate(config config.ProcessorConfig) (Processor, error) {
 		noteValue, err := strconv.ParseUint(noteBuffer.String(), 10, 8)
 
 		var velocityBuffer bytes.Buffer
-		err = velocityTemplate.Execute(&velocityBuffer, payload)
+		err = velocityTemplate.Execute(&velocityBuffer, templateData)
 
 		if err != nil {
 			return nil, err
@@ -123,16 +102,9 @@ func newMidiNoteOffCreate(config config.ProcessorConfig) (Processor, error) {
 
 	params := config.Params
 
-	channel, ok := params["channel"]
-
-	if !ok {
-		return nil, errors.New("midi.message.create NoteOn requires a channel parameter")
-	}
-
-	channelString, ok := channel.(string)
-
-	if !ok {
-		return nil, errors.New("midi.message.create NoteOn channel must be a string")
+	channelString, err := params.GetString("channel")
+	if err != nil {
+		return nil, fmt.Errorf("midi.message.create channel error: %w", err)
 	}
 
 	channelTemplate, err := template.New("channel").Parse(channelString)
@@ -141,16 +113,9 @@ func newMidiNoteOffCreate(config config.ProcessorConfig) (Processor, error) {
 		return nil, err
 	}
 
-	note, ok := params["note"]
-
-	if !ok {
-		return nil, errors.New("midi.message.create NoteOn requires a note parameter")
-	}
-
-	noteString, ok := note.(string)
-
-	if !ok {
-		return nil, errors.New("midi.message.create NoteOn note must be a string")
+	noteString, err := params.GetString("note")
+	if err != nil {
+		return nil, fmt.Errorf("midi.message.create note error: %w", err)
 	}
 
 	noteTemplate, err := template.New("note").Parse(noteString)
@@ -159,10 +124,23 @@ func newMidiNoteOffCreate(config config.ProcessorConfig) (Processor, error) {
 		return nil, err
 	}
 
+	velocityString, err := params.GetString("velocity")
+	if err != nil {
+		return nil, fmt.Errorf("midi.message.create velocity error: %w", err)
+	}
+
+	velocityTemplate, err := template.New("velocity").Parse(velocityString)
+
+	if err != nil {
+		return nil, err
+	}
+
 	return &MIDIMessageCreate{config: config, ProcessFunc: func(ctx context.Context, payload any) (any, error) {
 
+		templateData := GetTemplateData(ctx, payload)
+
 		var channelBuffer bytes.Buffer
-		err := channelTemplate.Execute(&channelBuffer, payload)
+		err := channelTemplate.Execute(&channelBuffer, templateData)
 
 		if err != nil {
 			return nil, err
@@ -171,7 +149,7 @@ func newMidiNoteOffCreate(config config.ProcessorConfig) (Processor, error) {
 		channelValue, err := strconv.ParseUint(channelBuffer.String(), 10, 8)
 
 		var noteBuffer bytes.Buffer
-		err = noteTemplate.Execute(&noteBuffer, payload)
+		err = noteTemplate.Execute(&noteBuffer, templateData)
 
 		if err != nil {
 			return nil, err
@@ -179,7 +157,16 @@ func newMidiNoteOffCreate(config config.ProcessorConfig) (Processor, error) {
 
 		noteValue, err := strconv.ParseUint(noteBuffer.String(), 10, 8)
 
-		payloadMessage := midi.NoteOff(uint8(channelValue), uint8(noteValue))
+		var velocityBuffer bytes.Buffer
+		err = velocityTemplate.Execute(&velocityBuffer, templateData)
+
+		if err != nil {
+			return nil, err
+		}
+
+		velocityValue, err := strconv.ParseUint(velocityBuffer.String(), 10, 8)
+
+		payloadMessage := midi.NoteOffVelocity(uint8(channelValue), uint8(noteValue), uint8(velocityValue))
 		return payloadMessage, nil
 	}}, nil
 }
@@ -188,16 +175,9 @@ func newMidiControlChangeCreate(config config.ProcessorConfig) (Processor, error
 
 	params := config.Params
 
-	channel, ok := params["channel"]
-
-	if !ok {
-		return nil, errors.New("midi.message.create ControlChange requires a channel parameter")
-	}
-
-	channelString, ok := channel.(string)
-
-	if !ok {
-		return nil, errors.New("midi.message.create ControlChange channel must be a string")
+	channelString, err := params.GetString("channel")
+	if err != nil {
+		return nil, fmt.Errorf("midi.message.create channel error: %w", err)
 	}
 
 	channelTemplate, err := template.New("channel").Parse(channelString)
@@ -206,34 +186,20 @@ func newMidiControlChangeCreate(config config.ProcessorConfig) (Processor, error
 		return nil, err
 	}
 
-	controller, ok := params["controller"]
-
-	if !ok {
-		return nil, errors.New("midi.message.create ControlChange requires a controller parameter")
+	controlString, err := params.GetString("control")
+	if err != nil {
+		return nil, fmt.Errorf("midi.message.create control error: %w", err)
 	}
 
-	controllerString, ok := controller.(string)
-
-	if !ok {
-		return nil, errors.New("midi.message.create ControlChange controller must be a string")
-	}
-
-	controllerTemplate, err := template.New("controller").Parse(controllerString)
+	controlTemplate, err := template.New("control").Parse(controlString)
 
 	if err != nil {
 		return nil, err
 	}
 
-	value, ok := params["value"]
-
-	if !ok {
-		return nil, errors.New("midi.message.create ControlChange requires a value parameter")
-	}
-
-	valueString, ok := value.(string)
-
-	if !ok {
-		return nil, errors.New("midi.message.create ControlChange value must be a string")
+	valueString, err := params.GetString("value")
+	if err != nil {
+		return nil, fmt.Errorf("midi.message.create value error: %w", err)
 	}
 
 	valueTemplate, err := template.New("value").Parse(valueString)
@@ -244,8 +210,10 @@ func newMidiControlChangeCreate(config config.ProcessorConfig) (Processor, error
 
 	return &MIDIMessageCreate{config: config, ProcessFunc: func(ctx context.Context, payload any) (any, error) {
 
+		templateData := GetTemplateData(ctx, payload)
+
 		var channelBuffer bytes.Buffer
-		err := channelTemplate.Execute(&channelBuffer, payload)
+		err := channelTemplate.Execute(&channelBuffer, templateData)
 
 		if err != nil {
 			return nil, err
@@ -253,17 +221,17 @@ func newMidiControlChangeCreate(config config.ProcessorConfig) (Processor, error
 
 		channelValue, err := strconv.ParseUint(channelBuffer.String(), 10, 8)
 
-		var controllerBuffer bytes.Buffer
-		err = controllerTemplate.Execute(&controllerBuffer, payload)
+		var controlBuffer bytes.Buffer
+		err = controlTemplate.Execute(&controlBuffer, templateData)
 
 		if err != nil {
 			return nil, err
 		}
 
-		controllerValue, err := strconv.ParseUint(controllerBuffer.String(), 10, 8)
+		controlValue, err := strconv.ParseUint(controlBuffer.String(), 10, 8)
 
 		var valueBuffer bytes.Buffer
-		err = valueTemplate.Execute(&valueBuffer, payload)
+		err = valueTemplate.Execute(&valueBuffer, templateData)
 
 		if err != nil {
 			return nil, err
@@ -271,7 +239,7 @@ func newMidiControlChangeCreate(config config.ProcessorConfig) (Processor, error
 
 		valueValue, err := strconv.ParseUint(valueBuffer.String(), 10, 8)
 
-		payloadMessage := midi.ControlChange(uint8(channelValue), uint8(controllerValue), uint8(valueValue))
+		payloadMessage := midi.ControlChange(uint8(channelValue), uint8(controlValue), uint8(valueValue))
 		return payloadMessage, nil
 	}}, nil
 }
@@ -280,16 +248,9 @@ func newMidiProgramChangeCreate(config config.ProcessorConfig) (Processor, error
 
 	params := config.Params
 
-	channel, ok := params["channel"]
-
-	if !ok {
-		return nil, errors.New("midi.message.create ProgramChange requires a channel parameter")
-	}
-
-	channelString, ok := channel.(string)
-
-	if !ok {
-		return nil, errors.New("midi.message.create ProgramChange channel must be a string")
+	channelString, err := params.GetString("channel")
+	if err != nil {
+		return nil, fmt.Errorf("midi.message.create channel error: %w", err)
 	}
 
 	channelTemplate, err := template.New("channel").Parse(channelString)
@@ -298,16 +259,9 @@ func newMidiProgramChangeCreate(config config.ProcessorConfig) (Processor, error
 		return nil, err
 	}
 
-	program, ok := params["program"]
-
-	if !ok {
-		return nil, errors.New("midi.message.create ProgramChange requires a program parameter")
-	}
-
-	programString, ok := program.(string)
-
-	if !ok {
-		return nil, errors.New("midi.message.create ProgramChange program must be a string")
+	programString, err := params.GetString("program")
+	if err != nil {
+		return nil, fmt.Errorf("midi.message.create program error: %w", err)
 	}
 
 	programTemplate, err := template.New("program").Parse(programString)
@@ -317,9 +271,10 @@ func newMidiProgramChangeCreate(config config.ProcessorConfig) (Processor, error
 	}
 
 	return &MIDIMessageCreate{config: config, ProcessFunc: func(ctx context.Context, payload any) (any, error) {
+		templateData := GetTemplateData(ctx, payload)
 
 		var channelBuffer bytes.Buffer
-		err := channelTemplate.Execute(&channelBuffer, payload)
+		err := channelTemplate.Execute(&channelBuffer, templateData)
 
 		if err != nil {
 			return nil, err
@@ -328,7 +283,7 @@ func newMidiProgramChangeCreate(config config.ProcessorConfig) (Processor, error
 		channelValue, err := strconv.ParseUint(channelBuffer.String(), 10, 8)
 
 		var programBuffer bytes.Buffer
-		err = programTemplate.Execute(&programBuffer, payload)
+		err = programTemplate.Execute(&programBuffer, templateData)
 
 		if err != nil {
 			return nil, err
@@ -347,16 +302,9 @@ func init() {
 		New: func(config config.ProcessorConfig) (Processor, error) {
 			params := config.Params
 
-			msgType, ok := params["type"]
-
-			if !ok {
-				return nil, errors.New("midi.message.create requires a type parameter")
-			}
-
-			msgTypeString, ok := msgType.(string)
-
-			if !ok {
-				return nil, errors.New("midi.message.create type parameter must be a string")
+			msgTypeString, err := params.GetString("type")
+			if err != nil {
+				return nil, fmt.Errorf("midi.message.create type error: %w", err)
 			}
 
 			switch msgTypeString {

internal/processor/midi-message-decode.go

@@ -15,7 +15,7 @@ type MIDIMessageDecode struct {
 }
 
 func (mmd *MIDIMessageDecode) Process(ctx context.Context, payload any) (any, error) {
-	payloadBytes, ok := payload.([]byte)
+	payloadBytes, ok := GetAnyAs[[]byte](payload)
 
 	if !ok {
 		return nil, errors.New("midi.message.decode processor only accepts a []byte")

internal/processor/midi-message-encode.go

@@ -15,10 +15,10 @@ type MIDIMessageEncode struct {
 }
 
 func (mme *MIDIMessageEncode) Process(ctx context.Context, payload any) (any, error) {
-	payloadMessage, ok := payload.(midi.Message)
+	payloadMessage, ok := GetAnyAs[midi.Message](payload)
 
 	if !ok {
-		return nil, errors.New("midi.message.encode processor only accepts an midi.Message")
+		return nil, errors.New("midi.message.encode processor only accepts a midi.Message")
 	}
 
 	return payloadMessage.Bytes(), nil

internal/processor/midi-message-filter.go

@@ -1,55 +0,0 @@
-//go:build cgo
-
-package processor
-
-import (
-	"context"
-	"errors"
-
-	"github.com/jwetzell/showbridge-go/internal/config"
-	"gitlab.com/gomidi/midi/v2"
-)
-
-type MIDIMessageFilter struct {
-	config   config.ProcessorConfig
-	MIDIType string
-}
-
-func (mmf *MIDIMessageFilter) Process(ctx context.Context, payload any) (any, error) {
-	payloadMessage, ok := payload.(midi.Message)
-
-	if !ok {
-		return nil, errors.New("midi.message.filter processor only accepts an midi.Message")
-	}
-
-	if payloadMessage.Type().String() != mmf.MIDIType {
-		return nil, nil
-	}
-
-	return payloadMessage, nil
-}
-
-func (mmf *MIDIMessageFilter) Type() string {
-	return mmf.config.Type
-}
-
-func init() {
-	RegisterProcessor(ProcessorRegistration{
-		Type: "midi.message.filter",
-		New: func(config config.ProcessorConfig) (Processor, error) {
-			params := config.Params
-			midiType, ok := params["type"]
-
-			if !ok {
-				return nil, errors.New("midi.message.filter requires a type parameter")
-			}
-			midiTypeString, ok := midiType.(string)
-
-			if !ok {
-				return nil, errors.New("midi.message.filter type must be a string")
-			}
-
-			return &MIDIMessageFilter{config: config, MIDIType: midiTypeString}, nil
-		},
-	})
-}

internal/processor/midi-message-unpack.go

@@ -45,7 +45,7 @@ type MIDIPitchBend struct {
 }
 
 func (mmu *MIDIMessageUnpack) Process(ctx context.Context, payload any) (any, error) {
-	payloadMidi, ok := payload.(midi.Message)
+	payloadMidi, ok := GetAnyAs[midi.Message](payload)
 
 	if !ok {
 		return nil, errors.New("midi.message.unpack processor only accepts a midi.Message")

internal/processor/mqtt-message-create.go

@@ -3,6 +3,7 @@ package processor
 import (
 	"context"
 	"errors"
+	"fmt"
 
 	"github.com/jwetzell/showbridge-go/internal/config"
 )
@@ -22,6 +23,15 @@ type MQTTMessageCreate struct {
 	Payload  []byte
 }
 
+func NewMQTTMessage(topic string, qos byte, retained bool, payload []byte) MQTTMessage {
+	return MQTTMessage{
+		topic:    topic,
+		qos:      qos,
+		retained: retained,
+		payload:  payload,
+	}
+}
+
 func (mm MQTTMessage) Duplicate() bool {
 	// TODO(jwetzell): implement?
 	return false
@@ -70,64 +80,40 @@ func (mmc *MQTTMessageCreate) Type() string {
 func init() {
 	RegisterProcessor(ProcessorRegistration{
 		Type: "mqtt.message.create",
-		New: func(config config.ProcessorConfig) (Processor, error) {
-			params := config.Params
-			topic, ok := params["topic"]
-
-			if !ok {
-				return nil, errors.New("mqtt.message.create requires a topic parameter")
+		New: func(processorConfig config.ProcessorConfig) (Processor, error) {
+			params := processorConfig.Params
+			topicString, err := params.GetString("topic")
+			if err != nil {
+				return nil, fmt.Errorf("mqtt.message.create topic error: %w", err)
 			}
 
-			topicString, ok := topic.(string)
-
-			if !ok {
-				return nil, errors.New("mqtt.message.create topic must be a string")
+			qosByte, err := params.GetInt("qos")
+			if err != nil {
+				return nil, fmt.Errorf("mqtt.message.create qos error: %w", err)
 			}
 
-			qos, ok := params["qos"]
-
-			if !ok {
-				return nil, errors.New("mqtt.message.create requires a qos parameter")
-			}
-
-			qosByte, ok := qos.(float64)
-
-			if !ok {
-				return nil, errors.New("mqtt.message.create qos must be a number")
-			}
-
-			retained, ok := params["retained"]
-
-			if !ok {
-				return nil, errors.New("mqtt.message.create requires a retained parameter")
-			}
-
-			retainedBool, ok := retained.(bool)
-
-			if !ok {
-				return nil, errors.New("mqtt.message.create retained must be a boolean")
+			retainedBool, err := params.GetBool("retained")
+			if err != nil {
+				return nil, fmt.Errorf("mqtt.message.create retained error: %w", err)
 			}
 
 			//TODO(jwetzell): convert payload into []byte or string for sending
-			payload, ok := params["payload"]
-
-			if !ok {
-				return nil, errors.New("mqtt.message.create requires a payload parameter")
+			payloadString, err := params.GetString("payload")
+			if err != nil {
+				if errors.Is(err, config.ErrParamNotString) {
+					payloadBytes, err := params.GetByteSlice("payload")
+					if err != nil {
+						return nil, fmt.Errorf("mqtt.message.create payload error: %w", err)
 					}
-
-			if payloadBytes, ok := payload.([]byte); ok {
-				return &MQTTMessageCreate{config: config, Topic: topicString, QoS: byte(qosByte), Retained: retainedBool, Payload: payloadBytes}, nil
+					return &MQTTMessageCreate{config: processorConfig, Topic: topicString, QoS: byte(qosByte), Retained: retainedBool, Payload: payloadBytes}, nil
+				} else {
+					return nil, fmt.Errorf("mqtt.message.create payload error: %w", err)
 				}
-
-			payloadString, ok := payload.(string)
-
-			if !ok {
-				return nil, errors.New("mqtt.message.create payload must be a string or byte array")
 			}
 
 			payloadBytes := []byte(payloadString)
 
-			return &MQTTMessageCreate{config: config, Topic: topicString, QoS: byte(qosByte), Retained: retainedBool, Payload: payloadBytes}, nil
+			return &MQTTMessageCreate{config: processorConfig, Topic: topicString, QoS: byte(qosByte), Retained: retainedBool, Payload: payloadBytes}, nil
 		},
 	})
 }

internal/processor/mqtt-message-encode.go

@@ -13,7 +13,7 @@ type MQTTMessageEncode struct {
 }
 
 func (mme *MQTTMessageEncode) Process(ctx context.Context, payload any) (any, error) {
-	payloadMessage, ok := payload.(mqtt.Message)
+	payloadMessage, ok := GetAnyAs[mqtt.Message](payload)
 
 	if !ok {
 		return nil, errors.New("mqtt.message.encode processor only accepts an mqtt.Message")

internal/processor/nats-message-create.go

@@ -3,7 +3,7 @@ package processor
 import (
 	"bytes"
 	"context"
-	"errors"
+	"fmt"
 	"text/template"
 
 	"github.com/jwetzell/showbridge-go/internal/config"
@@ -21,9 +21,10 @@ type NATSMessageCreate struct {
 }
 
 func (nmc *NATSMessageCreate) Process(ctx context.Context, payload any) (any, error) {
+	templateData := GetTemplateData(ctx, payload)
 
 	var payloadBuffer bytes.Buffer
-	err := nmc.Payload.Execute(&payloadBuffer, payload)
+	err := nmc.Payload.Execute(&payloadBuffer, templateData)
 
 	if err != nil {
 		return nil, err
@@ -32,7 +33,7 @@ func (nmc *NATSMessageCreate) Process(ctx context.Context, payload any) (any, er
 	payloadString := payloadBuffer.String()
 
 	var subjectBuffer bytes.Buffer
-	err = nmc.Subject.Execute(&subjectBuffer, payload)
+	err = nmc.Subject.Execute(&subjectBuffer, templateData)
 
 	if err != nil {
 		return nil, err
@@ -57,16 +58,9 @@ func init() {
 		Type: "nats.message.create",
 		New: func(config config.ProcessorConfig) (Processor, error) {
 			params := config.Params
-			subject, ok := params["subject"]
-
-			if !ok {
-				return nil, errors.New("nats.message.create requires a subject parameter")
-			}
-
-			subjectString, ok := subject.(string)
-
-			if !ok {
-				return nil, errors.New("nats.message.create subject must be a string")
+			subjectString, err := params.GetString("subject")
+			if err != nil {
+				return nil, fmt.Errorf("nats.message.create subject error: %w", err)
 			}
 
 			subjectTemplate, err := template.New("subject").Parse(subjectString)
@@ -75,16 +69,9 @@ func init() {
 				return nil, err
 			}
 
-			payload, ok := params["payload"]
-
-			if !ok {
-				return nil, errors.New("nats.message.create requires a payload parameter")
-			}
-
-			payloadString, ok := payload.(string)
-
-			if !ok {
-				return nil, errors.New("nats.message.create payload must be a string")
+			payloadString, err := params.GetString("payload")
+			if err != nil {
+				return nil, fmt.Errorf("nats.message.create payload error: %w", err)
 			}
 
 			payloadTemplate, err := template.New("payload").Parse(payloadString)

internal/processor/nats-message-encode.go

@@ -1,36 +0,0 @@
-package processor
-
-import (
-	"context"
-	"errors"
-
-	"github.com/jwetzell/showbridge-go/internal/config"
-	"github.com/nats-io/nats.go"
-)
-
-type NATSMessageEncode struct {
-	config config.ProcessorConfig
-}
-
-func (nme *NATSMessageEncode) Process(ctx context.Context, payload any) (any, error) {
-	payloadMessage, ok := payload.(*nats.Msg)
-
-	if !ok {
-		return nil, errors.New("nats.message.encode processor only accepts an nats.Msg")
-	}
-
-	return payloadMessage.Data, nil
-}
-
-func (nme *NATSMessageEncode) Type() string {
-	return nme.config.Type
-}
-
-func init() {
-	RegisterProcessor(ProcessorRegistration{
-		Type: "nats.message.encode",
-		New: func(config config.ProcessorConfig) (Processor, error) {
-			return &NATSMessageEncode{config: config}, nil
-		},
-	})
-}

internal/processor/osc-message-create.go

@@ -22,8 +22,10 @@ type OSCMessageCreate struct {
 
 func (omc *OSCMessageCreate) Process(ctx context.Context, payload any) (any, error) {
 
+	templateData := GetTemplateData(ctx, payload)
+
 	var addressBuffer bytes.Buffer
-	err := omc.Address.Execute(&addressBuffer, payload)
+	err := omc.Address.Execute(&addressBuffer, templateData)
 
 	if err != nil {
 		return nil, err
@@ -39,7 +41,7 @@ func (omc *OSCMessageCreate) Process(ctx context.Context, payload any) (any, err
 		return nil, errors.New("osc.message.create address must start with '/'")
 	}
 
-	payloadMessage := osc.OSCMessage{
+	payloadMessage := &osc.OSCMessage{
 		Address: addressString,
 	}
 
@@ -47,7 +49,7 @@ func (omc *OSCMessageCreate) Process(ctx context.Context, payload any) (any, err
 
 	for argIndex, argTemplate := range omc.Args {
 		var argBuffer bytes.Buffer
-		err := argTemplate.Execute(&argBuffer, payload)
+		err := argTemplate.Execute(&argBuffer, templateData)
 
 		if err != nil {
 			return nil, err
@@ -78,18 +80,11 @@ func (omc *OSCMessageCreate) Type() string {
 func init() {
 	RegisterProcessor(ProcessorRegistration{
 		Type: "osc.message.create",
-		New: func(config config.ProcessorConfig) (Processor, error) {
-			params := config.Params
-			address, ok := params["address"]
-
-			if !ok {
-				return nil, errors.New("osc.message.create requires an address parameter")
-			}
-
-			addressString, ok := address.(string)
-
-			if !ok {
-				return nil, errors.New("osc.message.create address must be a string")
+		New: func(processorConfig config.ProcessorConfig) (Processor, error) {
+			params := processorConfig.Params
+			addressString, err := params.GetString("address")
+			if err != nil {
+				return nil, fmt.Errorf("osc.message.create address error: %w", err)
 			}
 
 			addressTemplate, err := template.New("address").Parse(addressString)
@@ -98,39 +93,27 @@ func init() {
 				return nil, err
 			}
 
-			args, ok := params["args"]
-
-			if ok {
-				rawArgs, ok := args.([]interface{})
-
-				if !ok {
-					return nil, fmt.Errorf("osc.message.create address must be an array found %T", args)
+			argStrings, err := params.GetStringSlice("args")
+			if err != nil {
+				if errors.Is(err, config.ErrParamNotFound) {
+					return &OSCMessageCreate{config: processorConfig, Address: addressTemplate}, nil
+				} else {
+					return nil, fmt.Errorf("osc.message.create args error: %w", err)
+				}
 			}
 
-				types, ok := params["types"]
-
-				if !ok {
-					return nil, errors.New("osc.message.create requires a types parameter with args")
+			typesString, err := params.GetString("types")
+			if err != nil {
+				return nil, fmt.Errorf("osc.message.create types error: %w", err)
 			}
 
-				typesString, ok := types.(string)
-
-				if !ok {
-					return nil, errors.New("osc.message.create types must be a string")
-				}
-
-				if len(rawArgs) != len(typesString) {
+			if len(argStrings) != len(typesString) {
 				return nil, errors.New("osc.message.create args and types must be the same length")
 			}
 
 			argTemplates := []*template.Template{}
 
-				for _, rawArg := range rawArgs {
-					argString, ok := rawArg.(string)
-
-					if !ok {
-						return nil, errors.New("osc.message.create arg must be a string")
-					}
+			for _, argString := range argStrings {
 
 				argTemplate, err := template.New("arg").Parse(argString)
 
@@ -139,9 +122,7 @@ func init() {
 				}
 				argTemplates = append(argTemplates, argTemplate)
 			}
-				return &OSCMessageCreate{config: config, Address: addressTemplate, Args: argTemplates, Types: typesString}, nil
-			}
-			return &OSCMessageCreate{config: config, Address: addressTemplate}, nil
+			return &OSCMessageCreate{config: processorConfig, Address: addressTemplate, Args: argTemplates, Types: typesString}, nil
 		},
 	})
 }

internal/processor/osc-message-decode.go

@@ -3,6 +3,7 @@ package processor
 import (
 	"context"
 	"errors"
+	"fmt"
 
 	osc "github.com/jwetzell/osc-go"
 	"github.com/jwetzell/showbridge-go/internal/config"
@@ -13,7 +14,7 @@ type OSCMessageDecode struct {
 }
 
 func (omd *OSCMessageDecode) Process(ctx context.Context, payload any) (any, error) {
-	payloadBytes, ok := payload.([]byte)
+	payloadBytes, ok := GetAnyAs[[]byte](payload)
 
 	if !ok {
 		return nil, errors.New("osc.message.decode processor only accepts a []byte payload")
@@ -29,7 +30,7 @@ func (omd *OSCMessageDecode) Process(ctx context.Context, payload any) (any, err
 
 	message, err := osc.MessageFromBytes(payloadBytes)
 	if err != nil {
-		return nil, err
+		return nil, fmt.Errorf("osc.message.decode processor failed to decode OSC message: %w", err)
 	}
 	return message, nil
 }

internal/processor/osc-message-encode.go

@@ -13,10 +13,10 @@ type OSCMessageEncode struct {
 }
 
 func (ome *OSCMessageEncode) Process(ctx context.Context, payload any) (any, error) {
-	payloadMessage, ok := payload.(osc.OSCMessage)
+	payloadMessage, ok := GetAnyAs[*osc.OSCMessage](payload)
 
 	if !ok {
-		return nil, errors.New("osc.message.encode processor only accepts an OSCMessage")
+		return nil, errors.New("osc.message.encode processor only accepts an *OSCMessage")
 	}
 
 	bytes := payloadMessage.ToBytes()

internal/processor/osc-message-filter.go

@@ -1,71 +0,0 @@
-package processor
-
-import (
-	"context"
-	"errors"
-	"fmt"
-	"regexp"
-	"strings"
-
-	"github.com/jwetzell/osc-go"
-	"github.com/jwetzell/showbridge-go/internal/config"
-)
-
-type OSCMessageFilter struct {
-	config  config.ProcessorConfig
-	Address *regexp.Regexp
-}
-
-func (omf *OSCMessageFilter) Process(ctx context.Context, payload any) (any, error) {
-
-	payloadMessage, ok := payload.(osc.OSCMessage)
-
-	if !ok {
-		return nil, errors.New("osc.message.filter can only operate on OSCMessage payloads")
-	}
-
-	if !omf.Address.MatchString(payloadMessage.Address) {
-		return nil, nil
-	}
-
-	return payloadMessage, nil
-}
-
-func (omf *OSCMessageFilter) Type() string {
-	return omf.config.Type
-}
-
-func init() {
-	RegisterProcessor(ProcessorRegistration{
-		Type: "osc.message.filter",
-		New: func(config config.ProcessorConfig) (Processor, error) {
-			params := config.Params
-			address, ok := params["address"]
-
-			if !ok {
-				return nil, errors.New("osc.message.filter requires an address parameter")
-			}
-
-			addressString, ok := address.(string)
-
-			if !ok {
-				return nil, errors.New("osc.message.filter address must be a string")
-			}
-
-			addressPattern := strings.ReplaceAll(addressString, "?", ".")
-			addressPattern = strings.ReplaceAll(addressPattern, "*", "[^/]*")
-			addressPattern = strings.ReplaceAll(addressPattern, "[!", "[^")
-			addressPattern = strings.ReplaceAll(addressPattern, "{", "(")
-			addressPattern = strings.ReplaceAll(addressPattern, "}", ")")
-			addressPattern = strings.ReplaceAll(addressPattern, ",", "|")
-
-			addressPatternRegexp, err := regexp.Compile(fmt.Sprintf("^%s$", addressPattern))
-
-			if err != nil {
-				return nil, err
-			}
-
-			return &OSCMessageFilter{config: config, Address: addressPatternRegexp}, nil
-		},
-	})
-}

internal/processor/osc-message-transform.go

@@ -1,77 +0,0 @@
-package processor
-
-import (
-	"bytes"
-	"context"
-	"errors"
-	"text/template"
-
-	osc "github.com/jwetzell/osc-go"
-	"github.com/jwetzell/showbridge-go/internal/config"
-)
-
-type OSCMessageTransform struct {
-	config  config.ProcessorConfig
-	Address *template.Template
-}
-
-func (omt *OSCMessageTransform) Process(ctx context.Context, payload any) (any, error) {
-	payloadMessage, ok := payload.(osc.OSCMessage)
-
-	if !ok {
-		return nil, errors.New("osc.message.transform processor only accepts an OSCMessage")
-	}
-
-	var addressBuffer bytes.Buffer
-	err := omt.Address.Execute(&addressBuffer, payloadMessage)
-
-	if err != nil {
-		return nil, err
-	}
-
-	addressString := addressBuffer.String()
-
-	if len(addressString) == 0 {
-		return nil, errors.New("osc.message.transform address must not be empty")
-	}
-
-	if addressString[0] != '/' {
-		return nil, errors.New("osc.message.transform address must start with '/'")
-	}
-
-	payloadMessage.Address = addressString
-
-	return payloadMessage, nil
-}
-
-func (omt *OSCMessageTransform) Type() string {
-	return omt.config.Type
-}
-
-func init() {
-	RegisterProcessor(ProcessorRegistration{
-		Type: "osc.message.transform",
-		New: func(config config.ProcessorConfig) (Processor, error) {
-			params := config.Params
-			address, ok := params["address"]
-
-			if !ok {
-				return nil, errors.New("osc.message.transform requires an address parameter")
-			}
-
-			addressString, ok := address.(string)
-
-			if !ok {
-				return nil, errors.New("osc.message.transform address must be a string")
-			}
-
-			addressTemplate, err := template.New("address").Parse(addressString)
-
-			if err != nil {
-				return nil, err
-			}
-
-			return &OSCMessageTransform{config: config, Address: addressTemplate}, nil
-		},
-	})
-}

internal/processor/processor.go

@@ -3,8 +3,11 @@ package processor
 import (
 	"context"
 	"fmt"
+	"math"
+	"reflect"
 	"sync"
 
+	"github.com/jwetzell/showbridge-go/internal/common"
 	"github.com/jwetzell/showbridge-go/internal/config"
 )
 
@@ -40,3 +43,89 @@ var (
 	processorRegistryMu sync.RWMutex
 	ProcessorRegistry   = make(map[string]ProcessorRegistration)
 )
+
+func GetAnyAs[T any](p any) (T, bool) {
+	typed, ok := p.(T)
+	return typed, ok
+}
+
+func GetAnyAsByteSlice(p any) ([]byte, bool) {
+	v := reflect.ValueOf(p)
+	if v.Kind() != reflect.Slice {
+		return nil, false
+	}
+
+	result := make([]byte, v.Len())
+	for i := 0; i < v.Len(); i++ {
+		elem := v.Index(i).Interface()
+		byteValue, ok := elem.(byte)
+		if ok {
+			result[i] = byteValue
+			continue
+		}
+		uintValue, ok := elem.(uint)
+		if ok {
+			if uintValue > 255 {
+				return nil, false
+			}
+			result[i] = byte(uintValue)
+			continue
+		}
+		intValue, ok := elem.(int)
+		if ok {
+			if intValue < 0 || intValue > 255 {
+				return nil, false
+			}
+			result[i] = byte(intValue)
+			continue
+		}
+		floatValue, ok := elem.(float64)
+		if ok {
+			if floatValue != math.Floor(floatValue) {
+				return nil, false
+			}
+			if floatValue < 0 || floatValue > 255 {
+				return nil, false
+			}
+			result[i] = byte(floatValue)
+			continue
+		}
+		return nil, false
+	}
+	return result, true
+}
+
+type TemplateData struct {
+	Payload any
+	Modules any
+	Sender  any
+}
+
+type EnvData struct {
+	Payload any
+	Sender  any
+}
+
+func GetTemplateData(ctx context.Context, payload any) TemplateData {
+	templateData := TemplateData{Payload: payload}
+	modules := ctx.Value(common.ModulesContextKey)
+	if modules != nil {
+		templateData.Modules = modules
+	}
+
+	sender := ctx.Value(common.SenderContextKey)
+	if sender != nil {
+		templateData.Sender = sender
+	}
+	return templateData
+}
+
+func GetEnvData(ctx context.Context, payload any) EnvData {
+	envData := EnvData{Payload: payload}
+
+	sender := ctx.Value(common.SenderContextKey)
+	if sender != nil {
+		envData.Sender = sender
+	}
+	return envData
+}

internal/processor/router-output.go

@@ -0,0 +1,55 @@
+package processor
+
+import (
+	"context"
+	"errors"
+	"fmt"
+	"log/slog"
+
+	"github.com/jwetzell/showbridge-go/internal/common"
+	"github.com/jwetzell/showbridge-go/internal/config"
+)
+
+type RouterOutput struct {
+	config   config.ProcessorConfig
+	ModuleId string
+	logger   *slog.Logger
+}
+
+func (ro *RouterOutput) Process(ctx context.Context, payload any) (any, error) {
+
+	router, ok := ctx.Value(common.RouterContextKey).(common.RouteIO)
+	if !ok {
+		return nil, errors.New("router.output no router found")
+	}
+
+	err := router.HandleOutput(ctx, ro.ModuleId, payload)
+
+	if err != nil {
+		return nil, fmt.Errorf("router.output failed to send output: %w", err)
+	}
+
+	return payload, nil
+}
+
+func (ro *RouterOutput) Type() string {
+	return ro.config.Type
+}
+
+func init() {
+	RegisterProcessor(ProcessorRegistration{
+		Type: "router.output",
+		New: func(config config.ProcessorConfig) (Processor, error) {
+
+			params := config.Params
+
+			moduleId, err := params.GetString("module")
+
+			if err != nil {
+				return nil, fmt.Errorf("router.output module error: %w", err)
+			}
+
+			return &RouterOutput{config: config, ModuleId: moduleId, logger: slog.Default().With("component", "processor", "type", config.Type)}, nil
+		},
+	})
+}

internal/processor/script-expr.go

@@ -2,7 +2,7 @@ package processor
 
 import (
 	"context"
-	"errors"
+	"fmt"
 
 	"github.com/expr-lang/expr"
 	"github.com/expr-lang/expr/vm"
@@ -17,7 +17,9 @@ type ScriptExpr struct {
 
 func (se *ScriptExpr) Process(ctx context.Context, payload any) (any, error) {
 
-	output, err := expr.Run(se.Program, payload)
+	exprEnv := GetEnvData(ctx, payload)
+
+	output, err := expr.Run(se.Program, exprEnv)
 	if err != nil {
 		return nil, err
 	}
@@ -35,16 +37,9 @@ func init() {
 		New: func(config config.ProcessorConfig) (Processor, error) {
 			params := config.Params
 
-			expression, ok := params["expression"]
-
-			if !ok {
-				return nil, errors.New("script.expr requires an expression parameter")
-			}
-
-			expressionString, ok := expression.(string)
-
-			if !ok {
-				return nil, errors.New("script.expr expression must be a string")
+			expressionString, err := params.GetString("expression")
+			if err != nil {
+				return nil, fmt.Errorf("script.expr expression error: %w", err)
 			}
 
 			program, err := expr.Compile(expressionString)

internal/processor/script-expr_test.go

@@ -1,171 +0,0 @@
-package processor_test
-
-import (
-	"testing"
-
-	"github.com/expr-lang/expr"
-	"github.com/jwetzell/showbridge-go/internal/config"
-	"github.com/jwetzell/showbridge-go/internal/processor"
-)
-
-func TestScriptExprFromRegistry(t *testing.T) {
-	registration, ok := processor.ProcessorRegistry["script.expr"]
-	if !ok {
-		t.Fatalf("script.expr processor not registered")
-	}
-
-	processorInstance, err := registration.New(config.ProcessorConfig{
-		Type: "script.expr",
-		Params: map[string]any{
-			"expression": "foo + bar",
-		},
-	})
-	if err != nil {
-		t.Fatalf("failed to create script.expr processor: %s", err)
-	}
-
-	if processorInstance.Type() != "script.expr" {
-		t.Fatalf("script.expr processor has wrong type: %s", processorInstance.Type())
-	}
-}
-
-func TestScriptExprNoProgram(t *testing.T) {
-	registration, ok := processor.ProcessorRegistry["script.expr"]
-	if !ok {
-		t.Fatalf("script.expr processor not registered")
-	}
-
-	_, err := registration.New(config.ProcessorConfig{
-		Type:   "script.expr",
-		Params: map[string]any{},
-	})
-
-	if err == nil {
-		t.Fatalf("script.expr processor should have thrown an error when creating")
-	}
-}
-
-func TestScriptExprBadConfigWrongExpressionType(t *testing.T) {
-	registration, ok := processor.ProcessorRegistry["script.expr"]
-	if !ok {
-		t.Fatalf("script.expr processor not registered")
-	}
-
-	_, err := registration.New(config.ProcessorConfig{
-		Type: "script.expr",
-		Params: map[string]any{
-			"expression": 12345,
-		},
-	})
-
-	if err == nil {
-		t.Fatalf("script.expr processor should have thrown an error when creating with non-string expression")
-	}
-}
-
-func TestScriptExprBadConfigNonCompilingExpression(t *testing.T) {
-	registration, ok := processor.ProcessorRegistry["script.expr"]
-	if !ok {
-		t.Fatalf("script.expr processor not registered")
-	}
-
-	_, err := registration.New(config.ProcessorConfig{
-		Type: "script.expr",
-		Params: map[string]any{
-			"expression": "foo + ",
-		},
-	})
-
-	if err == nil {
-		t.Fatalf("script.expr processor should have thrown an error when creating with non-compiling expression")
-	}
-}
-
-func TestGoodScriptExpr(t *testing.T) {
-	tests := []struct {
-		program  string
-		name     string
-		payload  map[string]any
-		expected any
-	}{
-		{
-			program: "foo + bar",
-			name:    "number",
-			payload: map[string]any{
-				"foo": 1,
-				"bar": 1,
-			},
-			expected: 2,
-		},
-		{
-			program: "foo + bar",
-			name:    "string",
-			payload: map[string]any{
-				"foo": "1",
-				"bar": "1",
-			},
-			expected: "11",
-		},
-	}
-
-	for _, test := range tests {
-		t.Run(test.name, func(t *testing.T) {
-			program, err := expr.Compile(test.program)
-			if err != nil {
-				t.Fatalf("script.expr failed to compile program: %s", err)
-			}
-
-			exprProcessor := &processor.ScriptExpr{Program: program}
-
-			got, err := exprProcessor.Process(t.Context(), test.payload)
-
-			if err != nil {
-				t.Fatalf("script.expr failed: %s", err)
-			}
-
-			//TODO(jwetzell): work out better way to compare the any/any
-			if got != test.expected {
-				t.Fatalf("script.expr got %+v (%T), expected %+v (%T)", got, got, test.expected, test.expected)
-			}
-		})
-	}
-}
-
-func TestBadScriptExpr(t *testing.T) {
-	tests := []struct {
-		program     string
-		name        string
-		payload     map[string]any
-		errorString string
-	}{
-		{
-			name:    "accessing missing field",
-			program: "foo + bar",
-			payload: map[string]any{
-				"foo": 1,
-			},
-			errorString: "invalid operation: int + <nil> (1:5)\n | foo + bar\n | ....^",
-		},
-	}
-
-	for _, test := range tests {
-		t.Run(test.name, func(t *testing.T) {
-			program, err := expr.Compile(test.program)
-			if err != nil {
-				t.Fatalf("script.expr failed to compile program: %s", err)
-			}
-
-			exprProcessor := &processor.ScriptExpr{Program: program}
-
-			got, err := exprProcessor.Process(t.Context(), test.payload)
-
-			if err == nil {
-				t.Fatalf("script.expr expected to fail but succeeded, got: %v", got)
-
-			}
-			if err.Error() != test.errorString {
-				t.Fatalf("script.expr got error '%s', expected '%s'", err.Error(), test.errorString)
-			}
-		})
-	}
-}

internal/processor/script-js.go

@@ -3,8 +3,9 @@ package processor
 import (
 	"context"
 	"encoding/json"
-	"errors"
+	"fmt"
 
+	"github.com/jwetzell/showbridge-go/internal/common"
 	"github.com/jwetzell/showbridge-go/internal/config"
 	"modernc.org/quickjs"
 )
@@ -30,6 +31,16 @@ func (sj *ScriptJS) Process(ctx context.Context, payload any) (any, error) {
 
 	vm.SetProperty(vm.GlobalObject(), payloadAtom, payload)
 
+	sender := ctx.Value(common.SenderContextKey)
+	if sender != nil {
+		senderAtom, err := vm.NewAtom("sender")
+
+		if err != nil {
+			return nil, err
+		}
+		vm.SetProperty(vm.GlobalObject(), senderAtom, sender)
+	}
+
 	_, err = vm.Eval(sj.Program, quickjs.EvalGlobal)
 
 	if err != nil {
@@ -71,16 +82,9 @@ func init() {
 		New: func(config config.ProcessorConfig) (Processor, error) {
 			params := config.Params
 
-			program, ok := params["program"]
-
-			if !ok {
-				return nil, errors.New("script.js requires a program parameter")
-			}
-
-			programString, ok := program.(string)
-
-			if !ok {
-				return nil, errors.New("script.js program must be a string")
+			programString, err := params.GetString("program")
+			if err != nil {
+				return nil, fmt.Errorf("script.js program error: %w", err)
 			}
 
 			return &ScriptJS{config: config, Program: programString}, nil

internal/processor/script-wasm.go

@@ -2,6 +2,7 @@ package processor
 
 import (
 	"context"
+	"errors"
 	"fmt"
 
 	extism "github.com/extism/go-sdk"
@@ -14,21 +15,21 @@ type ScriptWASM struct {
 	Function string
 }
 
-func (se *ScriptWASM) Process(ctx context.Context, payload any) (any, error) {
+func (sw *ScriptWASM) Process(ctx context.Context, payload any) (any, error) {
 
-	payloadBytes, ok := payload.([]byte)
+	payloadBytes, ok := GetAnyAs[[]byte](payload)
 
 	if !ok {
-		return nil, fmt.Errorf("script.wasm can only operator on byte array")
+		return nil, fmt.Errorf("script.wasm can only process a byte array")
 	}
 
-	program, err := se.Program.Instance(ctx, extism.PluginInstanceConfig{})
+	program, err := sw.Program.Instance(ctx, extism.PluginInstanceConfig{})
 
 	if err != nil {
 		return nil, err
 	}
 
-	_, output, err := program.Call(se.Function, payloadBytes)
+	_, output, err := program.Call(sw.Function, payloadBytes)
 
 	if err != nil {
 		return nil, err
@@ -37,39 +38,37 @@ func (se *ScriptWASM) Process(ctx context.Context, payload any) (any, error) {
 	return output, nil
 }
 
-func (se *ScriptWASM) Type() string {
-	return se.config.Type
+func (sw *ScriptWASM) Type() string {
+	return sw.config.Type
 }
 
 func init() {
 	RegisterProcessor(ProcessorRegistration{
 		Type: "script.wasm",
-		New: func(config config.ProcessorConfig) (Processor, error) {
-			params := config.Params
+		New: func(processorConfig config.ProcessorConfig) (Processor, error) {
+			params := processorConfig.Params
 
-			path, ok := params["path"]
-
-			if !ok {
-				return nil, fmt.Errorf("script.wasm requires a path parameter")
+			pathString, err := params.GetString("path")
+			if err != nil {
+				return nil, fmt.Errorf("script.wasm path error: %w", err)
 			}
 
-			pathString, ok := path.(string)
-
-			if !ok {
-				return nil, fmt.Errorf("script.wasm path must be a string")
+			functionString, err := params.GetString("function")
+			if err != nil {
+				if errors.Is(err, config.ErrParamNotFound) {
+					functionString = "process"
+				} else {
+					return nil, fmt.Errorf("script.wasm function error: %w", err)
+				}
 			}
 
-			functionString := "process"
-
-			function, ok := params["function"]
-
-			if ok {
-				specificFunctionString, ok := function.(string)
-
-				if !ok {
-					return nil, fmt.Errorf("script.wasm function must be a string")
+			enableWasiBool, err := params.GetBool("enableWasi")
+			if err != nil {
+				if errors.Is(err, config.ErrParamNotFound) {
+					enableWasiBool = false
+				} else {
+					return nil, fmt.Errorf("script.wasm enableWasi error: %w", err)
 				}
-				functionString = specificFunctionString
 			}
 
 			manifest := extism.Manifest{
@@ -80,13 +79,15 @@ func init() {
 				},
 			}
 
-			program, err := extism.NewCompiledPlugin(context.Background(), manifest, extism.PluginConfig{}, []extism.HostFunction{})
+			program, err := extism.NewCompiledPlugin(context.Background(), manifest, extism.PluginConfig{
+				EnableWasi: enableWasiBool,
+			}, []extism.HostFunction{})
 
 			if err != nil {
 				return nil, err
 			}
 
-			return &ScriptWASM{config: config, Program: program, Function: functionString}, nil
+			return &ScriptWASM{config: processorConfig, Program: program, Function: functionString}, nil
 		},
 	})
 }

internal/processor/sip-response-audio-create.go

@@ -3,7 +3,7 @@ package processor
 import (
 	"bytes"
 	"context"
-	"errors"
+	"fmt"
 	"text/template"
 
 	"github.com/jwetzell/showbridge-go/internal/config"
@@ -22,10 +22,12 @@ type SipAudioFileResponse struct {
 	AudioFile string
 }
 
-func (scc *SipResponseAudioCreate) Process(ctx context.Context, payload any) (any, error) {
+func (srac *SipResponseAudioCreate) Process(ctx context.Context, payload any) (any, error) {
+
+	templateData := GetTemplateData(ctx, payload)
 
 	var audioFileBuffer bytes.Buffer
-	err := scc.AudioFile.Execute(&audioFileBuffer, payload)
+	err := srac.AudioFile.Execute(&audioFileBuffer, templateData)
 
 	if err != nil {
 		return nil, err
@@ -34,14 +36,14 @@ func (scc *SipResponseAudioCreate) Process(ctx context.Context, payload any) (an
 	audioFileString := audioFileBuffer.String()
 
 	return SipAudioFileResponse{
-		PreWait:   scc.PreWait,
-		PostWait:  scc.PostWait,
+		PreWait:   srac.PreWait,
+		PostWait:  srac.PostWait,
 		AudioFile: audioFileString,
 	}, nil
 }
 
-func (scc *SipResponseAudioCreate) Type() string {
-	return scc.config.Type
+func (srac *SipResponseAudioCreate) Type() string {
+	return srac.config.Type
 }
 
 func init() {
@@ -50,40 +52,19 @@ func init() {
 		New: func(config config.ProcessorConfig) (Processor, error) {
 			params := config.Params
 
-			preWait, ok := params["preWait"]
-
-			if !ok {
-				return nil, errors.New("sip.response.audio.create requires a preWait parameter")
+			preWaitNum, err := params.GetInt("preWait")
+			if err != nil {
+				return nil, fmt.Errorf("sip.response.audio.create preWait error: %w", err)
 			}
 
-			preWaitNum, ok := preWait.(float64)
-
-			if !ok {
-				return nil, errors.New("sip.response.audio.create preWait must be a number")
+			postWaitNum, err := params.GetInt("postWait")
+			if err != nil {
+				return nil, fmt.Errorf("sip.response.audio.create postWait error: %w", err)
 			}
 
-			postWait, ok := params["postWait"]
-
-			if !ok {
-				return nil, errors.New("sip.response.audio.create requires a postWait parameter")
-			}
-
-			postWaitNum, ok := postWait.(float64)
-
-			if !ok {
-				return nil, errors.New("sip.response.audio.create postWait must be a number")
-			}
-
-			audioFile, ok := params["audioFile"]
-
-			if !ok {
-				return nil, errors.New("sip.response.audio.create requires a audioFile parameter")
-			}
-
-			audioFileString, ok := audioFile.(string)
-
-			if !ok {
-				return nil, errors.New("sip.response.audio.create audioFile must be a string")
+			audioFileString, err := params.GetString("audioFile")
+			if err != nil {
+				return nil, fmt.Errorf("sip.response.audio.create audioFile error: %w", err)
 			}
 
 			audioFileTemplate, err := template.New("audioFile").Parse(audioFileString)

internal/processor/sip-response-dtmf-create.go

@@ -4,6 +4,7 @@ import (
 	"bytes"
 	"context"
 	"errors"
+	"fmt"
 	"regexp"
 	"text/template"
 
@@ -24,10 +25,12 @@ type SipDTMFResponse struct {
 	Digits   string
 }
 
-func (scc *SipResponseDTMFCreate) Process(ctx context.Context, payload any) (any, error) {
+func (srdc *SipResponseDTMFCreate) Process(ctx context.Context, payload any) (any, error) {
+
+	templateData := GetTemplateData(ctx, payload)
 
 	var digitsBuffer bytes.Buffer
-	err := scc.Digits.Execute(&digitsBuffer, payload)
+	err := srdc.Digits.Execute(&digitsBuffer, templateData)
 
 	if err != nil {
 		return nil, err
@@ -35,19 +38,19 @@ func (scc *SipResponseDTMFCreate) Process(ctx context.Context, payload any) (any
 
 	digitsString := digitsBuffer.String()
 
-	if !scc.validDTMF.MatchString(digitsString) {
+	if !srdc.validDTMF.MatchString(digitsString) {
 		return nil, errors.New("sip.response.dtmf.create result of digits template contains invalid characters")
 	}
 
 	return SipDTMFResponse{
-		PreWait:  scc.PreWait,
-		PostWait: scc.PostWait,
+		PreWait:  srdc.PreWait,
+		PostWait: srdc.PostWait,
 		Digits:   digitsString,
 	}, nil
 }
 
-func (scc *SipResponseDTMFCreate) Type() string {
-	return scc.config.Type
+func (srdc *SipResponseDTMFCreate) Type() string {
+	return srdc.config.Type
 }
 
 func init() {
@@ -56,40 +59,19 @@ func init() {
 		New: func(config config.ProcessorConfig) (Processor, error) {
 			params := config.Params
 
-			preWait, ok := params["preWait"]
-
-			if !ok {
-				return nil, errors.New("sip.response.dtmf.create requires a preWait parameter")
+			preWaitNum, err := params.GetInt("preWait")
+			if err != nil {
+				return nil, fmt.Errorf("sip.response.dtmf.create preWait error: %w", err)
 			}
 
-			preWaitNum, ok := preWait.(float64)
-
-			if !ok {
-				return nil, errors.New("sip.response.dtmf.create preWait must be a number")
+			postWaitNum, err := params.GetInt("postWait")
+			if err != nil {
+				return nil, fmt.Errorf("sip.response.dtmf.create postWait error: %w", err)
 			}
 
-			postWait, ok := params["postWait"]
-
-			if !ok {
-				return nil, errors.New("sip.response.dtmf.create requires a postWait parameter")
-			}
-
-			postWaitNum, ok := postWait.(float64)
-
-			if !ok {
-				return nil, errors.New("sip.response.dtmf.create postWait must be a number")
-			}
-
-			digits, ok := params["digits"]
-
-			if !ok {
-				return nil, errors.New("sip.response.dtmf.create requires a digits parameter")
-			}
-
-			digitsString, ok := digits.(string)
-
-			if !ok {
-				return nil, errors.New("sip.response.dtmf.create digits must be a string")
+			digitsString, err := params.GetString("digits")
+			if err != nil {
+				return nil, fmt.Errorf("sip.response.dtmf.create digits error: %w", err)
 			}
 
 			digitsTemplate, err := template.New("digits").Parse(digitsString)

internal/processor/string-create.go

@@ -3,7 +3,7 @@ package processor
 import (
 	"bytes"
 	"context"
-	"errors"
+	"fmt"
 	"text/template"
 
 	"github.com/jwetzell/showbridge-go/internal/config"
@@ -15,8 +15,10 @@ type StringCreate struct {
 }
 
 func (sc *StringCreate) Process(ctx context.Context, payload any) (any, error) {
+	templateData := GetTemplateData(ctx, payload)
+
 	var templateBuffer bytes.Buffer
-	err := sc.Template.Execute(&templateBuffer, payload)
+	err := sc.Template.Execute(&templateBuffer, templateData)
 
 	if err != nil {
 		return nil, err
@@ -36,16 +38,9 @@ func init() {
 		Type: "string.create",
 		New: func(config config.ProcessorConfig) (Processor, error) {
 			params := config.Params
-			tmpl, ok := params["template"]
-
-			if !ok {
-				return nil, errors.New("string.create requires a template parameter")
-			}
-
-			templateString, ok := tmpl.(string)
-
-			if !ok {
-				return nil, errors.New("string.create template must be a string")
+			templateString, err := params.GetString("template")
+			if err != nil {
+				return nil, fmt.Errorf("string.create template error: %w", err)
 			}
 
 			templateTemplate, err := template.New("template").Parse(templateString)

internal/processor/string-decode.go

@@ -12,7 +12,7 @@ type StringDecode struct {
 }
 
 func (sd *StringDecode) Process(ctx context.Context, payload any) (any, error) {
-	payloadBytes, ok := payload.([]byte)
+	payloadBytes, ok := GetAnyAs[[]byte](payload)
 
 	if !ok {
 		return nil, errors.New("string.decode processor only accepts a []byte")

internal/processor/string-encode.go

@@ -12,7 +12,7 @@ type StringEncode struct {
 }
 
 func (se *StringEncode) Process(ctx context.Context, payload any) (any, error) {
-	payloadString, ok := payload.(string)
+	payloadString, ok := GetAnyAs[string](payload)
 
 	if !ok {
 		return nil, errors.New("string.encode processor only accepts a string")

internal/processor/string-filter.go

@@ -3,6 +3,7 @@ package processor
 import (
 	"context"
 	"errors"
+	"fmt"
 	"regexp"
 
 	"github.com/jwetzell/showbridge-go/internal/config"
@@ -14,7 +15,7 @@ type StringFilter struct {
 }
 
 func (sf *StringFilter) Process(ctx context.Context, payload any) (any, error) {
-	payloadString, ok := payload.(string)
+	payloadString, ok := GetAnyAs[string](payload)
 
 	if !ok {
 		return nil, errors.New("string.filter processor only accepts a string")
@@ -37,16 +38,9 @@ func init() {
 		New: func(config config.ProcessorConfig) (Processor, error) {
 			params := config.Params
 
-			pattern, ok := params["pattern"]
-
-			if !ok {
-				return nil, errors.New("string.filter requires a pattern parameter")
-			}
-
-			patternString, ok := pattern.(string)
-
-			if !ok {
-				return nil, errors.New("string.filter pattern must be a string")
+			patternString, err := params.GetString("pattern")
+			if err != nil {
+				return nil, fmt.Errorf("string.filter pattern error: %w", err)
 			}
 
 			patternRegexp, err := regexp.Compile(patternString)

internal/processor/string-split.go

@@ -3,6 +3,7 @@ package processor
 import (
 	"context"
 	"errors"
+	"fmt"
 	"strings"
 
 	"github.com/jwetzell/showbridge-go/internal/config"
@@ -14,7 +15,7 @@ type StringSplit struct {
 }
 
 func (ss *StringSplit) Process(ctx context.Context, payload any) (any, error) {
-	payloadString, ok := payload.(string)
+	payloadString, ok := GetAnyAs[string](payload)
 
 	if !ok {
 		return nil, errors.New("string.split only accepts a string")
@@ -35,16 +36,9 @@ func init() {
 		New: func(config config.ProcessorConfig) (Processor, error) {
 			params := config.Params
 
-			separator, ok := params["separator"]
-
-			if !ok {
-				return nil, errors.New("string.split requires a separator")
-			}
-
-			separatorString, ok := separator.(string)
-
-			if !ok {
-				return nil, errors.New("string.split separator must be a string")
+			separatorString, err := params.GetString("separator")
+			if err != nil {
+				return nil, fmt.Errorf("string.split separator error: %w", err)
 			}
 
 			return &StringSplit{config: config, Separator: separatorString}, nil

internal/processor/string-split_test.go

@@ -1,70 +0,0 @@
-package processor_test
-
-import (
-	"slices"
-	"testing"
-
-	"github.com/jwetzell/showbridge-go/internal/processor"
-)
-
-func TestGoodStringSplit(t *testing.T) {
-	tests := []struct {
-		processor processor.Processor
-		name      string
-		payload   any
-		expected  []string
-	}{
-		{
-			processor: &processor.StringSplit{Separator: ","},
-			name:      "comma separated",
-			payload:   "part1,part2,part3",
-			expected:  []string{"part1", "part2", "part3"},
-		},
-	}
-
-	for _, test := range tests {
-		t.Run(test.name, func(t *testing.T) {
-			got, err := test.processor.Process(t.Context(), test.payload)
-
-			gotStrings, ok := got.([]string)
-			if !ok {
-				t.Fatalf("string.split returned a %T payload: %s", got, got)
-			}
-			if err != nil {
-				t.Fatalf("string.split failed: %s", err)
-			}
-			if !slices.Equal(gotStrings, test.expected) {
-				t.Fatalf("string.split got %s, expected %s", got, test.expected)
-			}
-		})
-	}
-}
-
-func TestBadStringSplit(t *testing.T) {
-	tests := []struct {
-		processor   processor.Processor
-		name        string
-		payload     any
-		errorString string
-	}{
-		{
-			processor:   &processor.StringSplit{Separator: ","},
-			name:        "hello",
-			payload:     []byte{0x68, 0x65, 0x6c, 0x6c, 0x6f},
-			errorString: "string.split only accepts a string",
-		},
-	}
-
-	for _, test := range tests {
-		t.Run(test.name, func(t *testing.T) {
-			got, err := test.processor.Process(t.Context(), test.payload)
-
-			if err == nil {
-				t.Fatalf("string.split expected error but got none, payload: %s", got)
-			}
-			if err.Error() != test.errorString {
-				t.Fatalf("string.split got error '%s', expected '%s'", err.Error(), test.errorString)
-			}
-		})
-	}
-}