@sitevision/api 1.0.20 → 1.1.0-alpha.1

package/hidden/javax/jcr/security/AccessControlManager/index.d.ts

@@ -0,0 +1,297 @@
+import Privilege from "../Privilege";
+import AccessControlPolicy from "../AccessControlPolicy";
+import AccessControlPolicyIterator from "../AccessControlPolicyIterator";
+
+/**
+ * The <code>AccessControlManager</code> object is accessed via {@link
+ * javax.jcr.Session#getAccessControlManager()}. It provides methods for: <ul>
+ * <li>Access control discovery</li> <li>Assigning access control policies</li>
+ * </ul>
+ *
+ * <p><strong>Sitevision note:</strong> Unsupported operation</p>Returns the privileges supported for absolute path <code>absPath</code>,
+ * which must be an existing node.
+ * <p>
+ * This method does not return the privileges held by the session. Instead,
+ * it returns the privileges that the repository supports.Returns the privilege with the specified <code>privilegeName</code>.
+ * Since the privilege name is a JCR name, it may be passed in either
+ * qualified or expanded form (see specification for details on JCR names).Returns whether the session has the specified privileges for absolute
+ * path <code>absPath</code>, which must be an existing node.
+ * <p>
+ * Testing an aggregate privilege is equivalent to testing each non
+ * aggregate privilege among the set returned by calling
+ * <code>Privilege.getAggregatePrivileges()</code> for that privilege.
+ * <p>
+ * The results reported by the this method reflect the net <i>effect</i> of
+ * the currently applied control mechanisms. It does not reflect unsaved
+ * access control policies or unsaved access control entries. Changes to
+ * access control status caused by these mechanisms only take effect on
+ * <code>Session.save()</code> and are only then reflected in the results of
+ * the privilege test methods.Returns the privileges the session has for absolute path absPath, which
+ * must be an existing node.
+ * <p>
+ * The returned privileges are those for which {@link #hasPrivileges} would
+ * return <code>true</code>.
+ * <p>
+ * The results reported by the this method reflect the net <i>effect</i> of
+ * the currently applied control mechanisms. It does not reflect unsaved
+ * access control policies or unsaved access control entries. Changes to
+ * access control status caused by these mechanisms only take effect on
+ * <code>Session.save()</code> and are only then reflected in the results of
+ * the privilege test methods.Returns the <code>AccessControlPolicy</code> objects that have been set
+ * to the node at <code>absPath</code> or an empty array if no policy has
+ * been set. This method reflects the binding state, including transient
+ * policy modifications.
+ * <p>
+ * Use {@link #getEffectivePolicies(String)} in order to determine the
+ * policy that effectively applies at <code>absPath</code>.Returns the <code>AccessControlPolicy</code> objects that currently are
+ * in effect at the node at <code>absPath</code>. This may be policies set
+ * through this API or some implementation specific (default) policies.Returns the access control policies that are capable of being applied to
+ * the node at <code>absPath</code>.Binds the <code>policy</code> to the node at <code>absPath</code>.
+ * <p>
+ * The behavior of the call <code>acm.setPolicy(absPath, policy)</code>
+ * differs depending on how the <code>policy</code> object was originally
+ * acquired.
+ * <p>
+ * If <code>policy</code> was acquired through {@link #getApplicablePolicies
+ * acm.getApplicablePolicies(absPath)} then that <code>policy</code> object
+ * is <i>added</i> to the node at <code>absPath</code>.
+ * <p>
+ * On the other hand, if <code>policy</code> was acquired through {@link
+ * #getPolicies acm.getPolicies(absPath)} then that <code>policy</code>
+ * object (usually after being altered) replaces its former version on the
+ * node at <code>absPath</code>.
+ * <p>
+ * This is session-write method and therefore the access control policy is
+ * only dispatched on <code>save</code> and will only take effect upon
+ * persist.
+ * <p>
+ * A <code>VersionException</code> will be thrown either immediately, on
+ * dispatch or on persists, if the node at <code>absPath</code> is read-only
+ * due to a checked-in node. Implementations may differ on when this
+ * validation is performed.
+ * <p>
+ * A <code>LockException</code> will be thrown either immediately, on
+ * dispatch or on persists, if a lock prevents the operation.
+ * Implementations may differ on when this validation is performed.Removes the specified <code>AccessControlPolicy</code> from the node at
+ * <code>absPath</code>.
+ * <p>
+ * An <code>AccessControlPolicy</code> can only be removed if it was bound
+ * to the specified node through this API before. The effect of the removal
+ * only takes place upon <code>Session.save()</code>. Note, that an
+ * implementation default or any other effective <code>AccessControlPolicy</code>
+ * that has not been applied to the node before may never be removed using
+ * this method.
+ * <p>
+ * A <code>PathNotFoundException</code> is thrown if no node at
+ * <code>absPath</code> exists or the session does not have privilege to
+ * retrieve the node.
+ * <p>
+ * An <code>AccessControlException</code> is thrown if the policy to remove
+ * does not exist at the node at <code>absPath</code>.
+ * <p>
+ * An <code>AccessDeniedException</code> is thrown if the session lacks
+ * <code>MODIFY_ACCESS_CONTROL</code> privilege for the <code>absPath</code>
+ * node.
+ * <p>
+ * An <code>LockException</code> is thrown either immediately, on dispatch
+ * or on persists, if the node at <code>absPath</code> is locked.
+ * Implementations may differ on when this validation is performed.
+ * <p>
+ * An <code>VersionException</code> is thrown either immediately, on
+ * dispatch or on persists, if the node at <code>absPath</code> is read-only
+ * due to a checked-in node.Implementations may differ on when this
+ * validation is performed.
+ * <p>
+ * A <code>RepositoryException</code> is thrown if another error occurs.
+ * @since JCR 2.0
+ */
+interface AccessControlManager {
+  /**
+   * Returns the privileges supported for absolute path <code>absPath</code>,
+   * which must be an existing node.
+   * <p>
+   * This method does not return the privileges held by the session. Instead,
+   * it returns the privileges that the repository supports.
+   * @param absPath an absolute path.
+   * @return an array of <code>Privilege</code>s.
+   * @throws PathNotFoundException if no node at <code>absPath</code> exists or the session does not have sufficient access to retrieve a node at that location.
+   * @throws RepositoryException if another error occurs.
+   */
+  getSupportedPrivileges(absPath: string): Privilege;
+
+  /**
+   * Returns the privilege with the specified <code>privilegeName</code>.
+   * Since the privilege name is a JCR name, it may be passed in either
+   * qualified or expanded form (see specification for details on JCR names).
+   * @param privilegeName the name of an existing privilege.
+   * @return the <code>Privilege</code> with the specified <code>privilegeName</code>.
+   * @throws AccessControlException if no privilege with the specified name exists.
+   * @throws RepositoryException if another error occurs.
+   */
+  privilegeFromName(privilegeName: string): Privilege;
+
+  /**
+   * Returns whether the session has the specified privileges for absolute
+   * path <code>absPath</code>, which must be an existing node.
+   * <p>
+   * Testing an aggregate privilege is equivalent to testing each non
+   * aggregate privilege among the set returned by calling
+   * <code>Privilege.getAggregatePrivileges()</code> for that privilege.
+   * <p>
+   * The results reported by the this method reflect the net <i>effect</i> of
+   * the currently applied control mechanisms. It does not reflect unsaved
+   * access control policies or unsaved access control entries. Changes to
+   * access control status caused by these mechanisms only take effect on
+   * <code>Session.save()</code> and are only then reflected in the results of
+   * the privilege test methods.
+   * @param absPath an absolute path.
+   * @param privileges an array of <code>Privilege</code>s.
+   * @return <code>true</code> if the session has the specified privileges; <code>false</code> otherwise.
+   * @throws PathNotFoundException if no node at <code>absPath</code> exists or the session does not have sufficent access to retrieve a node at that location.
+   * @throws RepositoryException if another error occurs.
+   */
+  hasPrivileges(absPath: string, privileges: Privilege): boolean;
+
+  /**
+   * Returns the privileges the session has for absolute path absPath, which
+   * must be an existing node.
+   * <p>
+   * The returned privileges are those for which {@link #hasPrivileges} would
+   * return <code>true</code>.
+   * <p>
+   * The results reported by the this method reflect the net <i>effect</i> of
+   * the currently applied control mechanisms. It does not reflect unsaved
+   * access control policies or unsaved access control entries. Changes to
+   * access control status caused by these mechanisms only take effect on
+   * <code>Session.save()</code> and are only then reflected in the results of
+   * the privilege test methods.
+   * @param absPath an absolute path.
+   * @return an array of <code>Privilege</code>s.
+   * @throws PathNotFoundException if no node at <code>absPath</code> exists or the session does not have sufficient access to retrieve a node at that location.
+   * @throws RepositoryException if another error occurs.
+   */
+  getPrivileges(absPath: string): Privilege;
+
+  /**
+   * Returns the <code>AccessControlPolicy</code> objects that have been set
+   * to the node at <code>absPath</code> or an empty array if no policy has
+   * been set. This method reflects the binding state, including transient
+   * policy modifications.
+   * <p>
+   * Use {@link #getEffectivePolicies(String)} in order to determine the
+   * policy that effectively applies at <code>absPath</code>.
+   * @param absPath an absolute path.
+   * @return an array of <code>AccessControlPolicy</code> objects or an empty array if no policy has been set.
+   * @throws PathNotFoundException if no node at <code>absPath</code> exists or the session does not have sufficient access to retrieve a node at that location.
+   * @throws AccessDeniedException if the session lacks <code>READ_ACCESS_CONTROL</code> privilege for the <code>absPath</code> node.
+   * @throws RepositoryException if another error occurs.
+   */
+  getPolicies(absPath: string): AccessControlPolicy;
+
+  /**
+   * Returns the <code>AccessControlPolicy</code> objects that currently are
+   * in effect at the node at <code>absPath</code>. This may be policies set
+   * through this API or some implementation specific (default) policies.
+   * @param absPath an absolute path.
+   * @return an array of <code>AccessControlPolicy</code> objects.
+   * @throws PathNotFoundException if no node at <code>absPath</code> exists or the session does not have sufficient access to retrieve a node at that location.
+   * @throws AccessDeniedException if the session lacks <code>READ_ACCESS_CONTROL</code> privilege for the <code>absPath</code> node.
+   * @throws RepositoryException if another error occurs.
+   */
+  getEffectivePolicies(absPath: string): AccessControlPolicy;
+
+  /**
+   * Returns the access control policies that are capable of being applied to
+   * the node at <code>absPath</code>.
+   * @param absPath an absolute path.
+   * @return an <code>AccessControlPolicyIterator</code> over the applicable access control policies or an empty iterator if no policies are applicable.
+   * @throws PathNotFoundException if no node at <code>absPath</code> exists or the session does not have sufficient access to retrieve a node at that location.
+   * @throws AccessDeniedException if the session lacks <code>READ_ACCESS_CONTROL</code> privilege for the <code>absPath</code> node.
+   * @throws RepositoryException if another error occurs.
+   */
+  getApplicablePolicies(absPath: string): AccessControlPolicyIterator;
+
+  /**
+   * Binds the <code>policy</code> to the node at <code>absPath</code>.
+   * <p>
+   * The behavior of the call <code>acm.setPolicy(absPath, policy)</code>
+   * differs depending on how the <code>policy</code> object was originally
+   * acquired.
+   * <p>
+   * If <code>policy</code> was acquired through {@link #getApplicablePolicies
+   * acm.getApplicablePolicies(absPath)} then that <code>policy</code> object
+   * is <i>added</i> to the node at <code>absPath</code>.
+   * <p>
+   * On the other hand, if <code>policy</code> was acquired through {@link
+   * #getPolicies acm.getPolicies(absPath)} then that <code>policy</code>
+   * object (usually after being altered) replaces its former version on the
+   * node at <code>absPath</code>.
+   * <p>
+   * This is session-write method and therefore the access control policy is
+   * only dispatched on <code>save</code> and will only take effect upon
+   * persist.
+   * <p>
+   * A <code>VersionException</code> will be thrown either immediately, on
+   * dispatch or on persists, if the node at <code>absPath</code> is read-only
+   * due to a checked-in node. Implementations may differ on when this
+   * validation is performed.
+   * <p>
+   * A <code>LockException</code> will be thrown either immediately, on
+   * dispatch or on persists, if a lock prevents the operation.
+   * Implementations may differ on when this validation is performed.
+   * @param absPath an absolute path.
+   * @param policy the <code>AccessControlPolicy</code> to be applied.
+   * @throws PathNotFoundException if no node at <code>absPath</code> exists or the session does not have sufficient access to retrieve a node at that location.
+   * @throws AccessControlException if the policy is not applicable.
+   * @throws AccessDeniedException if the session lacks <code>MODIFY_ACCESS_CONTROL</code> privilege for the <code>absPath</code> node.
+   * @throws LockException if a lock applies at the node at <code>absPath</code> and this implementation performs this validation immediately.
+   * @throws VersionException if the node at <code>absPath</code> is read-only due to a checked-in node and this implementation performs this validation immediately.
+   * @throws RepositoryException if another error occurs.
+   */
+  setPolicy(absPath: string, policy: AccessControlPolicy): void;
+
+  /**
+   * Removes the specified <code>AccessControlPolicy</code> from the node at
+   * <code>absPath</code>.
+   * <p>
+   * An <code>AccessControlPolicy</code> can only be removed if it was bound
+   * to the specified node through this API before. The effect of the removal
+   * only takes place upon <code>Session.save()</code>. Note, that an
+   * implementation default or any other effective <code>AccessControlPolicy</code>
+   * that has not been applied to the node before may never be removed using
+   * this method.
+   * <p>
+   * A <code>PathNotFoundException</code> is thrown if no node at
+   * <code>absPath</code> exists or the session does not have privilege to
+   * retrieve the node.
+   * <p>
+   * An <code>AccessControlException</code> is thrown if the policy to remove
+   * does not exist at the node at <code>absPath</code>.
+   * <p>
+   * An <code>AccessDeniedException</code> is thrown if the session lacks
+   * <code>MODIFY_ACCESS_CONTROL</code> privilege for the <code>absPath</code>
+   * node.
+   * <p>
+   * An <code>LockException</code> is thrown either immediately, on dispatch
+   * or on persists, if the node at <code>absPath</code> is locked.
+   * Implementations may differ on when this validation is performed.
+   * <p>
+   * An <code>VersionException</code> is thrown either immediately, on
+   * dispatch or on persists, if the node at <code>absPath</code> is read-only
+   * due to a checked-in node.Implementations may differ on when this
+   * validation is performed.
+   * <p>
+   * A <code>RepositoryException</code> is thrown if another error occurs.
+   * @param absPath an absolute path.
+   * @param policy the policy to be removed.
+   * @throws PathNotFoundException if no node at <code>absPath</code> exists or the session does not have sufficient access to retrieve a node at that location.
+   * @throws AccessControlException if no policy exists.
+   * @throws AccessDeniedException if the session lacks <code>MODIFY_ACCESS_CONTROL</code> privilege for the <code>absPath</code> node.
+   * @throws LockException if a lock applies at the node at <code>absPath</code> and this implementation performs this validation immediately instead of waiting until <code>save</code>.
+   * @throws VersionException if the node at <code>absPath</code> is versionable and checked-in or is non-versionable but its nearest versionable ancestor is checked-in and this implementation performs this validation immediately instead of waiting until <code>save</code>.
+   * @throws RepositoryException if another error occurs.
+   */
+  removePolicy(absPath: string, policy: AccessControlPolicy): void;
+}
+
+export default AccessControlManager;

package/hidden/javax/jcr/security/AccessControlPolicy/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The <code>AccessControlPolicy</code> is a marker interface for all kind of
+ * access control policies. This API defines two subinterfaces: <ul> <li>{@link
+ * NamedAccessControlPolicy},</li> <li>{@link AccessControlList}.</li> </ul>
+ *
+ * <p><strong>Sitevision note:</strong> Unsupported operation</p>
+ * @since JCR 2.0
+ */
+interface AccessControlPolicy {}
+
+export default AccessControlPolicy;

package/hidden/javax/jcr/security/AccessControlPolicyIterator/index.d.ts

@@ -0,0 +1,20 @@
+import AccessControlPolicy from "../AccessControlPolicy";
+
+/**
+ * Allows easy iteration through a list of <code>AccessControlPolicy</code>s
+ * with <code>nextAccessControlPolicy</code> as well as a <code>skip</code>
+ * method inherited from <code>RangeIterator</code>.
+ *
+ * <p><strong>Sitevision note:</strong> Unsupported operation</p>Returns the next <code>AccessControlPolicy</code> in the iteration.
+ * @since JCR 2.0
+ */
+interface AccessControlPolicyIterator {
+  /**
+   * Returns the next <code>AccessControlPolicy</code> in the iteration.
+   * @return the next <code>AccessControlPolicy</code> in the iteration.
+   * @throws java.util.NoSuchElementException if iteration has no more <code>AccessControlPolicy</code>s.
+   */
+  nextAccessControlPolicy(): AccessControlPolicy;
+}
+
+export default AccessControlPolicyIterator;

package/hidden/javax/jcr/security/NamedAccessControlPolicy/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * An <code>NamedAccessControlPolicy</code> is an opaque access control policy
+ * that is described by a JCR name and optionally a description.
+ * <code>NamedAccessControlPolicy</code> are immutable and can therefore be
+ * directly applied to a node without additional configuration step.
+ *
+ * <p><strong>Sitevision note:</strong> Unsupported operation</p>Returns the name of the access control policy, which is JCR name and
+ * should be unique among the choices applicable to any particular node.
+ * @since Sitevision 3.5
+ * @since JCR 2.0
+ */
+interface NamedAccessControlPolicy {
+  /**
+   * Returns the name of the access control policy, which is JCR name and
+   * should be unique among the choices applicable to any particular node.
+   * @return the name of the access control policy. A JCR name.
+   * @throws RepositoryException if an error occurs.
+   */
+  getName(): string;
+}
+
+export default NamedAccessControlPolicy;

package/hidden/javax/jcr/security/Privilege/index.d.ts

@@ -0,0 +1,117 @@
+/**
+ * A privilege represents the capability of performing a particular set of
+ * operations on items in the JCR repository. Each privilege is identified by a
+ * JCR name. JCR defines a set of standard privileges in the <code>jcr</code>
+ * namespace. Implementations may add additional privileges in namespaces other
+ * than <code>jcr</code>.
+ * <p>
+ * A privilege may be an aggregate privilege. Aggregate privileges are sets of
+ * other privileges. Granting, denying, or testing an aggregate privilege is
+ * equivalent to individually granting, denying, or testing each privilege it
+ * contains. The privileges contained by an aggregate privilege may themselves
+ * be aggregate privileges if the resulting privilege graph is acyclic.
+ * <p>
+ * A privilege may be an abstract privilege. Abstract privileges cannot
+ * themselves be granted or denied, but can be composed into aggregate
+ * privileges which are granted or denied.
+ * <p>
+ * A privilege can be both aggregate and abstract.
+ *
+ * <p><strong>Sitevision note:</strong> Unsupported operation</p>Returns the name of this privilege.
+ * <p>
+ * Since the privilege name is a JCR name, it must be returned
+ * in qualified form, according to the prevailing namespace-to-prefix
+ * mapping in the current <code>Session</code> (see the specification
+ * for details on JCR names).Returns whether this privilege is an abstract privilege.Returns whether this privilege is an aggregate privilege.If this privilege is an aggregate privilege, returns the privileges
+ * directly contained by the aggregate privilege. Otherwise returns an empty
+ * array.If this privilege is an aggregate privilege, returns the privileges it
+ * contains, the privileges contained by any aggregate privileges among
+ * those, and so on (the transitive closure of privileges contained by this
+ * privilege). Otherwise returns an empty array.A constant representing <code>jcr:read</code> (in expanded form), the
+ * privilege to retrieve a node and get its properties and their values.A constant representing <code>jcr:modifyProperties</code> (in expanded
+ * form), the privilege to create, modify and remove the properties of a
+ * node.A constant representing <code>jcr:addChildNodes</code> (in expanded
+ * form), the privilege to create child nodes of a node.A constant representing <code>jcr:removeNode</code> (in expanded form),
+ * the privilege to remove a node.
+ * <p>
+ * In order to actually remove a node requires <code>jcr:removeNode</code>
+ * on that node and <code>jcr:removeChildNodes</code> on the parent node.
+ * <p>
+ * The distinction is provided in order to reflect implementations that
+ * internally model "remove" as a "delete" instead of a "unlink". A
+ * repository that uses the "delete" model can have <code>jcr:removeChildNodes</code>
+ * in every access control policy, so that removal is effectively controlled
+ * by <code>jcr:removeNode</code>.A constant representing <code>jcr:removeChildNodes</code> (in expanded
+ * form), the privilege to remove child nodes of a node. In order to
+ * actually remove a node requires <code>jcr:removeNode</code> on that node
+ * and <code>jcr:removeChildNodes</code> on the parent node.
+ * <p>
+ * The distinction is provided in order to reflect implementations that
+ * internally model "remove" as a "unlink" instead of a "delete". A
+ * repository that uses the "unlink" model can have <code>jcr:removeNode</code>
+ * in every access control policy, so that removal is effectively controlled
+ * by <code>jcr:removeChildNodes</code>.A constant representing <code>jcr:write</code> (in expanded form), an
+ * aggregate privilege that contains: <ul> <li><code>jcr:modifyProperties</code></li>
+ * <li><code>jcr:addChildNodes</code></li> <li><code>jcr:removeNode</code></li>
+ * <li><code>jcr:removeChildNodes</code></li> </ul>A constant representing <code>jcr:readAccessControl</code> (in expanded
+ * form), the privilege to get the access control policy of a node.A constant representing <code>jcr:modifyAccessControl</code> (in expanded
+ * form), the privilege to modify the access control policies of a node.A constant representing <code>jcr:lockManagement</code> (in expanded
+ * form), the privilege to lock and unlock a node.A constant representing <code>jcr:versionManagement</code> (in expanded
+ * form), the privilege to perform versioning operations on a node.A constant representing <code>jcr:nodeTypeManagement</code> (in expanded
+ * form), the privilege to add and remove mixin node types and change the
+ * primary node type of a node.A constant representing <code>jcr:retentionManagement</code> (in expanded
+ * form), the privilege to perform retention management operations on a
+ * node.A constant representing <code>jcr:lifecycleManagement</code> (in expanded
+ * form), the privilege to perform lifecycle operations on a node.A constant representing <code>jcr:all</code> (in expanded form), an
+ * aggregate privilege that contains all predefined privileges. <ul>
+ * <li><code>jcr:read</code></li> <li><code>jcr:write</code></li>
+ * <li><code>jcr:readAccessControl</code></li> <li><code>jcr:modifyAccessControl</code></li>
+ * <li><code>jcr:lockManagement</code></li> <li><code>jcr:versionManagement</code></li>
+ * <li><code>jcr:nodeTypeManagement</code></li> <li><code>jcr:retentionManagement</code></li>
+ * <li><code>jcr:lifecycleManagement</code></li> </ul> It should, in
+ * addition, include all implementation-defined privileges.
+ * @since JCR 2.0
+ */
+interface Privilege {
+  /**
+   * Returns the name of this privilege.
+   * <p>
+   * Since the privilege name is a JCR name, it must be returned
+   * in qualified form, according to the prevailing namespace-to-prefix
+   * mapping in the current <code>Session</code> (see the specification
+   * for details on JCR names).
+   * @return the name of this privilege.
+   */
+  getName(): string;
+
+  /**
+   * Returns whether this privilege is an abstract privilege.
+   * @return <code>true</code> if this privilege is an abstract privilege; <code>false</code> otherwise.
+   */
+  isAbstract(): boolean;
+
+  /**
+   * Returns whether this privilege is an aggregate privilege.
+   * @return <code>true</code> if this privilege is an aggregate privilege; <code>false</code> otherwise.
+   */
+  isAggregate(): boolean;
+
+  /**
+   * If this privilege is an aggregate privilege, returns the privileges
+   * directly contained by the aggregate privilege. Otherwise returns an empty
+   * array.
+   * @return an array of <code>Privilege</code>s
+   */
+  getDeclaredAggregatePrivileges(): Privilege;
+
+  /**
+   * If this privilege is an aggregate privilege, returns the privileges it
+   * contains, the privileges contained by any aggregate privileges among
+   * those, and so on (the transitive closure of privileges contained by this
+   * privilege). Otherwise returns an empty array.
+   * @return an array of <code>Privilege</code>s
+   */
+  getAggregatePrivileges(): Privilege;
+}
+
+export default Privilege;

package/hidden/javax/jcr/version/Version/index.d.ts

@@ -0,0 +1,121 @@
+import VersionHistory from "../VersionHistory";
+import Node from "../../Node";
+
+/**
+ * A <code>Version</code> object wraps an <code>nt:version</code> node. It
+ * provides convenient access to version information.
+ *
+ * <p><strong>Sitevision note:</strong> Unsupported operation</p>Returns the <code>VersionHistory</code> that contains this
+ * <code>Version</code>.Returns the date this version was created. This corresponds to the value
+ * of the <code>jcr:created</code> property in the <code>nt:version</code>
+ * node that represents this version.Assuming that this <code>Version</code> object was acquired through a
+ * <code>Workspace</code> <code>W</code> and is within the
+ * <code>VersionHistory</code> <code>H</code>, this method returns the
+ * successor of this version along the same line of descent as is returned
+ * by <code>H.getAllLinearVersions()</code> where <code>H</code> was also
+ * acquired through <code>W</code>.
+ * <p>
+ * Note that under simple versioning the behavior of this method is
+ * equivalent to getting the unique successor (if any) of this version.Returns the successor versions of this version. This corresponds to
+ * returning all the <code>nt:version</code> nodes referenced by the
+ * <code>jcr:successors</code> multi-value property in the
+ * <code>nt:version</code> node that represents this version.
+ * <p>
+ * In a simple versioning repository this methodAssuming that this <code>Version</code> object was acquired through a
+ * <code>Workspace</code> <code>W</code> and is within the
+ * <code>VersionHistory</code> <code>H</code>, this method returns the
+ * predecessor of this version along the same line of descent as is returned
+ * by <code>H.getAllLinearVersions()</code> where <code>H</code> was also
+ * acquired through <code>W</code>.
+ * <p>
+ * Note that under simple versioning the behavior of this method is
+ * equivalent to getting the unique predecessor (if any) of this version.In both simple and full versioning repositories, this method returns the
+ * predecessor versions of this version. This corresponds to returning all
+ * the <code>nt:version</code> nodes whose <code>jcr:successors</code>
+ * property includes a reference to the <code>nt:version</code> node that
+ * represents this version.Returns the frozen node of this version.
+  
+    */
+interface Version {
+  /**
+   * Returns the <code>VersionHistory</code> that contains this
+   * <code>Version</code>.
+   * @return the <code>VersionHistory</code> that contains this <code>Version</code>.
+   * @throws RepositoryException if an error occurs.
+   */
+  getContainingHistory(): VersionHistory;
+
+  /**
+   * Returns the date this version was created. This corresponds to the value
+   * of the <code>jcr:created</code> property in the <code>nt:version</code>
+   * node that represents this version.
+   * @return a <code>Calendar</code> object
+   * @throws RepositoryException if an error occurs.
+   */
+  getCreated(): unknown;
+
+  /**
+   * Assuming that this <code>Version</code> object was acquired through a
+   * <code>Workspace</code> <code>W</code> and is within the
+   * <code>VersionHistory</code> <code>H</code>, this method returns the
+   * successor of this version along the same line of descent as is returned
+   * by <code>H.getAllLinearVersions()</code> where <code>H</code> was also
+   * acquired through <code>W</code>.
+   * <p>
+   * Note that under simple versioning the behavior of this method is
+   * equivalent to getting the unique successor (if any) of this version.
+   * @return a <code>Version</code> or <code>null</code> if no linear successor exists.
+   * @throws RepositoryException if an error occurs.
+   * @see VersionHistory#getAllLinearVersions
+   */
+  getLinearSuccessor(): Version;
+
+  /**
+   * Returns the successor versions of this version. This corresponds to
+   * returning all the <code>nt:version</code> nodes referenced by the
+   * <code>jcr:successors</code> multi-value property in the
+   * <code>nt:version</code> node that represents this version.
+   * <p>
+   * In a simple versioning repository this method
+   * @return a <code>Version</code> array.
+   * @throws RepositoryException if an error occurs.
+   */
+  getSuccessors(): Version;
+
+  /**
+   * Assuming that this <code>Version</code> object was acquired through a
+   * <code>Workspace</code> <code>W</code> and is within the
+   * <code>VersionHistory</code> <code>H</code>, this method returns the
+   * predecessor of this version along the same line of descent as is returned
+   * by <code>H.getAllLinearVersions()</code> where <code>H</code> was also
+   * acquired through <code>W</code>.
+   * <p>
+   * Note that under simple versioning the behavior of this method is
+   * equivalent to getting the unique predecessor (if any) of this version.
+   * @return a <code>Version</code> or <code>null</code> if no linear predecessor exists.
+   * @throws RepositoryException if an error occurs.
+   * @see VersionHistory#getAllLinearVersions
+   */
+  getLinearPredecessor(): Version;
+
+  /**
+   * In both simple and full versioning repositories, this method returns the
+   * predecessor versions of this version. This corresponds to returning all
+   * the <code>nt:version</code> nodes whose <code>jcr:successors</code>
+   * property includes a reference to the <code>nt:version</code> node that
+   * represents this version.
+   * @return a <code>Version</code> array.
+   * @throws RepositoryException if an error occurs.
+   */
+  getPredecessors(): Version;
+
+  /**
+   * Returns the frozen node of this version.
+   * @return a <code>Node</code> object
+   * @throws RepositoryException if an error occurs.
+   * @since JCR 2.0
+   */
+  getFrozenNode(): Node;
+}
+
+export default Version;