import { type Context, type Filter, type Message, type MessageEntity } from "@yaebal/core";
/**
 * message-shape filters: media, replies, forwards, entities, service events.
 * they check the update's own message (`messageOf`), and most are pure
 * narrowers — they stage nothing and only refine `ctx.message` so the matched
 * field is non-optional for the handler.
 */
/** narrows `ctx.message` so the given fields are present. a union of keys means "any of them". */
export type MessageWith<K extends keyof Message> = {
    message: Message & (K extends unknown ? {
        [P in K]-?: NonNullable<Message[P]>;
    } : never);
};
/** every media payload a message can carry — checked against the generated `Message` type. */
declare const MEDIA_KINDS: readonly ["animation", "audio", "document", "live_photo", "paid_media", "photo", "sticker", "story", "video", "video_note", "voice"];
export type MediaKind = (typeof MEDIA_KINDS)[number];
/** message carries one of the given media kinds; narrows `ctx.message`. */
export declare function mediaType<K extends MediaKind>(...kinds: readonly K[]): Filter<Context, MessageWith<K>>;
/** message carries any media. */
export declare const media: Filter<Context, {
    message: Message;
}>;
export declare const photo: Filter<Context, MessageWith<"photo">>;
export declare const video: Filter<Context, MessageWith<"video">>;
export declare const audio: Filter<Context, MessageWith<"audio">>;
export declare const voice: Filter<Context, MessageWith<"voice">>;
export declare const sticker: Filter<Context, MessageWith<"sticker">>;
export declare const document: Filter<Context, MessageWith<"document">>;
export declare const animation: Filter<Context, MessageWith<"animation">>;
export declare const videoNote: Filter<Context, MessageWith<"video_note">>;
export declare const paidMedia: Filter<Context, MessageWith<"paid_media">>;
export declare const story: Filter<Context, MessageWith<"story">>;
/** message contains a static location. */
export declare const location: Filter<Context, MessageWith<"location">>;
/** message contains a contact. */
export declare const contact: Filter<Context, MessageWith<"contact">>;
/** message contains a venue. */
export declare const venue: Filter<Context, MessageWith<"venue">>;
/** message contains a poll (the `poll` *update* is a different thing — use `on("poll")`). */
export declare const poll: Filter<Context, MessageWith<"poll">>;
/** message contains a dice roll. */
export declare const dice: Filter<Context, MessageWith<"dice">>;
/** message contains a game. */
export declare const game: Filter<Context, MessageWith<"game">>;
/** message contains an invoice. */
export declare const invoice: Filter<Context, MessageWith<"invoice">>;
/** message is a successful-payment service message. */
export declare const successfulPayment: Filter<Context, MessageWith<"successful_payment">>;
/** message is a reply to another message. */
export declare const reply: Filter<Context, MessageWith<"reply_to_message">>;
/** message is forwarded from somewhere. */
export declare const forward: Filter<Context, MessageWith<"forward_origin">>;
/** where a forwarded message came from (the generated schema keeps `origin.type` a plain string). */
export type ForwardOriginType = "user" | "hidden_user" | "chat" | "channel";
/** message is forwarded from one of the given origin kinds (any, when none given). */
export declare function forwardOrigin(...types: readonly ForwardOriginType[]): Filter<Context, MessageWith<"forward_origin">>;
/** message was sent via an inline bot — any, or one of the given ids/`@usernames`. */
export declare function viaBot(...ids: (number | string)[]): Filter<Context, MessageWith<"via_bot">>;
/**
 * message contains an entity of the given type — in text *or* caption
 * (`#hashtag` on a photo counts). stages the matching entities as
 * `ctx.entities`; with no `type`, any entity matches and all are staged.
 */
export declare function hasEntity(type?: MessageEntity["type"]): Filter<Context, {
    entities: MessageEntity[];
}>;
/** message is a service message (member joined/left, pin, topic event, video chat, …). */
export declare const service: Filter<Context, {
    message: Message;
}>;
/** users joined the chat. */
export declare const newChatMembers: Filter<Context, MessageWith<"new_chat_members">>;
/** a user left the chat. */
export declare const leftChatMember: Filter<Context, MessageWith<"left_chat_member">>;
/** a message was pinned. */
export declare const pinnedMessage: Filter<Context, MessageWith<"pinned_message">>;
export {};
//# sourceMappingURL=message.d.ts.map