@sitevision/api 2024.2.1 → 2024.3.1

package/index.d.ts

@@ -58,6 +58,7 @@ import './server/MailBuilder';
 import './server/MailUtil';
 import './server/MathInstance';
 import './server/MessageDigesterFactory';
+import './server/MessagesFactory';
 import './server/MetadataDefinitionUtil';
 import './server/MetadataUtil';
 import './server/MimeTypeUtil';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sitevision/api",
-  "version": "2024.2.1",
+  "version": "2024.3.1",
   "author": "Sitevision AB",
   "license": "MIT",
   "type": "module",
@@ -30,5 +30,5 @@
     "access": "public",
     "directory": "dist"
   },
-  "gitHead": "ecc0cf7bfd6da83e4fd08c03614bb676c40cb66f"
+  "gitHead": "ac4d35923f8a61c4fdaccbd6ffe6c46be9fddd8a"
 }

package/server/MessagesFactory/index.d.ts

@@ -0,0 +1,28 @@
+import type { Node } from "../../types/javax/jcr/Node";
+import type { ChannelWrapper } from "../../types/senselogic/sitevision/api/message/ChannelWrapper";
+
+/**
+ * Factory for creating messages-related instances.
+ *
+ *  <p>
+ *     An instance of the Sitevision class implementing this interface can be obtained via
+ *     {@link senselogic.sitevision.api.Utils#getMessagesFactory()}.
+ *     See {@link senselogic.sitevision.api.Utils} for how to obtain an instance of the <code>Utils</code> interface.
+ *  </p>
+ * @author Elias Abrache
+ * @since Sitevision 2024.03.01
+ */
+export interface MessagesFactory {
+  /**
+   * Gets a wrapper for the specified channel.
+   * @param aChannel the channel node (node of type sv:topic).
+   * @return a channel wrapper for <code>aChannel</code>, or <code>null</code> if <code>aChannel</code>&#xA; isn't a channel, is archived, Social Collaboration isn't activated or operating user doesn't have a social user identity.
+   */
+  getChannelWrapper(aChannel: Node): ChannelWrapper;
+}
+
+declare namespace MessagesFactory {}
+
+declare var messagesFactory: MessagesFactory;
+
+export default messagesFactory;

package/server/MessagesFactory/index.js

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

package/server/Utils/index.d.ts

@@ -85,6 +85,7 @@ import type { FormatterBuilderFactory } from "../FormatterBuilderFactory";
 import type { TextModuleRendererBuilder } from "../TextModuleRendererBuilder";
 import type { TagUtil } from "../TagUtil";
 import type { AliasUtil } from "../AliasUtil";
+import type { MessagesFactory } from "../MessagesFactory";
 
 /**
  * Main entry point to get instances of interfaces in the Sitevision Utility API.
@@ -747,6 +748,13 @@ export interface Utils {
    * @since Sitevision 2022.10.2
    */
   getAliasUtil(): AliasUtil;
+
+  /**
+   * Gets an instance of a messages factory class.
+   * @return a messages factory class
+   * @since Sitevision 2024.03.01
+   */
+  getMessagesFactory(): MessagesFactory;
 }
 
 declare namespace Utils {}

package/server/Utils/index.js

@@ -87,6 +87,7 @@ var _default = {
   getFormatterBuilderFactory: function getFormatterBuilderFactory() {},
   getTextModuleRendererBuilder: function getTextModuleRendererBuilder() {},
   getTagUtil: function getTagUtil() {},
-  getAliasUtil: function getAliasUtil() {}
+  getAliasUtil: function getAliasUtil() {},
+  getMessagesFactory: function getMessagesFactory() {}
 };
 exports["default"] = _default;

package/server/WebContentUtil/index.d.ts

@@ -457,6 +457,52 @@ export interface WebContentUtil {
    * @since Sitevision 3.6
    */
   resolveToResourceURL(aNode: Node, aUnresolvedURL: String | string): string;
+
+  /**
+   * Removes the page content of the first root layout for a sv:page, sv:article or a sv:template.
+   *
+   *  <p>
+   *     Content of the <strong>first</strong> root layout available on the node will be removed.
+   *     Use {@link #removeAllContent(Node, String)} instead to specify a specific root layout.
+   *  </p>
+   *
+   *  <p>
+   *     Current user must have effective WRITE permission to mutate the node or a  <code>ConstraintViolationException</code> is thrown.
+   *  </p>
+   *
+   *  <p>
+   *     <em>This method is typically called to clear all content before adding new content via {@link #updateContent(Node, String)}</em>
+   *  </p>
+   * @param aPageNode the node that will be altered, typically a node with primary node type sv:page or sv:article.&#xA; May not be null and may not be the site page
+   * @throws NullPointerException if aPageNode is null
+   * @throws IllegalArgumentException if aPageNode is of invalid type
+   * @throws ConstraintViolationException if current user is not allowed to alter aPageNode
+   * @throws RepositoryException if something else goes wrong
+   * @see senselogic.sitevision.api.security.PermissionUtil#hasEffectiveWritePermission(Node, Node)
+   * @since Sitevision 2024.03.1
+   */
+  removeAllContent(aPageNode: Node): void;
+
+  /**
+   * Removes the page content of a root layout for a sv:page, sv:article or a sv:template.
+   *
+   *  <p>
+   *     Current user must have effective WRITE permission to mutate the node or a <code>ConstraintViolationException</code> is thrown.
+   *  </p>
+   *
+   *  <p>
+   *     <em>This method is typically called to clear all content before adding new content via {@link #updateContent(Node, Map)}</em>
+   *  </p>
+   * @param aPageNode the node that will be altered, typically a node with primary node type sv:page or sv:article.&#xA; May not be null and may not be the site page
+   * @param aRootLayoutName the name of the root layout of aPageNode to remove content from (e.g. "Mittenspalt")
+   * @throws NullPointerException if aPageNode or aRootLayoutName is null
+   * @throws IllegalArgumentException if aPageNode is of invalid type or if there are no root layout named aRootLayoutName
+   * @throws ConstraintViolationException if current user is not allowed to alter aPageNode
+   * @throws RepositoryException if something else goes wrong
+   * @see senselogic.sitevision.api.security.PermissionUtil#hasEffectiveWritePermission(Node, Node)
+   * @since Sitevision 2024.03.1
+   */
+  removeAllContent(aPageNode: Node, aRootLayoutName: String | string): void;
 }
 
 declare namespace WebContentUtil {}

package/server/WebContentUtil/index.js

@@ -9,6 +9,7 @@ var _default = {
   updateContentWithRawHtml: function updateContentWithRawHtml() {},
   appendContent: function appendContent() {},
   appendContentWithRawHtml: function appendContentWithRawHtml() {},
-  resolveToResourceURL: function resolveToResourceURL() {}
+  resolveToResourceURL: function resolveToResourceURL() {},
+  removeAllContent: function removeAllContent() {}
 };
 exports["default"] = _default;

package/types/senselogic/sitevision/api/message/ChannelWrapper/index.d.ts

@@ -0,0 +1,91 @@
+import type { Node } from "../../../../../javax/jcr/Node";
+
+import type { Wrapper } from "../../base/Wrapper";
+
+/**
+ * Channel administration interface.
+ *
+ *  <p>
+ *     This wrapper provides methods to update an existing channel (node of type sv:topic).
+ *  </p>
+ *
+ *  <p>
+ *     An instance of the Sitevision class implementing this interface can be obtained via
+ *     {@link MessagesFactory#getChannelWrapper(javax.jcr.Node)}.
+ *     See {@link MessagesFactory} for how to obtain an instance of the MessagesFactory interface.
+ *  </p>
+ * @author Elias Abrache
+ * @since Sitevision 2024.03.01
+ */
+export type ChannelWrapper = Wrapper & {
+  /**
+   * Adds a user identity as member of the wrapped channel.
+   *
+   *  <p>
+   *     Requires enabled Social collaboration, and for the operating user to have a social user identity.
+   *  </p>
+   *
+   *  <p>
+   *     <em>Only non-members will be added</em>, i.e. a user identity that already is a member will be ignored.
+   *     Channels that are <em>archived</em> don't accept any new members.
+   *  </p>
+   *
+   *  <p>
+   *     <strong>Permission notes!</strong>
+   *  </p>
+   *  <p>
+   *     <em>Open channels</em> require the operating user to either have membership or the
+   *     {@link senselogic.sitevision.api.security.PermissionUtil.Permission#MANAGE_CHANNELS} permission.
+   *  </p>
+   *  <p>
+   *     <em>Private channels</em> require the operating user to have membership.
+   *  </p>
+   * @param aUserIdentity a user identity (or user)
+   * @return true if aUserIdentity was added as member of the wrapped channel, false otherwise.&#xA; false is always returned if aUserIdentity is null or already a member of the wrapped channel.
+   */
+  addMember(aUserIdentity: Node): boolean;
+
+  /**
+   * Removes a member from the wrapped channel.
+   *
+   *  <p>
+   *     <em>Only members can be removed</em>, i.e. a user identity that is a non-member will be ignored.
+   *     Members can not be removed from channels that are <em>archived</em>.
+   *  </p>
+   *
+   *  <p>
+   *     <strong>Permission notes!</strong>
+   *  </p>
+   *  <p>
+   *     <em>Open channels</em> require the operating user to have one of the following:
+   *  </p>
+   *  <ul>
+   *     <li>
+   *        {@link senselogic.sitevision.api.security.PermissionUtil.Permission#MANAGE_CHANNELS} permission.
+   *     </li>
+   *     <li>
+   *        Be channel administrator (author of the channel).
+   *     </li>
+   *     <li>
+   *        Operating user matches the user identity (i.e. "is yourself").
+   *     </li>
+   *  </ul>
+   *  <p>
+   *     <em>Private channels</em> require the operating user to have one of the following:
+   *  </p>
+   *  <ul>
+   *     <li>
+   *        Membership and the {@link senselogic.sitevision.api.security.PermissionUtil.Permission#MANAGE_CHANNELS} permission.
+   *     </li>
+   *     <li>
+   *        Be channel administrator (author of the channel).
+   *     </li>
+   *     <li>
+   *        Operating user matches the user identity (i.e. "is yourself").
+   *     </li>
+   *  </ul>
+   * @param aUserIdentity a user identity (or user)
+   * @return true if aUserIdentity was removed as member from the wrapped channel, false otherwise.&#xA; false is always returned if aUserIdentity is null or not a member of the wrapped channel.
+   */
+  removeMember(aUserIdentity: Node): boolean;
+};

package/types/senselogic/sitevision/api/message/ChannelWrapper/index.js

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