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

package/hidden/senselogic/sitevision/api/webresource/FileUtil/index.d.ts

@@ -0,0 +1,294 @@
+import Node from "../../../../../javax/jcr/Node";
+
+/**
+ * File utility interface that handles nodes with primary node type <code>sv:file</code> and <code>sv:temporaryFile</code>.
+ *
+ * <p>
+ *    <em>Note!</em> This interface is used to <em>create</em> files. You would typically use
+ *    {@link senselogic.sitevision.api.webresource.structure.StructureUtil} to <em>move</em> a file
+ *    and {@link senselogic.sitevision.api.webresource.structure.TrashcanUtil} to <em>delete</em> a file.
+ *    To check <em>MIME/Content-Type</em> for a file you would typically use {@link senselogic.sitevision.api.webresource.mime.MimeTypeUtil}.
+ * </p>
+ *
+ * <p>
+ *    An instance of the Sitevision class implementing this interface can be obtained via {@link senselogic.sitevision.api.Utils#getFileUtil()}.
+ *    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
+ */
+
+interface FileUtil {
+  /**
+   * <p>
+   *    Adds several files to a sv:localFileRepository, sv:fileRepository, sv:personalFileRepository or a sv:folder
+   *    residing as sub node to a file repository.
+   * </p>
+   * <p>
+   *    Files are specified by a map where the keys denotes the file names (will correspond to the property fileName
+   *    of the sv:file nodes) and the values denotes the URIs pointing to the file resources. The file resources
+   *    (i.e. the URIs) must be accessible from the Sitevision server. Sitevision opens a stream with the URI value
+   *    when creating/uploading the binary content of the file. If a firewall or such blocks outgoing communication
+   *    from the server - file creation will fail.
+   * </p>
+   * <p>
+   *    <strong>Permission note!</strong> Current user must be authorized to alter the parent node
+   *    (e.g. {@link senselogic.sitevision.api.security.PermissionUtil.Permission#WRITE}).
+   * </p>
+   * <p>
+   *    A warning will be written to the system log if Sitevision for any reason is unable to create one of the files.
+   * </p>
+   * @param aParent the parent node for the files
+   * @param aFileMappings a map of file name to URI pairs
+   * @throws java.lang.NullPointerException if <code>aParent</code> or <code>aFileMappings</code> is <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 file exceeds file size limit
+   * @throws RepositoryException if something else goes wrong
+   */
+  createFiles(aParent: Node, aFileMappings: java.util.Map): void;
+
+  /**
+   * Creates a file using a uri string.
+   *
+   * <p>
+   *    Note that the <code>aParent</code> of the file must be a <code>sv:localFileRepository</code>, <code>sv:fileRepository</code>,
+   *    <code>sv:personalFileRepository</code> or a <code>sv:folder</code> residing as sub node to a file repository.
+   * </p>
+   * <p>
+   *    <strong>Permission note!</strong> Current user must be authorized to alter the parent node
+   *    (e.g. {@link senselogic.sitevision.api.security.PermissionUtil.Permission#WRITE}).
+   * </p>
+   * <p>
+   *    <strong>URI note!</strong> The file resource must be accessible from the Sitevision server! Sitevision opens
+   *    a stream to an URL with the <code>aUri</code> value when creating/uploading the binary content of the file.
+   *    If a firewall or such blocks outgoing communication from the server - file creation will fail.
+   * </p>
+   * @param aParent the parent node of the file
+   * @param aFileName the filename
+   * @param aUri the URI pointing to the file resource retrievable from the Sitevision server
+   * @return a sv:file node corresponding to the newly created file. Will never return <code>null</code>
+   * @throws java.lang.NullPointerException if <code>aParent</code>, <code>aFileName</code> or <code>aUri</code> is <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 file exceeds file size limit
+   * @throws RepositoryException if something else goes wrong
+   */
+  createFile(
+    aParent: Node,
+    aFileName: java.lang.String,
+    aUri: java.lang.String
+  ): Node;
+
+  /**
+   * Creates a file 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:localFileRepository</code>, <code>sv:fileRepository</code>,
+   *    <code>sv:personalFileRepository</code> or a <code>sv:folder</code> residing as sub node to a file repository.
+   * </p>
+   * <p>
+   *    <strong>Permission note!</strong> Current user must be authorized to alter the parent node
+   *    (e.g. {@link senselogic.sitevision.api.security.PermissionUtil.Permission#WRITE}).
+   * </p>
+   * @param aParent the parent node of the file
+   * @param aFileName the filename
+   * @param aBase64EncodedString a base64 encoded string
+   * @return a sv:file node corresponding to the newly created file. Will never return <code>null</code>
+   * @throws java.lang.NullPointerException if <code>aParent</code>, <code>aFileName</code> or <code>aBase64EncodedString</code> is <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 file exceeds file size limit
+   * @throws RepositoryException if something else goes wrong
+   * @since Sitevision 4.5.4
+   */
+  createFileFromBase64(
+    aParent: Node,
+    aFileName: java.lang.String,
+    aBase64EncodedString: java.lang.String
+  ): Node;
+
+  /**
+   * Creates a file using a sv:temporaryFile.
+   *
+   * <p>
+   *    Note that the <code>aParent</code> of the file must be a <code>sv:localFileRepository</code>, <code>sv:fileRepository</code>,
+   *    <code>sv:personalFileRepository</code> or a <code>sv:folder</code> residing as sub node to a file repository.
+   * </p>
+   * <p>
+   *    <strong>Permission note!</strong> Current user must be authorized to alter the parent node
+   *    (e.g. {@link senselogic.sitevision.api.security.PermissionUtil.Permission#WRITE}).
+   * </p>
+   * @param aParent the parent node of the file
+   * @param aTemporaryFile a sv:temporaryFile (typically created via {@link senselogic.sitevision.api.node.builder.TemporaryFileNodeBuilder})
+   * @return a sv:file node corresponding to the newly created file. 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 file exceeds file size limit
+   * @throws RepositoryException if something else goes wrong
+   * @since Sitevision 4.5.4
+   */
+  createFileFromTemporary(aParent: Node, aTemporaryFile: Node): Node;
+
+  /**
+   * Updates the binary content of an existing file using a uri string.
+   *
+   * <p>
+   *    Properties related to the binary content will also be updated (e.g. <code>length</code>). A new version will
+   *    be created if the binary content of a <em>group file</em> is updated.
+   * </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 file that should be updated! Sitevision opens
+   *    a stream to an URL with the <code>anUri</code> value when uploading the binary content of the file.
+   *    If a firewall or such blocks outgoing communication from the server - file update will fail.
+   * </p>
+   * <p>
+   *    <strong>Permission note!</strong> Current user must be authorized to alter the file node that
+   *    should be updated (e.g. {@link senselogic.sitevision.api.security.PermissionUtil.Permission#WRITE}).
+   * </p>
+   * @param aFile the file
+   * @param aUri the URI pointing to the file resource to fetch new binary content from
+   * @throws ConstraintViolationException if the user is not authorized to alter the file node, if an invalid node is specified, if the end part of <code>aUri</code> doesn't match the file extension of <code>aFile</code> or if file exceeds file size limit
+   * @throws RepositoryException if something else goes wrong
+   * @since Sitevision 3.6.3
+   */
+  updateBinaryContent(aFile: Node, aUri: java.lang.String): void;
+
+  /**
+   * Updates the binary content of an existing file 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>). A new version will
+   *    be created if the binary content of a <em>group file</em> is updated.
+   * </p>
+   * <p>
+   *    <strong>Permission note!</strong> Current user must be authorized to alter the file node that
+   *    should be updated (e.g. {@link senselogic.sitevision.api.security.PermissionUtil.Permission#WRITE}).
+   * </p>
+   * @param aFile the file
+   * @param aBase64EncodedString a base64 encoded string
+   * @throws ConstraintViolationException if the user is not authorized to alter the file node, if an invalid node is specified, if <code>aBase64EncodedString</code> is not base64 encoded, if file exceeds file size limit or if file exceeds file size limit
+   * @throws RepositoryException if something else goes wrong
+   * @since Sitevision 4.5.4
+   */
+  updateBinaryContentFromBase64(
+    aFile: Node,
+    aBase64EncodedString: java.lang.String
+  ): void;
+
+  /**
+   * Updates the binary content of an existing file using a sv:temporaryFile.
+   *
+   * <p>
+   *    Properties related to the binary content will also be updated (e.g. <code>length</code>). A new version will
+   *    be created if the binary content of a <em>group file</em> is updated.
+   * </p>
+   * <p>
+   *    <strong>Permission note!</strong> Current user must be authorized to alter the file node that
+   *    should be updated (e.g. {@link senselogic.sitevision.api.security.PermissionUtil.Permission#WRITE}).
+   * </p>
+   * @param aFile the file
+   * @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 file 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>aFile</code> or if file exceeds file size limit
+   * @throws RepositoryException if something else goes wrong
+   * @since Sitevision 4.5.4
+   */
+  updateBinaryContentFromTemporary(aFile: Node, aTemporaryFile: Node): void;
+
+  /**
+   * Gets the contents of a file as a String using the UTF-8 character encoding.
+   *
+   * <p>
+   *    <em>Note! This is mere a convenience method for {@link #getContentAsString(Node, String)} using UTF-8 as character encoding.</em>
+   * </p>
+   * @param aFile the file Node (sv:file or sv:temporaryFile)
+   * @return the UTF-8 file content, or null if aFile isn't a character-based file
+   * @see #getContentAsString(Node, String)
+   * @since Sitevision 4.1.1
+   */
+  getContentAsString(aFile: Node): string;
+
+  /**
+   * Gets the contents of a file as a String using a given character encoding.
+   *
+   * <p>
+   *    <em>Note!</em> This method operates on character-based file nodes only! That is:
+   * </p>
+   * <ul>
+   *    <li>
+   *       Files that are of <em>text type</em> (as of {@link senselogic.sitevision.api.webresource.mime.MimeTypeUtil#isTextType(String)}).
+   *    </li>
+   *    <li>
+   *       Files that are of <em>xml type</em> (as of {@link senselogic.sitevision.api.webresource.mime.MimeTypeUtil#isXmlType(String)}).
+   *    </li>
+   *    <li>
+   *       Common "cross-over/mixed-types" files, such as <em>json</em> (application type) and <em>svg</em> (image type).
+   *    </li>
+   * </ul>
+   * @param aFile the file Node (sv:file or sv:temporaryFile)
+   * @param aCharacterEncoding the character encoding (Note! UTF-8 will be used instead for null, empty and illegal/unsupported encoding)
+   * @return the file content using the specified character encoding, or null if aFile isn't a character-based file
+   * @since Sitevision 4.1.1
+   */
+  getContentAsString(aFile: Node, aCharacterEncoding: java.lang.String): string;
+
+  /**
+   * Alters the name of a file.
+   *
+   * <p>
+   *    If no file is specified a <code>NullPointerException</code> is thrown.
+   *    If the node is not a sv:file 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 file node that should be updated (see {@link senselogic.sitevision.api.security.PermissionUtil.Permission#WRITE}).
+   *    <em>Updating a file for a <code>sv:userIdentity</code> requires
+   *    {@link senselogic.sitevision.api.security.PermissionUtil.Permission#MANAGE_USER_IDENTITIES} on current page.</em>
+   * </p>
+   * @param aFile the sv:file that should be renamed. May not be <code>null</code>
+   * @param aNewName the new name of the file. May not be <code>null</code>
+   * @throws ConstraintViolationException if the current user is not authorized to alter the name of the file or if the file extension doesn't match
+   * @throws RepositoryException if something else goes wrong
+   * @since Sitevision 4.5.2
+   */
+  renameFile(aFile: Node, aNewName: java.lang.String): void;
+
+  /**
+   * Modifies versioning for a file.
+   *
+   * <p>
+   *    <strong>Permission note!</strong> Current user (the invoker of this method) must have WRITE permission
+   *    on the file node that should be updated (see {@link senselogic.sitevision.api.security.PermissionUtil.Permission#WRITE}).
+   * </p>
+   * @param aFile the sv:file. May not be null
+   * @param aVersioned the new state of versioning for this file
+   * @throws ConstraintViolationException if the current user is not authorized to mutate aFile or if aFile is not a sv:file
+   * @throws RepositoryException if something else goes wrong
+   * @since Sitevision 9.1
+   */
+  setVersioned(aFile: Node, aVersioned: boolean): void;
+
+  /**
+   * Modifies download protection for a file.
+   *
+   * <p>
+   *    <strong>Permission note!</strong> Current user (the invoker of this method) must have WRITE permission and MANAGE_DOWNLOAD_PROTECTION
+   *    permission on the file node that should be updated (see {@link senselogic.sitevision.api.security.PermissionUtil.Permission#WRITE}
+   *    and {@link senselogic.sitevision.api.security.PermissionUtil.Permission#MANAGE_DOWNLOAD_PROTECTION}).
+   * </p>
+   *
+   * <p>
+   *    <em>Tip! Use {@link senselogic.sitevision.api.property.PropertyUtil} or {@link senselogic.sitevision.api.property.Properties}
+   *    to check current state, i.e. the "downloadProtected" boolean property.</em>
+   * </p>
+   * @param aFile the sv:file. May not be null
+   * @param aDownloadProtected the new state of download protection for aFile
+   * @throws ConstraintViolationException if the current user is not authorized to mutate aFile or if aFile is not a sv:file
+   * @throws RepositoryException if something else goes wrong
+   * @since Sitevision 2022.08.1
+   */
+  setDownloadProtected(aFile: Node, aDownloadProtected: boolean): void;
+}

package/hidden/senselogic/sitevision/api/webresource/ImageUtil/index.d.ts

@@ -0,0 +1,267 @@
+import Node from "../../../../../javax/jcr/Node";
+
+/**
+ * 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>
+ *    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
+ */
+
+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>
+   *
+   * <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>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 RepositoryException if something else goes wrong
+   */
+  createImages(aParent: Node, aImages: java.util.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>
+   *    <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>
+   * @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 RepositoryException if something else goes wrong
+   */
+  createImage(
+    aParent: Node,
+    aFileName: java.lang.String,
+    aUri: java.lang.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>
+   *    <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 RepositoryException if something else goes wrong
+   * @since Sitevision 4.5.4
+   */
+  createImageFromBase64(
+    aParent: Node,
+    aFileName: java.lang.String,
+    aBase64EncodedString: java.lang.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>
+   *    <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 RepositoryException if something else goes wrong
+   * @since Sitevision 4.5.4
+   */
+  createImageFromTemporary(aParent: Node, aTemporaryFile: Node): Node;
+
+  /**
+   * 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>
+   *    <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 RepositoryException if something else goes wrong
+   * @since Sitevision 3.6.3
+   */
+  updateBinaryContent(aImage: Node, aUri: java.lang.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>
+   *    <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 RepositoryException if something else goes wrong
+   * @since Sitevision 4.5.4
+   */
+  updateBinaryContentFromBase64(
+    aImage: Node,
+    aBase64EncodedString: java.lang.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>
+   *    <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 RepositoryException if something else goes wrong
+   * @since Sitevision 4.5.4
+   */
+  updateBinaryContentFromTemporary(aImage: Node, aTemporaryFile: Node): void;
+
+  /**
+   * 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>
+   *    <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 RepositoryException if something else goes wrong
+   * @since Sitevision 4.5.2
+   */
+  renameImage(aImage: Node, aName: java.lang.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>
+   * @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
+   * @throws RepositoryException if something else goes wrong
+   * @since Sitevision 4.5.5.2
+   */
+  toBase64(aImage: Node): string;
+}