@sitevision/api 2023.2.1 → 2023.2.2-beta.2

package/server/ImageRenderer/index.js

@@ -44,6 +44,12 @@ var _default = {
   setLazyLoad: function setLazyLoad() {},
   forceUseLazyLoad: function forceUseLazyLoad() {},
   clearUseLazyLoad: function clearUseLazyLoad() {},
+  addDataAttribute: function addDataAttribute() {},
+  clearDataAttributes: function clearDataAttributes() {},
+  addAriaAttribute: function addAriaAttribute() {},
+  clearAriaAttributes: function clearAriaAttributes() {},
+  addCssClass: function addCssClass() {},
+  clearCssClasses: function clearCssClasses() {},
   render: function render() {}
 };
 exports["default"] = _default;

package/server/ImageUtil/index.d.ts

@@ -1,148 +1,155 @@
 import type { Node } from "../../types/javax/jcr/Node";
+import type { Map } from "../../types/java/util/Map";
+
+import type { String } from "../../types/java/lang/String";
 
 /**
  * Image utility interface that handles nodes with primary node type <code>sv:image</code>.
  *
- * <p>
- *    <em>Note!</em> This interface is used to <em>create</em> images. You would typically use
- *    {@link senselogic.sitevision.api.webresource.structure.StructureUtil} to <em>move</em> an image
- *    and {@link senselogic.sitevision.api.webresource.structure.TrashcanUtil} to <em>delete</em> an image.
- *    To <em>render</em> images, you would typically use {@link senselogic.sitevision.api.render.ImageRenderer}
- *    or {@link senselogic.sitevision.api.render.ImageLinkRenderer}.
- * </p>
+ *  <p>
+ *     <em>Note!</em> This interface is used to <em>create</em> images. You would typically use
+ *     {@link senselogic.sitevision.api.webresource.structure.StructureUtil} to <em>move</em> an image
+ *     and {@link senselogic.sitevision.api.webresource.structure.TrashcanUtil} to <em>delete</em> an image.
+ *     To <em>render</em> images, you would typically use {@link senselogic.sitevision.api.render.ImageRenderer}
+ *     or {@link senselogic.sitevision.api.render.ImageLinkRenderer}.
+ *  </p>
  *
- * <p>
- *    An instance of the Sitevision class implementing this interface can be obtained via {@link senselogic.sitevision.api.Utils#getImageUtil()}.
- *    See {@link senselogic.sitevision.api.Utils} for how to obtain an instance of the <code>Utils</code> interface.
- * </p>
+ *  <p>
+ *     An instance of the Sitevision class implementing this interface can be obtained via {@link senselogic.sitevision.api.Utils#getImageUtil()}.
+ *     See {@link senselogic.sitevision.api.Utils} for how to obtain an instance of the <code>Utils</code> interface.
+ *  </p>
  * @author Mikael Wikblom
  * @since Sitevision 2.6.2
  */
 export interface ImageUtil {
   /**
    * <p>
-   *    Adds several images to a <code>sv:localImageRepository</code>, <code>sv:imageRepository</code>, <code>sv:personalImageRepository</code>
-   *    or a <code>sv:folder</code> residing as sub node to an image repository.
-   *    If an other parent node is specified a <code>ConstraintViolationException</code> is thrown.
-   *    The images map keys correspond to the file names (will correspond to the property fileName of the sv:image nodes)
-   *    and the values to URIs pointing to the file resources.
-   * </p>
+   *     Adds several images to a <code>sv:localImageRepository</code>, <code>sv:imageRepository</code>, <code>sv:personalImageRepository</code>
+   *     or a <code>sv:folder</code> residing as sub node to an image repository.
+   *     If an other parent node is specified a <code>ConstraintViolationException</code> is thrown.
+   *     The images map keys correspond to the file names (will correspond to the property fileName of the sv:image nodes)
+   *     and the values to URIs pointing to the file resources.
+   *  </p>
    *
-   * <p>
-   *    Note that the images must have an image mime-type to be created.
-   * </p>
+   *  <p>
+   *     Note that the images must have an image mime-type to be created.
+   *  </p>
    *
-   * <p>
-   *    <strong>URI note!</strong> The resource must be accessible from the Sitevision server! Sitevision opens
-   *    a stream to an URL with the <code>aUri</code> value when creating the binary content of the image.
-   *    If a firewall or such blocks outgoing communication from the server - image creation will fail.
-   * </p>
+   *  <p>
+   *     <strong>URI note!</strong> The resource must be accessible from the Sitevision server! Sitevision opens
+   *     a stream to an URL with the <code>aUri</code> value when creating the binary content of the image.
+   *     If a firewall or such blocks outgoing communication from the server - image creation will fail.
+   *  </p>
    *
-   * <p>
-   *    <strong>Permission note!</strong> Current user (the invoker of this method) must have WRITE permission
-   *    on the parent node (see {@link senselogic.sitevision.api.security.PermissionUtil.Permission#WRITE})
-   *    or a <code>ConstraintViolationException</code> is thrown.
-   *    <em>Creating an image for a <code>sv:userIdentity</code> requires
-   *    {@link senselogic.sitevision.api.security.PermissionUtil.Permission#MANAGE_USER_IDENTITIES} on current page.</em>
-   * </p>
+   *  <p>
+   *     <strong>Permission note!</strong> Current user (the invoker of this method) must have WRITE permission
+   *     on the parent node (see {@link senselogic.sitevision.api.security.PermissionUtil.Permission#WRITE})
+   *     or a <code>ConstraintViolationException</code> is thrown.
+   *     <em>Creating an image for a <code>sv:userIdentity</code> requires
+   *     {@link senselogic.sitevision.api.security.PermissionUtil.Permission#MANAGE_USER_IDENTITIES} on current page.</em>
+   *  </p>
    * @param aParent the parent node for the images. May not be <code>null</code>
    * @param aImages a map of file name to URI pairs May not be <code>null</code>
-   * @throws ConstraintViolationException if the user is not authorized to alter the parent node, if an invalid parent node is specified or if image exceeds file size limit
+   * @throws ConstraintViolationException if the user is not authorized to alter the parent node, if an invalid&#xA; parent node is specified or if image exceeds file size limit
    * @throws RepositoryException if something else goes wrong
    */
-  createImages(aParent: Node, aImages: unknown): void;
+  createImages(aParent: Node, aImages: Map | {}): void;
 
   /**
    * Creates an image using a uri string.
    *
-   * <p>
-   *    Note that the <code>aParent</code> of the file must be a <code>sv:localImageRepository</code>, <code>sv:imageRepository</code>,
-   *    <code>sv:personalImageRepository</code> or a <code>sv:folder</code> residing as sub node to an image repository.
-   * </p>
-   * <p>
-   *    The file must have an image mime-type or an <code>IllegalArgumentException</code> is thrown.
-   * </p>
+   *  <p>
+   *     Note that the <code>aParent</code> of the file must be a <code>sv:localImageRepository</code>, <code>sv:imageRepository</code>,
+   *     <code>sv:personalImageRepository</code> or a <code>sv:folder</code> residing as sub node to an image repository.
+   *  </p>
+   *  <p>
+   *     The file must have an image mime-type or an <code>IllegalArgumentException</code> is thrown.
+   *  </p>
    *
-   * <p>
-   *    <strong>URI note!</strong> The resource must be accessible from the Sitevision server! Sitevision opens
-   *    a stream to an URL with the <code>aUri</code> value when creating the binary content of the image.
-   *    If a firewall or such blocks outgoing communication from the server - image creation will fail.
-   * </p>
+   *  <p>
+   *     <strong>URI note!</strong> The resource must be accessible from the Sitevision server! Sitevision opens
+   *     a stream to an URL with the <code>aUri</code> value when creating the binary content of the image.
+   *     If a firewall or such blocks outgoing communication from the server - image creation will fail.
+   *  </p>
    *
-   * <p>
-   *    <strong>Permission note!</strong> Current user (the invoker of this method) must have WRITE permission
-   *    on the parent node (see {@link senselogic.sitevision.api.security.PermissionUtil.Permission#WRITE})
-   *    or a <code>ConstraintViolationException</code> is thrown.
-   *    <em>Creating an image for a <code>sv:userIdentity</code> requires
-   *    {@link senselogic.sitevision.api.security.PermissionUtil.Permission#MANAGE_USER_IDENTITIES} on current page.</em>
-   * </p>
+   *  <p>
+   *     <strong>Permission note!</strong> Current user (the invoker of this method) must have WRITE permission
+   *     on the parent node (see {@link senselogic.sitevision.api.security.PermissionUtil.Permission#WRITE})
+   *     or a <code>ConstraintViolationException</code> is thrown.
+   *     <em>Creating an image for a <code>sv:userIdentity</code> requires
+   *     {@link senselogic.sitevision.api.security.PermissionUtil.Permission#MANAGE_USER_IDENTITIES} on current page.</em>
+   *  </p>
    * @param aParent the parent node of the image. May not be <code>null</code>
    * @param aFileName the fileName property of the sv:image. May not be <code>null</code>
    * @param aUri the URI pointing to the file resource. May not be <code>null</code>
    * @return a sv:image node corresponding to the newly created image. Will never return <code>null</code>
-   * @throws ConstraintViolationException if the user is not authorized to alter the parent node, if an invalid parent node is specified or if image exceeds file size limit
+   * @throws ConstraintViolationException if the user is not authorized to alter the parent node, if an invalid&#xA; parent node is specified or if image exceeds file size limit
    * @throws RepositoryException if something else goes wrong
    */
-  createImage(aParent: Node, aFileName: string, aUri: string): Node;
+  createImage(
+    aParent: Node,
+    aFileName: String | string,
+    aUri: String | string
+  ): Node;
 
   /**
    * Creates an image using a base64 string.
    *
-   * <p>
-   *    The base64 decoder uses "The Base64 Alphabet" as specified in Table 1 of RFC 4648 and RFC 2045 for decoding operation.
-   *    The decoder rejects data that contains characters outside the base64 alphabet.
-   * </p>
-   * <p>
-   *    Note that the <code>aParent</code> of the file must be a <code>sv:localImageRepository</code>, <code>sv:imageRepository</code>,
-   *    <code>sv:personalImageRepository</code> or a <code>sv:folder</code> residing as sub node to an image repository.
-   * </p>
-   * <p>
-   *    The file name must correspond to an image mime-type or an <code>IllegalArgumentException</code> is thrown.
-   * </p>
+   *  <p>
+   *     The base64 decoder uses "The Base64 Alphabet" as specified in Table 1 of RFC 4648 and RFC 2045 for decoding operation.
+   *     The decoder rejects data that contains characters outside the base64 alphabet.
+   *  </p>
+   *  <p>
+   *     Note that the <code>aParent</code> of the file must be a <code>sv:localImageRepository</code>, <code>sv:imageRepository</code>,
+   *     <code>sv:personalImageRepository</code> or a <code>sv:folder</code> residing as sub node to an image repository.
+   *  </p>
+   *  <p>
+   *     The file name must correspond to an image mime-type or an <code>IllegalArgumentException</code> is thrown.
+   *  </p>
    *
-   * <p>
-   *    <strong>Permission note!</strong> Current user (the invoker of this method) must have WRITE permission
-   *    on the parent node (see {@link senselogic.sitevision.api.security.PermissionUtil.Permission#WRITE})
-   *    or a <code>ConstraintViolationException</code> is thrown.
-   *    <em>Creating an image for a <code>sv:userIdentity</code> requires
-   *    {@link senselogic.sitevision.api.security.PermissionUtil.Permission#MANAGE_USER_IDENTITIES} on current page.</em>
-   * </p>
+   *  <p>
+   *     <strong>Permission note!</strong> Current user (the invoker of this method) must have WRITE permission
+   *     on the parent node (see {@link senselogic.sitevision.api.security.PermissionUtil.Permission#WRITE})
+   *     or a <code>ConstraintViolationException</code> is thrown.
+   *     <em>Creating an image for a <code>sv:userIdentity</code> requires
+   *     {@link senselogic.sitevision.api.security.PermissionUtil.Permission#MANAGE_USER_IDENTITIES} on current page.</em>
+   *  </p>
    * @param aParent the parent node of the image. May not be <code>null</code>
    * @param aFileName the fileName property of the sv:image. May not be <code>null</code>
    * @param aBase64EncodedString a base64 encoded string. May not be <code>null</code>
    * @return a sv:image node corresponding to the newly created image. Will never return <code>null</code>
-   * @throws ConstraintViolationException if the user is not authorized to alter the parent node, if an invalid parent node is specified, if <code>aBase64EncodedString</code> is not base64 encoded or if image exceeds file size limit
+   * @throws ConstraintViolationException if the user is not authorized to alter the parent node, if an invalid&#xA; parent node is specified, if <code>aBase64EncodedString</code> is not base64 encoded or if image exceeds file size limit
    * @throws RepositoryException if something else goes wrong
    * @since Sitevision 4.5.4
    */
   createImageFromBase64(
     aParent: Node,
-    aFileName: string,
-    aBase64EncodedString: string
+    aFileName: String | string,
+    aBase64EncodedString: String | string
   ): Node;
 
   /**
    * Creates an image using a sv:temporaryFile.
    *
-   * <p>
-   *    Note that the <code>aParent</code> of the file must be a <code>sv:localImageRepository</code>, <code>sv:imageRepository</code>,
-   *    <code>sv:personalImageRepository</code> or a <code>sv:folder</code> residing as sub node to an image repository.
-   * </p>
-   * <p>
-   *    The file name must correspond to an image mime-type or an <code>IllegalArgumentException</code> is thrown.
-   * </p>
+   *  <p>
+   *     Note that the <code>aParent</code> of the file must be a <code>sv:localImageRepository</code>, <code>sv:imageRepository</code>,
+   *     <code>sv:personalImageRepository</code> or a <code>sv:folder</code> residing as sub node to an image repository.
+   *  </p>
+   *  <p>
+   *     The file name must correspond to an image mime-type or an <code>IllegalArgumentException</code> is thrown.
+   *  </p>
    *
-   * <p>
-   *    <strong>Permission note!</strong> Current user (the invoker of this method) must have WRITE permission
-   *    on the parent node (see {@link senselogic.sitevision.api.security.PermissionUtil.Permission#WRITE})
-   *    or a <code>ConstraintViolationException</code> is thrown.
-   *    <em>Creating an image for a <code>sv:userIdentity</code> requires
-   *    {@link senselogic.sitevision.api.security.PermissionUtil.Permission#MANAGE_USER_IDENTITIES} on current page.</em>
-   * </p>
+   *  <p>
+   *     <strong>Permission note!</strong> Current user (the invoker of this method) must have WRITE permission
+   *     on the parent node (see {@link senselogic.sitevision.api.security.PermissionUtil.Permission#WRITE})
+   *     or a <code>ConstraintViolationException</code> is thrown.
+   *     <em>Creating an image for a <code>sv:userIdentity</code> requires
+   *     {@link senselogic.sitevision.api.security.PermissionUtil.Permission#MANAGE_USER_IDENTITIES} on current page.</em>
+   *  </p>
    * @param aParent the parent node of the image
    * @param aTemporaryFile a sv:temporaryFile (typically created via {@link senselogic.sitevision.api.node.builder.TemporaryFileNodeBuilder})
    * @return a sv:image node corresponding to the newly created image. Will never return <code>null</code>
-   * @throws ConstraintViolationException if the user is not authorized to alter the parent node, if an invalid parent node is specified, if an invalid temporary node is specified or if image exceeds file size limit
+   * @throws ConstraintViolationException if the user is not authorized to alter the parent node, if an invalid&#xA; parent node is specified, if an invalid temporary node is specified or if image exceeds file size limit
    * @throws RepositoryException if something else goes wrong
    * @since Sitevision 4.5.4
    */
@@ -151,72 +158,72 @@ export interface ImageUtil {
   /**
    * Updates the binary content of an existing image using a uri string.
    *
-   * <p>
-   *    Properties related to the binary content will also be updated (e.g. <code>length</code>, <code>width</code> and <code>height</code>).
-   * </p>
+   *  <p>
+   *     Properties related to the binary content will also be updated (e.g. <code>length</code>, <code>width</code> and <code>height</code>).
+   *  </p>
    *
-   * <p>
-   *    <strong>URI note!</strong> The URI must be accessible from the Sitevision server and the ending part
-   *    of the URI must match the file extension of the existing image that should be updated!
-   * </p>
-   * <p>
-   *    <strong>Permission note!</strong> Current user (the invoker of this method) must have WRITE permission
-   *    on the image node that should be updated (see {@link senselogic.sitevision.api.security.PermissionUtil.Permission#WRITE}).
-   *    <em>Updating an image for a <code>sv:userIdentity</code> requires
-   *    {@link senselogic.sitevision.api.security.PermissionUtil.Permission#MANAGE_USER_IDENTITIES} on current page.</em>
-   * </p>
+   *  <p>
+   *     <strong>URI note!</strong> The URI must be accessible from the Sitevision server and the ending part
+   *     of the URI must match the file extension of the existing image that should be updated!
+   *  </p>
+   *  <p>
+   *     <strong>Permission note!</strong> Current user (the invoker of this method) must have WRITE permission
+   *     on the image node that should be updated (see {@link senselogic.sitevision.api.security.PermissionUtil.Permission#WRITE}).
+   *     <em>Updating an image for a <code>sv:userIdentity</code> requires
+   *     {@link senselogic.sitevision.api.security.PermissionUtil.Permission#MANAGE_USER_IDENTITIES} on current page.</em>
+   *  </p>
    * @param aImage the image. May not be <code>null</code>
    * @param aUri the URI pointing to the file resource to fetch new binary content from. May not be <code>null</code>
-   * @throws ConstraintViolationException if the user is not authorized to alter the image node, if an invalid node is specified, if the end part of <code>aUri</code> doesn't match the file extension of <code>aImage</code> or if image exceeds file size limit
+   * @throws ConstraintViolationException if the user is not authorized to alter the image node,&#xA; if an invalid node is specified, if the end part of <code>aUri</code> doesn't match the file extension&#xA; of <code>aImage</code> or if image exceeds file size limit
    * @throws RepositoryException if something else goes wrong
    * @since Sitevision 3.6.3
    */
-  updateBinaryContent(aImage: Node, aUri: string): void;
+  updateBinaryContent(aImage: Node, aUri: String | string): void;
 
   /**
    * Updates the binary content of an existing image using a base64 string.
    *
-   * <p>
-   *    The base64 decoder uses "The Base64 Alphabet" as specified in Table 1 of RFC 4648 and RFC 2045 for decoding operation.
-   *    The decoder rejects data that contains characters outside the base64 alphabet.
-   * </p>
-   * <p>
-   *    Properties related to the binary content will also be updated (e.g. <code>length</code>, <code>width</code> and <code>height</code>).
-   * </p>
+   *  <p>
+   *     The base64 decoder uses "The Base64 Alphabet" as specified in Table 1 of RFC 4648 and RFC 2045 for decoding operation.
+   *     The decoder rejects data that contains characters outside the base64 alphabet.
+   *  </p>
+   *  <p>
+   *     Properties related to the binary content will also be updated (e.g. <code>length</code>, <code>width</code> and <code>height</code>).
+   *  </p>
    *
-   * <p>
-   *    <strong>Permission note!</strong> Current user (the invoker of this method) must have WRITE permission
-   *    on the image node that should be updated (see {@link senselogic.sitevision.api.security.PermissionUtil.Permission#WRITE}).
-   *    <em>Updating an image for a <code>sv:userIdentity</code> requires
-   *    {@link senselogic.sitevision.api.security.PermissionUtil.Permission#MANAGE_USER_IDENTITIES} on current page.</em>
-   * </p>
+   *  <p>
+   *     <strong>Permission note!</strong> Current user (the invoker of this method) must have WRITE permission
+   *     on the image node that should be updated (see {@link senselogic.sitevision.api.security.PermissionUtil.Permission#WRITE}).
+   *     <em>Updating an image for a <code>sv:userIdentity</code> requires
+   *     {@link senselogic.sitevision.api.security.PermissionUtil.Permission#MANAGE_USER_IDENTITIES} on current page.</em>
+   *  </p>
    * @param aImage the image. May not be <code>null</code>
    * @param aBase64EncodedString a base64 encoded string. May not be <code>null</code>
-   * @throws ConstraintViolationException if the user is not authorized to alter the image node, if an invalid node is specified, if <code>aBase64EncodedString</code> is not base64 encoded or if image exceeds file size limit
+   * @throws ConstraintViolationException if the user is not authorized to alter the image node,&#xA; if an invalid node is specified, if <code>aBase64EncodedString</code> is not base64 encoded or if image exceeds file size limit
    * @throws RepositoryException if something else goes wrong
    * @since Sitevision 4.5.4
    */
   updateBinaryContentFromBase64(
     aImage: Node,
-    aBase64EncodedString: string
+    aBase64EncodedString: String | string
   ): void;
 
   /**
    * Updates the binary content of an existing image using a sv:temporaryFile.
    *
-   * <p>
-   *    Properties related to the binary content will also be updated (e.g. <code>length</code>, <code>width</code> and <code>height</code>).
-   * </p>
+   *  <p>
+   *     Properties related to the binary content will also be updated (e.g. <code>length</code>, <code>width</code> and <code>height</code>).
+   *  </p>
    *
-   * <p>
-   *    <strong>Permission note!</strong> Current user (the invoker of this method) must have WRITE permission
-   *    on the image node that should be updated (see {@link senselogic.sitevision.api.security.PermissionUtil.Permission#WRITE}).
-   *    <em>Updating an image for a <code>sv:userIdentity</code> requires
-   *    {@link senselogic.sitevision.api.security.PermissionUtil.Permission#MANAGE_USER_IDENTITIES} on current page.</em>
-   * </p>
+   *  <p>
+   *     <strong>Permission note!</strong> Current user (the invoker of this method) must have WRITE permission
+   *     on the image node that should be updated (see {@link senselogic.sitevision.api.security.PermissionUtil.Permission#WRITE}).
+   *     <em>Updating an image for a <code>sv:userIdentity</code> requires
+   *     {@link senselogic.sitevision.api.security.PermissionUtil.Permission#MANAGE_USER_IDENTITIES} on current page.</em>
+   *  </p>
    * @param aImage the image. May not be <code>null</code>
    * @param aTemporaryFile the sv:temporaryFile (typically created via {@link senselogic.sitevision.api.node.builder.TemporaryFileNodeBuilder})
-   * @throws ConstraintViolationException if the user is not authorized to alter the image node, if an invalid node is specified, if the end part of the file represented by <code>aTemporaryFile</code> doesn't match the file extension of <code>aImage</code> or if image exceeds file size limit
+   * @throws ConstraintViolationException if the user is not authorized to alter the image node,&#xA; if an invalid node is specified, if the end part of the file represented by <code>aTemporaryFile</code> doesn't match the file extension&#xA; of <code>aImage</code> or if image exceeds file size limit
    * @throws RepositoryException if something else goes wrong
    * @since Sitevision 4.5.4
    */
@@ -225,33 +232,33 @@ export interface ImageUtil {
   /**
    * Alters the name of an image.
    *
-   * <p>
-   *    If no image is specified a <code>NullPointerException</code> is thrown.
-   *    If the node is not a sv:image an <code>IllegalArgumentException</code> is thrown.
-   *    If no name is provided a <code>NullPointerException</code> is thrown.
-   * </p>
+   *  <p>
+   *     If no image is specified a <code>NullPointerException</code> is thrown.
+   *     If the node is not a sv:image an <code>IllegalArgumentException</code> is thrown.
+   *     If no name is provided a <code>NullPointerException</code> is thrown.
+   *  </p>
    *
-   * <p>
-   *    <strong>Permission note!</strong> Current user (the invoker of this method) must have WRITE permission
-   *    on the image node that should be updated (see {@link senselogic.sitevision.api.security.PermissionUtil.Permission#WRITE}).
-   *    <em>Updating an image for a <code>sv:userIdentity</code> requires
-   *    {@link senselogic.sitevision.api.security.PermissionUtil.Permission#MANAGE_USER_IDENTITIES} on current page.</em>
-   * </p>
+   *  <p>
+   *     <strong>Permission note!</strong> Current user (the invoker of this method) must have WRITE permission
+   *     on the image node that should be updated (see {@link senselogic.sitevision.api.security.PermissionUtil.Permission#WRITE}).
+   *     <em>Updating an image for a <code>sv:userIdentity</code> requires
+   *     {@link senselogic.sitevision.api.security.PermissionUtil.Permission#MANAGE_USER_IDENTITIES} on current page.</em>
+   *  </p>
    * @param aImage the sv:image that should be renamed. May not be <code>null</code>
    * @param aName the new name of the image. May not be <code>null</code>
-   * @throws ConstraintViolationException if the current user is not authorized to alter the name of the image or if the image extension doesn't match
+   * @throws ConstraintViolationException if the current user is not authorized to alter the name of the image&#xA; or if the image extension doesn't match
    * @throws RepositoryException if something else goes wrong
    * @since Sitevision 4.5.2
    */
-  renameImage(aImage: Node, aName: string): void;
+  renameImage(aImage: Node, aName: String | string): void;
 
   /**
    * The Base64 String representation of an image Node.
    *
-   * <p>
-   *    Reads the binary content of an image and encodes the bytes using
-   *    {@link senselogic.sitevision.api.text.EndecUtil#base64encodeToString(byte[])}.
-   * </p>
+   *  <p>
+   *     Reads the binary content of an image and encodes the bytes using
+   *     {@link senselogic.sitevision.api.text.EndecUtil#base64encodeToString(byte[])}.
+   *  </p>
    * @param aImage the image Node (sv:image or sv:temporaryFile), may not be null
    * @return aImage as base64-encoded String
    * @throws ConstraintViolationException if aImage is not a sv:image or sv:temporaryFile

package/server/IndexUtil/index.d.ts

@@ -1,14 +1,15 @@
 import type IndexType from "../IndexUtil.IndexType";
 import type { Node } from "../../types/javax/jcr/Node";
+import type { String } from "../../types/java/lang/String";
 
 /**
  * Index utility interface.
  *
- * <p>
- *    An instance of the Sitevision class implementing this interface can be obtained via
- *    {@link senselogic.sitevision.api.search.SearchFactory#getIndexUtil()}.
- *    See {@link senselogic.sitevision.api.search.SearchFactory} for how to obtain an instance of the <code>SearchFactory</code> interface.
- * </p>
+ *  <p>
+ *     An instance of the Sitevision class implementing this interface can be obtained via
+ *     {@link senselogic.sitevision.api.search.SearchFactory#getIndexUtil()}.
+ *     See {@link senselogic.sitevision.api.search.SearchFactory} for how to obtain an instance of the <code>SearchFactory</code> interface.
+ *  </p>
  * @author Magnus Lövgren
  * @since Sitevision 3.6
  */
@@ -16,10 +17,10 @@ export interface IndexUtil {
   /**
    * Gets the default index for a specified index type.
    *
-   * <p>
-   *    <strong>Note!</strong>The default user identity index is only handled if a <em>Social Collaboration</em> license is in use.
-   *    The default user-generated content (UGC) index is only handled if a <em>Social Collaboration</em> license is in use.
-   * </p>
+   *  <p>
+   *     <strong>Note!</strong>The default user identity index is only handled if a <em>Social Collaboration</em> license is in use.
+   *     The default user-generated content (UGC) index is only handled if a <em>Social Collaboration</em> license is in use.
+   *  </p>
    * @param aIndexType type of index
    * @return the default index for <code>aIndexType</code>, or <code>null</code> if not available
    */
@@ -28,23 +29,23 @@ export interface IndexUtil {
   /**
    * Gets an index by name.
    *
-   * <p>
-   *    Lookup order:
-   * </p>
-   * <ol>
-   *    <li>Custom <em>site</em> index</li>
-   *    <li>Custom <em>server</em> index</li>
-   *    <li><em>Default</em> index(-es), types specified by {@link senselogic.sitevision.api.search.index.IndexUtil.IndexType}</li>
-   * </ol>
-   * <p>
-   *    <strong>Note!</strong> Custom index is only handled if a <em>Search Package 2</em> license is in use.
-   *    The default user identity index is only handled if a <em>Social Collaboration</em> license is in use.
-   *    The default user-generated content (UGC) index is only handled if a <em>Social Collaboration</em> license is in use.
-   * </p>
+   *  <p>
+   *     Lookup order:
+   *  </p>
+   *  <ol>
+   *     <li>Custom <em>site</em> index</li>
+   *     <li>Custom <em>server</em> index</li>
+   *     <li><em>Default</em> index(-es), types specified by {@link senselogic.sitevision.api.search.index.IndexUtil.IndexType}</li>
+   *  </ol>
+   *  <p>
+   *     <strong>Note!</strong> Custom index is only handled if a <em>Search Package 2</em> license is in use.
+   *     The default user identity index is only handled if a <em>Social Collaboration</em> license is in use.
+   *     The default user-generated content (UGC) index is only handled if a <em>Social Collaboration</em> license is in use.
+   *  </p>
    * @param aIndexName the name of the index
    * @return the index or <code>null</code> if no index matches <code>aIndexName</code>
    */
-  getIndexByName(aIndexName: string): Node;
+  getIndexByName(aIndexName: String | string): Node;
 }
 
 declare namespace IndexUtil {}

package/server/IndexUtil.IndexType/index.d.ts

@@ -1,21 +1,21 @@
 /**
  * Type of default index, used by {@link senselogic.sitevision.api.search.index.IndexUtil}.
  *
- * <p>
- *    Example of how to get the {@link #USER_IDENTITY} type:
- * </p>
- * <ul>
- *    <li>
- *       Using <strong>Velocity:</strong><pre><code>
- *       #set ($instanceCreatorUtil = $sitevisionUtils.instanceCreatorUtil)
- *       #set ($enumClassName = 'senselogic.sitevision.api.search.index.IndexUtil$IndexType') <em>## Note the '$' separator...</em>
- *       #set ($userIdentityEnum = $instanceCreatorUtil.getEnumInstance($enumClassName, 'USER_IDENTITY'))</code></pre>
- *    </li>
- *    <li>
- *       Using server-side <strong>JavaScript:</strong><pre><code>
- *       var userIdentityEnum = require('IndexUtil.IndexType.USER_IDENTITY');</code></pre>
- *    </li>
- * </ul>
+ *  <p>
+ *     Example of how to get the {@link #USER_IDENTITY} type:
+ *  </p>
+ *  <ul>
+ *     <li>
+ *        Using <strong>Velocity:</strong><pre><code>
+ *        #set ($instanceCreatorUtil = $sitevisionUtils.instanceCreatorUtil)
+ *        #set ($enumClassName = 'senselogic.sitevision.api.search.index.IndexUtil$IndexType') <em>## Note the '$' separator...</em>
+ *        #set ($userIdentityEnum = $instanceCreatorUtil.getEnumInstance($enumClassName, 'USER_IDENTITY'))</code></pre>
+ *     </li>
+ *     <li>
+ *        Using server-side <strong>JavaScript:</strong><pre><code>
+ *        var userIdentityEnum = require('IndexUtil.IndexType.USER_IDENTITY');</code></pre>
+ *     </li>
+ *  </ul>
  * @author Magnus Lövgren
  * @since Sitevision 3.6
  */

package/server/IndexUtil.IndexType/index.js

@@ -5,9 +5,9 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports["default"] = void 0;
 var _default = {
-  NODE: 'NODE',
-  USER_IDENTITY: 'USER_IDENTITY',
-  USER: 'USER',
-  UGC: 'UGC'
+  NODE: "NODE",
+  USER_IDENTITY: "USER_IDENTITY",
+  USER: "USER",
+  UGC: "UGC"
 };
 exports["default"] = _default;