@sitevision/api 2023.2.1 → 2023.2.2-beta.2

package/server/ResourceLocatorUtil/index.d.ts

@@ -1,23 +1,25 @@
 import type { Node } from "../../types/javax/jcr/Node";
+import type { String } from "../../types/java/lang/String";
+import type { Object } from "../../types/java/lang/Object";
 
 /**
  * Utility interface for locating resources.
  *
- * <p>
- *    An instance of the Sitevision class implementing this interface can be obtained via
- *    {@link senselogic.sitevision.api.Utils#getResourceLocatorUtil()}.
- *    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#getResourceLocatorUtil()}.
+ *     See {@link senselogic.sitevision.api.Utils} for how to obtain an instance of the <code>Utils</code> interface.
+ *  </p>
  * @author Magnus Lövgren
  */
 export interface ResourceLocatorUtil {
   /**
    * Gets current site (i.e. the site node of the page for the currently executing portlet).
    *
-   * <p>
-   *    <strong>Note!</strong> If you are interested in the actual <em>start page</em>, you should use the {@link #getSitePage()} method.
-   * </p>
-   * @return current site <code>Node</code>, or <code>null</code> if indeterminable (e.g. current portlet and/or current page is not bound to any site)
+   *  <p>
+   *     <strong>Note!</strong> If you are interested in the actual <em>start page</em>, you should use the {@link #getSitePage()} method.
+   *  </p>
+   * @return current site <code>Node</code>, or <code>null</code> if indeterminable&#xA; (e.g. current portlet and/or current page is not bound to any site)
    * @see #getSitePage()
    */
   getSite(): Node;
@@ -25,10 +27,10 @@ export interface ResourceLocatorUtil {
   /**
    * Gets current site page (i.e. the site's start page node of the page for the currently executing portlet).
    *
-   * <p>
-   *    <strong>Note!</strong> If you are interested in the actual <em>site</em>, you should use the {@link #getSite()} method.
-   * </p>
-   * @return current site page <code>Node</code>, or <code>null</code> if indeterminable (e.g. current portlet and/or current page is not bound to any site)
+   *  <p>
+   *     <strong>Note!</strong> If you are interested in the actual <em>site</em>, you should use the {@link #getSite()} method.
+   *  </p>
+   * @return current site page <code>Node</code>, or <code>null</code> if indeterminable&#xA; (e.g. current portlet and/or current page is not bound to any site)
    * @see #getSite()
    */
   getSitePage(): Node;
@@ -60,12 +62,12 @@ export interface ResourceLocatorUtil {
   /**
    * Gets the local file repository for current page node.
    *
-   * <p>
-   *    <em>
-   *       This is a convenience for {@link #getLocalFileRepository(Node)} that uses
-   *       {@link senselogic.sitevision.api.context.PortletContextUtil#getCurrentPage()} to get current page node.
-   *    </em>
-   * </p>
+   *  <p>
+   *     <em>
+   *        This is a convenience for {@link #getLocalFileRepository(Node)} that uses
+   *        {@link senselogic.sitevision.api.context.PortletContextUtil#getCurrentPage()} to get current page node.
+   *     </em>
+   *  </p>
    * @return the local file repository for current node, or <code>null</code> if indeterminable
    */
   getLocalFileRepository(): Node;
@@ -87,12 +89,12 @@ export interface ResourceLocatorUtil {
   /**
    * Gets the local image repository for current page node.
    *
-   * <p>
-   *    <em>
-   *       This is a convenience for {@link #getLocalImageRepository(Node)} that uses
-   *       {@link senselogic.sitevision.api.context.PortletContextUtil#getCurrentPage()} to get current page node.
-   *    </em>
-   * </p>
+   *  <p>
+   *     <em>
+   *        This is a convenience for {@link #getLocalImageRepository(Node)} that uses
+   *        {@link senselogic.sitevision.api.context.PortletContextUtil#getCurrentPage()} to get current page node.
+   *     </em>
+   *  </p>
    * @return the local image repository for current node, or <code>null</code> if indeterminable
    */
   getLocalImageRepository(): Node;
@@ -108,12 +110,12 @@ export interface ResourceLocatorUtil {
   /**
    * Gets the page comment repository for current page node.
    *
-   * <p>
-   *    <em>
-   *       This is a convenience for {@link #getPageCommentRepository(Node)} that uses
-   *       {@link senselogic.sitevision.api.context.PortletContextUtil#getCurrentPage()} to get current page node.
-   *    </em>
-   * </p>
+   *  <p>
+   *     <em>
+   *        This is a convenience for {@link #getPageCommentRepository(Node)} that uses
+   *        {@link senselogic.sitevision.api.context.PortletContextUtil#getCurrentPage()} to get current page node.
+   *     </em>
+   *  </p>
    * @return the page comment repository for current page node, or <code>null</code> if indeterminable
    * @since Sitevision 3.6.4
    */
@@ -130,15 +132,15 @@ export interface ResourceLocatorUtil {
   /**
    * Gets the personal file repository for a specified node.
    *
-   * <p>
-   *    A <em>personal file repository</em> contains files that belongs to a <code>sv:collaborationGroup</code> (i.e. "group files")
-   *    or a <code>sv:userIdentity</code> (e.g. files attached when posting timeline entries).
-   * </p>
-   * <p>
-   *    <em>Convenience note!</em> This method will extract and use the corresponding <code>sv:collaborationGroup</code> if
-   *    the <em>aNode</em> argument is a <code>sv:collaborationGroupPage</code>. It will also try to extract and use the
-   *    corresponding <code>sv:userIdentity</code> if the <em>aNode</em> argument is a <code>sv:user</code>.
-   * </p>
+   *  <p>
+   *     A <em>personal file repository</em> contains files that belongs to a <code>sv:collaborationGroup</code> (i.e. "group files")
+   *     or a <code>sv:userIdentity</code> (e.g. files attached when posting timeline entries).
+   *  </p>
+   *  <p>
+   *     <em>Convenience note!</em> This method will extract and use the corresponding <code>sv:collaborationGroup</code> if
+   *     the <em>aNode</em> argument is a <code>sv:collaborationGroupPage</code>. It will also try to extract and use the
+   *     corresponding <code>sv:userIdentity</code> if the <em>aNode</em> argument is a <code>sv:user</code>.
+   *  </p>
    * @param aNode a node that has a personal file repository (typically a sv:collaborationGroup or sv:userIdentity)
    * @return the personal file repository for <code>aNode</code>, or <code>null</code> if indeterminable.
    * @since Sitevision 3.6.4
@@ -148,15 +150,15 @@ export interface ResourceLocatorUtil {
   /**
    * Gets the personal image repository for a specified node.
    *
-   * <p>
-   *    A <em>personal image repository</em> contains images that belongs to a <code>sv:collaborationGroup</code>
-   *    or a <code>sv:userIdentity</code> (e.g. profile image).
-   * </p>
-   * <p>
-   *    <em>Convenience note!</em> This method will extract and use the corresponding <code>sv:collaborationGroup</code> if
-   *    the <em>aNode</em> argument is a <code>sv:collaborationGroupPage</code>. It will also try to extract and use the
-   *    corresponding <code>sv:userIdentity</code> if the <em>aNode</em> argument is a <code>sv:user</code>.
-   * </p>
+   *  <p>
+   *     A <em>personal image repository</em> contains images that belongs to a <code>sv:collaborationGroup</code>
+   *     or a <code>sv:userIdentity</code> (e.g. profile image).
+   *  </p>
+   *  <p>
+   *     <em>Convenience note!</em> This method will extract and use the corresponding <code>sv:collaborationGroup</code> if
+   *     the <em>aNode</em> argument is a <code>sv:collaborationGroupPage</code>. It will also try to extract and use the
+   *     corresponding <code>sv:userIdentity</code> if the <em>aNode</em> argument is a <code>sv:user</code>.
+   *  </p>
    * @param aNode a node that has a personal image repository (typically a sv:collaborationGroup or sv:userIdentity)
    * @return the personal image repository for <code>aNode</code>, or <code>null</code> if indeterminable.
    * @since Sitevision 3.6.4
@@ -166,9 +168,9 @@ export interface ResourceLocatorUtil {
   /**
    * Gets the icon repository for the site of current node.
    *
-   * <p>
-   *    The icon repository contains all site-specific file icon nodes.
-   * </p>
+   *  <p>
+   *     The icon repository contains all site-specific file icon nodes.
+   *  </p>
    * @return the icon repository for the site of current node, or <code>null</code> if indeterminable
    */
   getIconRepository(): Node;
@@ -176,9 +178,9 @@ export interface ResourceLocatorUtil {
   /**
    * Gets the index repository for the site of current node.
    *
-   * <p>
-   *    <em>Tip!</em> The {@link senselogic.sitevision.api.search.index.IndexUtil} utility can be used for easy index lookup.
-   * </p>
+   *  <p>
+   *     <em>Tip!</em> The {@link senselogic.sitevision.api.search.index.IndexUtil} utility can be used for easy index lookup.
+   *  </p>
    * @return the index repository for the site of current node, or <code>null</code> if indeterminable
    * @since Sitevision 3.6
    */
@@ -187,9 +189,9 @@ export interface ResourceLocatorUtil {
   /**
    * Gets the default image repository for the site of current node.
    *
-   * <p>
-   *    The default image repository contains system/server-specific images/icons.
-   * </p>
+   *  <p>
+   *     The default image repository contains system/server-specific images/icons.
+   *  </p>
    * @return the default image repository for the site of current node, or <code>null</code> if indeterminable
    */
   getDefaultImageRepository(): Node;
@@ -203,34 +205,34 @@ export interface ResourceLocatorUtil {
   /**
    * Gets a <code>Node</code> given its identifier.
    *
-   * <p>
-   *    <em>
-   *       Note! This is mere a convenience alias for {@link javax.jcr.Session#getNodeByIdentifier(String)} but
-   *       unlike the original, this method returns null instead of throwing an exception if given identifier
-   *       can't be matched to an existing node.
-   *    </em>
-   * </p>
+   *  <p>
+   *     <em>
+   *        Note! This is mere a convenience alias for {@link javax.jcr.Session#getNodeByIdentifier(String)} but
+   *        unlike the original, this method returns null instead of throwing an exception if given identifier
+   *        can't be matched to an existing node.
+   *     </em>
+   *  </p>
    * @param anIdentifier a Node identifier
    * @return the corresponding <code>Node</code> or <code>null</code>
    * @since Sitevision 3.6.5
    */
-  getNodeByIdentifier(anIdentifier: string): Node;
+  getNodeByIdentifier(anIdentifier: String | string): Node;
 
   /**
    * Gets a <code>Node</code> given its absolute path.
    *
-   * <p>
-   *    <em>
-   *       Note! This is mere a convenience alias for {@link javax.jcr.Session#getNode(String)} but
-   *       unlike the original, this method returns null instead of throwing an exception if given
-   *       absolute path can't be matched to an existing node.
-   *    </em>
-   * </p>
+   *  <p>
+   *     <em>
+   *        Note! This is mere a convenience alias for {@link javax.jcr.Session#getNode(String)} but
+   *        unlike the original, this method returns null instead of throwing an exception if given
+   *        absolute path can't be matched to an existing node.
+   *     </em>
+   *  </p>
    * @param anAbsolutePath an absolute path
    * @return the corresponding <code>Node</code> or <code>null</code>
    * @since Sitevision 3.6.5
    */
-  getNodeByPath(anAbsolutePath: string): Node;
+  getNodeByPath(anAbsolutePath: String | string): Node;
 
   /**
    * Gets a <code>Node</code> given its URL
@@ -238,24 +240,24 @@ export interface ResourceLocatorUtil {
    * @return the corresponding <code>Node</code> or <code>null</code>
    * @since Sitevision 2.6.1
    */
-  getNodeByUrl(anUrl: string): Node;
+  getNodeByUrl(anUrl: String | string): Node;
 
   /**
    * <p>
-   *    Resolves a potential JCR Node identifier for an internal Sitevision object.
-   * </p>
+   *     Resolves a potential JCR Node identifier for an internal Sitevision object.
+   *  </p>
    *
-   * <p>
-   *    <em>
-   *       This is a deprecated legacy method for conversions between internal Sitevision objects and API objects (javax.jcr.Node).
-   *       This behaviour is typically only applicable in really old Velocity templates that was released prior to the API
-   *       (i.e. templates released before 2008).
-   *       This method is <strong>not</strong> intended for {@link javax.jcr.Node javax.jcr.Node} objects!
-   *       To get the "id" of a <code>javax.jcr.Node</code> - use the {@link Node#getIdentifier()} method.
-   *    </em>
-   * </p>
+   *  <p>
+   *     <em>
+   *        This is a deprecated legacy method for conversions between internal Sitevision objects and API objects (javax.jcr.Node).
+   *        This behaviour is typically only applicable in really old Velocity templates that was released prior to the API
+   *        (i.e. templates released before 2008).
+   *        This method is <strong>not</strong> intended for {@link javax.jcr.Node javax.jcr.Node} objects!
+   *        To get the "id" of a <code>javax.jcr.Node</code> - use the {@link Node#getIdentifier()} method.
+   *     </em>
+   *  </p>
    * @param aInternalObject a internal Sitevision object
-   * @return a potential JCR Node identifier, or null if aInternalObject is null. The identifier for the sv:sitePage Node is returned if aInternalObject corresponds to the "site". Note that there are no guarantee that returned value actually is a valid JCR Node identifier
+   * @return a potential JCR Node identifier, or null if aInternalObject is null.&#xA; The identifier for the sv:sitePage Node is returned if aInternalObject corresponds to the "site".&#xA; Note that there are no guarantee that returned value actually is a valid JCR Node identifier
    * @since Sitevision 2.6.1_01
    * @deprecated This is a legacy method for really old Velocity templates that uses internal Sitevision objects.
    */
@@ -299,12 +301,12 @@ export interface ResourceLocatorUtil {
   /**
    * Gets the module element file repository for current module element node.
    *
-   * <p>
-   *    <em>
-   *       This is a convenience for {@link #getModuleElementFileRepository(Node)} that uses
-   *       {@link senselogic.sitevision.api.context.PortletContextUtil#getCurrentModuleElement()} to get current module element node.
-   *    </em>
-   * </p>
+   *  <p>
+   *     <em>
+   *        This is a convenience for {@link #getModuleElementFileRepository(Node)} that uses
+   *        {@link senselogic.sitevision.api.context.PortletContextUtil#getCurrentModuleElement()} to get current module element node.
+   *     </em>
+   *  </p>
    * @return the module element file repository for current module element, or <code>null</code> if indeterminable.
    * @since Sitevision 4.2
    */
@@ -321,12 +323,12 @@ export interface ResourceLocatorUtil {
   /**
    * Gets the module element image repository for current module element node.
    *
-   * <p>
-   *    <em>
-   *       This is a convenience for {@link #getModuleElementImageRepository(Node)} that uses
-   *       {@link senselogic.sitevision.api.context.PortletContextUtil#getCurrentModuleElement()} to get current module element node.
-   *    </em>
-   * </p>
+   *  <p>
+   *     <em>
+   *        This is a convenience for {@link #getModuleElementImageRepository(Node)} that uses
+   *        {@link senselogic.sitevision.api.context.PortletContextUtil#getCurrentModuleElement()} to get current module element node.
+   *     </em>
+   *  </p>
    * @return the module element image repository for current module element, or <code>null</code> if indeterminable.
    * @since Sitevision 4.2
    */

package/server/RestApi/index.d.ts

@@ -1,58 +1,59 @@
 import type { Node } from "../../types/javax/jcr/Node";
+import type { String } from "../../types/java/lang/String";
 
 /**
  * Script utility for server-side invoke of the local Sitevision REST API.
  *
- * <p>
- *    This is a local, server-side, inbound utility to invoke the
- *    <a href="https://developer.sitevision.se/docs/rest-api/model-rest-api" target="_blank">Sitevision REST API</a>
- *    of the local site without any outgoing http connections.
- *    This utility can be used regardless of the REST API of the local site is enabled or not!
- * </p>
+ *  <p>
+ *     This is a local, server-side, inbound utility to invoke the
+ *     <a href="https://developer.sitevision.se/docs/rest-api/model-rest-api" target="_blank">Sitevision REST API</a>
+ *     of the local site without any outgoing http connections.
+ *     This utility can be used regardless of the REST API of the local site is enabled or not!
+ *  </p>
  *
- * <p>
- *    <strong>Version note!</strong> External (http connection-based) invocations of the Sitevision REST API can specify different versions
- *    (online / offline) via the URL. This inbound utility will always use <em>current version</em> as of
- *    {@link senselogic.sitevision.api.versioning.VersionUtil#getCurrentVersion()}.
- * </p>
+ *  <p>
+ *     <strong>Version note!</strong> External (http connection-based) invocations of the Sitevision REST API can specify different versions
+ *     (online / offline) via the URL. This inbound utility will always use <em>current version</em> as of
+ *     {@link senselogic.sitevision.api.versioning.VersionUtil#getCurrentVersion()}.
+ *  </p>
  *
- * <p>
- *    Below are two typical examples of how to use the RestApi utility to execute a GET for the "nodes" endpoint on a given JCR Node
- *    context and and process the returned javascript object.
- * </p>
- * <p>
- *    <em>a) Using a Node via a script variable (named "startPage") in the Sitevision Script module:</em>
- * </p>
- * <pre><code>   var restApi = require('RestApi'),
- *       result;
+ *  <p>
+ *     Below are two typical examples of how to use the RestApi utility to execute a GET for the "nodes" endpoint on a given JCR Node
+ *     context and and process the returned javascript object.
+ *  </p>
+ *  <p>
+ *     <em>a) Using a Node via a script variable (named "startPage") in the Sitevision Script module:</em>
+ *  </p>
+ *  <pre><code>   var restApi = require('RestApi'),
+ *        result;
  *
- *   result = restApi.get(scriptVariables.startPage, 'nodes');
+ *    result = restApi.get(scriptVariables.startPage, 'nodes');
  *
- *   if (result.statusCode &gt;= 200 &amp;&amp; result.statusCode &lt; 300) {
- *      out.println('Result: ' + JSON.stringify(result.body));
- *   } else {
- *      out.println('Fail: ' + result.statusMessage + '&lt;br&gt;' + JSON.stringify(result.body));
- *   }</code></pre>
- * <p>
- *    <em>b) Using a Node via the app data (property "startPage") of a WebApp/RestApp:</em>
- * </p>
- * <pre><code>   ...
- *   result = restApi.get(appData.getNode('startPage'), 'nodes');
- *   ...</code></pre>
+ *    if (result.statusCode &gt;= 200 &amp;&amp; result.statusCode &lt; 300) {
+ *       out.println('Result: ' + JSON.stringify(result.body));
+ *    } else {
+ *       out.println('Fail: ' + result.statusMessage + '&lt;br&gt;' + JSON.stringify(result.body));
+ *    }</code></pre>
+ *  <p>
+ *     <em>b) Using a Node via the app data (property "startPage") of a WebApp/RestApp:</em>
+ *  </p>
+ *  <pre><code>   ...
+ *    result = restApi.get(appData.getNode('startPage'), 'nodes');
+ *    ...</code></pre>
  *
- * <p>
- *    <strong>REST siblings note!</strong>
- * </p>
- * <ul>
- *    <li>
- *       Server-side invoke of a <em>local RESTApp</em> should typically be handled via
- *       {@link senselogic.sitevision.api.script.app.RestAppInvoker}.
- *    </li>
- *    <li>
- *       Invoking <em>external REST API:s</em> should typically be handled via
- *       {@link senselogic.sitevision.api.script.Requester}.
- *    </li>
- * </ul>
+ *  <p>
+ *     <strong>REST siblings note!</strong>
+ *  </p>
+ *  <ul>
+ *     <li>
+ *        Server-side invoke of a <em>local RESTApp</em> should typically be handled via
+ *        {@link senselogic.sitevision.api.script.app.RestAppInvoker}.
+ *     </li>
+ *     <li>
+ *        Invoking <em>external REST API:s</em> should typically be handled via
+ *        {@link senselogic.sitevision.api.script.Requester}.
+ *     </li>
+ *  </ul>
  * @param <O> script object
  * @author Magnus Lövgren
  * @since Sitevision 4.5
@@ -63,21 +64,21 @@ export interface RestApi {
   /**
    * Executes a GET endpoint of the REST API.
    *
-   * <p>
-   *    <em>REST hint!</em> A <em>get</em> typically indicates a <em>read</em> of something.
-   * </p>
+   *  <p>
+   *     <em>REST hint!</em> A <em>get</em> typically indicates a <em>read</em> of something.
+   *  </p>
    * @param aContextNode the endpoint context Node
    * @param aOperationName the endpoint operation name/method
    * @return a script object representing the response (properties: statusCode, statusMessage, body)
    */
-  get(aContextNode: Node, aOperationName: string): unknown;
+  get(aContextNode: Node, aOperationName: String | string): unknown;
 
   /**
    * Executes a GET endpoint of the REST API.
    *
-   * <p>
-   *    <em>REST hint!</em> A <em>get</em> typically indicates a <em>read</em> of something.
-   * </p>
+   *  <p>
+   *     <em>REST hint!</em> A <em>get</em> typically indicates a <em>read</em> of something.
+   *  </p>
    * @param aContextNode the endpoint context Node
    * @param aOperationName the endpoint operation name/method
    * @param aOperationOptions the operation data/parameters
@@ -85,16 +86,16 @@ export interface RestApi {
    */
   get(
     aContextNode: Node,
-    aOperationName: string,
+    aOperationName: String | string,
     aOperationOptions: unknown
   ): unknown;
 
   /**
    * Executes a GET endpoint of the REST API, targeting an instance of the context.
    *
-   * <p>
-   *    <em>REST hint!</em> A <em>get</em> typically indicates a <em>read</em> of something.
-   * </p>
+   *  <p>
+   *     <em>REST hint!</em> A <em>get</em> typically indicates a <em>read</em> of something.
+   *  </p>
    * @param aContextNode the endpoint context Node
    * @param aOperationName the endpoint operation name/method
    * @param aOperationNode the operation Node of the context
@@ -103,7 +104,7 @@ export interface RestApi {
    */
   get(
     aContextNode: Node,
-    aOperationName: string,
+    aOperationName: String | string,
     aOperationNode: Node,
     aOperationOptions: unknown
   ): unknown;
@@ -111,9 +112,9 @@ export interface RestApi {
   /**
    * Executes a POST endpoint of the REST API.
    *
-   * <p>
-   *    <em>REST hint!</em> A <em>post</em> typically indicates the <em>creation</em> of something.
-   * </p>
+   *  <p>
+   *     <em>REST hint!</em> A <em>post</em> typically indicates the <em>creation</em> of something.
+   *  </p>
    * @param aContextNode the endpoint context Node
    * @param aOperationName the endpoint operation name/method
    * @param aOperationOptions the operation data/parameters
@@ -121,16 +122,16 @@ export interface RestApi {
    */
   post(
     aContextNode: Node,
-    aOperationName: string,
+    aOperationName: String | string,
     aOperationOptions: unknown
   ): unknown;
 
   /**
    * Executes a PUT endpoint of the REST API.
    *
-   * <p>
-   *    <em>REST hint!</em> A <em>put</em> typically indicates an <em>update</em> of something.
-   * </p>
+   *  <p>
+   *     <em>REST hint!</em> A <em>put</em> typically indicates an <em>update</em> of something.
+   *  </p>
    * @param aContextNode the endpoint context Node
    * @param aOperationName the endpoint operation name/method
    * @param aOperationOptions the operation data/parameters
@@ -139,16 +140,16 @@ export interface RestApi {
    */
   put(
     aContextNode: Node,
-    aOperationName: string,
+    aOperationName: String | string,
     aOperationOptions: unknown
   ): unknown;
 
   /**
    * Executes a PUT endpoint of the REST API, targeting an instance of the context.
    *
-   * <p>
-   *    <em>REST hint!</em> A <em>put</em> typically indicates an <em>update</em> of something.
-   * </p>
+   *  <p>
+   *     <em>REST hint!</em> A <em>put</em> typically indicates an <em>update</em> of something.
+   *  </p>
    * @param aContextNode the endpoint context Node
    * @param aOperationName the endpoint operation name/method
    * @param aOperationNode the operation Node of the context
@@ -157,7 +158,7 @@ export interface RestApi {
    */
   put(
     aContextNode: Node,
-    aOperationName: string,
+    aOperationName: String | string,
     aOperationNode: Node,
     aOperationOptions: unknown
   ): unknown;
@@ -165,22 +166,22 @@ export interface RestApi {
   /**
    * Executes a DELETE endpoint of the REST API.
    *
-   * <p>
-   *    <em>REST hint!</em> A <em>delete</em> typically indicates a <em>removal</em> of something.
-   * </p>
+   *  <p>
+   *     <em>REST hint!</em> A <em>delete</em> typically indicates a <em>removal</em> of something.
+   *  </p>
    * @param aContextNode the endpoint context Node
    * @param aOperationName the endpoint operation name/method
    * @return a script object representing the response (properties: statusCode, statusMessage, body)
    * @since Sitevision 4.5.1
    */
-  delete(aContextNode: Node, aOperationName: string): unknown;
+  delete(aContextNode: Node, aOperationName: String | string): unknown;
 
   /**
    * Executes a DELETE endpoint of the REST API, targeting an instance of the context.
    *
-   * <p>
-   *    <em>REST hint!</em> A <em>delete</em> typically indicates a <em>removal</em> of something.
-   * </p>
+   *  <p>
+   *     <em>REST hint!</em> A <em>delete</em> typically indicates a <em>removal</em> of something.
+   *  </p>
    * @param aContextNode the endpoint context Node
    * @param aOperationName the endpoint operation name/method
    * @param aOperationNode the operation Node of the context
@@ -188,16 +189,16 @@ export interface RestApi {
    */
   delete(
     aContextNode: Node,
-    aOperationName: string,
+    aOperationName: String | string,
     aOperationNode: Node
   ): unknown;
 
   /**
    * Executes a DELETE endpoint of the REST API, targeting an instance of the context.
    *
-   * <p>
-   *    <em>REST hint!</em> A <em>delete</em> typically indicates a <em>removal</em> of something.
-   * </p>
+   *  <p>
+   *     <em>REST hint!</em> A <em>delete</em> typically indicates a <em>removal</em> of something.
+   *  </p>
    * @param aContextNode the endpoint context Node
    * @param aOperationName the endpoint operation name/method
    * @param aOperationNode the operation Node of the context
@@ -207,7 +208,7 @@ export interface RestApi {
    */
   delete(
     aContextNode: Node,
-    aOperationName: string,
+    aOperationName: String | string,
     aOperationNode: Node,
     aOperationOptions: unknown
   ): unknown;