@adguard/agtree 2.2.0 → 3.0.0-alpha.2

package/dist/deserializer/misc/modifier-deserializer.js

@@ -0,0 +1,87 @@
+/*
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 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.js';
+import { ValueDeserializer } from './value-deserializer.js';
+import { BaseDeserializer } from '../base-deserializer.js';
+import { ModifierNodeMarshallingMap, FREQUENT_MODIFIERS_SERIALIZATION_MAP, FREQUENT_REDIRECT_MODIFIERS_SERIALIZATION_MAP } from '../../marshalling-utils/misc/modifier-common.js';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.js';
+
+/* 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.
+ *
+ * @note Only 256 values can be represented this way.
+ */
+let frequentModifiersDeserializationMap;
+const getFrequentModifiersDeserializationMap = () => {
+    if (!frequentModifiersDeserializationMap) {
+        frequentModifiersDeserializationMap = new Map(Array.from(FREQUENT_MODIFIERS_SERIALIZATION_MAP).map(([key, value]) => [value, key]));
+    }
+    return frequentModifiersDeserializationMap;
+};
+/**
+ * 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 frequentValuesDeserializationMaps;
+const getFrequentValuesDeserializationMaps = () => {
+    if (!frequentValuesDeserializationMaps) {
+        frequentValuesDeserializationMaps = new Map(Array.from(FREQUENT_REDIRECT_MODIFIERS_SERIALIZATION_MAP, ([modifier, valueMap]) => [modifier, new Map(Array.from(valueMap, ([key, value]) => [value, key]))]));
+    }
+    return frequentValuesDeserializationMaps;
+};
+/**
+ * `ModifierDeserializer` is responsible for deserializing modifiers.
+ *
+ * @example
+ * `match-case`, `~third-party`, `domain=example.com|~example.org`
+ */
+class ModifierDeserializer extends BaseDeserializer {
+    /**
+     * Deserializes a modifier node from binary format.
+     *
+     * @param buffer ByteBuffer for reading binary data.
+     * @param node Destination node.
+     */
+    static deserialize(buffer, node) {
+        buffer.assertUint8(BinaryTypeMarshallingMap.ModifierNode);
+        node.type = 'Modifier';
+        let prop = buffer.readUint8();
+        while (prop !== NULL) {
+            switch (prop) {
+                case ModifierNodeMarshallingMap.Name:
+                    // eslint-disable-next-line max-len
+                    ValueDeserializer.deserialize(buffer, node.name = {}, getFrequentModifiersDeserializationMap());
+                    break;
+                case ModifierNodeMarshallingMap.Value:
+                    if (node.name) {
+                        // eslint-disable-next-line max-len
+                        ValueDeserializer.deserialize(buffer, node.value = {}, getFrequentValuesDeserializationMaps().get(node.name.value));
+                    }
+                    else {
+                        ValueDeserializer.deserialize(buffer, node.value = {});
+                    }
+                    break;
+                case ModifierNodeMarshallingMap.Exception:
+                    node.exception = buffer.readUint8() === 1;
+                    break;
+                case ModifierNodeMarshallingMap.Start:
+                    node.start = buffer.readUint32();
+                    break;
+                case ModifierNodeMarshallingMap.End:
+                    node.end = buffer.readUint32();
+                    break;
+                default:
+                    throw new Error(`Invalid property: ${prop}.`);
+            }
+            prop = buffer.readUint8();
+        }
+    }
+}
+
+export { ModifierDeserializer };

package/dist/deserializer/misc/modifier-list-deserializer.js

@@ -0,0 +1,61 @@
+/*
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 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.js';
+import { BaseDeserializer } from '../base-deserializer.js';
+import { ModifierDeserializer } from './modifier-deserializer.js';
+import { ModifierListNodeMarshallingMap } from '../../marshalling-utils/misc/modifier-list-common.js';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.js';
+
+/* eslint-disable no-param-reassign */
+/**
+ * `ModifierListDeserializer` is responsible for deserializing modifier lists. Please note that the name is not
+ * uniform, "modifiers" are also known as "options".
+ *
+ * @see {@link https://kb.adguard.com/en/general/how-to-create-your-own-ad-filters#basic-rules-modifiers}
+ * @see {@link https://kb.adguard.com/en/general/how-to-create-your-own-ad-filters#non-basic-rules-modifiers}
+ * @see {@link https://help.eyeo.com/adblockplus/how-to-write-filters#options}
+ */
+class ModifierListDeserializer extends BaseDeserializer {
+    /**
+     * Deserializes a modifier list node from binary format.
+     *
+     * @param buffer ByteBuffer for reading binary data.
+     * @param node Destination node.
+     */
+    static deserialize(buffer, node) {
+        buffer.assertUint8(BinaryTypeMarshallingMap.ModifierListNode);
+        node.type = 'ModifierList';
+        let prop = buffer.readUint8();
+        while (prop !== NULL) {
+            switch (prop) {
+                case ModifierListNodeMarshallingMap.Children:
+                    node.children = new Array(buffer.readUint16());
+                    // read children
+                    for (let i = 0; i < node.children.length; i += 1) {
+                        ModifierDeserializer.deserialize(buffer, node.children[i] = {});
+                    }
+                    break;
+                case ModifierListNodeMarshallingMap.Start:
+                    node.start = buffer.readUint32();
+                    break;
+                case ModifierListNodeMarshallingMap.End:
+                    node.end = buffer.readUint32();
+                    break;
+                default:
+                    throw new Error(`Invalid property: ${prop}.`);
+            }
+            prop = buffer.readUint8();
+        }
+        // Maybe children are not present in the binary data,
+        // in this case, we should initialize it as an empty array.
+        if (!node.children) {
+            node.children = [];
+        }
+    }
+}
+
+export { ModifierListDeserializer };

package/dist/deserializer/misc/parameter-list-deserializer.js

@@ -0,0 +1,64 @@
+/*
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 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.js';
+import { ValueDeserializer } from './value-deserializer.js';
+import { BaseDeserializer } from '../base-deserializer.js';
+import { ParameterListNodeMarshallingMap } from '../../marshalling-utils/misc/parameter-list-common.js';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.js';
+
+/**
+ * Deserializes binary data into parameter list nodes.
+ * Optionally uses a map of frequent values for optimization.
+ */
+class ParameterListDeserializer extends BaseDeserializer {
+    /**
+     * Deserializes a parameter list node from binary format.
+     *
+     * @param buffer ByteBuffer for reading binary data.
+     * @param node Destination node.
+     * @param frequentValuesMap Optional map of frequent values.
+     * @throws If the binary data is malformed.
+     */
+    static deserialize(buffer, node, frequentValuesMap) {
+        buffer.assertUint8(BinaryTypeMarshallingMap.ParameterListNode);
+        node.type = 'ParameterList';
+        let prop = buffer.readUint8();
+        while (prop !== NULL) {
+            switch (prop) {
+                case ParameterListNodeMarshallingMap.Children:
+                    node.children = new Array(buffer.readUint32());
+                    // read children
+                    for (let i = 0; i < node.children.length; i += 1) {
+                        switch (buffer.peekUint8()) {
+                            case BinaryTypeMarshallingMap.Null:
+                                buffer.readUint8();
+                                node.children[i] = null;
+                                break;
+                            case BinaryTypeMarshallingMap.ValueNode:
+                                // eslint-disable-next-line max-len
+                                ValueDeserializer.deserialize(buffer, node.children[i] = {}, frequentValuesMap);
+                                break;
+                            default:
+                                throw new Error(`Invalid child type: ${buffer.peekUint8()}`);
+                        }
+                    }
+                    break;
+                case ParameterListNodeMarshallingMap.Start:
+                    node.start = buffer.readUint32();
+                    break;
+                case ParameterListNodeMarshallingMap.End:
+                    node.end = buffer.readUint32();
+                    break;
+                default:
+                    throw new Error(`Invalid property: ${prop}`);
+            }
+            prop = buffer.readUint8();
+        }
+    }
+}
+
+export { ParameterListDeserializer };

package/dist/deserializer/misc/value-deserializer.js

@@ -0,0 +1,50 @@
+/*
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+import { NULL, EMPTY } from '../../utils/constants.js';
+import { BaseDeserializer } from '../base-deserializer.js';
+import { ValueNodeMarshallingMap } from '../../marshalling-utils/misc/value-common.js';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.js';
+
+/**
+ * Value deserializer.
+ */
+class ValueDeserializer extends BaseDeserializer {
+    /**
+     * Deserializes a value node from binary format.
+     *
+     * @param buffer ByteBuffer for reading binary data.
+     * @param node Destination node.
+     * @param frequentValuesMap Optional map of frequent values.
+     * @throws If the binary data is malformed.
+     */
+    static deserialize(buffer, node, frequentValuesMap) {
+        buffer.assertUint8(BinaryTypeMarshallingMap.ValueNode);
+        node.type = 'Value';
+        let prop = buffer.readUint8();
+        while (prop !== NULL) {
+            switch (prop) {
+                case ValueNodeMarshallingMap.Value:
+                    node.value = buffer.readString();
+                    break;
+                case ValueNodeMarshallingMap.FrequentValue:
+                    node.value = frequentValuesMap?.get(buffer.readUint8()) ?? EMPTY;
+                    break;
+                case ValueNodeMarshallingMap.Start:
+                    node.start = buffer.readUint32();
+                    break;
+                case ValueNodeMarshallingMap.End:
+                    node.end = buffer.readUint32();
+                    break;
+                default:
+                    throw new Error(`Invalid property: ${prop}`);
+            }
+            prop = buffer.readUint8();
+        }
+    }
+}
+
+export { ValueDeserializer };

package/dist/deserializer/network/host-rule-deserializer.js

@@ -0,0 +1,67 @@
+/*
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 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.js';
+import { RuleCategory, NetworkRuleType } from '../../nodes/index.js';
+import { ValueDeserializer } from '../misc/value-deserializer.js';
+import { HostnameListDeserializer } from './hostname-list-deserializer.js';
+import { BaseDeserializer } from '../base-deserializer.js';
+import { HostRuleMarshallingMap } from '../../marshalling-utils/misc/host-rule-common.js';
+import { AdblockSyntax } from '../../utils/adblockers.js';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.js';
+import { getSyntaxDeserializationMap } from '../syntax-deserialization-map.js';
+
+/* eslint-disable no-param-reassign */
+/**
+ * `HostRuleDeserializer` is responsible for deserializing hosts-like rules.
+ *
+ * HostRule is a structure for simple host-level rules (i.e. /etc/hosts syntax).
+ * It also supports "just domain" syntax. In this case, the IP will be set to 0.0.0.0.
+ */
+class HostRuleDeserializer extends BaseDeserializer {
+    /**
+     * Deserializes a host rule node from binary format.
+     *
+     * @param buffer Input byte buffer to read from.
+     * @param node Destination node to write to.
+     */
+    static deserialize(buffer, node) {
+        buffer.assertUint8(BinaryTypeMarshallingMap.HostRuleNode);
+        node.category = RuleCategory.Network;
+        node.type = NetworkRuleType.HostRule;
+        let prop = buffer.readUint8();
+        while (prop !== NULL) {
+            switch (prop) {
+                case HostRuleMarshallingMap.Syntax:
+                    node.syntax = getSyntaxDeserializationMap().get(buffer.readUint8()) ?? AdblockSyntax.Common;
+                    break;
+                case HostRuleMarshallingMap.Ip:
+                    node.ip = {};
+                    ValueDeserializer.deserialize(buffer, node.ip);
+                    break;
+                case HostRuleMarshallingMap.HostnameList:
+                    node.hostnames = {};
+                    HostnameListDeserializer.deserialize(buffer, node.hostnames);
+                    break;
+                case HostRuleMarshallingMap.Comment:
+                    node.comment = {};
+                    ValueDeserializer.deserialize(buffer, node.comment);
+                    break;
+                case HostRuleMarshallingMap.Start:
+                    node.start = buffer.readUint32();
+                    break;
+                case HostRuleMarshallingMap.End:
+                    node.end = buffer.readUint32();
+                    break;
+                default:
+                    throw new Error(`Invalid property: ${prop}.`);
+            }
+            prop = buffer.readUint8();
+        }
+    }
+}
+
+export { HostRuleDeserializer };

package/dist/deserializer/network/hostname-list-deserializer.js

@@ -0,0 +1,56 @@
+/*
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+import { BaseDeserializer } from '../base-deserializer.js';
+import { NULL } from '../../utils/constants.js';
+import { ValueDeserializer } from '../misc/value-deserializer.js';
+import { HostnameListNodeMarshallingMap } from '../../marshalling-utils/misc/hostname-list-common.js';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.js';
+
+/* eslint-disable no-param-reassign */
+/**
+ * Deserializes hostname list nodes from binary format.
+ */
+class HostnameListDeserializer extends BaseDeserializer {
+    /**
+     * Deserializes a hostname list node from binary format.
+     *
+     * @param buffer ByteBuffer for reading binary data.
+     * @param node Destination node.
+     */
+    static deserialize(buffer, node) {
+        buffer.assertUint8(BinaryTypeMarshallingMap.HostnameListNode);
+        node.type = 'HostnameList';
+        let prop = buffer.readUint8();
+        while (prop !== NULL) {
+            switch (prop) {
+                case HostnameListNodeMarshallingMap.Children:
+                    node.children = new Array(buffer.readUint16());
+                    // read children
+                    for (let i = 0; i < node.children.length; i += 1) {
+                        ValueDeserializer.deserialize(buffer, node.children[i] = {});
+                    }
+                    break;
+                case HostnameListNodeMarshallingMap.Start:
+                    node.start = buffer.readUint32();
+                    break;
+                case HostnameListNodeMarshallingMap.End:
+                    node.end = buffer.readUint32();
+                    break;
+                default:
+                    throw new Error(`Unknown property: ${prop}`);
+            }
+            prop = buffer.readUint8();
+        }
+        // Maybe children are not present in the binary data,
+        // in this case, we should initialize it as an empty array.
+        if (!node.children) {
+            node.children = [];
+        }
+    }
+}
+
+export { HostnameListDeserializer };

package/dist/deserializer/network/network-rule-deserializer.js

@@ -0,0 +1,65 @@
+/*
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 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.js';
+import { NetworkRuleType, RuleCategory } from '../../nodes/index.js';
+import { ValueDeserializer } from '../misc/value-deserializer.js';
+import { BaseDeserializer } from '../base-deserializer.js';
+import { ModifierListDeserializer } from '../misc/modifier-list-deserializer.js';
+import { NetworkRuleMarshallingMap } from '../../marshalling-utils/network/network-rule-common.js';
+import { AdblockSyntax } from '../../utils/adblockers.js';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.js';
+import { getSyntaxDeserializationMap } from '../syntax-deserialization-map.js';
+
+/* eslint-disable no-param-reassign */
+/**
+ * `NetworkRuleDeserializer` is responsible for deserializing network rules.
+ *
+ * @see {@link https://kb.adguard.com/en/general/how-to-create-your-own-ad-filters#basic-rules}
+ * @see {@link https://help.eyeo.com/adblockplus/how-to-write-filters#basic}
+ */
+class NetworkRuleDeserializer extends BaseDeserializer {
+    /**
+     * Deserializes a network rule node from binary format.
+     *
+     * @param buffer ByteBuffer for reading binary data.
+     * @param node Destination node.
+     */
+    static deserialize(buffer, node) {
+        buffer.assertUint8(BinaryTypeMarshallingMap.NetworkRuleNode);
+        node.type = NetworkRuleType.NetworkRule;
+        node.category = RuleCategory.Network;
+        node.modifiers = undefined;
+        let prop = buffer.readUint8();
+        while (prop !== NULL) {
+            switch (prop) {
+                case NetworkRuleMarshallingMap.Syntax:
+                    node.syntax = getSyntaxDeserializationMap().get(buffer.readUint8()) ?? AdblockSyntax.Common;
+                    break;
+                case NetworkRuleMarshallingMap.Exception:
+                    node.exception = buffer.readUint8() === 1;
+                    break;
+                case NetworkRuleMarshallingMap.Pattern:
+                    ValueDeserializer.deserialize(buffer, node.pattern = {});
+                    break;
+                case NetworkRuleMarshallingMap.ModifierList:
+                    ModifierListDeserializer.deserialize(buffer, node.modifiers = {});
+                    break;
+                case NetworkRuleMarshallingMap.Start:
+                    node.start = buffer.readUint32();
+                    break;
+                case NetworkRuleMarshallingMap.End:
+                    node.end = buffer.readUint32();
+                    break;
+                default:
+                    throw new Error(`Invalid property: ${prop}.`);
+            }
+            prop = buffer.readUint8();
+        }
+    }
+}
+
+export { NetworkRuleDeserializer };

package/dist/deserializer/rule-deserializer.js

@@ -0,0 +1,65 @@
+/*
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+import { BaseDeserializer } from './base-deserializer.js';
+import { CommentRuleDeserializer } from './comment/comment-rule-deserializer.js';
+import { CosmeticRuleDeserializer } from './cosmetic/cosmetic-rule-deserializer.js';
+import { HostRuleDeserializer } from './network/host-rule-deserializer.js';
+import { NetworkRuleDeserializer } from './network/network-rule-deserializer.js';
+import { EmptyRuleDeserializer } from './empty-rule-deserializer.js';
+import { InvalidRuleDeserializer } from './invalid-rule-deserializer.js';
+import { BinaryTypeMarshallingMap } from '../marshalling-utils/misc/binary-type-common.js';
+
+/**
+ * `RuleDeserializer` is responsible for deserializing the rules.
+ *
+ * It automatically determines the category and syntax of the rule, so you can pass any kind of rule to it.
+ */
+class RuleDeserializer extends BaseDeserializer {
+    /**
+     * Deserializes a rule node from binary format.
+     *
+     * @param buffer ByteBuffer for reading binary data.
+     * @param node Destination node.
+     */
+    static deserialize(buffer, node) {
+        // lookup instead of storing +1 byte
+        const type = buffer.peekUint8();
+        switch (type) {
+            case BinaryTypeMarshallingMap.AgentRuleNode:
+            case BinaryTypeMarshallingMap.HintRuleNode:
+            case BinaryTypeMarshallingMap.PreProcessorCommentRuleNode:
+            case BinaryTypeMarshallingMap.MetadataCommentRuleNode:
+            case BinaryTypeMarshallingMap.ConfigCommentRuleNode:
+            case BinaryTypeMarshallingMap.CommentRuleNode:
+                CommentRuleDeserializer.deserialize(buffer, node);
+                break;
+            case BinaryTypeMarshallingMap.ElementHidingRule:
+            case BinaryTypeMarshallingMap.CssInjectionRule:
+            case BinaryTypeMarshallingMap.ScriptletInjectionRule:
+            case BinaryTypeMarshallingMap.HtmlFilteringRule:
+            case BinaryTypeMarshallingMap.JsInjectionRule:
+                CosmeticRuleDeserializer.deserialize(buffer, node);
+                break;
+            case BinaryTypeMarshallingMap.NetworkRuleNode:
+                NetworkRuleDeserializer.deserialize(buffer, node);
+                break;
+            case BinaryTypeMarshallingMap.HostRuleNode:
+                HostRuleDeserializer.deserialize(buffer, node);
+                break;
+            case BinaryTypeMarshallingMap.EmptyRule:
+                EmptyRuleDeserializer.deserialize(buffer, node);
+                break;
+            case BinaryTypeMarshallingMap.InvalidRule:
+                InvalidRuleDeserializer.deserialize(buffer, node);
+                break;
+            default:
+                throw new Error('Unknown rule category');
+        }
+    }
+}
+
+export { RuleDeserializer };

package/dist/deserializer/syntax-deserialization-map.js

@@ -0,0 +1,21 @@
+/*
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+import { getSyntaxSerializationMap } from '../marshalling-utils/syntax-serialization-map.js';
+
+/**
+ * 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 syntaxDeserializationMap;
+const getSyntaxDeserializationMap = () => {
+    if (!syntaxDeserializationMap) {
+        syntaxDeserializationMap = new Map(Array.from(getSyntaxSerializationMap(), ([key, value]) => [value, key]));
+    }
+    return syntaxDeserializationMap;
+};
+
+export { getSyntaxDeserializationMap };

package/dist/errors/adblock-syntax-error.js

@@ -0,0 +1,39 @@
+/*
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+/**
+ * @file Customized syntax error class for Adblock Filter Parser.
+ */
+const ERROR_NAME = 'AdblockSyntaxError';
+/**
+ * Customized syntax error class for Adblock Filter Parser,
+ * which contains the location range of the error.
+ */
+class AdblockSyntaxError extends SyntaxError {
+    /**
+     * Start offset of the error.
+     */
+    start;
+    /**
+     * End offset of the error.
+     */
+    end;
+    /**
+     * Constructs a new `AdblockSyntaxError` instance.
+     *
+     * @param message Error message.
+     * @param start Start offset of the error.
+     * @param end End offset of the error.
+     */
+    constructor(message, start, end) {
+        super(message);
+        this.name = ERROR_NAME;
+        this.start = start;
+        this.end = end;
+    }
+}
+
+export { AdblockSyntaxError };

package/dist/errors/binary-schema-mismatch-error.js

@@ -0,0 +1,37 @@
+/*
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+/**
+ * @file Customized error for binary schema mismatch.
+ */
+const ERROR_NAME = 'BinarySchemaMismatchError';
+/**
+ * Customized error for binary schema mismatch.
+ */
+class BinarySchemaMismatchError extends Error {
+    /**
+     * Expected schema version.
+     */
+    expectedVersion;
+    /**
+     * Actual schema version.
+     */
+    actualVersion;
+    /**
+     * Constructs a new `BinarySchemaMismatchError` instance.
+     *
+     * @param expectedVersion Expected schema version.
+     * @param actualVersion Actual schema version.
+     */
+    constructor(expectedVersion, actualVersion) {
+        super(`Expected schema version ${expectedVersion}, but got ${actualVersion}`);
+        this.name = ERROR_NAME;
+        this.expectedVersion = expectedVersion;
+        this.actualVersion = actualVersion;
+    }
+}
+
+export { BinarySchemaMismatchError };

package/dist/errors/not-implemented-error.js

@@ -0,0 +1,31 @@
+/*
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+/**
+ * @file Customized error class for not implemented features.
+ */
+const ERROR_NAME = 'NotImplementedError';
+const BASE_MESSAGE = 'Not implemented';
+/**
+ * Customized error class for not implemented features.
+ */
+class NotImplementedError extends Error {
+    /**
+     * Constructs a new `NotImplementedError` instance.
+     *
+     * @param message Additional error message (optional)
+     */
+    constructor(message = undefined) {
+        // Prepare the full error message
+        const fullMessage = message
+            ? `${BASE_MESSAGE}: ${message}`
+            : BASE_MESSAGE;
+        super(fullMessage);
+        this.name = ERROR_NAME;
+    }
+}
+
+export { NotImplementedError };