moeralib 0.18.3 → 0.18.7

package/typings/node/types.d.ts

@@ -9,9 +9,9 @@ export type OperationStatus = "waiting" | "added" | "started" | "succeeded" | "f
 export type PrincipalFlag = "none" | "private" | "admin" | "owner" | "secret" | "senior" | "enigma" | "major" | "signed" | "subscribed" | "public" | "friends" | "unset";
 export type PushContentType = "story-added" | "story-deleted" | "feed-updated";
 export type PushRelayType = "fcm";
-export type Scope = "none" | "identify" | "other" | "view-media" | "view-content" | "add-post" | "update-post" | "add-comment" | "update-comment" | "react" | "delete-own-content" | "delete-others-content" | "view-people" | "block" | "friend" | "remote-identify" | "drafts" | "view-feeds" | "update-feeds" | "name" | "plugins" | "view-profile" | "update-profile" | "sheriff" | "view-settings" | "update-settings" | "subscribe" | "tokens" | "user-lists" | "grant" | "upload-public-media" | "upload-private-media" | "view-all" | "all";
+export type Scope = "none" | "identify" | "other" | "view-content" | "add-post" | "update-post" | "add-comment" | "update-comment" | "react" | "delete-own-content" | "delete-others-content" | "view-people" | "block" | "friend" | "remote-identify" | "drafts" | "view-feeds" | "update-feeds" | "name" | "plugins" | "view-profile" | "update-profile" | "sheriff" | "view-settings" | "update-settings" | "subscribe" | "tokens" | "user-lists" | "grant" | "upload-public-media" | "upload-private-media" | "lease-media" | "view-all" | "all";
 export declare const SCOPE_VALUES: Record<Scope, number>;
-export type SearchContentUpdateType = "block" | "comment-add" | "comment-update" | "comment-update-heading" | "comment-update-media-text" | "comment-delete" | "friend" | "profile" | "posting-add" | "posting-update" | "posting-update-heading" | "posting-update-media-text" | "posting-delete" | "reaction-add" | "reaction-delete" | "reactions-delete-all" | "subscribe" | "unblock" | "unfriend" | "unsubscribe";
+export type SearchContentUpdateType = "block" | "comment-add" | "comment-update" | "comment-update-heading" | "comment-update-media" | "comment-update-media-text" | "comment-delete" | "friend" | "profile" | "posting-add" | "posting-update" | "posting-update-heading" | "posting-update-media" | "posting-update-media-text" | "posting-delete" | "reaction-add" | "reaction-delete" | "reactions-delete-all" | "subscribe" | "unblock" | "unfriend" | "unsubscribe";
 export type SearchEngine = "google" | "bing" | "yandex";
 export type SearchEntryType = "all" | "posting" | "comment";
 export type SettingType = "bool" | "int" | "string" | "json" | "Duration" | "PrivateKey" | "PublicKey" | "Timestamp" | "UUID" | "Principal";
@@ -761,6 +761,7 @@ export interface ContactInfo {
     nodeName: string;
     fullName?: string | null;
     gender?: string | null;
+    title?: string | null;
     avatar?: AvatarImage | null;
     /**
      * social distance between the contact and the node, which depends on subscription and friendship status and the
@@ -804,6 +805,12 @@ export interface ContactInfo {
      */
     adminOperations?: ContactOperations | null;
 }
+export interface VisitedNodeAttributes {
+    /**
+     * name of the visited node
+     */
+    nodeName: string;
+}
 export interface Credentials {
     login: string;
     password: string;
@@ -1122,28 +1129,16 @@ export interface LinkPreview {
      * hash of the image presenting the page
      */
     imageHash?: string | null;
-}
-export interface LinkPreviewInfo {
-    /**
-     * name of the site
-     */
-    siteName?: string | null;
-    /**
-     * canonical URL of the page
-     */
-    url?: string | null;
-    /**
-     * title of the page
-     */
-    title?: string | null;
     /**
-     * description of the page
+     * timestamp of the page publication time
      */
-    description?: string | null;
+    publishedAt?: number | null;
+}
+export interface MediaDownloadAttributes {
     /**
-     * URL of the image presenting the page
+     * media grant allowing access to the media
      */
-    imageUrl?: string | null;
+    grant: string;
 }
 export interface MediaFilePreviewInfo {
     /**
@@ -1154,6 +1149,10 @@ export interface MediaFilePreviewInfo {
      * SHA-1 hash of the preview
      */
     hash: string;
+    /**
+     * virtual location of the preview, relative to the ``/media`` virtual page
+     */
+    path: string;
     /**
      * location of the preview, relative to the ``/media``; points to a static image served directly from a filesystem
      * or CDN
@@ -1180,15 +1179,75 @@ export interface MediaFilePreviewInfo {
      */
     original?: boolean | null;
 }
-export interface MediaWithDigest {
+export interface MediaLeaseAttributes {
+    /**
+     * name of the node that receives the lease
+     */
+    nodeName: string;
     /**
      * ID of the media file
      */
+    mediaId: string;
+    /**
+     * ID of the posting used to verify access to the media file
+     */
+    postingId?: string | null;
+    /**
+     * ID of the comment used to verify access to the media file
+     */
+    commentId?: string | null;
+}
+export interface MediaUploadAttributes {
+    /**
+     * MIME type of the media source file
+     */
+    mimeType: string;
+    /**
+     * title of the media file, may be used as an alternative to the file name
+     */
+    title?: string | null;
+    /**
+     * full file size in bytes
+     */
+    fileSize: number;
+    /**
+     * client-proposed chunk size in bytes
+     */
+    chunkSize?: number | null;
+}
+export interface MediaUploadInfo {
+    /**
+     * upload ID
+     */
     id: string;
     /**
-     * cryptographic digest of the media file
+     * MIME type of the media source file
      */
-    digest?: string | null;
+    mimeType?: string | null;
+    /**
+     * title of the media file, may be used as an alternative to the file name
+     */
+    title?: string | null;
+    /**
+     * full file size in bytes
+     */
+    fileSize: number;
+    /**
+     * chunk size in bytes
+     */
+    chunkSize: number;
+    /**
+     * zero-based numbers of uploaded chunks, sorted in natural order
+     */
+    uploadedChunks: number[];
+    /**
+     * upload expiration timestamp - the real time when the upload may be deleted
+     */
+    deadline: number;
+    /**
+     * upload completion timestamp - the real time when all chunks were uploaded
+     */
+    completedAt?: number | null;
 }
 export interface NameToRegister {
     name: string;
@@ -1262,6 +1321,27 @@ export interface NodeNameInfo {
      */
     operations?: NodeNameOperations | null;
 }
+export interface ParentMediaInfo {
+    /**
+     * name of the node containing the media the posting is linked to; if ``null``, the media is located on the same
+     * node as the posting
+     */
+    nodeName?: string | null;
+    /**
+     * ID of the media the posting is linked to; the media is located on the ``nodeName`` node
+     */
+    mediaId: string;
+    /**
+     * ID of the posting that owns the attachment the posting is linked to; the posting is located at the same node as
+     * the posting
+     */
+    postingId: string;
+    /**
+     * ID of the comment that owns the attachment the posting is linked to; if set, ``postingId`` contains ID of the
+     * parent posting of the comment; the comment is located at the same node as the posting
+     */
+    commentId?: string | null;
+}
 export interface PeopleGeneralInfo {
     /**
      * total number of subscribers of the node
@@ -1352,18 +1432,6 @@ export interface PostingFeatures {
      * list of source text formats the node understands
      */
     sourceFormats: SourceFormat[];
-    /**
-     * maximal size of a media attachment in a post
-     */
-    mediaMaxSize: number;
-    /**
-     * maximal size of a compressed image in a post
-     */
-    imageRecommendedSize: number;
-    /**
-     * maximal resolution of a compressed image in a post (in pixels)
-     */
-    imageRecommendedPixels: number;
     /**
      * list of image formats (in MIME type form) the node understands
      */
@@ -1410,6 +1478,10 @@ export interface PrivateMediaFileInfo {
      * SHA-1 hash of the media file
      */
     hash: string;
+    /**
+     * cryptographic digest of the media file
+     */
+    digest: string;
     /**
      * virtual location of the media file, relative to the ``/media`` virtual page
      */
@@ -1452,10 +1524,6 @@ export interface PrivateMediaFileInfo {
      * the text contained in the image, if any
      */
     textContent?: string | null;
-    /**
-     * ID of the posting linked to the media
-     */
-    postingId?: string | null;
     /**
      * list of media previews - downscaled versions of the media
      */
@@ -1469,6 +1537,14 @@ export interface PrivateMediaFileInfo {
      * ``true`` if the media file is considered to be malware, ``false`` (default) otherwise
      */
     malware?: boolean | null;
+    /**
+     * media grant allowing access to the media
+     */
+    grant?: string | null;
+    /**
+     * grant expiration timestamp - the real time when the grant will not be valid anymore
+     */
+    grantExpiresAt?: number | null;
     /**
      * the supported operations and the corresponding principals
      */
@@ -1921,33 +1997,65 @@ export interface RemoteFeed {
     feedName: string;
 }
 export interface RemoteMedia {
+    /**
+     * name of the node the media file is located on
+     */
+    nodeName: string;
     /**
      * ID of the media file
      */
-    id: string;
+    mediaId: string;
     /**
      * SHA-1 hash of the media file
      */
-    hash?: string | null;
+    hash: string;
     /**
      * cryptographic digest of the media file
      */
-    digest?: string | null;
+    digest: string;
     /**
      * MIME type of the media
      */
     mimeType: string;
+    /**
+     * width of the media in pixels (``null``, if the media file is not an image or video)
+     */
+    width?: number | null;
+    /**
+     * height of the media in pixels (``null``, if the media file is not an image or video)
+     */
+    height?: number | null;
+    /**
+     * size of the media file in bytes
+     */
+    size: number;
+    /**
+     * title of the media file, may be used as an alternative to the file name
+     */
+    title?: string | null;
     /**
      * ``true`` if the media cannot be displayed as an image or video and should be displayed as an attachment instead,
      * ``false`` (default) otherwise
      */
     attachment?: boolean | null;
+    /**
+     * ID of the lease
+     */
+    leaseId?: string | null;
 }
 export interface RemoteMediaInfo {
     /**
-     * ID of the media file
+     * ID of the remote media file object
      */
     id: string;
+    /**
+     * name of the node the media file is located on
+     */
+    nodeName: string;
+    /**
+     * ID of the media file on the node it is located on
+     */
+    mediaId: string;
     /**
      * SHA-1 hash of the media file
      */
@@ -1960,11 +2068,31 @@ export interface RemoteMediaInfo {
      * MIME type of the media
      */
     mimeType?: string | null;
+    /**
+     * width of the media in pixels (``null``, if the media file is not an image or video)
+     */
+    width?: number | null;
+    /**
+     * height of the media in pixels (``null``, if the media file is not an image or video)
+     */
+    height?: number | null;
+    /**
+     * size of the media file in bytes
+     */
+    size?: number | null;
+    /**
+     * title of the media file, may be used as an alternative to the file name
+     */
+    title?: string | null;
     /**
      * ``true`` if the media cannot be displayed as an image or video and should be displayed as an attachment instead,
      * ``false`` (default) otherwise
      */
     attachment?: boolean | null;
+    /**
+     * media grant allowing access to the media
+     */
+    grant?: string | null;
 }
 export interface RemotePosting {
     /**
@@ -2105,6 +2233,36 @@ export interface SearchCommentHeadingUpdate {
      */
     heading: string;
 }
+export interface SearchCommentMediaUpdate {
+    /**
+     * ID of the posting
+     */
+    postingId: string;
+    /**
+     * ID of the comment
+     */
+    commentId: string;
+    /**
+     * ID of the media
+     */
+    mediaId: string;
+    /**
+     * name of the node where the media is originated from
+     */
+    remoteMediaNodeName: string;
+    /**
+     * ID of the media on the original node
+     */
+    remoteMediaId: string;
+    /**
+     * title of the media file, may be used as an alternative to the file name
+     */
+    title?: string | null;
+    /**
+     * text content of the media
+     */
+    textContent?: string | null;
+}
 export interface SearchCommentMediaTextUpdate {
     /**
      * ID of the posting
@@ -2276,6 +2434,32 @@ export interface SearchPostingHeadingUpdate {
      */
     heading: string;
 }
+export interface SearchPostingMediaUpdate {
+    /**
+     * ID of the posting
+     */
+    postingId: string;
+    /**
+     * ID of the media
+     */
+    mediaId: string;
+    /**
+     * name of the node where the media is originated from
+     */
+    remoteMediaNodeName: string;
+    /**
+     * ID of the media on the original node
+     */
+    remoteMediaId: string;
+    /**
+     * title of the media file, may be used as an alternative to the file name
+     */
+    title?: string | null;
+    /**
+     * text content of the media
+     */
+    textContent?: string | null;
+}
 export interface SearchPostingMediaTextUpdate {
     /**
      * ID of the posting
@@ -3370,6 +3554,24 @@ export interface VerificationInfo {
      */
     errorMessage?: string | null;
 }
+export interface VisitDetails {
+    /**
+     * ID of the visited posting
+     */
+    postingId: string;
+    /**
+     * ID of the visited comment
+     */
+    commentId?: string | null;
+    /**
+     * ID of the visited media
+     */
+    mediaId?: string | null;
+    /**
+     * page referrer
+     */
+    referrer?: string | null;
+}
 export interface WhoAmI {
     nodeName?: string | null;
     /**
@@ -3557,388 +3759,207 @@ export interface CommentMassAttributes {
      */
     seniorRejectedReactions?: RejectedReactions | null;
 }
-export interface CommentRevisionInfoBase<B> {
-    id: string;
+export interface ContactWithRelationships {
     /**
-     * ID of the posting revision that was actual at the moment of creation of this comment revision
+     * contact's details
      */
-    postingRevisionId: string;
+    contact: ContactInfo;
     /**
-     * preview of the revision's body, a string representation of a JSON structure
+     * information about the contact's subscription to the node's feeds
      */
-    bodyPreview?: B | null;
+    subscriber?: SubscriberInfo | null;
     /**
-     * hash of the source text of the revision
+     * information about the node's subscription to the contact's feeds
      */
-    bodySrcHash: string;
+    subscription?: SubscriptionInfo | null;
     /**
-     * format of the source text of the revision, the list of available formats is returned in ``PostingFeatures``
+     * information about the node's friendship with the contact
      */
-    bodySrcFormat?: SourceFormat | null;
+    friend?: FriendInfo | null;
     /**
-     * body of the revision, a string representation of a JSON structure
+     * information about the contact's friendship with the node
      */
-    body: B;
+    friendOf?: FriendOfInfo | null;
     /**
-     * format of the body of the revision, may have any value meaningful for the client
+     * information about blocking the contact by the node
      */
-    bodyFormat?: BodyFormat | null;
+    blocked?: BlockedUserInfo[] | null;
     /**
-     * heading of the revision
+     * information about blocking the node by the contact
      */
-    heading: string;
+    blockedBy?: BlockedByUserInfo[] | null;
+}
+export interface Features {
     /**
-     * in addition to ``heading``, gives a more detailed description of the revision that can be used for search
-     * engines and link previews
+     * features of a posting
      */
-    description?: string | null;
+    posting: PostingFeatures;
     /**
-     * revision creation timestamp - the real time when the revision was created
+     * list of names of plugins enabled for the node
      */
-    createdAt: number;
+    plugins?: string[] | null;
     /**
-     * revision deletion timestamp - the time when the revision was deleted
+     * width of the feed in pixels
      */
-    deletedAt?: number | null;
+    feedWidth: number;
     /**
-     * revision deletion timestamp - the time when the revision will be deleted and the previous revision will take its
-     * place
+     * features of groups of friends
      */
-    deadline?: number | null;
-    /**
-     * cryptographic digest of the revision (use ``Comment`` fingerprint)
-     */
-    digest?: string | null;
-    /**
-     * the comment's owner signature (use ``Comment`` fingerprint)
-     */
-    signature?: string | null;
-    /**
-     * signature version (i.e. fingerprint version)
-     */
-    signatureVersion?: number | null;
+    friendGroups?: FriendGroupsFeatures | null;
     /**
-     * details of the existing reaction (if any) of the client's owner
+     * list of requests to the node owner that are accepted by the node
      */
-    clientReaction?: ClientReactionInfo | null;
+    ask?: AskSubject[] | null;
     /**
-     * summary of reactions to the revision
+     * ``true``, if the node is subscribed to the client, ``false`` otherwise
      */
-    reactions?: ReactionTotalsInfo | null;
+    subscribed?: boolean | null;
 }
-export type EncodedCommentRevisionInfo = CommentRevisionInfoBase<string>;
-export type CommentRevisionInfo = CommentRevisionInfoBase<Body>;
-export interface CommentSourceText {
-    /**
-     * avatar of the comment's owner
-     */
-    ownerAvatar?: AvatarDescription | null;
-    /**
-     * the source text of the comment, a string representation of a JSON structure
-     */
-    bodySrc?: Body | string | null;
+export interface FeedInfo {
     /**
-     * format of the source text of the comment, ``plain-text`` by default; the list of available formats is returned
-     * in ``PostingFeatures``
+     * name of the feed
      */
-    bodySrcFormat?: SourceFormat | null;
+    feedName: string;
     /**
-     * array of IDs and digests of private media to be attached to the comment
+     * title of the feed
      */
-    media?: MediaWithDigest[] | null;
+    title?: string | null;
     /**
-     * types of reactions that the comment rejects
+     * total number of stories in the feed
      */
-    rejectedReactions?: RejectedReactions | null;
+    total: number;
     /**
-     * types of reactions that the comment rejects, as defined by the posting's owner ("senior"); only the senior may
-     * set this
+     * creation timestamp of the earliest story in the feed
      */
-    seniorRejectedReactions?: RejectedReactions | null;
+    firstCreatedAt?: number | null;
     /**
-     * ID of the comment this comment is replying to
+     * creation timestamp of the latest story in the feed
      */
-    repliedToId?: string | null;
+    lastCreatedAt?: number | null;
     /**
-     * the operations and the corresponding principals
+     * the supported operations and the corresponding principals
      */
-    operations?: CommentOperations | null;
+    operations?: FeedOperations | null;
     /**
-     * the operations and the corresponding principals that are overridden in reactions to the comment
+     * list of sheriffs supervising the feed
      */
-    reactionOperations?: ReactionOperations | null;
+    sheriffs?: string[] | null;
     /**
-     * the operations and the corresponding principals that are overridden by the posting's owner ("senior"); only the
-     * senior may set this
+     * list of sheriff marks on the feed
      */
-    seniorOperations?: CommentOperations | null;
+    sheriffMarks?: SheriffMark[] | null;
 }
-export interface CommentText {
-    /**
-     * node name of the comment's owner
-     */
-    ownerName?: string | null;
-    /**
-     * full name of the comment's owner
-     */
-    ownerFullName?: string | null;
-    /**
-     * gender of the comment's owner
-     */
-    ownerGender?: string | null;
-    /**
-     * avatar of the comment's owner
-     */
-    ownerAvatar?: AvatarDescription | null;
-    /**
-     * preview of the comment's body, a string representation of a JSON structure
-     */
-    bodyPreview?: Body | string | null;
-    /**
-     * the source text of the comment, a string representation of a JSON structure
-     */
-    bodySrc?: Body | string | null;
-    /**
-     * format of the source text of the comment, ``plain-text`` by default; the list of available formats is returned
-     * in ``PostingFeatures``
-     */
-    bodySrcFormat?: SourceFormat | null;
-    /**
-     * body of the comment, a string representation of a JSON structure
-     */
-    body?: Body | string | null;
-    /**
-     * format of the body of the comment, may have any value meaningful for the client
-     */
-    bodyFormat?: BodyFormat | null;
-    /**
-     * array of IDs of private media to be attached to the comment
-     */
-    media?: string[] | null;
-    /**
-     * comment creation timestamp - the real time when the comment was created
-     */
-    createdAt?: number | null;
-    /**
-     * types of reactions that the comment rejects
-     */
-    rejectedReactions?: RejectedReactions | null;
-    /**
-     * types of reactions that the comment rejects, as defined by the posting's owner ("senior"); only the senior may
-     * set this
-     */
-    seniorRejectedReactions?: RejectedReactions | null;
-    /**
-     * ID of the comment this comment is replying to
-     */
-    repliedToId?: string | null;
-    /**
-     * the comment's owner signature (use ``Comment`` fingerprint)
-     */
-    signature?: string | null;
-    /**
-     * signature version (i.e. fingerprint version)
-     */
-    signatureVersion?: number | null;
-    /**
-     * ``true``, if the comment is being be checked by the post's author before publication, ``false`` (default)
-     * otherwise; only the senior may set this
-     */
-    premoderating?: boolean | null;
-    /**
-     * the operations and the corresponding principals
-     */
-    operations?: CommentOperations | null;
+export interface FriendDescription {
     /**
-     * the operations and the corresponding principals that are overridden in reactions to the comment
+     * name of the node
      */
-    reactionOperations?: ReactionOperations | null;
+    nodeName: string;
     /**
-     * the operations and the corresponding principals that are overridden by the posting's owner ("senior"); only the
-     * senior may set this
+     * groups of friends the node is to be included into
      */
-    seniorOperations?: CommentOperations | null;
+    groups?: FriendGroupAssignment[] | null;
 }
-export interface ContactWithRelationships {
-    /**
-     * contact's details
-     */
-    contact: ContactInfo;
+export interface LinkPreviewInfo {
     /**
-     * information about the contact's subscription to the node's feeds
+     * name of the site
      */
-    subscriber?: SubscriberInfo | null;
+    siteName?: string | null;
     /**
-     * information about the node's subscription to the contact's feeds
+     * canonical URL of the page
      */
-    subscription?: SubscriptionInfo | null;
+    url?: string | null;
     /**
-     * information about the node's friendship with the contact
+     * title of the page
      */
-    friend?: FriendInfo | null;
+    title?: string | null;
     /**
-     * information about the contact's friendship with the node
+     * description of the page
      */
-    friendOf?: FriendOfInfo | null;
+    description?: string | null;
     /**
-     * information about blocking the contact by the node
+     * image presenting the page
      */
-    blocked?: BlockedUserInfo[] | null;
+    image?: PrivateMediaFileInfo | null;
     /**
-     * information about blocking the node by the contact
+     * timestamp of the page publication time
      */
-    blockedBy?: BlockedByUserInfo[] | null;
+    publishedAt?: number | null;
 }
-export interface DraftText {
-    /**
-     * type of the draft
-     */
-    draftType: DraftType;
-    /**
-     * name of the node the draft is related to
-     */
-    receiverName: string;
-    /**
-     * ID of the posting, mandatory for all types, except ``new-posting``
-     */
-    receiverPostingId?: string | null;
-    /**
-     * ID of the comment, mandatory for ``comment-update`` type
-     */
-    receiverCommentId?: string | null;
-    /**
-     * ID of the comment replied to
-     */
-    repliedToId?: string | null;
-    /**
-     * full name of the posting's/comment's owner
-     */
-    ownerFullName?: string | null;
-    /**
-     * avatar of the posting's/comment's owner
-     */
-    ownerAvatar?: AvatarDescription | null;
-    /**
-     * types of reactions that the posting rejects
-     */
-    rejectedReactions?: RejectedReactions | null;
-    /**
-     * types of reactions that the posting's comments should reject
-     */
-    commentRejectedReactions?: RejectedReactions | null;
-    /**
-     * the source text of the draft, a string representation of a JSON structure
-     */
-    bodySrc?: Body | string | null;
-    /**
-     * format of the source text of the draft, ``plain-text`` by default; the list of available formats is returned in
-     * ``PostingFeatures``
-     */
-    bodySrcFormat?: SourceFormat | null;
+export interface MediaAttachment {
     /**
-     * list of the media attached to the draft, the media may be located on another node
+     * details of the attached media, may be absent if the media is not located on the node
      */
-    media?: RemoteMedia[] | null;
+    media?: PrivateMediaFileInfo | null;
     /**
-     * story publication timestamp - the time the story must be published under in the feed
+     * (drafts only) ID of the lease of the local media to the target node
      */
-    publishAt?: number | null;
+    mediaLeaseId?: string | null;
     /**
-     * description of the update
+     * details of the media, if it is located on another node
      */
-    updateInfo?: UpdateInfo | null;
+    remoteMedia?: RemoteMediaInfo | null;
     /**
-     * draft of the list of operations and the corresponding principals
+     * ID of the child posting linked to the attachment, if any
      */
-    operations?: PostingOperations | null;
+    postingId?: string | null;
     /**
-     * draft of the list of operations and the corresponding principals that are overridden in the posting's comments
+     * ``true`` if the media is used in the body of the posting/comment, ``false`` otherwise
      */
-    commentOperations?: CommentOperations | null;
+    embedded: boolean;
 }
-export interface Features {
-    /**
-     * features of a posting
-     */
-    posting: PostingFeatures;
+export interface MediaCaptionBase<B> {
     /**
-     * list of names of plugins enabled for the node
+     * ID of the media file the caption belongs to
      */
-    plugins?: string[] | null;
-    /**
-     * width of the feed in pixels
-     */
-    feedWidth: number;
-    /**
-     * features of groups of friends
-     */
-    friendGroups?: FriendGroupsFeatures | null;
+    mediaId: string;
     /**
-     * list of requests to the node owner that are accepted by the node
+     * caption source text, a string representation of a JSON structure
      */
-    ask?: AskSubject[] | null;
+    captionSrc?: B | null;
     /**
-     * ``true``, if the node is subscribed to the client, ``false`` otherwise
+     * format of the caption source text
      */
-    subscribed?: boolean | null;
+    captionSrcFormat?: SourceFormat | null;
 }
-export interface FeedInfo {
-    /**
-     * name of the feed
-     */
-    feedName: string;
-    /**
-     * title of the feed
-     */
-    title?: string | null;
-    /**
-     * total number of stories in the feed
-     */
-    total: number;
-    /**
-     * creation timestamp of the earliest story in the feed
-     */
-    firstCreatedAt?: number | null;
-    /**
-     * creation timestamp of the latest story in the feed
-     */
-    lastCreatedAt?: number | null;
+export type EncodedMediaCaption = MediaCaptionBase<string>;
+export type MediaCaption = MediaCaptionBase<Body>;
+export interface MediaCaptionText {
     /**
-     * the supported operations and the corresponding principals
+     * ID of the media file the caption belongs to
      */
-    operations?: FeedOperations | null;
+    mediaId: string;
     /**
-     * list of sheriffs supervising the feed
+     * caption source text, a string representation of a JSON structure
      */
-    sheriffs?: string[] | null;
+    captionSrc?: Body | string | null;
     /**
-     * list of sheriff marks on the feed
+     * format of the caption source text
      */
-    sheriffMarks?: SheriffMark[] | null;
+    captionSrcFormat?: SourceFormat | null;
 }
-export interface FriendDescription {
+export interface MediaLeaseInfo {
     /**
-     * name of the node
+     * ID of the lease
      */
-    nodeName: string;
+    id: string;
     /**
-     * groups of friends the node is to be included into
+     * details of the media
      */
-    groups?: FriendGroupAssignment[] | null;
+    media: PrivateMediaFileInfo;
 }
-export interface MediaAttachment {
+export interface MediaToAttach {
     /**
-     * details of the attached media, may be absent if the media is not located on the node
+     * ID of the local media to attach
      */
-    media?: PrivateMediaFileInfo | null;
+    localMediaId?: string | null;
     /**
-     * details of the media, if it is located on another node
+     * (drafts only) ID of the lease of the local media to the target node
      */
-    remoteMedia?: RemoteMediaInfo | null;
+    localMediaLeaseId?: string | null;
     /**
-     * ``true`` if the media is used in the body of the posting/comment, ``false`` otherwise
+     * remote media to attach
      */
-    embedded: boolean;
+    remoteMedia?: RemoteMedia | null;
 }
 export interface PostingInfoBase<B> {
     id: string;
@@ -3975,9 +3996,9 @@ export interface PostingInfoBase<B> {
      */
     receiverPostingId?: string | null;
     /**
-     * ID of the media the posting is linked to, if any
+     * information about the media the posting is linked to, if any
      */
-    parentMediaId?: string | null;
+    parentMedia?: ParentMediaInfo | null;
     /**
      * node name of the posting's owner
      */
@@ -4152,6 +4173,10 @@ export interface PostingInfoBase<B> {
      * total number of comments to the posting
      */
     totalComments?: number | null;
+    /**
+     * number of posting views (for admin only)
+     */
+    viewCount?: number | null;
     /**
      * ``true``, if the posting was recommended by a recommendation service (for cached copies of remote postings
      * only), ``false`` otherwise
@@ -4262,9 +4287,13 @@ export interface PostingSourceText {
      */
     bodySrcFormat?: SourceFormat | null;
     /**
-     * array of IDs and digests of private media to be attached to the posting
+     * array of media to be attached to the posting
      */
-    media?: MediaWithDigest[] | null;
+    media?: MediaToAttach[] | null;
+    /**
+     * captions of the media to be attached to the posting
+     */
+    mediaCaptions?: MediaCaptionText[] | null;
     /**
      * types of reactions that the posting rejects
      */
@@ -4329,9 +4358,9 @@ export interface PostingText {
      */
     bodyFormat?: BodyFormat | null;
     /**
-     * array of IDs of private media to be attached to the posting
+     * array of media to be attached to the posting
      */
-    media?: string[] | null;
+    media?: MediaToAttach[] | null;
     /**
      * posting creation timestamp - the real time when the posting was created
      */
@@ -4445,6 +4474,11 @@ export interface SearchEntryInfoBase<B> {
      * preview of the media attached to the entry, if any
      */
     mediaPreview?: PublicMediaFileInfo | null;
+    /**
+     * Source node of the media attached to the entry that was chosen for the preview (``null``, if the media is
+     * located on the same node as the entry)
+     */
+    mediaPreviewNodeName?: string | null;
     /**
      * ID of the media attached to the entry that was chosen for the preview
      */
@@ -4623,183 +4657,393 @@ export interface CommentInfoBase<B> {
      */
     ownerGender?: string | null;
     /**
-     * avatar of the comment's owner
+     * avatar of the comment's owner
+     */
+    ownerAvatar?: AvatarImage | null;
+    /**
+     * ID of the parent posting of the comment
+     */
+    postingId: string;
+    /**
+     * ID of the revision of parent posting that was current when the comment was created
+     */
+    postingRevisionId: string;
+    /**
+     * ID of the current revision of the comment
+     */
+    revisionId: string;
+    /**
+     * total number of revisions the comment has
+     */
+    totalRevisions: number;
+    /**
+     * preview of the comment's body, a string representation of a JSON structure
+     */
+    bodyPreview?: B | null;
+    /**
+     * the source text of the comment, a string representation of a JSON structure, may be absent if not requested
+     */
+    bodySrc?: B | null;
+    /**
+     * hash of the source text of the comment
+     */
+    bodySrcHash: string;
+    /**
+     * format of the source text of the comment, the list of available formats is returned in ``PostingFeatures``
+     */
+    bodySrcFormat?: SourceFormat | null;
+    /**
+     * body of the comment, a string representation of a JSON structure
+     */
+    body: B;
+    /**
+     * format of the body of the comment, may have any value meaningful for the client
+     */
+    bodyFormat?: BodyFormat | null;
+    /**
+     * list of the media attached to the comment
+     */
+    media?: MediaAttachment[] | null;
+    /**
+     * heading of the comment
+     */
+    heading: string;
+    /**
+     * in addition to ``heading``, gives a more detailed description of the comment that can be used for search engines
+     * and link previews
+     */
+    description?: string | null;
+    /**
+     * information about the comment this comment is replying to
+     */
+    repliedTo?: RepliedTo | null;
+    moment: number;
+    /**
+     * comment creation timestamp - the real time when the comment was created
+     */
+    createdAt: number;
+    /**
+     * comment editing timestamp - the last time the comment was updated
+     */
+    editedAt?: number | null;
+    /**
+     * comment deletion timestamp - the time when the comment was deleted
+     */
+    deletedAt?: number | null;
+    /**
+     * creation timestamp of the current revision of the comment
+     */
+    revisionCreatedAt: number;
+    /**
+     * comment purging timestamp - the time when the deleted comment will be purged from the database
+     */
+    deadline?: number | null;
+    /**
+     * cryptographic digest of the comment (use ``Comment`` fingerprint)
+     */
+    digest?: string | null;
+    /**
+     * the comment's owner signature (use ``Comment`` fingerprint)
+     */
+    signature?: string | null;
+    /**
+     * signature version (i.e. fingerprint version)
+     */
+    signatureVersion?: number | null;
+    /**
+     * ``true``, if the comment is being be checked by the post's author before publication, ``false`` (default)
+     * otherwise
+     */
+    premoderating?: boolean | null;
+    /**
+     * the supported operations and the corresponding principals
+     */
+    operations?: CommentOperations | null;
+    /**
+     * the operations and the corresponding principals that are overridden in reactions to the comment
+     */
+    reactionOperations?: ReactionOperations | null;
+    /**
+     * the supported operations and the corresponding principals as defined by the comment's owner
+     */
+    ownerOperations?: CommentOperations | null;
+    /**
+     * the operations and the corresponding principals that are overridden by the posting's owner ("senior")
+     */
+    seniorOperations?: CommentOperations | null;
+    /**
+     * operations on the comment that are blocked for the client
+     */
+    blockedOperations?: BlockedEntryOperation[] | null;
+    /**
+     * list of sheriff marks on the comment
+     */
+    sheriffMarks?: SheriffMark[] | null;
+    /**
+     * types of reactions that the comment rejects
+     */
+    rejectedReactions?: RejectedReactions | null;
+    /**
+     * types of reactions that the comment rejects, as defined by the comments' owner
+     */
+    ownerRejectedReactions?: RejectedReactions | null;
+    /**
+     * types of reactions that the comment rejects, as defined by the posting's owner ("senior")
+     */
+    seniorRejectedReactions?: RejectedReactions | null;
+    /**
+     * details of the existing reaction (if any) of the client's owner
+     */
+    clientReaction?: ClientReactionInfo | null;
+    /**
+     * details of the existing reaction (if any) of the posting's owner ("senior") to the comment
+     */
+    seniorReaction?: ClientReactionInfo | null;
+    /**
+     * summary of reactions to the comment
+     */
+    reactions?: ReactionTotalsInfo | null;
+}
+export type EncodedCommentInfo = CommentInfoBase<string>;
+export type CommentInfo = CommentInfoBase<Body>;
+export interface CommentRevisionInfoBase<B> {
+    id: string;
+    /**
+     * ID of the posting revision that was actual at the moment of creation of this comment revision
+     */
+    postingRevisionId: string;
+    /**
+     * preview of the revision's body, a string representation of a JSON structure
+     */
+    bodyPreview?: B | null;
+    /**
+     * hash of the source text of the revision
+     */
+    bodySrcHash: string;
+    /**
+     * format of the source text of the revision, the list of available formats is returned in ``PostingFeatures``
+     */
+    bodySrcFormat?: SourceFormat | null;
+    /**
+     * body of the revision, a string representation of a JSON structure
+     */
+    body: B;
+    /**
+     * format of the body of the revision, may have any value meaningful for the client
+     */
+    bodyFormat?: BodyFormat | null;
+    /**
+     * list of the media attached to the revision
+     */
+    media?: MediaAttachment[] | null;
+    /**
+     * heading of the revision
+     */
+    heading: string;
+    /**
+     * in addition to ``heading``, gives a more detailed description of the revision that can be used for search
+     * engines and link previews
+     */
+    description?: string | null;
+    /**
+     * revision creation timestamp - the real time when the revision was created
+     */
+    createdAt: number;
+    /**
+     * revision deletion timestamp - the time when the revision was deleted
+     */
+    deletedAt?: number | null;
+    /**
+     * revision deletion timestamp - the time when the revision will be deleted and the previous revision will take its
+     * place
+     */
+    deadline?: number | null;
+    /**
+     * cryptographic digest of the revision (use ``Comment`` fingerprint)
      */
-    ownerAvatar?: AvatarImage | null;
+    digest?: string | null;
     /**
-     * ID of the parent posting of the comment
+     * the comment's owner signature (use ``Comment`` fingerprint)
      */
-    postingId: string;
+    signature?: string | null;
     /**
-     * ID of the revision of parent posting that was current when the comment was created
+     * signature version (i.e. fingerprint version)
      */
-    postingRevisionId: string;
+    signatureVersion?: number | null;
     /**
-     * ID of the current revision of the comment
+     * details of the existing reaction (if any) of the client's owner
      */
-    revisionId: string;
+    clientReaction?: ClientReactionInfo | null;
     /**
-     * total number of revisions the comment has
+     * summary of reactions to the revision
      */
-    totalRevisions: number;
+    reactions?: ReactionTotalsInfo | null;
+}
+export type EncodedCommentRevisionInfo = CommentRevisionInfoBase<string>;
+export type CommentRevisionInfo = CommentRevisionInfoBase<Body>;
+export interface CommentsSliceInfoBase<B> {
     /**
-     * preview of the comment's body, a string representation of a JSON structure
+     * the slice contains all comments before this moment, inclusive. May be the far future.
      */
-    bodyPreview?: B | null;
+    before: number;
     /**
-     * the source text of the comment, a string representation of a JSON structure, may be absent if not requested
+     * the slice contains all comments after this moment, exclusive. May be the far past.
      */
-    bodySrc?: B | null;
+    after: number;
     /**
-     * hash of the source text of the comment
+     * the comments
      */
-    bodySrcHash: string;
+    comments: CommentInfoBase<B>[];
     /**
-     * format of the source text of the comment, the list of available formats is returned in ``PostingFeatures``
+     * total number of comments
      */
-    bodySrcFormat?: SourceFormat | null;
+    total: number;
     /**
-     * body of the comment, a string representation of a JSON structure
+     * number of comments before this slice till the far past
      */
-    body: B;
+    totalInPast: number;
     /**
-     * format of the body of the comment, may have any value meaningful for the client
+     * number of comments after this slice till the far future
      */
-    bodyFormat?: BodyFormat | null;
+    totalInFuture: number;
+}
+export type EncodedCommentsSliceInfo = CommentsSliceInfoBase<string>;
+export type CommentsSliceInfo = CommentsSliceInfoBase<Body>;
+export interface CommentSourceText {
     /**
-     * list of the media attached to the comment
+     * avatar of the comment's owner
      */
-    media?: MediaAttachment[] | null;
+    ownerAvatar?: AvatarDescription | null;
     /**
-     * heading of the comment
+     * the source text of the comment, a string representation of a JSON structure
      */
-    heading: string;
+    bodySrc?: Body | string | null;
     /**
-     * in addition to ``heading``, gives a more detailed description of the comment that can be used for search engines
-     * and link previews
+     * format of the source text of the comment, ``plain-text`` by default; the list of available formats is returned
+     * in ``PostingFeatures``
      */
-    description?: string | null;
+    bodySrcFormat?: SourceFormat | null;
     /**
-     * information about the comment this comment is replying to
+     * array of media to be attached to the comment
      */
-    repliedTo?: RepliedTo | null;
-    moment: number;
+    media?: MediaToAttach[] | null;
     /**
-     * comment creation timestamp - the real time when the comment was created
+     * captions of the media to be attached to the comment
      */
-    createdAt: number;
+    mediaCaptions?: MediaCaptionText[] | null;
     /**
-     * comment editing timestamp - the last time the comment was updated
+     * types of reactions that the comment rejects
      */
-    editedAt?: number | null;
+    rejectedReactions?: RejectedReactions | null;
     /**
-     * comment deletion timestamp - the time when the comment was deleted
+     * types of reactions that the comment rejects, as defined by the posting's owner ("senior"); only the senior may
+     * set this
      */
-    deletedAt?: number | null;
+    seniorRejectedReactions?: RejectedReactions | null;
     /**
-     * creation timestamp of the current revision of the comment
+     * ID of the comment this comment is replying to
      */
-    revisionCreatedAt: number;
+    repliedToId?: string | null;
     /**
-     * comment purging timestamp - the time when the deleted comment will be purged from the database
+     * the operations and the corresponding principals
      */
-    deadline?: number | null;
+    operations?: CommentOperations | null;
     /**
-     * cryptographic digest of the comment (use ``Comment`` fingerprint)
+     * the operations and the corresponding principals that are overridden in reactions to the comment
      */
-    digest?: string | null;
+    reactionOperations?: ReactionOperations | null;
     /**
-     * the comment's owner signature (use ``Comment`` fingerprint)
+     * the operations and the corresponding principals that are overridden by the posting's owner ("senior"); only the
+     * senior may set this
      */
-    signature?: string | null;
+    seniorOperations?: CommentOperations | null;
+}
+export interface CommentText {
     /**
-     * signature version (i.e. fingerprint version)
+     * node name of the comment's owner
      */
-    signatureVersion?: number | null;
+    ownerName?: string | null;
     /**
-     * ``true``, if the comment is being be checked by the post's author before publication, ``false`` (default)
-     * otherwise
+     * full name of the comment's owner
      */
-    premoderating?: boolean | null;
+    ownerFullName?: string | null;
     /**
-     * the supported operations and the corresponding principals
+     * gender of the comment's owner
      */
-    operations?: CommentOperations | null;
+    ownerGender?: string | null;
     /**
-     * the operations and the corresponding principals that are overridden in reactions to the comment
+     * avatar of the comment's owner
      */
-    reactionOperations?: ReactionOperations | null;
+    ownerAvatar?: AvatarDescription | null;
     /**
-     * the supported operations and the corresponding principals as defined by the comment's owner
+     * preview of the comment's body, a string representation of a JSON structure
      */
-    ownerOperations?: CommentOperations | null;
+    bodyPreview?: Body | string | null;
     /**
-     * the operations and the corresponding principals that are overridden by the posting's owner ("senior")
+     * the source text of the comment, a string representation of a JSON structure
      */
-    seniorOperations?: CommentOperations | null;
+    bodySrc?: Body | string | null;
     /**
-     * operations on the comment that are blocked for the client
+     * format of the source text of the comment, ``plain-text`` by default; the list of available formats is returned
+     * in ``PostingFeatures``
      */
-    blockedOperations?: BlockedEntryOperation[] | null;
+    bodySrcFormat?: SourceFormat | null;
     /**
-     * list of sheriff marks on the comment
+     * body of the comment, a string representation of a JSON structure
      */
-    sheriffMarks?: SheriffMark[] | null;
+    body?: Body | string | null;
     /**
-     * types of reactions that the comment rejects
+     * format of the body of the comment, may have any value meaningful for the client
      */
-    rejectedReactions?: RejectedReactions | null;
+    bodyFormat?: BodyFormat | null;
     /**
-     * types of reactions that the comment rejects, as defined by the comments' owner
+     * array of IDs of private media to be attached to the comment
      */
-    ownerRejectedReactions?: RejectedReactions | null;
+    media?: MediaToAttach[] | null;
     /**
-     * types of reactions that the comment rejects, as defined by the posting's owner ("senior")
+     * comment creation timestamp - the real time when the comment was created
      */
-    seniorRejectedReactions?: RejectedReactions | null;
+    createdAt?: number | null;
     /**
-     * details of the existing reaction (if any) of the client's owner
+     * types of reactions that the comment rejects
      */
-    clientReaction?: ClientReactionInfo | null;
+    rejectedReactions?: RejectedReactions | null;
     /**
-     * details of the existing reaction (if any) of the posting's owner ("senior") to the comment
+     * types of reactions that the comment rejects, as defined by the posting's owner ("senior"); only the senior may
+     * set this
      */
-    seniorReaction?: ClientReactionInfo | null;
+    seniorRejectedReactions?: RejectedReactions | null;
     /**
-     * summary of reactions to the comment
+     * ID of the comment this comment is replying to
      */
-    reactions?: ReactionTotalsInfo | null;
-}
-export type EncodedCommentInfo = CommentInfoBase<string>;
-export type CommentInfo = CommentInfoBase<Body>;
-export interface CommentsSliceInfoBase<B> {
+    repliedToId?: string | null;
     /**
-     * the slice contains all comments before this moment, inclusive. May be the far future.
+     * the comment's owner signature (use ``Comment`` fingerprint)
      */
-    before: number;
+    signature?: string | null;
     /**
-     * the slice contains all comments after this moment, exclusive. May be the far past.
+     * signature version (i.e. fingerprint version)
      */
-    after: number;
+    signatureVersion?: number | null;
     /**
-     * the comments
+     * ``true``, if the comment is being be checked by the post's author before publication, ``false`` (default)
+     * otherwise; only the senior may set this
      */
-    comments: CommentInfoBase<B>[];
+    premoderating?: boolean | null;
     /**
-     * total number of comments
+     * the operations and the corresponding principals
      */
-    total: number;
+    operations?: CommentOperations | null;
     /**
-     * number of comments before this slice till the far past
+     * the operations and the corresponding principals that are overridden in reactions to the comment
      */
-    totalInPast: number;
+    reactionOperations?: ReactionOperations | null;
     /**
-     * number of comments after this slice till the far future
+     * the operations and the corresponding principals that are overridden by the posting's owner ("senior"); only the
+     * senior may set this
      */
-    totalInFuture: number;
+    seniorOperations?: CommentOperations | null;
 }
-export type EncodedCommentsSliceInfo = CommentsSliceInfoBase<string>;
-export type CommentsSliceInfo = CommentsSliceInfoBase<Body>;
 export interface DraftInfoBase<B> {
     id: string;
     /**
@@ -4871,6 +5115,10 @@ export interface DraftInfoBase<B> {
      * list of the media attached to the draft
      */
     media?: MediaAttachment[] | null;
+    /**
+     * captions of the media attached to the draft
+     */
+    mediaCaptions?: MediaCaptionBase<B>[] | null;
     /**
      * heading of the draft
      */
@@ -4895,18 +5143,77 @@ export interface DraftInfoBase<B> {
 }
 export type EncodedDraftInfo = DraftInfoBase<string>;
 export type DraftInfo = DraftInfoBase<Body>;
-export interface EntryInfoBase<B> {
+export interface DraftText {
     /**
-     * posting details, set if the entry is a posting
+     * type of the draft
      */
-    posting?: PostingInfoBase<B> | null;
+    draftType: DraftType;
     /**
-     * comment details, set if the entry is a comment
+     * name of the node the draft is related to
      */
-    comment?: CommentInfoBase<B> | null;
+    receiverName: string;
+    /**
+     * ID of the posting, mandatory for all types, except ``new-posting``
+     */
+    receiverPostingId?: string | null;
+    /**
+     * ID of the comment, mandatory for ``comment-update`` type
+     */
+    receiverCommentId?: string | null;
+    /**
+     * ID of the comment replied to
+     */
+    repliedToId?: string | null;
+    /**
+     * full name of the posting's/comment's owner
+     */
+    ownerFullName?: string | null;
+    /**
+     * avatar of the posting's/comment's owner
+     */
+    ownerAvatar?: AvatarDescription | null;
+    /**
+     * types of reactions that the posting rejects
+     */
+    rejectedReactions?: RejectedReactions | null;
+    /**
+     * types of reactions that the posting's comments should reject
+     */
+    commentRejectedReactions?: RejectedReactions | null;
+    /**
+     * the source text of the draft, a string representation of a JSON structure
+     */
+    bodySrc?: Body | string | null;
+    /**
+     * format of the source text of the draft, ``plain-text`` by default; the list of available formats is returned in
+     * ``PostingFeatures``
+     */
+    bodySrcFormat?: SourceFormat | null;
+    /**
+     * list of the media attached to the draft
+     */
+    media?: MediaToAttach[] | null;
+    /**
+     * captions of the media attached to the draft
+     */
+    mediaCaptions?: MediaCaptionText[] | null;
+    /**
+     * story publication timestamp - the time the story must be published under in the feed
+     */
+    publishAt?: number | null;
+    /**
+     * description of the update
+     */
+    updateInfo?: UpdateInfo | null;
+    /**
+     * draft of the list of operations and the corresponding principals
+     */
+    operations?: PostingOperations | null;
+    /**
+     * draft of the list of operations and the corresponding principals that are overridden in the posting's comments
+     */
+    commentOperations?: CommentOperations | null;
 }
-export type EncodedEntryInfo = EntryInfoBase<string>;
-export type EntryInfo = EntryInfoBase<Body>;
 export interface SettingDescriptor {
     /**
      * name of the setting