wavvon

type AppClose struct {
	AppID     string `json:"app_id"`
	ChannelID string `json:"channel_id"`
}

type AppCommand struct {
	Name        string `json:"name"`
	Description string `json:"description"`
	Args        string `json:"args,omitempty"`
	// Scope is "hub" (the default) or "channel".
	Scope      string `json:"scope,omitempty"`
	Privileged bool   `json:"privileged,omitempty"`
	// CooldownSeconds per user and command; nil means the hub default (3), 0 none.
	CooldownSeconds *int64 `json:"cooldown_seconds,omitempty"`
}

type AppComponent struct {
	// Type is "button" or "select".
	Type        string         `json:"type"`
	CustomID    string         `json:"custom_id"`
	Label       string         `json:"label,omitempty"`
	Style       string         `json:"style,omitempty"`
	Disabled    bool           `json:"disabled,omitempty"`
	Placeholder string         `json:"placeholder,omitempty"`
	MinValues   *int           `json:"min_values,omitempty"`
	MaxValues   *int           `json:"max_values,omitempty"`
	Options     []SelectOption `json:"options,omitempty"`
}

type AppLaunch struct {
	AppID       string `json:"app_id"`
	Title       string `json:"title"`
	Description string `json:"description"`
	ChannelID   string `json:"channel_id"`
}

type AppOpen struct {
	AppID          string `json:"app_id"`
	ChannelID      string `json:"channel_id"`
	MiniAppURL     string `json:"mini_app_url"`
	SessionToken   string `json:"session_token"`
	RequiresCamera bool   `json:"requires_camera"`
}

type AppProfile = rest.SetMeAppProfileJSONRequestBody

type AppResponse struct {
	Reply *Reply `json:"reply,omitempty"`
	// Ephemeral shows the reply to the invoker only.
	Ephemeral bool       `json:"ephemeral,omitempty"`
	Reactions []Reaction `json:"reactions,omitempty"`
	// Defer says the app will post later on its own.
	Defer bool `json:"defer,omitempty"`
	// Game is attached to the reply; ignored without one.
	Game *GameLaunchCard `json:"game,omitempty"`
}

type AppSubscription struct {
	Event    string   `json:"event"`
	Channels []string `json:"channels,omitempty"`
}

type AuthOptions struct {
	// InviteCode admits the program on an invite_only hub. Ignored for members.
	InviteCode string
	Retry      RetryOptions
	// HTTPClient defaults to http.DefaultClient.
	HTTPClient *http.Client
}

type AuthSchemeError struct {
	Reason string
}

type AuthorInfo struct {
	Pubkey      string `json:"pubkey"`
	DisplayName string `json:"display_name,omitempty"`
}

type Client struct {
	HubURL   string
	Identity *Identity
	// Rest is the client generated from openapi.yaml. Bearer, retry and
	// re-authentication on 401 are built into its transport; pass its
	// results through Check to turn non-2xx answers into errors.
	Rest *rest.ClientWithResponses
	// contains filtered or unexported fields
}

type ClientOptions struct {
	HubURL string
	// Seed is a 32-byte Ed25519 seed. It is never sent anywhere.
	Seed []byte
	// Identity is used instead of Seed when set.
	Identity *Identity
	// InviteCode admits the program on an invite_only hub.
	InviteCode string
	Retry      RetryOptions
	// HTTPClient defaults to http.DefaultClient.
	HTTPClient *http.Client
}

type ComponentInteraction struct {
	HubURL    string     `json:"hub_url"`
	ChannelID string     `json:"channel_id"`
	MessageID string     `json:"message_id"`
	CustomID  string     `json:"custom_id"`
	Values    []string   `json:"values"`
	User      AuthorInfo `json:"user"`
}

type ComponentResponse struct {
	Update         *ComponentUpdate `json:"update,omitempty"`
	EphemeralReply *EphemeralReply  `json:"ephemeral_reply,omitempty"`
	Defer          bool             `json:"defer,omitempty"`
}

type ComponentRow struct {
	Type       string         `json:"type"`
	Components []AppComponent `json:"components"`
}

type ComponentUpdate struct {
	Body       *string        `json:"body,omitempty"`
	Components []ComponentRow `json:"components,omitempty"`
}

type ConnectionState string

type DMEvent struct {
	ConversationID string  `json:"conversation_id"`
	Sender         string  `json:"sender"`
	SenderName     *string `json:"sender_name"`
	Content        string  `json:"content"`
	Timestamp      int64   `json:"timestamp"`
}

type Dispatch interface {
	DispatchType() string
}

type DispatchHandler struct {
	// HubPublicKey is the hub's key, hex, from GET /info.
	HubPublicKey   string
	OnSlashCommand func(context.Context, *SlashInvocation) (*AppResponse, error)
	OnComponent    func(context.Context, *ComponentInteraction) (*ComponentResponse, error)
	// OnUnknown handles a verified dispatch of a type this SDK does not know.
	OnUnknown func(context.Context, *UnknownDispatch) (any, error)
	Verify    VerifyOptions
}

type Embed struct {
	Title        string       `json:"title,omitempty"`
	URL          string       `json:"url,omitempty"`
	Description  string       `json:"description,omitempty"`
	Color        string       `json:"color,omitempty"`
	Fields       []EmbedField `json:"fields,omitempty"`
	ThumbnailURL string       `json:"thumbnail_url,omitempty"`
	ImageURL     string       `json:"image_url,omitempty"`
	Footer       *EmbedFooter `json:"footer,omitempty"`
}

type EmbedField struct {
	Name   string `json:"name"`
	Value  string `json:"value"`
	Inline bool   `json:"inline,omitempty"`
}

type EmbedFooter struct {
	Text string `json:"text"`
}

type EphemeralReply struct {
	Body string `json:"body"`
}

type ErrorEvent struct {
	Context string `json:"context"`
	Message string `json:"message"`
}

type Event interface {
	// EventType is the frame's "type" field ("binary" for a binary frame).
	EventType() string
}

type EventStream struct {
	// contains filtered or unexported fields
}

type EventStreamOptions struct {
	// SinceSeq replays hub events after this seq on the first connect (an app
	// persisting its position across restarts). Nil starts from now.
	SinceSeq *int64
	// Buffer is how many events wait for Next before reading pauses. Default 256.
	Buffer int
}

type GameLaunchCard struct {
	EntryURL     string `json:"entry_url"`
	Name         string `json:"name"`
	Description  string `json:"description,omitempty"`
	ThumbnailURL string `json:"thumbnail_url,omitempty"`
}

type Hello struct {
	LiveSeq int64 `json:"live_seq"`
}

type HubError struct {
	Status int
	// Body is the hub's own words, usually plain text.
	Body string
}

type HubEvent struct {
	Seq int64 `json:"seq"`
	// Event is e.g. "member.joined", "message.created".
	Event   string         `json:"event"`
	HubURL  string         `json:"hub_url"`
	At      int64          `json:"at"`
	Payload map[string]any `json:"payload"`
	// Replay only, and only when the audit row has them.
	ActorPubkey  string `json:"actor_pubkey,omitempty"`
	TargetPubkey string `json:"target_pubkey,omitempty"`
	ChannelID    string `json:"channel_id,omitempty"`
	Replayed     bool   `json:"replayed,omitempty"`
}

type HubUnavailableError struct {
	// LastStatus is the last HTTP status seen, or 0 for a network error or timeout.
	LastStatus int
	Attempts   int
	// Err is the last network error, if the last attempt failed with one.
	Err error
}

type Identity struct {
	// PublicKey is the Ed25519 public key, lowercase hex.
	PublicKey string
	// contains filtered or unexported fields
}

type MessageEvent struct {
	Type      string       `json:"type"`
	ChannelID string       `json:"channel_id"`
	Message   rest.Message `json:"message"`
}

type MessageRefEvent struct {
	Type      string `json:"type"`
	ChannelID string `json:"channel_id"`
	MessageID string `json:"message_id"`
}

type MiniAppMessage struct {
	AppID      string `json:"app_id"`
	ChannelID  string `json:"channel_id"`
	Payload    string `json:"payload"`
	FromPubkey string `json:"from_pubkey,omitempty"`
}

type OutgoingWebhookEvent struct {
	Type string `json:"type"`
	HubEvent
	WebhookID string `json:"webhook_id,omitempty"`
	Truncated bool   `json:"truncated,omitempty"`
}

type PolledEvent struct {
	ID        string
	EventType string
	// Payload is the event's JSON. A payload that is not JSON arrives as a JSON string.
	Payload   json.RawMessage
	CreatedAt int64
}

type Pong struct {
	Nonce           int64    `json:"nonce"`
	OutboundLossPct *float64 `json:"outbound_loss_pct,omitempty"`
}

type Reaction struct {
	MessageID string `json:"message_id"`
	Emoji     string `json:"emoji"`
}

type ReactionsUpdated struct {
	ChannelID string `json:"channel_id"`
	MessageID string `json:"message_id"`
	Reactions []struct {
		Emoji string `json:"emoji"`
		Count int    `json:"count"`
		Me    bool   `json:"me"`
	} `json:"reactions"`
}

type ReplayComplete struct {
	Replayed    int64 `json:"replayed"`
	LiveFromSeq int64 `json:"live_from_seq"`
}

type ReplayUnavailable struct {
	EarliestSeq int64 `json:"earliest_seq"`
	EarliestAt  int64 `json:"earliest_at"`
}

type Reply struct {
	Body       string         `json:"body"`
	Embeds     []Embed        `json:"embeds,omitempty"`
	Components []ComponentRow `json:"components,omitempty"`
	ReplyTo    string         `json:"reply_to,omitempty"`
}

type RetryInfo struct {
	Attempt int
	Delay   time.Duration
	// Status is the HTTP status, or 0 for a network error or timeout.
	Status int
	Err    error
}

type RetryOptions struct {
	// MaxAttempts before giving up with HubUnavailableError. 0 means 8; a
	// negative value keeps trying until the context ends.
	MaxAttempts int
	// BaseDelay is the first backoff ceiling. Default 500 ms.
	BaseDelay time.Duration
	// MaxDelay caps the backoff ceiling. Default 30 s.
	MaxDelay time.Duration
	// Timeout per attempt; a timeout counts as transient. Default 15 s.
	Timeout time.Duration
	// OnRetry is called before each wait, so a program can show it is retrying.
	OnRetry func(RetryInfo)
	// contains filtered or unexported fields
}

type SelectOption struct {
	Label       string `json:"label"`
	Value       string `json:"value"`
	Description string `json:"description,omitempty"`
}

type Session struct {
	Token string
	// Scope is "member", or "lobby" on a hub that holds newcomers back.
	Scope string
	// CanonicalPubkey is the identity the hub attributes this session's actions to.
	CanonicalPubkey string
}

type SessionState string

type SlashInvocation struct {
	HubURL        string     `json:"hub_url"`
	ChannelID     string     `json:"channel_id"`
	MessageIDHint string     `json:"message_id_hint"`
	Author        AuthorInfo `json:"author"`
	Command       string     `json:"command"`
	ArgsRaw       string     `json:"args_raw"`
	ArgsTokens    []string   `json:"args_tokens"`
}

type TypingEvent struct {
	ChannelID   string  `json:"channel_id"`
	PublicKey   string  `json:"public_key"`
	DisplayName *string `json:"display_name"`
	Typing      bool    `json:"typing"`
}

type UnknownDispatch struct {
	RawType string
	Raw     json.RawMessage
}

type UnknownEvent struct {
	// RawType is the frame's own type, "binary" for a binary frame, "" if unparseable.
	RawType string
	Raw     []byte
}

type UnsupportedByHubError struct {
	Capability string
}

type VerifyOptions struct {
	// Now defaults to the clock.
	Now time.Time
	// Tolerance is the maximum |now - X-Wavvon-Timestamp|. Default 300 s.
	Tolerance time.Duration
}

type WebhookVerificationError struct {
	Reason string
}