fiber

type ActionHandler func(client *WSClient, payload json.RawMessage)

type AppError struct {
	Code       ErrorCode              `json:"code"`
	Message    string                 `json:"message"`
	Details    map[string]interface{} `json:"details,omitempty"`
	Stack      string                 `json:"stack,omitempty"`
	StatusCode int                    `json:"-"`
	Recover    bool                   `json:"-"` // Whether state can be recovered
}

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

type CompressedContent struct {
	Original []byte
	Brotli   []byte
	Gzip     []byte
}

type CompressionConfig struct {
	// EnableBrotli enables Brotli compression (better compression ratio)
	EnableBrotli bool
	// EnableGzip enables Gzip compression (wider browser support)
	EnableGzip bool
	// BrotliLevel compression level (0-11, default 4 for balance)
	BrotliLevel int
	// GzipLevel compression level (1-9, default 6 for balance)
	GzipLevel int
	// MinSize minimum response size to compress (default 1024 bytes)
	MinSize int
	// CompressibleTypes content types that should be compressed
	CompressibleTypes []string
	// SkipCompression paths to skip compression for
	SkipPaths []string
}

type Config struct {
	// RuntimeScript is the path to the client runtime script
	RuntimeScript string
	// StateKey is the context key for storing state
	StateKey string
	// ComponentIDKey is the context key for component IDs
	ComponentIDKey string
	// DevMode enables development features
	DevMode bool
	// DefaultState is the initial state for new sessions
	DefaultState map[string]interface{}
}

type ConnectHandler func(client *WSClient)

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

type DevConfig struct {
	// Enabled enables development mode
	Enabled bool
	// RoutesDir is the directory containing route files
	RoutesDir string
	// ComponentsDir is the directory containing component files
	ComponentsDir string
	// WatchPaths are additional paths to watch for changes
	WatchPaths []string
	// IgnorePaths are paths to ignore
	IgnorePaths []string
	// Debounce is the debounce time for file changes
	Debounce time.Duration
	// OnReload is called when files change
	OnReload func()
	// StateKey is the context key for state
	StateKey string
}

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

type ErrorCode string

type ErrorHandlerConfig struct {
	// DevMode enables development features like stack traces
	DevMode bool
	// StateKey is the context key for state
	StateKey string
	// CustomErrorPages maps error codes to custom handlers
	CustomErrorPages map[ErrorCode]func(*fiberpkg.Ctx, *AppError) error
	// OnError is called when an error occurs
	OnError func(*fiberpkg.Ctx, *AppError)
	// RecoverState attempts to recover state on error
	RecoverState bool
}

type ErrorInfo struct {
	Message     string       `json:"message"`
	Type        string       `json:"type"`
	Stack       []StackFrame `json:"stack"`
	File        string       `json:"file"`
	Line        int          `json:"line"`
	Column      int          `json:"column"`
	CodeSnippet string       `json:"codeSnippet"`
	Timestamp   int64        `json:"timestamp"`
	Request     *RequestInfo `json:"request,omitempty"`
	Cause       *ErrorInfo   `json:"cause,omitempty"`
}

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

type ErrorOverlayConfig struct {
	Enabled     bool
	ShowStack   bool
	ShowRequest bool
	ShowCode    bool
	Theme       string // "dark" or "light"
	Editor      string // editor to open files in (e.g., "code", "idea")
	EditorPort  int
}

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

type HMRConfig struct {
	Enabled      bool          `json:"enabled"`
	WatchPaths   []string      `json:"watchPaths"`
	IgnorePaths  []string      `json:"ignorePaths"`
	DebounceTime time.Duration `json:"debounceTime"`
	BroadcastAll bool          `json:"broadcastAll"`
}

type HMRFileChangeEvent struct {
	Path        string    `json:"path"`
	EventType   string    `json:"eventType"` // "create", "modify", "delete"
	Timestamp   time.Time `json:"timestamp"`
	ContentHash string    `json:"contentHash,omitempty"`
}

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

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

type HMRMessage struct {
	Type      string `json:"type"` // "update", "reload", "error", "state-preserve", "connected"
	Path      string `json:"path,omitempty"`
	ModuleID  string `json:"moduleId,omitempty"`
	Event     string `json:"event,omitempty"`
	State     any    `json:"state,omitempty"`
	Error     string `json:"error,omitempty"`
	Timestamp int64  `json:"timestamp"`
}

type HMRUpdatePayload struct {
	ModuleID      string `json:"moduleId"`
	Path          string `json:"path"`
	UpdateType    string `json:"updateType"` // "template", "script", "style", "full"
	Content       string `json:"content,omitempty"`
	StatePreserve bool   `json:"statePreserve"`
}

type PreloadConfig struct {
	// RuntimeScript is the path to the runtime JS
	RuntimeScript string
	// NavigationScript is the path to the navigation module
	NavigationScript string
	// WebSocketScript is the path to the WebSocket module
	WebSocketScript string
	// CoreScript is the path to the core runtime
	CoreScript string
	// MicroScript is the path to the micro runtime
	MicroScript string
	// Enabled determines if preload headers are added
	Enabled bool
}

type RequestInfo struct {
	Method  string            `json:"method"`
	URL     string            `json:"url"`
	Headers map[string]string `json:"headers,omitempty"`
	Query   map[string]string `json:"query,omitempty"`
}

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

type SSEClient struct {
	// ID is the unique client identifier
	ID string
	// Channel is the client's event channel
	Channel chan SSEEvent
	// ConnectedAt is the connection timestamp
	ConnectedAt time.Time
	// Metadata contains additional client data
	Metadata map[string]any
	// Topics the client is subscribed to
	Topics map[string]bool
}

type SSEConfig struct {
	// EventBufferSize is the buffer size for client channels
	EventBufferSize int
	// HeartbeatInterval is the keepalive interval (0 to disable)
	HeartbeatInterval time.Duration
	// OnConnect is called when a client connects
	OnConnect func(*SSEClient)
	// OnDisconnect is called when a client disconnects
	OnDisconnect func(*SSEClient)
	// PubSub backend for distributed environments
	PubSub store.PubSub
}

type SSEEvent struct {
	// ID is the event identifier
	ID string `json:"id,omitempty"`
	// Event is the event type/name
	Event string `json:"event,omitempty"`
	// Data is the event payload
	Data any `json:"data"`
	// Retry specifies reconnection time in milliseconds
	Retry int `json:"retry,omitempty"`
}

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

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

type StackFrame struct {
	File     string `json:"file"`
	Line     int    `json:"line"`
	Function string `json:"function"`
	Source   string `json:"source,omitempty"`
}

type StateLogEntry struct {
	Timestamp time.Time   `json:"timestamp"`
	Key       string      `json:"key"`
	OldValue  interface{} `json:"oldValue,omitempty"`
	NewValue  interface{} `json:"newValue"`
	Source    string      `json:"source"` // "client" or "server"
}

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

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

type WSClient struct {
	ID        string
	SessionID string
	Conn      *websocket.Conn
	Send      chan []byte
	State     *state.StateMap
	// contains filtered or unexported fields
}

type WSHub struct {
	Clients    map[string]*WSClient
	Register   chan *WSClient
	Unregister chan *WSClient
	Broadcast  chan []byte
	// contains filtered or unexported fields
}

type WSMessage struct {
	Type         string                 `json:"type"`
	ComponentID  string                 `json:"componentId,omitempty"`
	Action       string                 `json:"action,omitempty"`
	Data         map[string]interface{} `json:"data,omitempty"`
	Payload      json.RawMessage        `json:"payload,omitempty"`
	SessionToken string                 `json:"sessionToken,omitempty"` // SECURITY: Token sent in message, not URL
	ClientID     string                 `json:"clientId,omitempty"`     // Client ID for session association
}

type WSStateUpdate struct {
	Key   string      `json:"key"`
	Value interface{} `json:"value"`
}

type WebSocketConfig struct {
	// Hub is the WebSocket hub for managing connections.
	Hub *WSHub
	// OnConnect is called when a client connects.
	OnConnect func(*WSClient)
	// OnDisconnect is called when a client disconnects.
	OnDisconnect func(*WSClient)
	// OnMessage is called when a message is received.
	OnMessage func(*WSClient, WSMessage)
	// GenerateID generates a client ID.
	GenerateID func() string
	// CompressState enables gzip compression of outbound state payloads.
	// The client receives { type:'compressed', data: '<base64>', compressed:true }
	// and must decompress using the DecompressionStream browser API.
	CompressState bool
	// StateDiffing enables delta-only 'patch' messages instead of full state syncs.
	// When enabled only changed keys are broadcast after the initial snapshot.
	StateDiffing bool
	// Serializer overrides JSON for outbound state serialization.
	Serializer func(interface{}) ([]byte, error)
	// Deserializer overrides JSON for inbound state deserialization.
	Deserializer func([]byte, interface{}) error
	// WSMaxMessageSize limits the maximum payload size for WebSocket messages.
	WSMaxMessageSize int
}