@adguard/agtree 2.1.2 → 3.0.0-alpha.1

package/dist/esm/deserializer/base-deserializer.mjs

@@ -0,0 +1,29 @@
+/*
+ * AGTree v3.0.0-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+import { NotImplementedError } from '../errors/not-implemented-error.mjs';
+
+/**
+ * @file Base serializer class.
+ */
+/**
+ * Base class for deserializers. Each deserializer should extend this class.
+ */
+class BaseDeserializer {
+    /**
+     * Deserializes the AST node from a byte buffer.
+     *
+     * @param buffer Input byte buffer to read from.
+     * @param node Destination node to write to.
+     * @param args Additional, parser-specific arguments, if needed.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    static deserialize(buffer, node, ...args) {
+        throw new NotImplementedError();
+    }
+}
+
+export { BaseDeserializer };

package/dist/esm/deserializer/comment/agent-comment-deserializer.mjs

@@ -0,0 +1,74 @@
+/*
+ * AGTree v3.0.0-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+import { NULL } from '../../utils/constants.mjs';
+import { CommentRuleType, RuleCategory } from '../../nodes/index.mjs';
+import { AdblockSyntax } from '../../utils/adblockers.mjs';
+import { BaseDeserializer } from '../base-deserializer.mjs';
+import { AgentCommentMarshallingMap } from '../../marshalling-utils/comment/agent-comment-common.mjs';
+import { AgentDeserializer } from './agent-deserializer.mjs';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.mjs';
+
+/* eslint-disable no-param-reassign */
+/**
+ * `AgentCommentDeserializer` is responsible for deserializing an Adblock agent comments.
+ * Adblock agent comment marks that the filter list is supposed to
+ * be used by the specified ad blockers.
+ *
+ * @example
+ *  - ```adblock
+ *    [AdGuard]
+ *    ```
+ *  - ```adblock
+ *    [Adblock Plus 2.0]
+ *    ```
+ *  - ```adblock
+ *    [uBlock Origin]
+ *    ```
+ *  - ```adblock
+ *    [uBlock Origin 1.45.3]
+ *    ```
+ *  - ```adblock
+ *    [Adblock Plus 2.0; AdGuard]
+ *    ```
+ */
+class AgentCommentDeserializer extends BaseDeserializer {
+    /**
+     * Deserializes an agent list node from binary format.
+     *
+     * @param buffer ByteBuffer for reading binary data.
+     * @param node Destination node.
+     */
+    static deserialize(buffer, node) {
+        buffer.assertUint8(BinaryTypeMarshallingMap.AgentRuleNode);
+        node.type = CommentRuleType.AgentCommentRule;
+        node.syntax = AdblockSyntax.Common;
+        node.category = RuleCategory.Comment;
+        let prop = buffer.readUint8();
+        while (prop !== NULL) {
+            switch (prop) {
+                case AgentCommentMarshallingMap.Children:
+                    node.children = new Array(buffer.readUint8());
+                    // read children
+                    for (let i = 0; i < node.children.length; i += 1) {
+                        AgentDeserializer.deserialize(buffer, node.children[i] = {});
+                    }
+                    break;
+                case AgentCommentMarshallingMap.Start:
+                    node.start = buffer.readUint32();
+                    break;
+                case AgentCommentMarshallingMap.End:
+                    node.end = buffer.readUint32();
+                    break;
+                default:
+                    throw new Error(`Invalid property: ${prop}`);
+            }
+            prop = buffer.readUint8();
+        }
+    }
+}
+
+export { AgentCommentDeserializer };

package/dist/esm/deserializer/comment/agent-deserializer.mjs

@@ -0,0 +1,65 @@
+/*
+ * AGTree v3.0.0-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+import { NULL } from '../../utils/constants.mjs';
+import { BaseDeserializer } from '../base-deserializer.mjs';
+import { AgentNodeMarshallingMap, FREQUENT_AGENTS_DESERIALIZATION_MAP } from '../../marshalling-utils/comment/agent-common.mjs';
+import { getAdblockSyntax } from '../../common/agent-common.mjs';
+import { ValueDeserializer } from '../misc/value-deserializer.mjs';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.mjs';
+
+/* eslint-disable no-param-reassign */
+/**
+ * `AgentDeserializer` is responsible for deserializing single adblock agent elements.
+ *
+ * @example
+ * If the adblock agent rule is
+ * ```adblock
+ * [Adblock Plus 2.0; AdGuard]
+ * ```
+ * then the adblock agents are `Adblock Plus 2.0` and `AdGuard`, and this
+ * class is responsible for parsing them. The rule itself is parsed by
+ * `AgentCommentSerializer`, which uses this class to parse single agents.
+ */
+class AgentDeserializer extends BaseDeserializer {
+    /**
+     * Deserializes an agent node from binary format.
+     *
+     * @param buffer ByteBuffer for reading binary data.
+     * @param node Destination node.
+     * @throws If the binary data is malformed.
+     */
+    static deserialize(buffer, node) {
+        buffer.assertUint8(BinaryTypeMarshallingMap.AgentNode);
+        node.type = 'Agent';
+        let prop = buffer.readUint8();
+        while (prop !== NULL) {
+            switch (prop) {
+                case AgentNodeMarshallingMap.Adblock:
+                    // eslint-disable-next-line max-len
+                    ValueDeserializer.deserialize(buffer, node.adblock = {}, FREQUENT_AGENTS_DESERIALIZATION_MAP);
+                    if (node.adblock) {
+                        node.syntax = getAdblockSyntax(node.adblock.value);
+                    }
+                    break;
+                case AgentNodeMarshallingMap.Version:
+                    ValueDeserializer.deserialize(buffer, node.version = {});
+                    break;
+                case AgentNodeMarshallingMap.Start:
+                    node.start = buffer.readUint32();
+                    break;
+                case AgentNodeMarshallingMap.End:
+                    node.end = buffer.readUint32();
+                    break;
+                default:
+                    throw new Error(`Invalid property: ${prop}`);
+            }
+            prop = buffer.readUint8();
+        }
+    }
+}
+
+export { AgentDeserializer };

package/dist/esm/deserializer/comment/comment-rule-deserializer.mjs

@@ -0,0 +1,107 @@
+/*
+ * AGTree v3.0.0-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+import { AgentCommentDeserializer } from './agent-comment-deserializer.mjs';
+import { ConfigCommentDeserializer } from './config-comment-deserializer.mjs';
+import { HintCommentDeserializer } from './hint-comment-deserializer.mjs';
+import { MetadataCommentDeserializer } from './metadata-comment-deserializer.mjs';
+import { PreProcessorCommentDeserializer } from './pre-processor-comment-deserializer.mjs';
+import { SimpleCommentDeserializer } from './simple-comment-deserializer.mjs';
+import { BaseDeserializer } from '../base-deserializer.mjs';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.mjs';
+
+/**
+ * `CommentRuleSerializer` is responsible for serializing any comment-like adblock rules.
+ *
+ * @example
+ * Example rules:
+ *  - Adblock agent rules:
+ *      - ```adblock
+ *        [AdGuard]
+ *        ```
+ *      - ```adblock
+ *        [Adblock Plus 2.0]
+ *        ```
+ *      - etc.
+ *  - AdGuard hint rules:
+ *      - ```adblock
+ *        !+ NOT_OPTIMIZED
+ *        ```
+ *      - ```adblock
+ *        !+ NOT_OPTIMIZED PLATFORM(windows)
+ *        ```
+ *      - etc.
+ *  - Pre-processor rules:
+ *      - ```adblock
+ *        !#if (adguard)
+ *        ```
+ *      - ```adblock
+ *        !#endif
+ *        ```
+ *      - etc.
+ *  - Metadata rules:
+ *      - ```adblock
+ *        ! Title: My List
+ *        ```
+ *      - ```adblock
+ *        ! Version: 2.0.150
+ *        ```
+ *      - etc.
+ *  - AGLint inline config rules:
+ *      - ```adblock
+ *        ! aglint-enable some-rule
+ *        ```
+ *      - ```adblock
+ *        ! aglint-disable some-rule
+ *        ```
+ *      - etc.
+ *  - Simple comments:
+ *      - Regular version:
+ *        ```adblock
+ *        ! This is just a comment
+ *        ```
+ *      - uBlock Origin / "hostlist" version:
+ *        ```adblock
+ *        # This is just a comment
+ *        ```
+ *      - etc.
+ */
+class CommentRuleDeserializer extends BaseDeserializer {
+    /**
+     * Deserializes a comment rule node from binary format.
+     *
+     * @param buffer ByteBuffer for reading binary data.
+     * @param node Destination node.
+     * @throws If the binary data is malformed.
+     */
+    static deserialize(buffer, node) {
+        const type = buffer.peekUint8();
+        switch (type) {
+            case BinaryTypeMarshallingMap.AgentRuleNode:
+                AgentCommentDeserializer.deserialize(buffer, node);
+                return;
+            case BinaryTypeMarshallingMap.HintRuleNode:
+                HintCommentDeserializer.deserialize(buffer, node);
+                return;
+            case BinaryTypeMarshallingMap.PreProcessorCommentRuleNode:
+                PreProcessorCommentDeserializer.deserialize(buffer, node);
+                return;
+            case BinaryTypeMarshallingMap.MetadataCommentRuleNode:
+                MetadataCommentDeserializer.deserialize(buffer, node);
+                return;
+            case BinaryTypeMarshallingMap.ConfigCommentRuleNode:
+                ConfigCommentDeserializer.deserialize(buffer, node);
+                return;
+            case BinaryTypeMarshallingMap.CommentRuleNode:
+                SimpleCommentDeserializer.deserialize(buffer, node);
+                return;
+            default:
+                throw new Error(`Unknown comment rule type: ${type}`);
+        }
+    }
+}
+
+export { CommentRuleDeserializer };

package/dist/esm/deserializer/comment/config-comment-deserializer.mjs

@@ -0,0 +1,111 @@
+/*
+ * AGTree v3.0.0-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+import { NULL } from '../../utils/constants.mjs';
+import { CommentRuleType, RuleCategory } from '../../nodes/index.mjs';
+import { BaseDeserializer } from '../base-deserializer.mjs';
+import { ConfigNodeMarshallingMap, ConfigCommentRuleMarshallingMap, FREQUENT_COMMANDS_SERIALIZATION_MAP } from '../../marshalling-utils/comment/config-comment-common.mjs';
+import { AdblockSyntax } from '../../utils/adblockers.mjs';
+import { ValueDeserializer } from '../misc/value-deserializer.mjs';
+import { ParameterListDeserializer } from '../misc/parameter-list-deserializer.mjs';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.mjs';
+
+/* eslint-disable no-param-reassign */
+/**
+ * Value map for binary deserialization. This helps to reduce the size of the serialized data,
+ * as it allows us to use a single byte to represent frequently used values.
+ */
+let frequentCommandsDeserializationMap;
+const getFrequentCommandsDeserializationMap = () => {
+    if (!frequentCommandsDeserializationMap) {
+        frequentCommandsDeserializationMap = new Map(Array.from(FREQUENT_COMMANDS_SERIALIZATION_MAP).map(([key, value]) => [value, key]));
+    }
+    return frequentCommandsDeserializationMap;
+};
+/**
+ * `ConfigCommentDeserializer` is responsible for deserializing inline AGLint configuration rules.
+ * Generally, the idea is inspired by ESLint inline configuration comments.
+ *
+ * @see {@link https://eslint.org/docs/latest/user-guide/configuring/rules#using-configuration-comments}
+ */
+class ConfigCommentDeserializer extends BaseDeserializer {
+    /**
+     * Deserializes a metadata comment node from binary format.
+     *
+     * @param buffer ByteBuffer for reading binary data.
+     * @param node Destination node.
+     * @throws If the binary data is malformed.
+     */
+    static deserializeConfigNode(buffer, node) {
+        buffer.assertUint8(BinaryTypeMarshallingMap.ConfigNode);
+        node.type = 'ConfigNode';
+        let prop = buffer.readUint8();
+        while (prop !== NULL) {
+            switch (prop) {
+                case ConfigNodeMarshallingMap.Value:
+                    // note: it is safe to use JSON.parse here, because we serialized it with JSON.stringify
+                    node.value = JSON.parse(buffer.readString());
+                    break;
+                case ConfigNodeMarshallingMap.Start:
+                    node.start = buffer.readUint32();
+                    break;
+                case ConfigNodeMarshallingMap.End:
+                    node.end = buffer.readUint32();
+                    break;
+                default:
+                    throw new Error(`Invalid property: ${prop}.`);
+            }
+            prop = buffer.readUint8();
+        }
+    }
+    /**
+     * Deserializes a metadata comment node from binary format.
+     *
+     * @param buffer ByteBuffer for reading binary data.
+     * @param node Destination node.
+     * @throws If the binary data is malformed.
+     */
+    static deserialize(buffer, node) {
+        buffer.assertUint8(BinaryTypeMarshallingMap.ConfigCommentRuleNode);
+        node.type = CommentRuleType.ConfigCommentRule;
+        node.category = RuleCategory.Comment;
+        node.syntax = AdblockSyntax.Common;
+        let prop = buffer.readUint8();
+        while (prop !== NULL) {
+            switch (prop) {
+                case ConfigCommentRuleMarshallingMap.Marker:
+                    ValueDeserializer.deserialize(buffer, node.marker = {});
+                    break;
+                case ConfigCommentRuleMarshallingMap.Command:
+                    // eslint-disable-next-line max-len
+                    ValueDeserializer.deserialize(buffer, node.command = {}, getFrequentCommandsDeserializationMap());
+                    break;
+                case ConfigCommentRuleMarshallingMap.Params:
+                    if (buffer.peekUint8() === BinaryTypeMarshallingMap.ConfigNode) {
+                        ConfigCommentDeserializer.deserializeConfigNode(buffer, node.params = {});
+                    }
+                    else {
+                        ParameterListDeserializer.deserialize(buffer, node.params = {});
+                    }
+                    break;
+                case ConfigCommentRuleMarshallingMap.Comment:
+                    ValueDeserializer.deserialize(buffer, node.comment = {});
+                    break;
+                case ConfigCommentRuleMarshallingMap.Start:
+                    node.start = buffer.readUint32();
+                    break;
+                case ConfigCommentRuleMarshallingMap.End:
+                    node.end = buffer.readUint32();
+                    break;
+                default:
+                    throw new Error(`Invalid property: ${prop}`);
+            }
+            prop = buffer.readUint8();
+        }
+    }
+}
+
+export { ConfigCommentDeserializer };

package/dist/esm/deserializer/comment/hint-comment-deserializer.mjs

@@ -0,0 +1,67 @@
+/*
+ * AGTree v3.0.0-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+import { NULL } from '../../utils/constants.mjs';
+import { RuleCategory, CommentRuleType } from '../../nodes/index.mjs';
+import { HintDeserializer } from './hint-deserializer.mjs';
+import { AdblockSyntax } from '../../utils/adblockers.mjs';
+import { BaseDeserializer } from '../base-deserializer.mjs';
+import { HintCommentMarshallingMap } from '../../marshalling-utils/comment/hint-comment-common.mjs';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.mjs';
+import { getSyntaxDeserializationMap } from '../syntax-deserialization-map.mjs';
+
+/* eslint-disable no-param-reassign */
+/**
+ * `HintCommentDeserializer` is responsible for deserializing AdGuard hint rules.
+ *
+ * @example
+ * The following hint rule
+ * ```adblock
+ * !+ NOT_OPTIMIZED PLATFORM(windows)
+ * ```
+ * contains two hints: `NOT_OPTIMIZED` and `PLATFORM`.
+ * @see {@link https://kb.adguard.com/en/general/how-to-create-your-own-ad-filters#hints}
+ */
+class HintCommentDeserializer extends BaseDeserializer {
+    /**
+     * Deserializes a hint rule node from binary format.
+     *
+     * @param buffer ByteBuffer for reading binary data.
+     * @param node Destination node.
+     * @throws If the binary data is malformed.
+     */
+    static deserialize(buffer, node) {
+        buffer.assertUint8(BinaryTypeMarshallingMap.HintRuleNode);
+        node.category = RuleCategory.Comment;
+        node.type = CommentRuleType.HintCommentRule;
+        let prop = buffer.readUint8();
+        while (prop !== NULL) {
+            switch (prop) {
+                case HintCommentMarshallingMap.Syntax:
+                    node.syntax = getSyntaxDeserializationMap().get(buffer.readUint8()) ?? AdblockSyntax.Common;
+                    break;
+                case HintCommentMarshallingMap.Children:
+                    node.children = new Array(buffer.readUint8());
+                    // read children
+                    for (let i = 0; i < node.children.length; i += 1) {
+                        HintDeserializer.deserialize(buffer, node.children[i] = {});
+                    }
+                    break;
+                case HintCommentMarshallingMap.Start:
+                    node.start = buffer.readUint32();
+                    break;
+                case HintCommentMarshallingMap.End:
+                    node.end = buffer.readUint32();
+                    break;
+                default:
+                    throw new Error(`Invalid property: ${prop}`);
+            }
+            prop = buffer.readUint8();
+        }
+    }
+}
+
+export { HintCommentDeserializer };

package/dist/esm/deserializer/comment/hint-deserializer.mjs

@@ -0,0 +1,85 @@
+/*
+ * AGTree v3.0.0-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+import { NULL } from '../../utils/constants.mjs';
+import { BaseDeserializer } from '../base-deserializer.mjs';
+import { HintNodeMarshallingMap, FREQUENT_HINTS_SERIALIZATION_MAP, FREQUENT_PLATFORMS_SERIALIZATION_MAP } from '../../marshalling-utils/comment/hint-common.mjs';
+import { ValueDeserializer } from '../misc/value-deserializer.mjs';
+import { ParameterListDeserializer } from '../misc/parameter-list-deserializer.mjs';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.mjs';
+
+/* eslint-disable no-param-reassign */
+/**
+ * Value map for binary deserialization. This helps to reduce the size of the serialized data,
+ * as it allows us to use a single byte to represent frequently used values.
+ */
+let frequentHintsDeserializationMap;
+const getFrequentHintsDeserializationMap = () => {
+    if (!frequentHintsDeserializationMap) {
+        frequentHintsDeserializationMap = new Map(Array.from(FREQUENT_HINTS_SERIALIZATION_MAP).map(([key, value]) => [value, key]));
+    }
+    return frequentHintsDeserializationMap;
+};
+/**
+ * Value map for binary deserialization. This helps to reduce the size of the serialized data,
+ * as it allows us to use a single byte to represent frequently used values.
+ */
+let frequentPlatformsDeserializationMap;
+const getFrequentPlatformsDeserializationMap = () => {
+    if (!frequentPlatformsDeserializationMap) {
+        frequentPlatformsDeserializationMap = new Map(Array.from(FREQUENT_PLATFORMS_SERIALIZATION_MAP).map(([key, value]) => [value, key]));
+    }
+    return frequentPlatformsDeserializationMap;
+};
+/**
+ * `HintDeserializer` is responsible for deserializing AdGuard hints.
+ *
+ * @example
+ * If the hint rule is
+ * ```adblock
+ * !+ NOT_OPTIMIZED PLATFORM(windows)
+ * ```
+ * then the hints are `NOT_OPTIMIZED` and `PLATFORM(windows)`, and this
+ * class is responsible for parsing them. The rule itself is parsed by
+ * the `HintRuleParser`, which uses this class to parse single hints.
+ */
+class HintDeserializer extends BaseDeserializer {
+    /**
+     * Deserializes a hint node from binary format.
+     *
+     * @param buffer ByteBuffer for reading binary data.
+     * @param node Destination node.
+     * @throws If the binary data is malformed.
+     */
+    static deserialize(buffer, node) {
+        buffer.assertUint8(BinaryTypeMarshallingMap.HintNode);
+        node.type = 'Hint';
+        let prop = buffer.readUint8();
+        while (prop !== NULL) {
+            switch (prop) {
+                case HintNodeMarshallingMap.Name:
+                    // eslint-disable-next-line max-len
+                    ValueDeserializer.deserialize(buffer, node.name = {}, getFrequentHintsDeserializationMap());
+                    break;
+                case HintNodeMarshallingMap.Params:
+                    // eslint-disable-next-line max-len
+                    ParameterListDeserializer.deserialize(buffer, node.params = {}, getFrequentPlatformsDeserializationMap());
+                    break;
+                case HintNodeMarshallingMap.Start:
+                    node.start = buffer.readUint32();
+                    break;
+                case HintNodeMarshallingMap.End:
+                    node.end = buffer.readUint32();
+                    break;
+                default:
+                    throw new Error(`Invalid property: ${prop}`);
+            }
+            prop = buffer.readUint8();
+        }
+    }
+}
+
+export { HintDeserializer, getFrequentPlatformsDeserializationMap };

package/dist/esm/deserializer/comment/metadata-comment-deserializer.mjs

@@ -0,0 +1,69 @@
+/*
+ * AGTree v3.0.0-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+import { NULL } from '../../utils/constants.mjs';
+import { CommentRuleType, RuleCategory } from '../../nodes/index.mjs';
+import { BaseDeserializer } from '../base-deserializer.mjs';
+import { MetadataCommentMarshallingMap, FREQUENT_HEADERS_DESERIALIZATION_MAP } from '../../marshalling-utils/comment/metadata-comment-common.mjs';
+import { AdblockSyntax } from '../../utils/adblockers.mjs';
+import { ValueDeserializer } from '../misc/value-deserializer.mjs';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.mjs';
+
+/* eslint-disable no-param-reassign */
+/**
+ * `MetadataCommentDeserializer` is responsible for deserializing metadata comments.
+ * Metadata comments are special comments that specify some properties of the list.
+ *
+ * @example
+ * For example, in the case of
+ * ```adblock
+ * ! Title: My List
+ * ```
+ * the name of the header is `Title`, and the value is `My List`, which means that
+ * the list title is `My List`, and it can be used in the adblocker UI.
+ * @see {@link https://help.eyeo.com/adblockplus/how-to-write-filters#special-comments}
+ */
+class MetadataCommentDeserializer extends BaseDeserializer {
+    /**
+     * Deserializes a metadata comment node from binary format.
+     *
+     * @param buffer ByteBuffer for reading binary data.
+     * @param node Destination node.
+     * @throws If the binary data is malformed.
+     */
+    static deserialize(buffer, node) {
+        buffer.assertUint8(BinaryTypeMarshallingMap.MetadataCommentRuleNode);
+        node.type = CommentRuleType.MetadataCommentRule;
+        node.category = RuleCategory.Comment;
+        node.syntax = AdblockSyntax.Common;
+        let prop = buffer.readUint8();
+        while (prop !== NULL) {
+            switch (prop) {
+                case MetadataCommentMarshallingMap.Marker:
+                    ValueDeserializer.deserialize(buffer, node.marker = {});
+                    break;
+                case MetadataCommentMarshallingMap.Header:
+                    // eslint-disable-next-line max-len
+                    ValueDeserializer.deserialize(buffer, node.header = {}, FREQUENT_HEADERS_DESERIALIZATION_MAP);
+                    break;
+                case MetadataCommentMarshallingMap.Value:
+                    ValueDeserializer.deserialize(buffer, node.value = {});
+                    break;
+                case MetadataCommentMarshallingMap.Start:
+                    node.start = buffer.readUint32();
+                    break;
+                case MetadataCommentMarshallingMap.End:
+                    node.end = buffer.readUint32();
+                    break;
+                default:
+                    throw new Error(`Invalid property: ${prop}`);
+            }
+            prop = buffer.readUint8();
+        }
+    }
+}
+
+export { MetadataCommentDeserializer };