@sitevision/api 1.1.0-alpha.2 → 2.0.0-alpha.0

package/hidden/senselogic/sitevision/api/text/EndecUtil/index.d.ts

@@ -0,0 +1,352 @@
+/**
+ * Utility interface for encoding/decoding ("encode/decode" / "escape/unescape").
+ *
+ * <p>
+ *    An instance of the Sitevision class implementing this interface can be obtained via
+ *    {@link senselogic.sitevision.api.Utils#getEndecUtil()}.
+ *    See {@link senselogic.sitevision.api.Utils} for how to obtain an instance of the <code>Utils</code> interface.
+ * </p>
+ * @author Magnus Lövgren
+ */
+
+interface EndecUtil {
+  /**
+   * Escapes/encodes the characters in a String using XML entities.
+   *
+   * <pre>
+   *   Example: "One &lt;br /&gt; &amp; two" -&gt; "One &amp;lt;br /&amp;gt; &amp;amp; two"
+   * </pre>
+   * @param aString a <code>String</code> that needs to be escaped
+   * @return aString escaped
+   */
+  escapeXML(aString: java.lang.String): string;
+
+  /**
+   * Unescapes/decodes a string containing basic XML entities to a string containing the actual Unicode characters corresponding to the entities.
+   *
+   * <p>
+   * Supports the 5 basic XML entities (gt, lt, quot, amp, apos) and numerical unicodes (decimal and hex).
+   * </p>
+   *
+   * <strong>Examples:</strong>
+   * <p style="margin-left:40px">
+   * [ <code>One &amp;lt;br /&amp;gt; &amp;amp; two</code> ] will become:<br>
+   * [ <code>One &lt;br /&gt; &amp; two</code> ]
+   * </p>
+   * <p style="margin-left:40px">
+   * [ <code>&amp;quot;Hej &amp;aring; h&amp;#229;&amp;quot; &amp;auml;r kopieringsskyddat&amp;copy; s&amp;#xE4;gs det</code> ] will become:<br>
+   * [ <code>&quot;Hej &amp;aring; hå&quot; &amp;auml;r kopieringsskyddat&amp;copy; sägs det</code> ]
+   * </p>
+   * @param aString a <code>String</code> that contains escaped xml entities
+   * @return aString unescaped
+   * @see #unEscapeHTML4(String)
+   */
+  unEscapeXML(aString: java.lang.String): string;
+
+  /**
+   * Unescapes/decodes a string containing HTML 4 entities to a string containing the actual Unicode characters corresponding to the entities.
+   *
+   * <p>
+   * Supports HTML 4.0 entities, including numerical unicodes (decimal and hex).
+   * </p>
+   *
+   * <strong>Examples:</strong>
+   * <p style="margin-left:40px">
+   * [ <code>One &amp;lt;br /&amp;gt; &amp;amp; two</code> ] will become:<br>
+   * [ <code>One &lt;br /&gt; &amp; two</code> ]
+   * </p>
+   * <p style="margin-left:40px">
+   * [ <code>&amp;quot;Hej &amp;aring; h&amp;#229;&amp;quot; &amp;auml;r kopieringsskyddat&amp;copy; s&amp;#xE4;gs det</code> ] will become:<br>
+   * [ <code>&quot;Hej å hå&quot; är kopieringsskyddat&copy; sägs det</code> ]
+   * </p>
+   * @param aString a <code>String</code> that contains escaped html 4 entities
+   * @return aString unescaped
+   * @see #unEscapeXML(String)
+   * @since Sitevision 2.6.2
+   */
+  unEscapeHTML4(aString: java.lang.String): string;
+
+  /**
+   * Encodes a String into its URL safe form using the default charset.
+   * <p>
+   * Handles the <em>www-form-urlencoded</em> encoding scheme, also misleadingly known as <em>URL encoding</em>
+   * </p>
+   * @param aURL the string to convert to a URL safe form
+   * @return an URL safe String. Returns <code>null</code> if <code>aURL</code> is <code>null</code> or can't be encoded.
+   * @since Sitevision 2.6.1_04
+   */
+  encodeURL(aURL: java.lang.String): string;
+
+  /**
+   * Decodes a URL safe String into its original form using the default charset.
+   * <p>
+   * Handles the <em>www-form-urlencoded</em> encoding scheme, also misleadingly known as <em>URL encoding</em>
+   * </p>
+   * @param aURL URL safe String to convert to its original form
+   * @return a decoded String. Returns <code>null</code> if <code>aURL</code> is <code>null</code> or can't be decoded.
+   * @since Sitevision 2.6.1_04
+   */
+  decodeURL(aURL: java.lang.String): string;
+
+  /**
+   * Converts line breaks to xhtml &lt;br /&gt; elements.
+   *
+   * <pre>
+   *   Example: "Line 1\nLine 2" -&gt; "Line 1&lt;br /&gt;Line2"
+   * </pre>
+   * @param aString a <code>String</code> to convert
+   * @return aString the converted string
+   */
+  br(aString: java.lang.String): string;
+
+  /**
+   * Replaces characters to their base subtitute.
+   * A name that is base substituted ensures that the name is CSS valid. Can for instance be used to get valid names for anchors (anchor links).
+   *
+   * <pre>
+   *   Example: "xml &euml;B&aring;_$-1205" -&gt; "xmleBa1205"
+   * </pre>
+   * @param aString a <code>String</code> that should be base substituted
+   * @return the base substitute for aString
+   */
+  getBaseSubstitute(aString: java.lang.String): string;
+
+  /**
+   * Escapes/encodes a jcr name (property name or node name) that might contain illegal characters.
+   *
+   * <p>
+   *    Any operation that includes a JCR name that contains illegal characters must be escaped. For example:
+   * </p>
+   * <pre><code>
+   *    javax.jcr.Node node = ...
+   *
+   *    javax.jcr.NodeIterator nodeIterator = node.getNodes("aNodeNameThatShouldBeEscaped");
+   *    javax.jcr.NodeIterator anotherNodeIterator = node.getNodes("aNodeNameThatShouldBeEscaped/aNodeNameThatShouldBeEscaped");
+   *    javax.jcr.Property property = node.getProperty("aPropertyNameThatShouldBeEscaped");
+   * </code></pre>
+   *
+   * <p>
+   *    Characters in JCR Names - section 3.2.5.4 of the JSR 283 specification (Java Content Repository 2.0)
+   * </p>
+   * <table summary="3.2.5.4 of the JSR 283 specification" style="border:1px solid black">
+   *    <tr>
+   *       <th>Illegal character</th>
+   *       <th>Substitution character</th>
+   *    </tr>
+   *    <tr>
+   *       <td><code>*</code> (U+002A) "asterix"</td>
+   *       <td>U+F02A</td>
+   *    </tr>
+   *    <tr>
+   *       <td><code>/</code> (U+002F) "slash"</td>
+   *       <td>U+F02F</td>
+   *    </tr>
+   *    <tr>
+   *       <td><code>:</code> (U+003A) "colon"</td>
+   *       <td>U+F03A</td>
+   *    </tr>
+   *    <tr>
+   *       <td><code>[</code> (U+005B) "left bracket"</td>
+   *       <td>U+F05B</td>
+   *    </tr>
+   *    <tr>
+   *       <td><code>]</code> (U+005D) "right bracket"</td>
+   *       <td>U+F05D</td>
+   *    </tr>
+   *    <tr>
+   *       <td><code>|</code> (U+007C) "pipe"</td>
+   *       <td>U+F07C</td>
+   *    </tr>
+   * </table>
+   * <p>
+   *    Some specific names are conflicting with the JCR naming semantics and must also be escaped:
+   *    <br><em>(though, these two "dot-only" expressions would typically be extremely uncommon as names)</em>
+   * </p>
+   * <table summary="Illegal JCR Names" style="border:1px solid black">
+   *    <tr>
+   *       <th>Illegal Name</th>
+   *       <th>Substitution Name</th>
+   *    </tr>
+   *    <tr>
+   *       <td><code>"."</code> <em>(the JCR Self Notation)</em></td>
+   *       <td>U+F02E</td>
+   *    </tr>
+   *    <tr>
+   *       <td><code>".."</code> <em>(the JCR Parent Notation)</em></td>
+   *       <td>U+F02E and U+F02E</td>
+   *    </tr>
+   * </table>
+   * @param aJcrName a name that should be escaped/encoded
+   * @return aJcrName escaped/encoded
+   * @see #unEscapeJcrName(String)
+   */
+  escapeJcrName(aJcrName: java.lang.String): string;
+
+  /**
+   * Unescapes/decodes a jcr name (property name or node name) that might be escape/encoded.
+   *
+   * <p>
+   *    Any operation that includes getting a JCR name must be unescaped if it contains illegal characters. For example:
+   * </p>
+   * <pre><code>
+   *    javax.jcr.Node node = ...
+   *    javax.jcr.Property property = ...
+   *
+   *    java.lang.String aNameThatNeedsToBeUnEscaped = node.getName();
+   *    java.lang.String anotherNameThatNeedsToBeUnEscaped = property.getName();
+   * </code></pre>
+   *
+   * <p>
+   *    See {@link #escapeJcrName(String)} for escape/unescape characters and names
+   * </p>
+   * @param aJcrName a name that might be escaped/encoded
+   * @return aJcrName unescaped/decoded
+   * @see #escapeJcrName(String)
+   */
+  unEscapeJcrName(aJcrName: java.lang.String): string;
+
+  /**
+   * Encodes a string using base64 encoding (using UTF-8 encoding).
+   * @param aString a <code>String</code> that should be base64 encoded
+   * @return <code>aString</code> base64 encoded. Returns <code>null</code> if <code>aString</code> is <code>null</code>
+   * @see #base64decode(String)
+   * @since Sitevision 2.6
+   */
+  base64encode(aString: java.lang.String): string;
+
+  /**
+   * Encodes a byte array to a base64 encoded string (using UTF-8 encoding).
+   * @param aBytes a byte array that should be base64 encoded as string
+   * @return aBytes as base64 encoded string, using UTF-8 encoding. Returns null if aBytes is null
+   * @see #base64encode(String)
+   * @since Sitevision 4.5.5.2
+   */
+  base64encodeToString(aBytes: byte): string;
+
+  /**
+   * Decodes a base64 encoded string (using UTF-8 encoding).
+   * @param aBase64EncodedString a base64 encoded String
+   * @return aBase64EncodedString base64 decoded. Returns null if aBase64EncodedString is null or can't be decoded.
+   * @see #base64encode(String)
+   * @since Sitevision 2.6
+   */
+  base64decode(aBase64EncodedString: java.lang.String): string;
+
+  /**
+   * Decodes a base64 encoded string to a byte array (using UTF-8 encoding).
+   * @param aBase64EncodedString a base64 encoded String
+   * @return aBase64EncodedString base64 decoded as byte array, using UTF-8 encoding. Returns null if aBase64EncodedString is null or can't be decoded.
+   * @see #base64decode(String)
+   * @since Sitevision 4.5.5.2
+   */
+  base64decodeToBytes(aBase64EncodedString: java.lang.String): unknown;
+
+  /**
+   * Escapes/encodes an identifier.
+   *
+   * <table style="border:1px solid black" summary="">
+   *    <caption style="text-align:left">Some examples</caption>
+   *    <tr>
+   *       <th style="text-align:left">aPrefix</th><th style="text-align:left">anIdentifier</th><th style="text-align:left">Returned</th>
+   *    </tr>
+   *    <tr>
+   *       <td><code>null</code></td><td><code>null</code></td><td><code>""</code></td>
+   *    </tr>
+   *    <tr>
+   *       <td><code>""</code></td><td><code>null</code></td><td><code>""</code></td>
+   *    </tr>
+   *    <tr>
+   *       <td><code>null</code></td><td><code>""</code></td><td><code>""</code></td>
+   *    </tr>
+   *    <tr>
+   *       <td><code>""</code></td><td><code>""</code></td><td><code>""</code></td>
+   *    </tr>
+   *    <tr>
+   *       <td><code>"pcx"</code></td><td><code>null</code></td><td><code>"pcx"</code></td>
+   *    </tr>
+   *    <tr>
+   *       <td><code>null</code></td><td><code>"pcx"</code></td><td><code>"pcx"</code></td>
+   *    </tr>
+   *    <tr>
+   *       <td><code>"pcx"</code></td><td><code>""</code></td><td><code>"pcx"</code></td>
+   *    </tr>
+   *    <tr>
+   *       <td><code>"pcx"</code></td><td><code>"123"</code></td><td><code>"pcx123"</code></td>
+   *    </tr>
+   *    <tr>
+   *       <td><code>"pcx"</code></td><td><code>"1.23"</code></td><td><code>"pcx1_23"</code></td>
+   *    </tr>
+   *    <tr>
+   *       <td><code>"pcx"</code></td><td><code>"1.23.45"</code></td><td><code>"pcx1_23_45"</code></td>
+   *    </tr>
+   * </table>
+   * @param aPrefix a prefix added to the result
+   * @param anIdentifier a string id
+   * @return a non-null prefixed and escaped string identifier
+   * @see #unEscapeIdentifier(String, String)
+   * @since Sitevision 3.0.2
+   */
+  escapeIdentifier(
+    aPrefix: java.lang.String,
+    anIdentifier: java.lang.String
+  ): string;
+
+  /**
+   * Unescapes/decodes an escaped/encoded identifier.
+   *
+   * <table style="border:1px solid black" summary="">
+   *    <caption style="text-align:left">Some examples</caption>
+   *    <tr>
+   *       <th style="text-align:left">aPrefix</th><th style="text-align:left">anIdentifier</th><th style="text-align:left">Returned</th>
+   *    </tr>
+   *    <tr>
+   *       <td><code>null</code></td><td><code>null</code></td><td><code>""</code></td>
+   *    </tr>
+   *    <tr>
+   *       <td><code>""</code></td><td><code>null</code></td><td><code>""</code></td>
+   *    </tr>
+   *    <tr>
+   *       <td><code>null</code></td><td><code>""</code></td><td><code>""</code></td>
+   *    </tr>
+   *    <tr>
+   *       <td><code>""</code></td><td><code>""</code></td><td><code>""</code></td>
+   *    </tr>
+   *    <tr>
+   *       <td><code>"pcx"</code></td><td><code>null</code></td><td><code>""</code></td>
+   *    </tr>
+   *    <tr>
+   *       <td><code>null</code></td><td><code>"pcx"</code></td><td><code>"pcx"</code></td>
+   *    </tr>
+   *    <tr>
+   *       <td><code>"pcx"</code></td><td><code>""</code></td><td><code>""</code></td>
+   *    </tr>
+   *    <tr>
+   *       <td><code>"pcx"</code></td><td><code>"pcx123"</code></td><td><code>"123"</code></td>
+   *    </tr>
+   *    <tr>
+   *       <td><code>"pcx"</code></td><td><code>"pcx1_23"</code></td><td><code>"1.23"</code></td>
+   *    </tr>
+   *    <tr>
+   *       <td><code>"pcx"</code></td><td><code>"pcx1_23_45"</code></td><td><code>"1.23.45"</code></td>
+   *    </tr>
+   *    <tr>
+   *       <td><code>null</code></td><td><code>"pcx1_23"</code></td><td><code>"pcx1.23"</code></td>
+   *    </tr>
+   *    <tr>
+   *       <td><code>""</code></td><td><code>"pcx1_23"</code></td><td><code>"pcx1.23"</code></td>
+   *    </tr>
+   *    <tr>
+   *       <td><code>"badprefix"</code></td><td><code>"pcx1_23"</code></td><td><code>"pcx1.23"</code></td>
+   *    </tr>
+   * </table>
+   * @param aPrefix a prefix that will be removed from the result
+   * @param anIdentifier a string id
+   * @return an unescaped non-null identifier
+   * @see #escapeIdentifier(String, String)
+   * @since Sitevision 3.0.2
+   */
+  unEscapeIdentifier(
+    aPrefix: java.lang.String,
+    anIdentifier: java.lang.String
+  ): string;
+}

package/hidden/senselogic/sitevision/api/user/SimpleUserUtil/index.d.ts

@@ -0,0 +1,43 @@
+import Node from "../../../../../javax/jcr/Node";
+
+/**
+ * Simple user utility interface.
+ *
+ * <p>
+ *    This interface handles nodes with primary node type <code>sv:simpleUser</code>.
+ * </p>
+ *
+ * <p>
+ *    An instance of the Sitevision class implementing this interface can be obtained via {@link UserFactory#getSimpleUserUtil()}.
+ *    See {@link senselogic.sitevision.api.user.UserFactory} for how to obtain an instance of the <code>UserFactory</code> interface.
+ * </p>
+ * @author Magnus Lövgren
+ * @since Sitevision 4.0.1
+ */
+
+interface SimpleUserUtil {
+  /**
+   * Checks if current user is member of a virtual group with a specific id.
+   *
+   * <p>
+   *    This is a convenience for {@link #isMemberOfVirtualGroup(javax.jcr.Node, String)} using current user
+   *    (as of {@link senselogic.sitevision.api.context.PortletContextUtil#getCurrentUser()}).
+   * </p>
+   * @param aVirtualGroupId id of a virtual group (sv:virtualGroup). Note! The <em>id</em> of a virtual group does not always match the <em>name</em> of the virtual group.
+   * @return <code>true</code> if current user is member of the virtual group resolved via <code>aVirtualGroupId</code>, <code>false</code> otherwise
+   * @see senselogic.sitevision.api.user.UserUtil#isMemberOfGroup(javax.jcr.Node)
+   */
+  isMemberOfVirtualGroup(aVirtualGroupId: java.lang.String): boolean;
+
+  /**
+   * Checks if a simple user is member of a virtual group with a specific id.
+   * @param aSimpleUser a simple user node (sv:simpleUser)
+   * @param aVirtualGroupId id of a virtual group (sv:virtualGroup). Note! The <em>id</em> of a virtual group does not always match the <em>name</em> of the virtual group.
+   * @return <code>true</code> if <code>aSimpleUser</code> is member of the virtual group resolved via <code>aVirtualGroupId</code>, <code>false</code> otherwise
+   * @see senselogic.sitevision.api.user.UserUtil#isMemberOfGroup(javax.jcr.Node, javax.jcr.Node)
+   */
+  isMemberOfVirtualGroup(
+    aSimpleUser: Node,
+    aVirtualGroupId: java.lang.String
+  ): boolean;
+}

package/hidden/senselogic/sitevision/api/user/SystemUserUtil/index.d.ts

@@ -0,0 +1,163 @@
+import Node from "../../../../../javax/jcr/Node";
+
+/**
+ * System user utility interface.
+ *
+ * <p>
+ *    This interface handles nodes with primary node type <code>sv:systemUser</code>, i.e. the
+ *    <em>Anonymous</em>, <em>System</em>, <em>Indexer</em> and <em>Extractor</em> user.
+ * </p>
+ *
+ * <p>
+ *    An instance of the Sitevision class implementing this interface can be obtained via
+ *    {@link senselogic.sitevision.api.user.UserFactory#getSystemUserUtil()}.
+ *    See {@link senselogic.sitevision.api.user.UserFactory} for how to obtain an instance of the <code>UserFactory</code> interface.
+ * </p>
+ * @author Magnus Lövgren
+ * @since Sitevision 3.6
+ */
+
+interface SystemUserUtil {
+  /**
+   * Checks if current user is anonymous (not authenticated).
+   *
+   * <p>
+   *    An <em>Anonymous user</em> is not authenticated and can only access public resources.
+   * </p>
+   *
+   * <p>
+   * <em>Note! This method does NOT produce a reliable result if called during the authentication process
+   * (i.e. from a JAAS filter or JAAS module) since it relies on a fully loaded current user (as of
+   * {@link senselogic.sitevision.api.context.PortletContextUtil#getCurrentUser()}).</em>
+   * </p>
+   * @return <code>true</code> if current user is Anonymous (i.e. not authenticated), <code>false</code> otherwise
+   */
+  isAnonymous(): boolean;
+
+  /**
+   * Checks if a user node is anonymous (not authenticated).
+   *
+   * <p>
+   *    An <em>Anonymous user</em> is not authenticated and can only access public resources.
+   * </p>
+   * @param aUserNode a user node
+   * @return <code>true</code> if <code>aUserNode</code> is anonymous (i.e. not authenticated), <code>false</code> otherwise (i.e. no match or <code>aUserNode</code> is <code>null</code>)
+   */
+  isAnonymous(aUserNode: Node): boolean;
+
+  /**
+   * Checks if current user is the Sitevision System user.
+   *
+   * <p>
+   *    The <em>System user</em> has all permissions and full access to all Sitevision portlets and functionality allowed
+   *    by the current license(-s).
+   * </p>
+   *
+   * <p>
+   * <em>Note! This method does NOT produce a reliable result if called during the authentication process
+   * (i.e. from a JAAS filter or JAAS module) since it relies on a fully loaded current user (as of
+   * {@link senselogic.sitevision.api.context.PortletContextUtil#getCurrentUser()}).</em>
+   * </p>
+   * @return <code>true</code> if current user is the Sitevision System user, <code>false</code> otherwise
+   */
+  isSystem(): boolean;
+
+  /**
+   * Checks if a user node is the Sitevision System user.
+   *
+   * <p>
+   *    The <em>System user</em> has all permissions and full access to all Sitevision portlets and functionality allowed
+   *    by the current license(-s).
+   * </p>
+   * @param aUserNode a user node
+   * @return <code>true</code> if <code>aUserNode</code> is the Sitevision System user, <code>false</code> otherwise (i.e. no match or <code>aUserNode</code> is <code>null</code>)
+   */
+  isSystem(aUserNode: Node): boolean;
+
+  /**
+   * Checks if current user is the Sitevision Indexer.
+   *
+   * <p>
+   *    The <em>Indexer user</em> has read permission on all resources and visits/renders pages in order to collect
+   *    metadata/content and such that should be indexed by the Sitevision search engine.
+   * </p>
+   *
+   * <p>
+   * <em>Note! This method does NOT produce a reliable result if called during the authentication process
+   * (i.e. from a JAAS filter or JAAS module) since it relies on a fully loaded current user (as of
+   * {@link senselogic.sitevision.api.context.PortletContextUtil#getCurrentUser()}).</em>
+   * </p>
+   * @return <code>true</code> if current user is the Sitevision Indexer, <code>false</code> otherwise
+   */
+  isIndexer(): boolean;
+
+  /**
+   * Checks if a user node is the Sitevision Indexer.
+   *
+   * <p>
+   *    The <em>Indexer user</em> has read permission on all resources and visits/renders pages in order to collect
+   *    metadata/content and such that should be indexed by the Sitevision search engine.
+   * </p>
+   * @param aUserNode a user node
+   * @return <code>true</code> if <code>aUserNode</code> is the Sitevision Indexer, <code>false</code> otherwise (i.e. no match or <code>aUserNode</code> is <code>null</code>)
+   */
+  isIndexer(aUserNode: Node): boolean;
+
+  /**
+   * Checks if current user is the Sitevision Validator.
+   *
+   * <p>
+   *    The <em>Validator user</em> has read permission on all resources and visits/renders pages in order to validate them.
+   * </p>
+   *
+   * <p>
+   * <em>Note! This method does NOT produce a reliable result if called during the authentication process
+   * (i.e. from a JAAS filter or JAAS module) since it relies on a fully loaded current user (as of
+   * {@link senselogic.sitevision.api.context.PortletContextUtil#getCurrentUser()}).</em>
+   * </p>
+   * @return <code>true</code> if current user is the Sitevision Validator, <code>false</code> otherwise
+   * @since Sitevision 4.2.3
+   */
+  isValidator(): boolean;
+
+  /**
+   * Checks if a user node is the Sitevision Validator.
+   *
+   * <p>
+   *    The <em>Validator user</em> has read permission on all resources and visits/renders pages in order to validate them.
+   * </p>
+   * @param aUserNode a user node
+   * @return <code>true</code> if <code>aUserNode</code> is the Sitevision Validator, <code>false</code> otherwise (i.e. no match or <code>aUserNode</code> is <code>null</code>)
+   * @since Sitevision 4.2.3
+   */
+  isValidator(aUserNode: Node): boolean;
+
+  /**
+   * Checks if current user is the Sitevision Extractor.
+   *
+   * <p>
+   *    The <em>Extractor user</em> has read permission on all resources and renders pages in order to store their
+   *    content as static html pages.
+   * </p>
+   *
+   * <p>
+   * <em>Note! This method does NOT produce a reliable result if called during the authentication process
+   * (i.e. from a JAAS filter or JAAS module) since it relies on a fully loaded current user (as of
+   * {@link senselogic.sitevision.api.context.PortletContextUtil#getCurrentUser()}).</em>
+   * </p>
+   * @return <code>true</code> if current user is the Sitevision Extractor, <code>false</code> otherwise
+   */
+  isExtractor(): boolean;
+
+  /**
+   * Checks if a user node is the Sitevision Extractor.
+   *
+   * <p>
+   *    The <em>Extractor user</em> has read permission on all resources and renders pages in order to store their
+   *    content as static html pages.
+   * </p>
+   * @param aUserNode a user node
+   * @return <code>true</code> if <code>aUserNode</code> is the Sitevision Extractor, <code>false</code> otherwise (i.e. no match or <code>aUserNode</code> is <code>null</code>)
+   */
+  isExtractor(aUserNode: Node): boolean;
+}