@sitevision/api 1.0.7 → 1.0.11

package/builtins/Collection/index.d.ts

@@ -0,0 +1,3 @@
+interface Collection {}
+
+export default Collection;

package/package.json

@@ -1,16 +1,16 @@
 {
   "name": "@sitevision/api",
-  "version": "1.0.7",
+  "version": "1.0.11",
   "author": "Sitevision AB",
   "license": "MIT",
   "types": "index.d.ts",
   "repository": {
     "type": "git",
-    "url": "https://github.com/sitevision/siteivision-apps.git",
+    "url": "https://github.com/sitevision/sitevision-apps.git",
     "directory": "packages/api"
   },
   "bugs": {
-    "url": "https://github.com/sitevision/siteivision-apps/issues"
+    "url": "https://github.com/sitevision/sitevision-apps/issues"
   },
   "scripts": {
     "prepare": "yarn build",
@@ -26,5 +26,5 @@
     "access": "public",
     "directory": "dist"
   },
-  "gitHead": "3f87b5444a9c07c96cbcf4dc9ef87fec98ec8f0c"
+  "gitHead": "cc9cb637f880cbc0def7dccfaa295bc43f2a3e5e"
 }

package/server/ArticleUtil/index.d.ts

@@ -24,38 +24,51 @@ export const PROPERTY_SHORTID: string;
 export const PROPERTY_VISIBLE_IN_MENUS: string;
 
 /**
-* Creates an article as sub node to a specified parent.
-* @returns {Node} a sv:article node corresponding to the newly created article. Will never return null 
-* @param {Node} aParent - the parent node of the article. May not be null
-* @param {Node} aTemplate - the template used for the article. May not be null
-* @param {string} aName - the name of the sv:article. May not be null
-  */
-export function createArticle(aParent: Node, aTemplate: Node, aName: string): Node;
+ * Creates an article as sub node to a specified parent.
+ * @returns {Node} a sv:article node corresponding to the newly created article. Will never return null
+ * @param {Node} aParent - the parent node of the article. May not be null
+ * @param {Node} aTemplate - the template used for the article. May not be null
+ * @param {string} aName - the name of the sv:article. May not be null
+ */
+export function createArticle(
+  aParent: Node,
+  aTemplate: Node,
+  aName: string
+): Node;
 
 /**
-* Creates an article with properties and web content.
-* @returns {Node} a sv:article node corresponding to the newly created article. Will never return null 
-* @param {Node} aParent - the parent node of the article. May not be null
-* @param {Node} aTemplate - the sv:template node to be used for the article. May not be null
-* @param {string} aName - the name of the sv:article. May not be null
-* @param {Map<string, any>} properties - the article properties. May be null
-* @param {Map<string, string>} content - a map containing the HTML content. The keys must correspond to layout names on the node. May be null
-*/
-export function createArticle(aParent: Node, aTemplate: Node, aName: string, properties: Map<string, any>, content: Map<string, string>): Node;
+ * Creates an article with properties and web content.
+ * @returns {Node} a sv:article node corresponding to the newly created article. Will never return null
+ * @param {Node} aParent - the parent node of the article. May not be null
+ * @param {Node} aTemplate - the sv:template node to be used for the article. May not be null
+ * @param {string} aName - the name of the sv:article. May not be null
+ * @param {Map<string, any>} properties - the article properties. May be null
+ * @param {Map<string, string>} content - a map containing the HTML content. The keys must correspond to layout names on the node. May be null
+ */
+export function createArticle(
+  aParent: Node,
+  aTemplate: Node,
+  aName: string,
+  properties: Map<string, any>,
+  content: Map<string, string>
+): Node;
 
 /**
-* Alters the name of an article.
-* @param {Node} anArticle - the article that should be renamed. May not be null
-* @param {string} aName - the new name of the article. May not be null
-*/
+ * Alters the name of an article.
+ * @param {Node} anArticle - the article that should be renamed. May not be null
+ * @param {string} aName - the new name of the article. May not be null
+ */
 export function renameArticle(anArticle: Node, aName: string): void;
 
 /**
-* Updates the properties of an article.
-* @param {Node} anArticle - the sv:article that will be altered. May not be null
-* @param {Map<string, any>} properties - the article properties. May not be null
-*/
-export function updateArticle(anArticle: Node, properties: Map<string, any>): void;
+ * Updates the properties of an article.
+ * @param {Node} anArticle - the sv:article that will be altered. May not be null
+ * @param {Map<string, any>} properties - the article properties. May not be null
+ */
+export function updateArticle(
+  anArticle: Node,
+  properties: Map<string, any>
+): void;
 
 declare namespace articleUtil {
   export {
@@ -79,5 +92,3 @@ declare namespace articleUtil {
 }
 
 export default articleUtil;
-
-PROPERTY_CREATED_BY

package/server/BookmarkUtil/index.d.ts

@@ -0,0 +1,95 @@
+import List from '../../builtins/List';
+import Node from '../../builtins/Node';
+
+/**
+ * Returns a list of <code>Node</code> objects for all bookmarks belonging to
+ * the current user regardless of category. This method only returns valid bookmarks
+ * (existing, published objects)
+ *
+ * @return {List<Node>} a list of bookmark nodes. Is never <code>null</code>
+ */
+export function getBookmarks(): List<Node>;
+
+/**
+ * Returns a list of <code>Node</code> objects corresponding to the bookmarks for
+ * the current user and the provided categories. This method only returns valid bookmarks
+ * (existing, published objects)
+ *
+ * @param {string} category a comma separated list of categories or <code>null</code> for no category
+ * @return {List<Node>} a list of bookmark nodes. Is never <code>null</code>
+ */
+export function getBookmarks(category: string): List<Node>;
+
+/**
+ * Adds a bookmark for the current user. This operation is synchronized
+ *
+ * @param {Node} bookmark   the node to be bookmarked must be a <code>sv:page</code>,
+ *                   <code>sv:sitePage</code> or an <code>sv:article</code>
+ * @param {string} categories a comma separated list of categories to where this bookmark belongs
+ * @throws IllegalArgumentException if <code>bookmark</code> is node of wrong type
+ * @throws NullPointerException     if <code>bookmark</code> is <code>null</code>
+ * @deprecated Use {@link #add(javax.jcr.Node)}, categories will be resolved from metadata.
+ */
+export function add(bookmark: Node, categories: string): void;
+
+/**
+ * Adds a bookmark for the current user. This operation is synchronized
+ *
+ * @param {Node} bookmark the node to be bookmarked must be a <code>sv:page</code>,
+ *                 <code>sv:sitePage</code> or an <code>sv:article</code>
+ * @throws IllegalArgumentException if bookmark is node of wrong type
+ * @throws NullPointerException     if <code>bookmark</code> is <code>null</code>
+ */
+export function add(bookmark: Node): void;
+
+/**
+ * Removes a bookmark for the current user. This operation is synchronized
+ *
+ * @param {Node} bookmark the bookmark
+ * @throws NullPointerException if <code>bookmark</code> is <code>null</code>
+ */
+export function remove(bookmark: Node): void;
+
+/**
+ * Checks if the current user has the provided bookmark
+ *
+ * @param {Node} bookmark the bookmark
+ * @return if the user has provided bookmark
+ * @throws NullPointerException if <code>bookmark</code> is <code>null</code>
+ */
+export function contains(bookmark: Node): boolean;
+
+/**
+ * Accesses a <code>boolean</code> indicating if the current site has a limited number of bookmarks.
+ *
+ * To get the max number of bookmarks, use {@link #getMaxNofBookmarks()}.
+ *
+ * @return {boolean} a <code>boolean</code> indicating if the current site has a limited number of bookmarks
+ * @throws NullPointerException if current site is indeterminable
+ * @see #getMaxNofBookmarks()
+ * @since Sitevision 2.6.1_01
+ */
+export function getLimitNofBookmarks(): boolean;
+
+/**
+ * Accessor to max number of bookmarks for the current site.
+ *
+ * @return {number} max number of bookmarks for the current site
+ * @throws NullPointerException if current site is indeterminable
+ * @see #getLimitNofBookmarks()
+ * @since Sitevision 2.6.1_01
+ */
+export function getMaxNofBookmarks(): number;
+
+declare namespace bookmarkUtil {
+  export {
+    getBookmarks,
+    add,
+    remove,
+    contains,
+    getLimitNofBookmarks,
+    getMaxNofBookmarks,
+  };
+}
+
+export default bookmarkUtil;

package/server/BookmarkUtil/index.js

@@ -0,0 +1,15 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+var _default = {
+  getBookmarks: function getBookmarks() {},
+  add: function add() {},
+  remove: function remove() {},
+  contains: function contains() {},
+  getLimitNofBookmarks: function getLimitNofBookmarks() {},
+  getMaxNofBookmarks: function getMaxNofBookmarks() {}
+};
+exports["default"] = _default;

package/server/ClientUtil/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Gets the Internet Protocol (IP) address of the client (or last proxy) that initiated currently executing request.
+ *
+ * @return {string} a <code>String</code> containing the IP address of the client that sent the request, or <code>null</code> if indeterminable
+ */
+export function getClientAddress(): string;
+
+declare namespace clientUtil {
+  export { getClientAddress };
+}
+
+export default clientUtil;

package/server/ClientUtil/index.js

@@ -0,0 +1,10 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+var _default = {
+  getClientAddress: function getClientAddress() {}
+};
+exports["default"] = _default;

package/server/ColorUtil/index.d.ts

@@ -0,0 +1,44 @@
+import Node from '../../builtins/Node';
+
+/**
+ * Gets the color with a given name
+ *
+ * @param {string} aColorName the name of the font
+ * @return {Node} the first color with name aColorName, or <code>null</code> if no color matches
+ */
+export function getColorByName(aColorName: string): Node;
+
+/**
+ * Gets the color with a given name with a fallback value if no color matches
+ *
+ * @param {string} aColorName the name of the font
+ * @param {Node} aDefaultValue fallback value
+ * @return {Node} the first color with name aColorName, or aDefaultValue if no color matches
+ */
+export function getColorByName(aColorName: string, aDefaultValue: Node): Node;
+
+/**
+ * Gets the color with a given html hex value (i.e. a '#' followed by 6 characters [0-9,a-f,A-F]).
+ *
+ * @param {string} aHexString the hex string value of the font (starts with a '#' and ends with 6 characters [0-9,a-f,A-F])
+ * @return {Node} the first color with the corresponding hex string, or <code>null</code> if no color matches
+ */
+export function getColorByHtmlHexValue(aHexString: string): Node;
+
+/**
+ * Gets the color with a given html hex value (i.e. a '#' followed by 6 characters [0-9,a-f,A-F]) with a fallback value if no color matches.
+ *
+ * @param {string} aHexString the hex string value of the font (starts with a '#' and ends with 6 characters [0-9,a-f,A-F])
+ * @param {Node} aDefaultValue fallback value
+ * @return {Node} the first color with the corresponding hex string, or aDefaultValue if no color matches
+ */
+export function getColorByHtmlHexValue(
+  aHexString: string,
+  aDefaultValue: Node
+): Node;
+
+declare namespace colorUtil {
+  export { getColorByName, getColorByHtmlHexValue };
+}
+
+export default colorUtil;

package/server/ColorUtil/index.js

@@ -0,0 +1,11 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+var _default = {
+  getColorByName: function getColorByName() {},
+  getColorByHtmlHexValue: function getColorByHtmlHexValue() {}
+};
+exports["default"] = _default;

package/server/SiteCookieUtil/index.d.ts

@@ -0,0 +1,174 @@
+import Node from '../../builtins/Node';
+import List from '../../builtins/List';
+
+/**
+ * Necessary Site cookies (sv:siteCookie) of current site.
+ *
+ * @return {List<Node>} the necessary site cookies of current site, or empty list if current site has no site cookies
+ */
+export function getNecessarySiteCookies(): List<Node>;
+
+/**
+ * Gets the necessary site cookies category title.
+ *
+ * @return {string} necessary site cookies category title
+ */
+export function getNecessarySiteCookiesTitle(): string;
+
+/**
+ * Gets the necessary site cookies category description.
+ *
+ * @return {string} necessary site cookies category description
+ */
+export function getNecessarySiteCookiesDescription(): string;
+
+/**
+ * Analytics Site cookies (sv:siteCookie) of current site.
+ *
+ * @return {List<Node>} the analytics site cookies of current site, or empty list if current site has no site cookies
+ */
+export function getAnalyticsSiteCookies(): List<Node>;
+
+/**
+ * Gets the analytics site cookies category title.
+ *
+ * @return {string} analytics site cookies category title
+ */
+export function getAnalyticsSiteCookiesTitle(): string;
+
+/**
+ * Gets the analytics site cookies category description.
+ *
+ * @return {string} analytics site cookies category description
+ */
+export function getAnalyticsSiteCookiesDescription(): string;
+
+/**
+ * Marketing Site cookies (sv:siteCookie) of current site.
+ *
+ * @return {List<Node>} the marketing site cookies of current site, or empty list if current site has no site cookies
+ */
+export function getMarketingSiteCookies(): List<Node>;
+
+/**
+ * Gets the marketing site cookies category title.
+ *
+ * @return {string} marketing site cookies category title
+ */
+export function getMarketingSiteCookiesTitle(): string;
+
+/**
+ * Gets the marketing site cookies category description.
+ *
+ * @return {string} marketing site cookies category description
+ */
+export function getMarketingSiteCookiesDescription(): string;
+
+/**
+ * Custom Site cookies (sv:siteCookie) of current site.
+ *
+ * @return {List<Node>} the custom site cookies of current site, or empty list if current site has no site cookies
+ */
+export function getCustomSiteCookies(): List<Node>;
+
+/**
+ * Gets the custom site cookies category title.
+ *
+ * @return {string} custom site cookies category title
+ */
+export function getCustomSiteCookiesTitle(): string;
+
+/**
+ * Gets the custom site cookies category description.
+ *
+ * @return {string} custom site cookies category description
+ */
+export function getCustomSiteCookiesDescription(): string;
+
+/**
+ * Convenience method that resolves a sv:siteCookie Node from a given cookie identifier.
+ *
+ * @param {string} aCookieIdentifier the site cookie identifier
+ * @return {Node} the sv:siteCookie Node with the "cookieIdentifier" property that matches aCookieIdentifier. Returns null if
+ * aCookieIdentifier is null, blank or indeterminable
+ */
+export function resolveSiteCookieByIdentifier(aCookieIdentifier: string): Node;
+
+/**
+ * Checks whether or not current user explicitly has accepted a specific site cookie.
+ *
+ * @param {Node} aSiteCookie the sv:siteCookie
+ * @return {boolean} true if current user has accepted aSiteCookie, false otherwise
+ */
+export function checkUserConsent(aSiteCookie: Node);
+
+/**
+ * Whether or not current user has explicitly accepted/rejected all "user selectable" site cookies.
+ *
+ * @return {boolean} true if there are site cookies that current user hasn't yet accepted/rejected, false otherwise
+ * @see #hasUserConsentCookie()
+ */
+export function hasPendingUserConsents(): boolean;
+
+/**
+ * Whether or not current user has a consent cookie.
+ *
+ * @return {boolean} true if current user has a consent cookie set, false otherwise
+ * @see #hasPendingUserConsents()
+ */
+export function hasUserConsentCookie(): boolean;
+
+/**
+ * The name of the cookie that contains data about site cookie consents.
+ *
+ * @return {string} the name of the cookie that contains data about site cookie consents
+ */
+export function getUserConsentCookieName(): string;
+
+/**
+ * Generates a consent string that can be saved as cookie value for the cookie named {@link #getUserConsentCookieName()}.
+ *
+ * <p>
+ *    <em>Note!</em> All "user selectable" sv:siteCookie Nodes that are <em>not</em> present in <code>aAllowCookieIdList</code>
+ *    will be treated as rejected.
+ * </p>
+ *
+ * @param {List<Node>} aAllowCookieIdList the list of sv:siteCookie accepted by current user
+ * @return {string} a string that represents the accept/reject status for current sv:siteCookie's
+ * @throws IllegalArgumentException if aAllowCookieIdList is null or contains other than sv:siteCookie Nodes
+ */
+export function createUserConsentCookieValue(
+  aAllowCookieIdList: List<Node>
+): string;
+
+/**
+ * Gets all sv:siteCookie nodes that current user has accepted.
+ *
+ * @return {List<Node>} the list of sv:siteCookie Nodes current user has accepted. Returns empty list if site has no site cookies or if current user hasn't
+ * accepted any sv:siteCookie
+ */
+export function getUserConsents(): List<Node>;
+
+declare namespace siteCookieUtil {
+  export {
+    getNecessarySiteCookies,
+    getNecessarySiteCookiesTitle,
+    getNecessarySiteCookiesDescription,
+    getAnalyticsSiteCookies,
+    getAnalyticsSiteCookiesTitle,
+    getAnalyticsSiteCookiesDescription,
+    getMarketingSiteCookies,
+    getMarketingSiteCookiesTitle,
+    getMarketingSiteCookiesDescription,
+    getCustomSiteCookies,
+    getCustomSiteCookiesTitle,
+    getCustomSiteCookiesDescription,
+    resolveSiteCookieByIdentifier,
+    checkUserConsent,
+    hasPendingUserConsents,
+    hasUserConsentCookie,
+    getUserConsentCookieName,
+    createUserConsentCookieValue,
+    getUserConsents,
+  };
+}

package/server/SiteCookieUtil/index.js

@@ -0,0 +1,28 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+var _default = {
+  getNecessarySiteCookies: function getNecessarySiteCookies() {},
+  getNecessarySiteCookiesTitle: function getNecessarySiteCookiesTitle() {},
+  getNecessarySiteCookiesDescription: function getNecessarySiteCookiesDescription() {},
+  getAnalyticsSiteCookies: function getAnalyticsSiteCookies() {},
+  getAnalyticsSiteCookiesTitle: function getAnalyticsSiteCookiesTitle() {},
+  getAnalyticsSiteCookiesDescription: function getAnalyticsSiteCookiesDescription() {},
+  getMarketingSiteCookies: function getMarketingSiteCookies() {},
+  getMarketingSiteCookiesTitle: function getMarketingSiteCookiesTitle() {},
+  getMarketingSiteCookiesDescription: function getMarketingSiteCookiesDescription() {},
+  getCustomSiteCookies: function getCustomSiteCookies() {},
+  getCustomSiteCookiesTitle: function getCustomSiteCookiesTitle() {},
+  getCustomSiteCookiesDescription: function getCustomSiteCookiesDescription() {},
+  resolveSiteCookieByIdentifier: function resolveSiteCookieByIdentifier() {},
+  checkUserConsent: function checkUserConsent() {},
+  hasPendingUserConsents: function hasPendingUserConsents() {},
+  hasUserConsentCookie: function hasUserConsentCookie() {},
+  getUserConsentCookieName: function getUserConsentCookieName() {},
+  createUserConsentCookieValue: function createUserConsentCookieValue() {},
+  getUserConsents: function getUserConsents() {}
+};
+exports["default"] = _default;

package/server/VersionUtil/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * The offline version (i.e. the version used when editing in the Sitevision editor) marker
+ */
+export const OFFLINE_VERSION: number;
+/**
+ * The online version (i.e. the published version that visitors can access) marker
+ */
+export const ONLINE_VERSION: number;
+
+/**
+ * Gets current version
+ *
+ * @return {@link #OFFLINE_VERSION} or {@link #ONLINE_VERSION}. If current version is undeterminable, -1 is returned.
+ */
+export function getCurrentVersion(): number;
+
+declare namespace versionUtil {
+  export { OFFLINE_VERSION, ONLINE_VERSION, getCurrentVersion };
+}

package/server/VersionUtil/index.js

@@ -0,0 +1,12 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+var _default = {
+  OFFLINE_VERSION: 0,
+  ONLINE_VERSION: 1,
+  getCurrentVersion: function getCurrentVersion() {}
+};
+exports["default"] = _default;

package/server/XSLTUtil/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Gets the default XSL template for cleanup of HTML sources.
+ *
+ * <p>
+ *    The template strips all &lt;div&gt;'s, &lt;spans&gt;'s and removes all inline styling, classes and attributes
+ *    that is not mandatory or needed for WCAG purposes.
+ * </p>
+ * <p>
+ *    <em>Note!</em> The template supports a <em>sub-set</em> of HTML elements (the presumed most commonly used elements).
+ *    All unsupported elements are completely discarded (i.e. they will not be included at all in the transformation result).
+ * </p>
+ *
+ * @return {string} the default cleanup template for HTML sources
+ */
+export function getDefaultCleanHtmlTemplate(): string;
+
+/**
+ * Transforms a HTML/XML source using a XSL template.
+ *
+ * <p>
+ *    <em>Note!</em> The contents of the XSL Template is always handled as UTF-8.
+ * </p>
+ *
+ * @param {string} aSource the source that should be transformed, HTML, XHTML or XML. Must not be null
+ * @param {any} aXslTemplate the UTF-8 XSL template;
+ *                     a sv:file Node, a sv:temporaryFile Node, a sv:link Node that targets a sv:file, a char array or a CharSequence
+ *                     (typically a String). Must not be null
+ * @return {string} the transformation result
+ * @throws IOException if the transformation fails (e.g. the aSource is really bad/interpretable HTML or aXslTemplate is invalid XSL)
+ * @throws RepositoryException if aNode-operation on aXslTemplate fails
+ */
+export function transform(aSource: string, aXslTemplate: any): string;
+
+declare namespace xsltUtil {
+  export { getDefaultCleanHtmlTemplate, transform };
+}

package/server/XSLTUtil/index.js

@@ -0,0 +1,11 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+var _default = {
+  getDefaultCleanHtmlTemplate: function getDefaultCleanHtmlTemplate() {},
+  transform: function transform() {}
+};
+exports["default"] = _default;

package/server/XmlParserUtil/index.d.ts

@@ -0,0 +1,117 @@
+import Node from '../builtins/Node';
+import Collection from '../builtins/Collection';
+
+interface XmlElement {
+  /**
+   * Gets the name of the element
+   *
+   * @return {string} the element name
+   */
+  getName(): string;
+
+  /**
+   * Gets the text content of the element.
+   *
+   * @return {string} the text content of the element or null if no text content is available.
+   */
+  getText(): string;
+
+  /**
+   * Gets an attribute value of the element.
+   *
+   * @param {string} aName the attribute name
+   * @return {string} the attribute value or null if no value is associated with attribute
+   */
+  getAttribute(aName: string): string;
+
+  /**
+   * Check if a sub element with a specific name is available in the element.
+   *
+   * @param {string} aName name of the sub element of this element, must be non-null.
+   * @return {boolean} true if one or more sub elements with the specific name is available
+   */
+  hasElement(aName: string): boolean;
+
+  /**
+   * Gets the first sub element with a specific name of the element.
+   *
+   * @param {string} aName name of the sub element of this element, must be non-null.
+   * @return {XmlElement} the sub element or null if no sub element is found.
+   */
+  getElement(aName: string): XmlElement;
+
+  /**
+   * Gets all sub element with a specific name of the element.
+   *
+   * @param {string} aName name of the sub element of this element, must be non-null.
+   * @return {Collection<XmlElement>}the sub elements or an empty collection if no sub elements are available
+   */
+  getElements(aName: string): Collection<XmlElement>;
+
+  /**
+   * Gets all sub elements of the element.
+   *
+   * @return {Collection<XmlElement>} a list of all sub elements
+   */
+  getElements(): Collection<XmlElement>;
+}
+
+interface XmlElementHandler {
+  /**
+   * Called when a element matching the selection has been parsed.
+   *
+   * @param {XmlElement} aXmlElement the element
+   */
+  handleElement(aXmlElement: XmlElement): void;
+}
+
+/**
+ * Parse a XML string.
+ *
+ * @param {string} aElementSelection the elements in the XML that should be passed to the XmlElementHandler
+ * @param {string} aXml the UTF-8 XML string
+ * @param {XmlElementHandler} aXmlElementHandler the XmlElementHandler
+ * @throws XmlParserException if an error occurs while parsing the XML
+ */
+export function parse(
+  aElementSelection: string,
+  aXml: string,
+  aXmlElementHandler: XmlElementHandler
+): void;
+
+/**
+ * Parse a file containing XML encoded using UTF-8.
+ *
+ * @param {string} aElementSelection the elements in the XML that should be passed to the XmlElementHandler
+ * @param {Node} aXmlFile the file containing XML encoded using UTF-8 (sv:file or sv:temporaryFile)
+ * @param {XmlElementHandler} aXmlElementHandler the XmlElementHandler
+ * @throws RepositoryException if an error occurs while accessing the file
+ * @throws XmlParserException if an error occurs while parsing the XML
+ */
+export function parse(
+  aElementSelection: string,
+  aXmlFile: Node,
+  aXmlElementHandler: XmlElementHandler
+): void;
+
+/**
+ * Parse a file containing XML encoded with the supplied charset.
+ *
+ * @param {string} aElementSelection the elements in the XML that should be passed to the XmlElementHandler
+ * @param {Node} aXmlFile the file containing XML encoded using supplied encoding (sv:file or sv:temporaryFile)
+ * @param {string} aCharset the character encoding of the the file content
+ *                 (an IllegalArgument will be thrown if aCharset can not be resolved as a java.nio.charset.Charset)
+ * @param {XmlElementHandler} aXmlElementHandler the XmlElementHandler
+ * @throws RepositoryException if an error occurs while accessing the file
+ * @throws XmlParserException if an error occurs while parsing the XML
+ */
+export function parse(
+  aElementSelection: string,
+  aXmlFile: Node,
+  aCharset: string,
+  aXmlElementHandler: XmlElementHandler
+): void;
+
+declare namespace xmlParserUtil {
+  export { parse };
+}

package/server/XmlParserUtil/index.js

@@ -0,0 +1,10 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+var _default = {
+  parse: function parse() {}
+};
+exports["default"] = _default;