@adguard/agtree 2.1.2 → 3.0.0-alpha.1

package/dist/esm/deserializer/misc/parameter-list-deserializer.mjs

@@ -0,0 +1,60 @@
+/*
+ * 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 { ValueDeserializer } from './value-deserializer.mjs';
+import { BaseDeserializer } from '../base-deserializer.mjs';
+import { ParameterListNodeMarshallingMap } from '../../marshalling-utils/misc/parameter-list-common.mjs';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.mjs';
+
+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/esm/deserializer/misc/value-deserializer.mjs

@@ -0,0 +1,50 @@
+/*
+ * 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, EMPTY } from '../../utils/constants.mjs';
+import { BaseDeserializer } from '../base-deserializer.mjs';
+import { ValueNodeMarshallingMap } from '../../marshalling-utils/misc/value-common.mjs';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.mjs';
+
+/**
+ * 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/esm/deserializer/network/host-rule-deserializer.mjs

@@ -0,0 +1,79 @@
+/*
+ * 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, NetworkRuleType } from '../../nodes/index.mjs';
+import { ValueDeserializer } from '../misc/value-deserializer.mjs';
+import { HostnameListDeserializer } from './hostname-list-deserializer.mjs';
+import { BaseDeserializer } from '../base-deserializer.mjs';
+import { HostRuleMarshallingMap } from '../../marshalling-utils/misc/host-rule-common.mjs';
+import { AdblockSyntax } from '../../utils/adblockers.mjs';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.mjs';
+import { getSyntaxDeserializationMap } from '../syntax-deserialization-map.mjs';
+
+/* eslint-disable no-param-reassign */
+/**
+ * `HostRuleSerializer` is responsible for serializing 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.
+ *
+ * Rules syntax looks like this:
+ * ```text
+ * IP_address canonical_hostname [aliases...]
+ * ```
+ *
+ * @example
+ * `192.168.1.13 bar.mydomain.org bar` -- ipv4
+ * `ff02::1 ip6-allnodes` -- ipv6
+ * `::1 localhost ip6-localhost ip6-loopback` -- ipv6 aliases
+ * `example.org` -- "just domain" syntax
+ * @see {@link http://man7.org/linux/man-pages/man5/hosts.5.html}
+ */
+class HostRuleDeserializer 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.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/esm/deserializer/network/hostname-list-deserializer.mjs

@@ -0,0 +1,48 @@
+/*
+ * 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 { BaseDeserializer } from '../base-deserializer.mjs';
+import { NULL } from '../../utils/constants.mjs';
+import { ValueDeserializer } from '../misc/value-deserializer.mjs';
+import { HostnameListNodeMarshallingMap } from '../../marshalling-utils/misc/hostname-list-common.mjs';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.mjs';
+
+/* eslint-disable no-param-reassign */
+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();
+        }
+    }
+}
+
+export { HostnameListDeserializer };

package/dist/esm/deserializer/network/network-rule-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 { NetworkRuleType, RuleCategory } from '../../nodes/index.mjs';
+import { ValueDeserializer } from '../misc/value-deserializer.mjs';
+import { BaseDeserializer } from '../base-deserializer.mjs';
+import { ModifierListDeserializer } from '../misc/modifier-list-deserializer.mjs';
+import { NetworkRuleMarshallingMap } from '../../marshalling-utils/network/network-rule-common.mjs';
+import { AdblockSyntax } from '../../utils/adblockers.mjs';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.mjs';
+import { getSyntaxDeserializationMap } from '../syntax-deserialization-map.mjs';
+
+/* 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/esm/deserializer/rule-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 { BaseDeserializer } from './base-deserializer.mjs';
+import { CommentRuleDeserializer } from './comment/comment-rule-deserializer.mjs';
+import { CosmeticRuleDeserializer } from './cosmetic/cosmetic-rule-deserializer.mjs';
+import { HostRuleDeserializer } from './network/host-rule-deserializer.mjs';
+import { NetworkRuleDeserializer } from './network/network-rule-deserializer.mjs';
+import { EmptyRuleDeserializer } from './empty-rule-deserializer.mjs';
+import { InvalidRuleDeserializer } from './invalid-rule-deserializer.mjs';
+import { BinaryTypeMarshallingMap } from '../marshalling-utils/misc/binary-type-common.mjs';
+
+/**
+ * `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/esm/deserializer/syntax-deserialization-map.mjs

@@ -0,0 +1,21 @@
+/*
+ * 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 { getSyntaxSerializationMap } from '../marshalling-utils/syntax-serialization-map.mjs';
+
+/**
+ * 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/esm/errors/adblock-syntax-error.mjs

@@ -0,0 +1,39 @@
+/*
+ * 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
+ */
+/**
+ * @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/esm/errors/binary-schema-mismatch-error.mjs

@@ -0,0 +1,37 @@
+/*
+ * 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
+ */
+/**
+ * @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/esm/errors/not-implemented-error.mjs

@@ -0,0 +1,31 @@
+/*
+ * 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
+ */
+/**
+ * @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 };

package/dist/esm/errors/rule-conversion-error.mjs

@@ -0,0 +1,26 @@
+/*
+ * 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
+ */
+/**
+ * @file Customized error class for conversion errors.
+ */
+const ERROR_NAME = 'RuleConversionError';
+/**
+ * Customized error class for conversion errors.
+ */
+class RuleConversionError extends Error {
+    /**
+     * Constructs a new `RuleConversionError` instance.
+     *
+     * @param message Error message
+     */
+    constructor(message) {
+        super(message);
+        this.name = ERROR_NAME;
+    }
+}
+
+export { RuleConversionError };

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

@@ -0,0 +1,27 @@
+/*
+ * 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';
+
+/* eslint-disable @typescript-eslint/no-unused-vars */
+/**
+ * @file Base parser class.
+ */
+/**
+ * Base class for generators. Each generator should extend this class.
+ */
+class BaseGenerator {
+    /**
+     * Generates a string from the AST node.
+     *
+     * @param node AST node to generate a string from.
+     */
+    static generate(node) {
+        throw new NotImplementedError();
+    }
+}
+
+export { BaseGenerator };

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

@@ -0,0 +1,28 @@
+/*
+ * 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 { SEMICOLON, SPACE, CLOSE_SQUARE_BRACKET, OPEN_SQUARE_BRACKET } from '../../utils/constants.mjs';
+import { BaseGenerator } from '../base-generator.mjs';
+import { AgentGenerator } from './agent-generator.mjs';
+
+class AgentCommentGenerator extends BaseGenerator {
+    /**
+     * Converts an adblock agent AST to a string.
+     *
+     * @param ast Agent rule AST
+     * @returns Raw string
+     */
+    static generate(ast) {
+        let result = OPEN_SQUARE_BRACKET;
+        result += ast.children
+            .map(AgentGenerator.generate)
+            .join(SEMICOLON + SPACE);
+        result += CLOSE_SQUARE_BRACKET;
+        return result;
+    }
+}
+
+export { AgentCommentGenerator };

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

@@ -0,0 +1,32 @@
+/*
+ * 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 { BaseGenerator } from '../base-generator.mjs';
+import { SPACE, EMPTY } from '../../utils/constants.mjs';
+import { isUndefined } from '../../utils/type-guards.mjs';
+
+class AgentGenerator extends BaseGenerator {
+    /**
+     * Converts an adblock agent node to a string.
+     *
+     * @param value Agent node
+     * @returns Raw string
+     */
+    static generate(value) {
+        let result = EMPTY;
+        // Agent adblock name
+        result += value.adblock.value;
+        // Agent adblock version (if present)
+        if (!isUndefined(value.version)) {
+            // Add a space between the name and the version
+            result += SPACE;
+            result += value.version.value;
+        }
+        return result;
+    }
+}
+
+export { AgentGenerator };