release

Documentation

Index

• Constants
• func CurrentTarget() string
• func Seal(root string) error
• func TransportCapabilities(manifest Manifest) (app, relay []string)
• func ValidateUpgradeCompatibility(current, target Manifest) error
• func WebHashFS(filesystem fs.FS) (string, error)
• type Manifest
  • func Build(root, version, revision, target string) (Manifest, error)
  • func Load(root string) (Manifest, error)
  • func Verify(root, expectedTarget string) (Manifest, error)

Constants

const (
	ManifestName   = "release-manifest.json"
	ManifestSchema = 1
)

Functions

func CurrentTarget

func CurrentTarget() string

func Seal

func Seal(root string) error

Seal removes write permission from a verified release tree. Runtime state belongs outside releases, and keeping installed bundles immutable prevents platform metadata such as Finder's .DS_Store from invalidating the manifest.

func TransportCapabilities

func TransportCapabilities(manifest Manifest) (app, relay []string)

TransportCapabilities returns the transports supported by an installed release. Releases created before this metadata existed spoke E2EE v1 only.

func ValidateUpgradeCompatibility

func ValidateUpgradeCompatibility(current, target Manifest) error

ValidateUpgradeCompatibility requires both app-first and relay-first rollout windows to remain connected. An incompatible transport change therefore needs an intermediate bridge release that supports both transports.

func WebHashFS

func WebHashFS(filesystem fs.FS) (string, error)

Types

type Manifest

type Manifest struct {
	Schema          int               `json:"schema"`
	Version         string            `json:"version"`
	Revision        string            `json:"revision"`
	Target          string            `json:"target"`
	WebHash         string            `json:"web_hash,omitempty"`
	AppTransports   []string          `json:"app_transports,omitempty"`
	RelayTransports []string          `json:"relay_transports,omitempty"`
	Files           map[string]string `json:"files"`
}

func Build

func Build(root, version, revision, target string) (Manifest, error)

func Load

func Load(root string) (Manifest, error)

func Verify

func Verify(root, expectedTarget string) (Manifest, error)