@mtkruto/node 0.0.825 → 0.0.827

package/esm/deps/deno.land/x/html_parser@v0.1.3/src/utils/traversal.js

@@ -0,0 +1,101 @@
+import { isTag } from '../Node.js';
+const emptyArray = [];
+/**
+ * Get a node's children.
+ *
+ * @param elem Node to get the children of.
+ * @returns `elem`'s children, or an empty array.
+ */
+export function getChildren(elem) {
+    return elem.children ?? emptyArray;
+}
+/**
+ * Get a node's parent.
+ *
+ * @param elem Node to get the parent of.
+ * @returns `elem`'s parent node.
+ */
+export function getParent(elem) {
+    return elem.parent || null;
+}
+/**
+ * Gets an elements siblings, including the element itself.
+ *
+ * Attempts to get the children through the element's parent first.
+ * If we don't have a parent (the element is a root node),
+ * we walk the element's `prev` & `next` to get all remaining nodes.
+ *
+ * @param elem Element to get the siblings of.
+ * @returns `elem`'s siblings.
+ */
+export function getSiblings(elem) {
+    const parent = getParent(elem);
+    if (parent != null)
+        return getChildren(parent);
+    const siblings = [elem];
+    let { prev, next } = elem;
+    while (prev != null) {
+        siblings.unshift(prev);
+        ({ prev } = prev);
+    }
+    while (next != null) {
+        siblings.push(next);
+        ({ next } = next);
+    }
+    return siblings;
+}
+/**
+ * Gets an attribute from an element.
+ *
+ * @param elem Element to check.
+ * @param name Attribute name to retrieve.
+ * @returns The element's attribute value, or `undefined`.
+ */
+export function getAttributeValue(elem, name) {
+    return elem.attribs?.[name];
+}
+/**
+ * Checks whether an element has an attribute.
+ *
+ * @param elem Element to check.
+ * @param name Attribute name to look for.
+ * @returns Returns whether `elem` has the attribute `name`.
+ */
+export function hasAttrib(elem, name) {
+    return (elem.attribs != null &&
+        Object.prototype.hasOwnProperty.call(elem.attribs, name) &&
+        elem.attribs[name] != null);
+}
+/**
+ * Get the tag name of an element.
+ *
+ * @param elem The element to get the name for.
+ * @returns The tag name of `elem`.
+ */
+export function getName(elem) {
+    return elem.name;
+}
+/**
+ * Returns the next element sibling of a node.
+ *
+ * @param elem The element to get the next sibling of.
+ * @returns `elem`'s next sibling that is a tag.
+ */
+export function nextElementSibling(elem) {
+    let { next } = elem;
+    while (next !== null && !isTag(next))
+        ({ next } = next);
+    return next;
+}
+/**
+ * Returns the previous element sibling of a node.
+ *
+ * @param elem The element to get the previous sibling of.
+ * @returns `elem`'s previous sibling that is a tag.
+ */
+export function prevElementSibling(elem) {
+    let { prev } = elem;
+    while (prev !== null && !isTag(prev))
+        ({ prev } = prev);
+    return prev;
+}

package/esm/deps.d.ts

@@ -2,3 +2,4 @@ export * from "./deps/deno.land/std@0.186.0/testing/asserts.js";
 export { ctr256Decrypt, ctr256Encrypt, factorize, ige256Decrypt, ige256Encrypt, init as initTgCrypto } from "./deps/deno.land/x/tgcrypto@0.1.3/mod.js";
 export { gunzip, gzip } from "./deps/raw.githubusercontent.com/MTKruto/compress/master/gzip/gzip.js";
 export { Mutex } from "async-mutex";
+export { Parser } from "./deps/deno.land/x/html_parser@v0.1.3/src/mod.js";

package/esm/deps.js

@@ -2,3 +2,4 @@ export * from "./deps/deno.land/std@0.186.0/testing/asserts.js";
 export { ctr256Decrypt, ctr256Encrypt, factorize, ige256Decrypt, ige256Encrypt, init as initTgCrypto } from "./deps/deno.land/x/tgcrypto@0.1.3/mod.js";
 export { gunzip, gzip } from "./deps/raw.githubusercontent.com/MTKruto/compress/master/gzip/gzip.js";
 export { Mutex } from "async-mutex";
+export { Parser } from "./deps/deno.land/x/html_parser@v0.1.3/src/mod.js";

package/esm/storage/storage.d.ts

@@ -19,5 +19,5 @@ export declare abstract class Storage {
     getUserAccessHash(id: bigint): Promise<bigint | null>;
     private readonly username__;
     updateUsernames(type: "user" | "channel", id: bigint, usernames: string[]): Promise<void>;
-    getUsername(username: string): Promise<readonly ["user" | "channel", bigint, Date] | null>;
+    getUsername(username: string): Promise<readonly ["channel" | "user", bigint, Date] | null>;
 }

package/esm/types/0_message_entity.d.ts

@@ -0,0 +1,90 @@
+import * as types from "../tl/2_types.js";
+export declare enum MessageEntityType {
+    Mention = "mention",
+    Hashtag = "hashtag",
+    BotCommand = "bot_command",
+    URL = "url",
+    Email = "email",
+    Bold = "bold",
+    Italic = "italic",
+    Code = "code",
+    Pre = "pre",
+    TextURL = "text_url",
+    MentionName = "mention_name",
+    Cashtag = "cashtag",
+    Phone = "phone",
+    Underline = "underline",
+    Strike = "strike",
+    Blockquote = "blockquote",
+    BankCard = "bank_card",
+    Spoiler = "spoiler",
+    CustomEmoji = "custom_emoji"
+}
+export interface MessageEntityBase {
+    offset: number;
+    length: number;
+}
+export interface MessageEntityMention extends MessageEntityBase {
+    type: MessageEntityType.Mention;
+}
+export interface MessageEntityHashtag extends MessageEntityBase {
+    type: MessageEntityType.Hashtag;
+}
+export interface MessageEntityBotCommand extends MessageEntityBase {
+    type: MessageEntityType.BotCommand;
+}
+export interface MessageEntityURL extends MessageEntityBase {
+    type: MessageEntityType.URL;
+}
+export interface MessageEntityEmailAddress extends MessageEntityBase {
+    type: MessageEntityType.Email;
+}
+export interface MessageEntityBold extends MessageEntityBase {
+    type: MessageEntityType.Bold;
+}
+export interface MessageEntityItalic extends MessageEntityBase {
+    type: MessageEntityType.Italic;
+}
+export interface MessageEntityPre extends MessageEntityBase {
+    type: MessageEntityType.Pre;
+    language: string;
+}
+export interface MessageEntityCode extends MessageEntityBase {
+    type: MessageEntityType.Code;
+}
+export interface MessageEntityTextURL extends MessageEntityBase {
+    type: MessageEntityType.TextURL;
+    url: string;
+}
+export interface MessageEntityMentionName extends MessageEntityBase {
+    type: MessageEntityType.MentionName;
+    userId: number;
+}
+export interface MessageEntityCashtag extends MessageEntityBase {
+    type: MessageEntityType.Cashtag;
+}
+export interface MessageEntityPhone extends MessageEntityBase {
+    type: MessageEntityType.Phone;
+}
+export interface MessageEntityUnderline extends MessageEntityBase {
+    type: MessageEntityType.Underline;
+}
+export interface MessageEntityStrike extends MessageEntityBase {
+    type: MessageEntityType.Strike;
+}
+export interface MessageEntityBlockquote extends MessageEntityBase {
+    type: MessageEntityType.Blockquote;
+}
+export interface MessageEntityBankCard extends MessageEntityBase {
+    type: MessageEntityType.BankCard;
+}
+export interface MessageEntitySpoiler extends MessageEntityBase {
+    type: MessageEntityType.Spoiler;
+}
+export interface MessageEntityCustomEmoji extends MessageEntityBase {
+    type: MessageEntityType.CustomEmoji;
+    documentId: bigint;
+}
+export type MessageEntity = MessageEntityMention | MessageEntityHashtag | MessageEntityBotCommand | MessageEntityURL | MessageEntityEmailAddress | MessageEntityBold | MessageEntityItalic | MessageEntityCode | MessageEntityPre | MessageEntityTextURL | MessageEntityMentionName | MessageEntityCashtag | MessageEntityPhone | MessageEntityUnderline | MessageEntityStrike | MessageEntityBlockquote | MessageEntityBankCard | MessageEntitySpoiler | MessageEntityCustomEmoji;
+export declare function fromTlObject(obj: types.TypeMessageEntity): MessageEntity | null;
+export declare function toTlObject(entity: MessageEntity): types.MessageEntityMention | types.MessageEntityHashtag | types.MessageEntityBotCommand | types.MessageEntityURL | types.MessageEntityEmail | types.MessageEntityBold | types.MessageEntityItalic | types.MessageEntityCode | types.MessageEntityPre | types.MessageEntityTextURL | types.MessageEntityMentionName | types.MessageEntityPhone | types.MessageEntityCashtag | types.MessageEntityUnderline | types.MessageEntityStrike | types.MessageEntityBlockquote | types.MessageEntityBankCard | types.MessageEntitySpoiler | types.MessageEntityCustomEmoji;

package/esm/types/0_message_entity.js

@@ -0,0 +1,128 @@
+import * as types from "../tl/2_types.js";
+export var MessageEntityType;
+(function (MessageEntityType) {
+    MessageEntityType["Mention"] = "mention";
+    MessageEntityType["Hashtag"] = "hashtag";
+    MessageEntityType["BotCommand"] = "bot_command";
+    MessageEntityType["URL"] = "url";
+    MessageEntityType["Email"] = "email";
+    MessageEntityType["Bold"] = "bold";
+    MessageEntityType["Italic"] = "italic";
+    MessageEntityType["Code"] = "code";
+    MessageEntityType["Pre"] = "pre";
+    MessageEntityType["TextURL"] = "text_url";
+    MessageEntityType["MentionName"] = "mention_name";
+    MessageEntityType["Cashtag"] = "cashtag";
+    MessageEntityType["Phone"] = "phone";
+    MessageEntityType["Underline"] = "underline";
+    MessageEntityType["Strike"] = "strike";
+    MessageEntityType["Blockquote"] = "blockquote";
+    MessageEntityType["BankCard"] = "bank_card";
+    MessageEntityType["Spoiler"] = "spoiler";
+    MessageEntityType["CustomEmoji"] = "custom_emoji";
+})(MessageEntityType || (MessageEntityType = {}));
+export function fromTlObject(obj) {
+    if (obj instanceof types.MessageEntityMention) {
+        return { type: MessageEntityType.Mention, offset: obj.offset, length: obj.length };
+    }
+    else if (obj instanceof types.MessageEntityHashtag) {
+        return { type: MessageEntityType.Hashtag, offset: obj.offset, length: obj.length };
+    }
+    else if (obj instanceof types.MessageEntityBotCommand) {
+        return { type: MessageEntityType.BotCommand, offset: obj.offset, length: obj.length };
+    }
+    else if (obj instanceof types.MessageEntityURL) {
+        return { type: MessageEntityType.URL, offset: obj.offset, length: obj.length };
+    }
+    else if (obj instanceof types.MessageEntityEmail) {
+        return { type: MessageEntityType.Email, offset: obj.offset, length: obj.length };
+    }
+    else if (obj instanceof types.MessageEntityBold) {
+        return { type: MessageEntityType.Bold, offset: obj.offset, length: obj.length };
+    }
+    else if (obj instanceof types.MessageEntityItalic) {
+        return { type: MessageEntityType.Italic, offset: obj.offset, length: obj.length };
+    }
+    else if (obj instanceof types.MessageEntityCode) {
+        return { type: MessageEntityType.Code, offset: obj.offset, length: obj.length };
+    }
+    else if (obj instanceof types.MessageEntityPre) {
+        return { type: MessageEntityType.Pre, offset: obj.offset, length: obj.length, language: obj.language };
+    }
+    else if (obj instanceof types.MessageEntityTextURL) {
+        return { type: MessageEntityType.TextURL, offset: obj.offset, length: obj.length, url: obj.url };
+    }
+    else if (obj instanceof types.MessageEntityMentionName) {
+        return { type: MessageEntityType.MentionName, offset: obj.offset, length: obj.length, userId: Number(obj.userId) };
+    }
+    else if (obj instanceof types.MessageEntityCashtag) {
+        return { type: MessageEntityType.Cashtag, offset: obj.offset, length: obj.length };
+    }
+    else if (obj instanceof types.MessageEntityPhone) {
+        return { type: MessageEntityType.Phone, offset: obj.offset, length: obj.length };
+    }
+    else if (obj instanceof types.MessageEntityUnderline) {
+        return { type: MessageEntityType.Underline, offset: obj.offset, length: obj.length };
+    }
+    else if (obj instanceof types.MessageEntityStrike) {
+        return { type: MessageEntityType.Strike, offset: obj.offset, length: obj.length };
+    }
+    else if (obj instanceof types.MessageEntityBlockquote) {
+        return { type: MessageEntityType.Blockquote, offset: obj.offset, length: obj.length };
+    }
+    else if (obj instanceof types.MessageEntityBankCard) {
+        return { type: MessageEntityType.BankCard, offset: obj.offset, length: obj.length };
+    }
+    else if (obj instanceof types.MessageEntitySpoiler) {
+        return { type: MessageEntityType.Spoiler, offset: obj.offset, length: obj.length };
+    }
+    else if (obj instanceof types.MessageEntityCustomEmoji) {
+        return { type: MessageEntityType.CustomEmoji, offset: obj.offset, length: obj.length, documentId: obj.documentId };
+    }
+    else {
+        return null;
+    }
+}
+export function toTlObject(entity) {
+    const { offset, length } = entity;
+    switch (entity.type) {
+        case MessageEntityType.Mention:
+            return new types.MessageEntityMention({ offset, length });
+        case MessageEntityType.Hashtag:
+            return new types.MessageEntityHashtag({ offset, length });
+        case MessageEntityType.BotCommand:
+            return new types.MessageEntityBotCommand({ offset, length });
+        case MessageEntityType.URL:
+            return new types.MessageEntityURL({ offset, length });
+        case MessageEntityType.Email:
+            return new types.MessageEntityEmail({ offset, length });
+        case MessageEntityType.Bold:
+            return new types.MessageEntityBold({ offset, length });
+        case MessageEntityType.Italic:
+            return new types.MessageEntityItalic({ offset, length });
+        case MessageEntityType.Code:
+            return new types.MessageEntityCode({ offset, length });
+        case MessageEntityType.Pre:
+            return new types.MessageEntityPre({ offset, length, language: entity.language });
+        case MessageEntityType.TextURL:
+            return new types.MessageEntityTextURL({ offset, length, url: entity.url });
+        case MessageEntityType.MentionName:
+            return new types.MessageEntityMentionName({ offset, length, userId: BigInt(entity.userId) });
+        case MessageEntityType.Cashtag:
+            return new types.MessageEntityCashtag({ offset, length });
+        case MessageEntityType.Phone:
+            return new types.MessageEntityPhone({ offset, length });
+        case MessageEntityType.Underline:
+            return new types.MessageEntityUnderline({ offset, length });
+        case MessageEntityType.Strike:
+            return new types.MessageEntityStrike({ offset, length });
+        case MessageEntityType.Blockquote:
+            return new types.MessageEntityBlockquote({ offset, length });
+        case MessageEntityType.BankCard:
+            return new types.MessageEntityBankCard({ offset, length });
+        case MessageEntityType.Spoiler:
+            return new types.MessageEntitySpoiler({ offset, length });
+        case MessageEntityType.CustomEmoji:
+            return new types.MessageEntityCustomEmoji({ offset, length, documentId: entity.documentId });
+    }
+}

package/esm/utilities/0_html.d.ts

@@ -0,0 +1,2 @@
+import { MessageEntity } from "../types/0_message_entity.js";
+export declare function parseHtml(html: string): readonly [string, MessageEntity[]];

package/esm/utilities/0_html.js

@@ -0,0 +1,74 @@
+import { Parser } from "../deps.js";
+import { MessageEntityType } from "../types/0_message_entity.js";
+export function parseHtml(html) {
+    let text = "";
+    const entities = new Array();
+    const queue = new Array();
+    const parser = new Parser({
+        onopentag(name, attribs) {
+            switch (name) {
+                case "b":
+                case "strong":
+                    queue.push({ type: MessageEntityType.Bold, offset: text.length, length: 0 });
+                    break;
+                case "em":
+                case "i":
+                    queue.push({ type: MessageEntityType.Italic, offset: text.length, length: 0 });
+                    break;
+                case "code":
+                    queue.push({ type: MessageEntityType.Code, offset: text.length, length: 0 });
+                    break;
+                case "pre": {
+                    const language = attribs.language ?? "";
+                    queue.push({ type: MessageEntityType.Pre, offset: text.length, length: 0, language });
+                    break;
+                }
+                case "a": {
+                    const url = attribs.href;
+                    if (!url) {
+                        throw new Error("Missing attribute href");
+                    }
+                    queue.push({ type: MessageEntityType.TextURL, offset: text.length, length: 0, url });
+                    break;
+                }
+                case "ins":
+                case "u":
+                    queue.push({ type: MessageEntityType.Underline, offset: text.length, length: 0 });
+                    break;
+                case "del":
+                case "strike":
+                    queue.push({ type: MessageEntityType.Strike, offset: text.length, length: 0 });
+                    break;
+                case "span":
+                    if (attribs.class != "tg-spoiler") {
+                        throw new Error("The class attribute must be tg-spoiler");
+                    }
+                // falls through
+                case "tg-spoiler":
+                    queue.push({ type: MessageEntityType.Spoiler, offset: text.length, length: 0 });
+                    break;
+                case "tg-emoji":
+                    if (!attribs["emoji-id"]) {
+                        throw new Error("Missing attribute emoji-id");
+                    }
+                    queue.push({ type: MessageEntityType.Spoiler, offset: text.length, length: 0 });
+            }
+        },
+        ontext(data) {
+            text += data;
+            const lastItem = queue[queue.length - 1];
+            if (lastItem) {
+                lastItem.length += data.length;
+            }
+        },
+        onclosetag() {
+            const lastItem = queue.pop();
+            if (lastItem) {
+                entities.push(lastItem);
+            }
+        },
+    });
+    parser.write(html);
+    parser.end();
+    return [text, entities];
+}

package/package.json

@@ -2,7 +2,7 @@
   "module": "./esm/mod.js",
   "main": "./script/mod.js",
   "name": "@mtkruto/node",
-  "version": "0.0.825",
+  "version": "0.0.827",
   "description": "MTKruto for Node.js",
   "author": "Roj <rojvv@icloud.com>",
   "license": "LGPL-3.0-or-later",

package/script/client/client.d.ts

@@ -4,7 +4,12 @@ import * as functions from "../tl/3_functions.js";
 import { ClientAbstract } from "./client_abstract.js";
 import { Storage } from "../storage/storage.js";
 import { DC, TransportProvider } from "../transport/transport_provider.js";
+import { MessageEntity } from "../types/0_message_entity.js";
 export declare const restartAuth: unique symbol;
+export declare enum ParseMode {
+    None = "none",
+    HTML = "html"
+}
 export interface AuthorizeUserParams<S = string> {
     phone: S | (() => MaybePromise<S>);
     code: S | (() => MaybePromise<S>);
@@ -12,6 +17,10 @@ export interface AuthorizeUserParams<S = string> {
 }
 export type UpdatesHandler = null | ((client: Client, update: types.Updates) => MaybePromise<void>);
 export interface ClientParams {
+    /**
+     * Default parse mode. Defauls to `ParseMode.None`.
+     */
+    parseMode?: ParseMode;
     /**
      * The transport provider to use. Defaults to `defaultTransportProvider`.
      */
@@ -51,6 +60,7 @@ export declare class Client extends ClientAbstract {
     private promises;
     private toAcknowledge;
     updatesHandler: UpdatesHandler;
+    readonly parseMode: ParseMode;
     readonly appVersion: string;
     readonly deviceModel: string;
     readonly langCode: string;
@@ -117,4 +127,14 @@ export declare class Client extends ClientAbstract {
     private processUsers;
     private processUpdates;
     getInputPeer(id: string | number): Promise<types.InputPeerChat | types.InputPeerUser | types.InputPeerChannel>;
+    sendMessage(chatId: number | string, text: string, params?: {
+        parseMode?: ParseMode;
+        entities?: MessageEntity[];
+        disableWebPagePreview?: boolean;
+        disableNotification?: boolean;
+        protectContent?: boolean;
+        replyToMessageId?: number;
+        messageThreadId?: number;
+        sendAs?: number | string;
+    }): Promise<types.TypeUpdates>;
 }

package/script/client/client.js

@@ -23,10 +23,11 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Client = exports.restartAuth = void 0;
+exports.Client = exports.ParseMode = exports.restartAuth = void 0;
 const deps_js_1 = require("../deps.js");
 const constants_js_1 = require("../constants.js");
 const _0_bigint_js_1 = require("../utilities/0_bigint.js");
+const _0_html_js_1 = require("../utilities/0_html.js");
 const _1_message_js_1 = require("../utilities/1_message.js");
 const _1_password_js_1 = require("../utilities/1_password.js");
 const _1_tl_object_js_1 = require("../tl/1_tl_object.js");
@@ -40,7 +41,13 @@ const client_abstract_js_1 = require("./client_abstract.js");
 const client_plain_js_1 = require("./client_plain.js");
 const storage_memory_js_1 = require("../storage/storage_memory.js");
 const _0_hash_js_1 = require("../utilities/0_hash.js");
+const _0_message_entity_js_1 = require("../types/0_message_entity.js");
 exports.restartAuth = Symbol();
+var ParseMode;
+(function (ParseMode) {
+    ParseMode["None"] = "none";
+    ParseMode["HTML"] = "html";
+})(ParseMode = exports.ParseMode || (exports.ParseMode = {}));
 class Client extends client_abstract_js_1.ClientAbstract {
     /**
      * Constructs the client.
@@ -106,6 +113,12 @@ class Client extends client_abstract_js_1.ClientAbstract {
             writable: true,
             value: null
         });
+        Object.defineProperty(this, "parseMode", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         Object.defineProperty(this, "appVersion", {
             enumerable: true,
             configurable: true,
@@ -148,6 +161,7 @@ class Client extends client_abstract_js_1.ClientAbstract {
             writable: true,
             value: false
         });
+        this.parseMode = params?.parseMode ?? ParseMode.None;
         this.appVersion = params?.appVersion ?? constants_js_1.DEFAULT_APP_VERSION;
         this.deviceModel = params?.deviceModel ?? constants_js_1.DEFAULT_DEVICE_MODEL;
         this.langCode = params?.langCode ?? constants_js_1.DEFAULT_LANG_CODE;
@@ -610,5 +624,42 @@ class Client extends client_abstract_js_1.ClientAbstract {
             throw new Error("ID format unknown or not implemented");
         }
     }
+    async sendMessage(chatId, text, params) {
+        const entities_ = params?.entities ?? [];
+        const parseMode = params?.parseMode ?? this.parseMode;
+        switch (parseMode) {
+            case ParseMode.None:
+                break;
+            case ParseMode.HTML: {
+                const [newText, entitiesToPush] = (0, _0_html_js_1.parseHtml)(text);
+                text = newText;
+                for (const entity of entitiesToPush) {
+                    entities_.push(entity);
+                }
+            }
+        }
+        const peer = await this.getInputPeer(chatId);
+        const randomId = (0, _0_bigint_js_1.getRandomId)();
+        const message = text;
+        const noWebpage = params?.disableWebPagePreview ? true : undefined;
+        const silent = params?.disableNotification ? true : undefined;
+        const noforwards = params?.protectContent ? true : undefined;
+        const replyToMsgId = params?.replyToMessageId;
+        const topMsgId = params?.messageThreadId;
+        const sendAs = params?.sendAs ? await this.getInputPeer(params.sendAs) : undefined;
+        const entities = entities_?.length > 0 ? entities_.map((v) => (0, _0_message_entity_js_1.toTlObject)(v)) : undefined;
+        return await this.invoke(new functions.MessagesSendMessage({
+            peer,
+            randomId,
+            message,
+            noWebpage,
+            silent,
+            noforwards,
+            replyToMsgId,
+            topMsgId,
+            sendAs,
+            entities,
+        }));
+    }
 }
 exports.Client = Client;

package/script/deps/deno.land/x/html_parser@v0.1.3/src/DomHandler.d.ts

@@ -0,0 +1,83 @@
+import { Node, Element, Document, NodeWithChildren, DataNode } from './Node.js';
+export interface DomHandlerOptions {
+    /**
+     * Add a `startIndex` property to nodes.
+     * When the parser is used in a non-streaming fashion, `startIndex` is an integer
+     * indicating the position of the start of the node in the document.
+     *
+     * @default false
+     */
+    withStartIndices?: boolean;
+    /**
+     * Add an `endIndex` property to nodes.
+     * When the parser is used in a non-streaming fashion, `endIndex` is an integer
+     * indicating the position of the end of the node in the document.
+     *
+     * @default false
+     */
+    withEndIndices?: boolean;
+    /**
+     * Replace all whitespace with single spaces.
+     *
+     * **Note:** Enabling this might break your markup.
+     *
+     * @default false
+     * @deprecated
+     */
+    normalizeWhitespace?: boolean;
+    /**
+     * Treat the markup as XML.
+     *
+     * @default false
+     */
+    xmlMode?: boolean;
+}
+interface ParserInterface {
+    startIndex: number | null;
+    endIndex: number | null;
+}
+type Callback = (error: Error | null, dom: Node[]) => void;
+type ElementCallback = (element: Element) => void;
+export declare class DomHandler {
+    /** The elements of the DOM */
+    dom: Node[];
+    /** The root element for the DOM */
+    root: Document;
+    /** Called once parsing has completed. */
+    private readonly callback;
+    /** Settings for the handler. */
+    private readonly options;
+    /** Callback whenever a tag is closed. */
+    private readonly elementCB;
+    /** Indicated whether parsing has been completed. */
+    private done;
+    /** Stack of open tags. */
+    protected tagStack: NodeWithChildren[];
+    /** A data node that is still being written to. */
+    protected lastNode: DataNode | null;
+    /** Reference to the parser instance. Used for location information. */
+    private parser;
+    /**
+     * @param callback Called once parsing has completed.
+     * @param options Settings for the handler.
+     * @param elementCB Callback whenever a tag is closed.
+     */
+    constructor(callback?: Callback | null, options?: DomHandlerOptions | null, elementCB?: ElementCallback);
+    onparserinit(parser: ParserInterface): void;
+    onreset(): void;
+    onend(): void;
+    onerror(error: Error): void;
+    onclosetag(): void;
+    onopentag(name: string, attribs: {
+        [key: string]: string;
+    }): void;
+    ontext(data: string): void;
+    oncomment(data: string): void;
+    oncommentend(): void;
+    oncdatastart(): void;
+    oncdataend(): void;
+    onprocessinginstruction(name: string, data: string): void;
+    protected handleCallback(error: Error | null): void;
+    protected addNode(node: Node): void;
+}
+export default DomHandler;