import type { ServerWebSocket } from './index';
export interface ChannelParams {
    [key: string]: unknown;
}
/**
 * Base class for WebSocket channels. Extend this and register with `wsm.channel()`.
 *
 * @example
 * ```ts
 * import { Channel } from '@tekir/core'
 *
 * export class ChatChannel extends Channel {
 *   authorize(ws, params) {
 *     return !!ws.data.user // only authenticated users
 *   }
 *
 *   onJoin(ws, room) {
 *     this.broadcast(room, 'user:joined', { user: ws.data.user.name })
 *   }
 *
 *   onMessage(ws, event, data, room) {
 *     if (event === 'message') {
 *       this.broadcastExcept(ws, room, 'message', {
 *         text: data.text,
 *         user: ws.data.user.name,
 *       })
 *     }
 *   }
 *
 *   onLeave(ws, room) {
 *     this.broadcast(room, 'user:left', { user: ws.data.user.name })
 *   }
 * }
 * ```
 */
export declare abstract class Channel {
    /** Channel name — set automatically by ChannelManager */
    name: string;
    /** Enable presence tracking for this channel */
    presence: boolean;
    /** Require authenticated user to join. Checked before authorize(). */
    requireAuth: boolean;
    /** Bun Server reference — set by ChannelManager after boot */
    _server: any;
    /**
     * Authorize a socket to join this channel. Return false to deny.
     * Override this to add auth logic.
     */
    authorize(_ws: ServerWebSocket, _params: ChannelParams): boolean | Promise<boolean>;
    /**
     * Return the data that represents this member in presence tracking.
     * Override to customize — default returns ws.data.user or socket id.
     */
    presenceData(ws: ServerWebSocket): Record<string, unknown>;
    /** Called when a socket successfully joins a room */
    onJoin(_ws: ServerWebSocket, _room: string): void | Promise<void>;
    /** Called when a socket sends an event to a room */
    onMessage(_ws: ServerWebSocket, _event: string, _data: unknown, _room: string): void | Promise<void>;
    /** Called when a socket leaves a room (explicit or disconnect) */
    onLeave(_ws: ServerWebSocket, _room: string): void | Promise<void>;
    /** Build the topic string for Bun's pub/sub */
    topic(room: string): string;
    /** Broadcast to all sockets in a room (including sender) */
    broadcast(room: string, event: string, data?: unknown): void;
    /** Broadcast to all sockets in a room except the sender */
    broadcastExcept(ws: ServerWebSocket, room: string, event: string, data?: unknown): void;
}