ref

package

v0.1.0 Latest Latest Go to latest Published: Jul 17, 2026 License: MIT Imports: 5 Imported by: 0

Details

This section is empty.

This section is empty.

func IsKnownField(field string) bool

IsKnownField reports whether field is part of the user-facing field vocabulary.

func NormalizeFields(fields []string) ([]string, error)

NormalizeFields validates fields, removes duplicates, and returns canonical order.

func ParseReportPinNumber(arg string) (int64, error)

ParseReportPinNumber parses a positive pin number from a flag.

func WireFieldName(field string) string

WireFieldName returns the API wire field name for a validated user-facing field.

type PinFetch struct {
	Pin    PinRef
	Fields []string
}

PinFetch identifies a pin and the fields to fetch for it.

func DedupAndUnion(fetches []PinFetch) []PinFetch

DedupAndUnion merges fetches for the same pin while preserving first-seen pin order.

func ParsePinFetch(arg string, defaultFields []string) (PinFetch, error)

ParsePinFetch parses a pin reference with an optional colon-delimited field override.

type PinRef struct {
	Session SessionRef
	Pin     int64
}

PinRef identifies a pin within a Disbug session.

func ParsePin(arg string) (PinRef, error)

ParsePin parses a Disbug report URL with a pin query parameter.

func (r PinRef) RefString() string

RefString returns a stable, human-readable scoped pin reference.

type SessionRef struct {
	TeamSlug      string
	ProjectID     int64
	SessionNumber int64
}

SessionRef identifies a cloud Disbug session by the same scoped identity used in report URLs.

func ParseSession(arg string) (SessionRef, error)

ParseSession parses a Disbug report URL.

func (r SessionRef) RefString() string

RefString returns a stable, human-readable scoped session reference.