wrpc 0.16.0

WebAssembly component-native RPC framework based on WIT
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87

package wrpc

import (
	"errors"
	"fmt"
	"log/slog"
)

type Result[Ok, Err any] struct {
	Ok  *Ok
	Err *Err
}

func Ok[Err, Ok any](v Ok) *Result[Ok, Err] {
	return &Result[Ok, Err]{Ok: &v}
}

func Err[Ok, Err any](v Err) *Result[Ok, Err] {
	return &Result[Ok, Err]{Err: &v}
}

// ReadResultStatus reads a single byte from `r` and returns:
// - `true` for `result::ok`
// - `false` for `result::err`
func ReadResultStatus(r ByteReader) (bool, error) {
	status, err := r.ReadByte()
	if err != nil {
		return false, fmt.Errorf("failed to read `result` status byte: %w", err)
	}
	switch status {
	case 0:
		return true, nil
	case 1:
		return false, nil
	default:
		return false, fmt.Errorf("invalid `result` status byte %d", status)
	}
}

// ReadResult reads a single byte from `r`
func ReadResult[T, U any](r ByteReader, fOk func(ByteReader) (T, error), fErr func(ByteReader) (U, error)) (*Result[T, U], error) {
	ok, err := ReadResultStatus(r)
	if err != nil {
		return nil, err
	}
	if !ok {
		v, err := fErr(r)
		if err != nil {
			return nil, fmt.Errorf("failed to read `result::err` value: %w", err)
		}
		return &Result[T, U]{Err: &v}, nil
	}
	v, err := fOk(r)
	if err != nil {
		return nil, fmt.Errorf("failed to read `result::ok` value: %w", err)
	}
	return &Result[T, U]{Ok: &v}, nil
}

func (v *Result[Ok, Err]) WriteTo(w ByteWriter, fOk func(*Ok, ByteWriter) error, fErr func(*Err, ByteWriter) error) error {
	switch {
	case v.Ok == nil && v.Err == nil:
		return errors.New("both result variants cannot be nil")
	case v.Ok != nil && v.Err != nil:
		return errors.New("exactly one result variant must non-nil")
	case v.Ok != nil:
		slog.Debug("writing `result::ok` status byte")
		if err := w.WriteByte(0); err != nil {
			return fmt.Errorf("failed to write `result::ok` status byte: %w", err)
		}
		slog.Debug("writing `result::ok` payload")
		if err := fOk(v.Ok, w); err != nil {
			return fmt.Errorf("failed to write `result::ok` payload: %w", err)
		}
		return nil
	default:
		slog.Debug("writing `result::err` status byte")
		if err := w.WriteByte(1); err != nil {
			return fmt.Errorf("failed to write `result::err` status byte: %w", err)
		}
		slog.Debug("writing `result::err` payload")
		if err := fErr(v.Err, w); err != nil {
			return fmt.Errorf("failed to write `result::err` payload: %w", err)
		}
		return nil
	}
}