Files
Piik/internal/client/loopback/protocol.go
T
AAA 1332473513 feat: rename product and runtime to Piik
Rename the active product, Go module, binaries, configuration, protocols and documentation to Piik while retaining the TV mascot and existing media/room behavior.

Use one current private contract without old-name aliases. Preserve SQLite authority and copy compatible local settings once; other settings start fresh. Git-message cleanup and the infrastructure name cutover are coordinated with this phase, with original history and deployment data archived externally.

Validated locally with Web and Go checks, Windows capture compilation, matched Client/Server builds, packaged Client control handshake and history-rewrite integrity checks. Skip duplicate hosted CI for this owner-authorized local release.

[skip ci]
2026-09-10 11:10:12 +08:00

74 lines
1.8 KiB
Go

package loopback
import (
"bytes"
"encoding/json"
"errors"
"io"
"regexp"
)
const (
ProtocolVersion = 9
ServiceName = "piik-client"
ControlSubprotocol = "piik-client-v9"
MaxControlMessageBytes = 256 << 10
DefaultPortStart = 39721
DefaultPortEnd = 39730
)
var (
requestIDPattern = regexp.MustCompile(`^[A-Za-z0-9_-]{8,256}$`)
errInvalidMessage = errors.New("loopback control message is invalid")
)
type controlMessage struct {
Version int `json:"version"`
ID string `json:"id"`
Type string `json:"type"`
}
func decodeEnvelope(payload []byte) (controlMessage, error) {
var message controlMessage
decoder := json.NewDecoder(bytes.NewReader(payload))
if decoder.Decode(&message) != nil || decoder.Decode(&struct{}{}) != io.EOF ||
message.Version != ProtocolVersion || !requestIDPattern.MatchString(message.ID) ||
message.Type == "" {
return controlMessage{}, errInvalidMessage
}
return message, nil
}
func decodeRequest(payload []byte) (controlMessage, error) {
var message controlMessage
decoder := json.NewDecoder(bytes.NewReader(payload))
decoder.DisallowUnknownFields()
if decoder.Decode(&message) != nil || decoder.Decode(&struct{}{}) != io.EOF ||
message.Version != ProtocolVersion || !requestIDPattern.MatchString(message.ID) {
return controlMessage{}, errInvalidMessage
}
return message, nil
}
func validateHello(message controlMessage) error {
if message.Type != "hello" {
return errInvalidMessage
}
return nil
}
func validatePing(message controlMessage) error {
if message.Type != "ping" {
return errInvalidMessage
}
return nil
}
func encodeMessage(value any) ([]byte, error) {
payload, err := json.Marshal(value)
if err != nil || len(payload) == 0 || len(payload) > MaxControlMessageBytes {
return nil, errInvalidMessage
}
return payload, nil
}