whatsapp

type AccessControlConfig struct {
	// DefaultPolicy: "allow" (anyone), "deny" (only authorized), or "ask" (ask once).
	DefaultPolicy string `yaml:"default_policy"`

	// Owners have full control.
	Owners []string `yaml:"owners"`

	// Admins can manage users.
	Admins []string `yaml:"admins"`

	// Allowed users can interact.
	AllowedUsers []string `yaml:"allowed_users"`

	// Blocked users cannot interact.
	BlockedUsers []string `yaml:"blocked_users"`

	// Allowed groups can interact.
	AllowedGroups []string `yaml:"allowed_groups"`

	// Blocked groups cannot interact.
	BlockedGroups []string `yaml:"blocked_groups"`

	// Pending message sent to unauthorized users.
	PendingMessage string `yaml:"pending_message"`
}

type Config struct {
	// InstanceID identifies this instance ("" for default, e.g. "business" for named).
	// Set automatically from the config key in whatsapp_instances.
	InstanceID string `yaml:"instance_id,omitempty"`

	// SessionDir is the directory for session persistence (SQLite).
	// Ignored if DatabasePath is set.
	SessionDir string `yaml:"session_dir"`

	// DatabasePath is the path to the SQLite database file for session storage.
	// If set, the WhatsApp session tables (prefixed with whatsmeow_) will be
	// stored in this database alongside other devclaw data.
	// If empty, defaults to {SessionDir}/whatsapp.db.
	DatabasePath string `yaml:"database_path"`

	// Trigger is the keyword that activates the bot (e.g. "@devclaw").
	Trigger string `yaml:"trigger"`

	// RespondToGroups enables responding in group chats.
	RespondToGroups bool `yaml:"respond_to_groups"`

	// RespondToDMs enables responding in direct messages.
	RespondToDMs bool `yaml:"respond_to_dms"`

	// AutoRead marks incoming messages as read.
	AutoRead bool `yaml:"auto_read"`

	// SendTyping sends typing indicators while processing.
	SendTyping bool `yaml:"send_typing"`

	// MediaDir is the directory for downloaded media files.
	MediaDir string `yaml:"media_dir"`

	// MaxMediaSizeMB is the maximum media file size to process.
	MaxMediaSizeMB int `yaml:"max_media_size_mb"`

	// ReconnectBackoff is the initial backoff duration for reconnection.
	ReconnectBackoff time.Duration `yaml:"reconnect_backoff"`

	// MaxReconnectAttempts is the maximum number of reconnection attempts (0 = unlimited).
	MaxReconnectAttempts int `yaml:"max_reconnect_attempts"`

	// HealthMonitor configures proactive connection health monitoring.
	HealthMonitor HealthMonitorConfig `yaml:"health_monitor"`

	// Access control configuration.
	Access AccessControlConfig `yaml:"access"`

	// Group policies configuration.
	GroupPolicies GroupPoliciesConfig `yaml:"group_policies"`
}

type ConnectionEvent struct {
	State     ConnectionState `json:"state"`
	Previous  ConnectionState `json:"previous,omitempty"`
	Timestamp time.Time       `json:"timestamp"`
	Reason    string          `json:"reason,omitempty"`
	Details   map[string]any  `json:"details,omitempty"`
}

type ConnectionObserver interface {
	OnConnectionChange(evt ConnectionEvent)
}

type ConnectionState string

type GroupPoliciesConfig struct {
	// Default policies for unconfigured groups.
	// Multiple policies are combined with OR logic.
	DefaultPolicies []string `yaml:"default_policies"`

	// Legacy DefaultPolicy for backwards compatibility.
	// Deprecated: Use DefaultPolicies instead.
	DefaultPolicy string `yaml:"default_policy"`

	// Specific group policies.
	Groups []GroupPolicyConfig `yaml:"groups"`
}

type GroupPolicyConfig struct {
	// ID is the group JID.
	ID string `yaml:"id"`

	// Name is optional display name.
	Name string `yaml:"name"`

	// Policies: list of "always", "mention", "reply", "keyword", "disabled", "allowlist".
	// Multiple policies are combined with OR logic (respond if ANY policy matches).
	Policies []string `yaml:"policies"`

	// Legacy Policy field for backwards compatibility.
	// Deprecated: Use Policies instead.
	Policy string `yaml:"policy"`

	// Keywords that trigger the bot (for policy="keyword").
	Keywords []string `yaml:"keywords"`

	// Allowed users (for policy="allowlist").
	AllowedUsers []string `yaml:"allowed_users"`

	// Workspace override for this group.
	Workspace string `yaml:"workspace"`
}

type HealthMonitorConfig struct {
	// Enabled turns on proactive health monitoring.
	Enabled bool `yaml:"enabled"`

	// CheckInterval is how often to perform health checks.
	// Default: 30s
	CheckInterval time.Duration `yaml:"check_interval"`

	// MaxSilentDuration is the maximum time without any activity before
	// a health check is considered failed.
	// Default: 5m
	MaxSilentDuration time.Duration `yaml:"max_silent_duration"`

	// ForceReconnectAfter is the maximum silent duration before forcing
	// a preventive reconnection, regardless of client.IsConnected() result.
	// This handles "half-open" TCP connections where the socket appears
	// connected but is actually dead.
	// Default: 30m (0 = disabled)
	ForceReconnectAfter time.Duration `yaml:"force_reconnect_after"`
}

type QREvent struct {
	// Type is "code", "success", "timeout", "error", or "refresh".
	Type string `json:"type"`
	// Code is the raw QR code string (only for Type == "code").
	Code string `json:"code,omitempty"`
	// Message is a human-readable description.
	Message string `json:"message,omitempty"`
	// ExpiresAt is when the QR code expires.
	ExpiresAt time.Time `json:"expires_at,omitempty"`
	// SecondsLeft is seconds until expiration.
	SecondsLeft int `json:"seconds_left,omitempty"`
}

type QREventEnhanced struct {
	Type        string    `json:"type"`                   // "code", "success", "timeout", "error", "refresh"
	Code        string    `json:"code,omitempty"`         // Raw QR code string
	Message     string    `json:"message"`                // Human-readable message
	ExpiresAt   time.Time `json:"expires_at,omitempty"`   // When QR code expires
	SecondsLeft int       `json:"seconds_left,omitempty"` // Seconds until expiration
	Attempts    int       `json:"attempts,omitempty"`     // Number of QR attempts
}

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