@mtkruto/node 0.1.289 → 0.1.299

package/README.md

@@ -1 +1,77 @@
-<https://github.com/MTKruto/MTKruto>
+<div align="center">
+
+# MTKruto
+
+Cross-runtime JavaScript library for building Telegram clients
+
+###### [Documentation](https://mtkruto.deno.dev) / [API Reference](https://deno.land/x/mtkruto/mod.ts) / [Discussion Chat](https://t.me/MTKrutoChat) / [License](#license)
+
+</div>
+
+### Key Features
+
+- **Cross-runtime.** Runs inside browsers, Deno, Node.js, and Bun.
+- **Type-safe.** DX is enhanced with TypeScript support.
+- **Made for the Web.** Leverages Web APIs.
+- **Unopinionated.** No hidden behaviors.
+- **Extensible.** Highly customizable.
+
+> Note: MTKruto has not reached version 1.0.0 yet. While it can run in production, we currently do not recommend depending on it for critical projects.
+
+## Get Started
+
+### Browsers
+
+```html
+<script type="module">
+    import { Client, getRandomId } from "https://esm.sh/@mtkruto/browser";
+
+    const client = new Client();
+    await client.connect();
+
+    const pong = await client.api.ping({ ping_id: getRandomId() });
+    console.debug(pong);
+</script>
+```
+
+> The [@mtkruto/browser](https://npm.im/@mtkruto/browser) package can also be used with front end frameworks and bundlers.
+
+### Deno
+
+```ts
+import { Client, getRandomId } from "https://deno.land/x/mtkruto/mod.ts";
+
+const client = new Client();
+await client.connect();
+
+const pong = await client.api.ping({ ping_id: getRandomId() });
+console.debug(pong);
+```
+
+### Node.js
+
+```ts
+const { Client, getRandomId } = require("@mtkruto/node"); // npm install @mtkruto/node
+
+const client = new Client();
+await client.connect();
+
+const pong = await client.api.ping({ ping_id: getRandomId() });
+console.debug(pong);
+```
+
+### Bun
+
+```ts
+import { Client, getRandomId } from "@mtkruto/mtkruto"; // bunx jsr i @mtkruto/mtkruto
+
+const client = new Client();
+await client.connect();
+
+const pong = await client.api.ping({ ping_id: getRandomId() });
+console.debug(pong);
+```
+
+## License
+
+MTKruto is made open-source under the GNU Lesser General Public License version 3, or at your option, any later version. Refer to [COPYING](./COPYING) and [COPYING.LESSER](./COPYING.LESSER) for more.

package/esm/client/4_client.js

@@ -1141,7 +1141,7 @@ export class Client extends Composer {
                 if (!this.connected) {
                     continue;
                 }
-                __classPrivateFieldGet(this, _Client_pingLoopAbortController, "f").signal.throwIfAborted();
+                __classPrivateFieldGet(this, _Client_pingLoopAbortController, "f")?.signal.throwIfAborted();
                 await this.api.ping_delay_disconnect({ ping_id: getRandomId(), disconnect_delay: __classPrivateFieldGet(this, _Client_pingInterval, "f") / 1000 + 15 });
                 if (Date.now() - __classPrivateFieldGet(this, _Client_lastUpdates, "f").getTime() >= 15 * 60 * 1000) {
                     drop(__classPrivateFieldGet(this, _Client_updateManager, "f").recoverUpdateGap("lastUpdates"));

package/esm/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;

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

@@ -0,0 +1,203 @@
+import { Element, Document, NodeWithChildren, Comment, Text, ProcessingInstruction, } from './Node.js';
+import { ElementType } from './ElementType.js';
+const reWhitespace = /\s+/g;
+// Default options
+const defaultOpts = {
+    normalizeWhitespace: false,
+    withStartIndices: false,
+    withEndIndices: false,
+};
+export class DomHandler {
+    /**
+     * @param callback Called once parsing has completed.
+     * @param options Settings for the handler.
+     * @param elementCB Callback whenever a tag is closed.
+     */
+    constructor(callback, options, elementCB) {
+        /** The elements of the DOM */
+        Object.defineProperty(this, "dom", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: []
+        });
+        /** The root element for the DOM */
+        Object.defineProperty(this, "root", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Document(this.dom)
+        });
+        /** Called once parsing has completed. */
+        Object.defineProperty(this, "callback", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /** Settings for the handler. */
+        Object.defineProperty(this, "options", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /** Callback whenever a tag is closed. */
+        Object.defineProperty(this, "elementCB", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /** Indicated whether parsing has been completed. */
+        Object.defineProperty(this, "done", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: false
+        });
+        /** Stack of open tags. */
+        Object.defineProperty(this, "tagStack", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: [this.root]
+        });
+        /** A data node that is still being written to. */
+        Object.defineProperty(this, "lastNode", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: null
+        });
+        /** Reference to the parser instance. Used for location information. */
+        Object.defineProperty(this, "parser", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: null
+        });
+        // Make it possible to skip arguments, for backwards-compatibility
+        if (typeof options === 'function') {
+            elementCB = options;
+            options = defaultOpts;
+        }
+        if (typeof callback === 'object') {
+            options = callback;
+            callback = undefined;
+        }
+        this.callback = callback ?? null;
+        this.options = options ?? defaultOpts;
+        this.elementCB = elementCB ?? null;
+    }
+    onparserinit(parser) {
+        this.parser = parser;
+    }
+    // Resets the handler back to starting state
+    onreset() {
+        this.dom = [];
+        this.root = new Document(this.dom);
+        this.done = false;
+        this.tagStack = [this.root];
+        this.lastNode = null;
+        this.parser = this.parser ?? null;
+    }
+    // Signals the handler that parsing is done
+    onend() {
+        if (this.done)
+            return;
+        this.done = true;
+        this.parser = null;
+        this.handleCallback(null);
+    }
+    onerror(error) {
+        this.handleCallback(error);
+    }
+    onclosetag() {
+        this.lastNode = null;
+        const elem = this.tagStack.pop();
+        if (this.options.withEndIndices) {
+            elem.endIndex = this.parser.endIndex;
+        }
+        if (this.elementCB)
+            this.elementCB(elem);
+    }
+    onopentag(name, attribs) {
+        const type = this.options.xmlMode ? ElementType.Tag : undefined;
+        const element = new Element(name, attribs, undefined, type);
+        this.addNode(element);
+        this.tagStack.push(element);
+    }
+    ontext(data) {
+        const { normalizeWhitespace } = this.options;
+        const { lastNode } = this;
+        if (lastNode && lastNode.type === ElementType.Text) {
+            if (normalizeWhitespace) {
+                lastNode.data = (lastNode.data + data).replace(reWhitespace, ' ');
+            }
+            else {
+                lastNode.data += data;
+            }
+        }
+        else {
+            if (normalizeWhitespace) {
+                data = data.replace(reWhitespace, ' ');
+            }
+            const node = new Text(data);
+            this.addNode(node);
+            this.lastNode = node;
+        }
+    }
+    oncomment(data) {
+        if (this.lastNode && this.lastNode.type === ElementType.Comment) {
+            this.lastNode.data += data;
+            return;
+        }
+        const node = new Comment(data);
+        this.addNode(node);
+        this.lastNode = node;
+    }
+    oncommentend() {
+        this.lastNode = null;
+    }
+    oncdatastart() {
+        const text = new Text('');
+        const node = new NodeWithChildren(ElementType.CDATA, [text]);
+        this.addNode(node);
+        text.parent = node;
+        this.lastNode = text;
+    }
+    oncdataend() {
+        this.lastNode = null;
+    }
+    onprocessinginstruction(name, data) {
+        const node = new ProcessingInstruction(name, data);
+        this.addNode(node);
+    }
+    handleCallback(error) {
+        if (typeof this.callback === 'function') {
+            this.callback(error, this.dom);
+        }
+        else if (error) {
+            throw error;
+        }
+    }
+    addNode(node) {
+        const parent = this.tagStack[this.tagStack.length - 1];
+        const previousSibling = parent.children[parent.children.length - 1];
+        if (this.options.withStartIndices) {
+            node.startIndex = this.parser.startIndex;
+        }
+        if (this.options.withEndIndices) {
+            node.endIndex = this.parser.endIndex;
+        }
+        parent.children.push(node);
+        if (previousSibling) {
+            node.prev = previousSibling;
+            previousSibling.next = node;
+        }
+        node.parent = parent;
+        this.lastNode = null;
+    }
+}
+export default DomHandler;

package/esm/deps/deno.land/x/html_parser@v0.1.3/src/DomSerializer.d.ts

@@ -0,0 +1,50 @@
+import type { Node } from './Node.js';
+/**
+ * Mixed-case SVG and MathML tags & attributes
+ * recognized by the HTML parser.
+ *
+ * @see https://html.spec.whatwg.org/multipage/parsing.html#parsing-main-inforeign
+ */
+export declare const elementNames: Map<string, string>;
+export declare const attributeNames: Map<string, string>;
+export interface DomSerializerOptions {
+    /**
+     * Print an empty attribute's value.
+     *
+     * @default xmlMode
+     * @example With <code>emptyAttrs: false</code>: <code>&lt;input checked&gt;</code>
+     * @example With <code>emptyAttrs: true</code>: <code>&lt;input checked=""&gt;</code>
+     */
+    emptyAttrs?: boolean;
+    /**
+     * Print self-closing tags for tags without contents.
+     *
+     * @default xmlMode
+     * @example With <code>selfClosingTags: false</code>: <code>&lt;foo&gt;&lt;/foo&gt;</code>
+     * @example With <code>selfClosingTags: true</code>: <code>&lt;foo /&gt;</code>
+     */
+    selfClosingTags?: boolean;
+    /**
+     * Treat the input as an XML document; enables the `emptyAttrs` and `selfClosingTags` options.
+     *
+     * If the value is `"foreign"`, it will try to correct mixed-case attribute names.
+     *
+     * @default false
+     */
+    xmlMode?: boolean | 'foreign';
+    /**
+     * Encode characters that are either reserved in HTML or XML, or are outside of the ASCII range.
+     *
+     * @default true
+     */
+    decodeEntities?: boolean;
+}
+/**
+ * Renders a DOM node or an array of DOM nodes to a string.
+ *
+ * Can be thought of as the equivalent of the `outerHTML` of the passed node(s).
+ *
+ * @param node Node to be rendered.
+ * @param options Changes serialization behavior
+ */
+export default function render(node: Node | ArrayLike<Node>, options?: DomSerializerOptions): string;

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

@@ -0,0 +1,274 @@
+/*
+ * Module dependencies
+ */
+import * as ElementType from './ElementType.js';
+import { encodeXML } from './utils/entities/mod.js';
+/**
+ * Mixed-case SVG and MathML tags & attributes
+ * recognized by the HTML parser.
+ *
+ * @see https://html.spec.whatwg.org/multipage/parsing.html#parsing-main-inforeign
+ */
+export const elementNames = new Map([
+    ['altglyph', 'altGlyph'],
+    ['altglyphdef', 'altGlyphDef'],
+    ['altglyphitem', 'altGlyphItem'],
+    ['animatecolor', 'animateColor'],
+    ['animatemotion', 'animateMotion'],
+    ['animatetransform', 'animateTransform'],
+    ['clippath', 'clipPath'],
+    ['feblend', 'feBlend'],
+    ['fecolormatrix', 'feColorMatrix'],
+    ['fecomponenttransfer', 'feComponentTransfer'],
+    ['fecomposite', 'feComposite'],
+    ['feconvolvematrix', 'feConvolveMatrix'],
+    ['fediffuselighting', 'feDiffuseLighting'],
+    ['fedisplacementmap', 'feDisplacementMap'],
+    ['fedistantlight', 'feDistantLight'],
+    ['fedropshadow', 'feDropShadow'],
+    ['feflood', 'feFlood'],
+    ['fefunca', 'feFuncA'],
+    ['fefuncb', 'feFuncB'],
+    ['fefuncg', 'feFuncG'],
+    ['fefuncr', 'feFuncR'],
+    ['fegaussianblur', 'feGaussianBlur'],
+    ['feimage', 'feImage'],
+    ['femerge', 'feMerge'],
+    ['femergenode', 'feMergeNode'],
+    ['femorphology', 'feMorphology'],
+    ['feoffset', 'feOffset'],
+    ['fepointlight', 'fePointLight'],
+    ['fespecularlighting', 'feSpecularLighting'],
+    ['fespotlight', 'feSpotLight'],
+    ['fetile', 'feTile'],
+    ['feturbulence', 'feTurbulence'],
+    ['foreignobject', 'foreignObject'],
+    ['glyphref', 'glyphRef'],
+    ['lineargradient', 'linearGradient'],
+    ['radialgradient', 'radialGradient'],
+    ['textpath', 'textPath'],
+]);
+export const attributeNames = new Map([
+    ['definitionurl', 'definitionURL'],
+    ['attributename', 'attributeName'],
+    ['attributetype', 'attributeType'],
+    ['basefrequency', 'baseFrequency'],
+    ['baseprofile', 'baseProfile'],
+    ['calcmode', 'calcMode'],
+    ['clippathunits', 'clipPathUnits'],
+    ['diffuseconstant', 'diffuseConstant'],
+    ['edgemode', 'edgeMode'],
+    ['filterunits', 'filterUnits'],
+    ['glyphref', 'glyphRef'],
+    ['gradienttransform', 'gradientTransform'],
+    ['gradientunits', 'gradientUnits'],
+    ['kernelmatrix', 'kernelMatrix'],
+    ['kernelunitlength', 'kernelUnitLength'],
+    ['keypoints', 'keyPoints'],
+    ['keysplines', 'keySplines'],
+    ['keytimes', 'keyTimes'],
+    ['lengthadjust', 'lengthAdjust'],
+    ['limitingconeangle', 'limitingConeAngle'],
+    ['markerheight', 'markerHeight'],
+    ['markerunits', 'markerUnits'],
+    ['markerwidth', 'markerWidth'],
+    ['maskcontentunits', 'maskContentUnits'],
+    ['maskunits', 'maskUnits'],
+    ['numoctaves', 'numOctaves'],
+    ['pathlength', 'pathLength'],
+    ['patterncontentunits', 'patternContentUnits'],
+    ['patterntransform', 'patternTransform'],
+    ['patternunits', 'patternUnits'],
+    ['pointsatx', 'pointsAtX'],
+    ['pointsaty', 'pointsAtY'],
+    ['pointsatz', 'pointsAtZ'],
+    ['preservealpha', 'preserveAlpha'],
+    ['preserveaspectratio', 'preserveAspectRatio'],
+    ['primitiveunits', 'primitiveUnits'],
+    ['refx', 'refX'],
+    ['refy', 'refY'],
+    ['repeatcount', 'repeatCount'],
+    ['repeatdur', 'repeatDur'],
+    ['requiredextensions', 'requiredExtensions'],
+    ['requiredfeatures', 'requiredFeatures'],
+    ['specularconstant', 'specularConstant'],
+    ['specularexponent', 'specularExponent'],
+    ['spreadmethod', 'spreadMethod'],
+    ['startoffset', 'startOffset'],
+    ['stddeviation', 'stdDeviation'],
+    ['stitchtiles', 'stitchTiles'],
+    ['surfacescale', 'surfaceScale'],
+    ['systemlanguage', 'systemLanguage'],
+    ['tablevalues', 'tableValues'],
+    ['targetx', 'targetX'],
+    ['targety', 'targetY'],
+    ['textlength', 'textLength'],
+    ['viewbox', 'viewBox'],
+    ['viewtarget', 'viewTarget'],
+    ['xchannelselector', 'xChannelSelector'],
+    ['ychannelselector', 'yChannelSelector'],
+    ['zoomandpan', 'zoomAndPan'],
+]);
+const unencodedElements = new Set([
+    'style',
+    'script',
+    'xmp',
+    'iframe',
+    'noembed',
+    'noframes',
+    'plaintext',
+    'noscript',
+]);
+/**
+ * Format attributes
+ */
+function formatAttributes(attributes, opts) {
+    if (!attributes)
+        return;
+    return Object.keys(attributes)
+        .map(key => {
+        const value = attributes[key] ?? '';
+        if (opts.xmlMode === 'foreign') {
+            /* Fix up mixed-case attribute names */
+            key = attributeNames.get(key) ?? key;
+        }
+        if (!opts.emptyAttrs && !opts.xmlMode && value === '') {
+            return key;
+        }
+        return `${key}="${opts.decodeEntities !== false
+            ? encodeXML(value)
+            : value.replace(/"/g, '"')}"`;
+    })
+        .join(' ');
+}
+/**
+ * Self-enclosing tags
+ */
+const singleTag = new Set([
+    'area',
+    'base',
+    'basefont',
+    'br',
+    'col',
+    'command',
+    'embed',
+    'frame',
+    'hr',
+    'img',
+    'input',
+    'isindex',
+    'keygen',
+    'link',
+    'meta',
+    'param',
+    'source',
+    'track',
+    'wbr',
+]);
+/**
+ * Renders a DOM node or an array of DOM nodes to a string.
+ *
+ * Can be thought of as the equivalent of the `outerHTML` of the passed node(s).
+ *
+ * @param node Node to be rendered.
+ * @param options Changes serialization behavior
+ */
+export default function render(node, options = {}) {
+    const nodes = 'length' in node ? node : [node];
+    let output = '';
+    for (let i = 0; i < nodes.length; i++) {
+        output += renderNode(nodes[i], options);
+    }
+    return output;
+}
+function renderNode(node, options) {
+    switch (node.type) {
+        case ElementType.Root:
+            return render(node.children, options);
+        case ElementType.Directive:
+        case ElementType.Doctype:
+            return renderDirective(node);
+        case ElementType.Comment:
+            return renderComment(node);
+        case ElementType.CDATA:
+            return renderCdata(node);
+        case ElementType.Script:
+        case ElementType.Style:
+        case ElementType.Tag:
+            return renderTag(node, options);
+        case ElementType.Text:
+            return renderText(node, options);
+    }
+}
+const foreignModeIntegrationPoints = new Set([
+    'mi',
+    'mo',
+    'mn',
+    'ms',
+    'mtext',
+    'annotation-xml',
+    'foreignObject',
+    'desc',
+    'title',
+]);
+const foreignElements = new Set(['svg', 'math']);
+function renderTag(elem, opts) {
+    // Handle SVG / MathML in HTML
+    if (opts.xmlMode === 'foreign') {
+        /* Fix up mixed-case element names */
+        elem.name = elementNames.get(elem.name) ?? elem.name;
+        /* Exit foreign mode at integration points */
+        if (elem.parent &&
+            foreignModeIntegrationPoints.has(elem.parent.name)) {
+            opts = { ...opts, xmlMode: false };
+        }
+    }
+    if (!opts.xmlMode && foreignElements.has(elem.name)) {
+        opts = { ...opts, xmlMode: 'foreign' };
+    }
+    let tag = `<${elem.name}`;
+    const attribs = formatAttributes(elem.attribs, opts);
+    if (attribs) {
+        tag += ` ${attribs}`;
+    }
+    if (elem.children.length === 0 &&
+        (opts.xmlMode
+            ? // In XML mode or foreign mode, and user hasn't explicitly turned off self-closing tags
+                opts.selfClosingTags !== false
+            : // User explicitly asked for self-closing tags, even in HTML mode
+                opts.selfClosingTags && singleTag.has(elem.name))) {
+        if (!opts.xmlMode)
+            tag += ' ';
+        tag += '/>';
+    }
+    else {
+        tag += '>';
+        if (elem.children.length > 0) {
+            tag += render(elem.children, opts);
+        }
+        if (opts.xmlMode || !singleTag.has(elem.name)) {
+            tag += `</${elem.name}>`;
+        }
+    }
+    return tag;
+}
+function renderDirective(elem) {
+    return `<${elem.data}>`;
+}
+function renderText(elem, opts) {
+    let data = elem.data || '';
+    // If entities weren't decoded, no need to encode them back
+    if (opts.decodeEntities !== false &&
+        !(!opts.xmlMode &&
+            elem.parent &&
+            unencodedElements.has(elem.parent.name))) {
+        data = encodeXML(data);
+    }
+    return data;
+}
+function renderCdata(elem) {
+    return `<![CDATA[${elem.children[0].data}]]>`;
+}
+function renderComment(elem) {
+    return `<!--${elem.data}-->`;
+}