moeralib 0.18.3 → 0.18.7

package/lib/node/caller.js

@@ -84,6 +84,9 @@ function encodeBodies(data) {
         return data.map(item => encodeBodies(item));
     }
     const encoded = (0, lodash_clonedeep_1.default)(data);
+    if (data.mediaCaptions != null) {
+        encoded.mediaCaptions = data.mediaCaptions.map((item) => encodeBodies(item));
+    }
     if (data.body != null) {
         encoded.body = encodeBody(data.body, data.bodyFormat);
     }
@@ -93,6 +96,9 @@ function encodeBodies(data) {
     if (data.bodySrc != null) {
         encoded.bodySrc = encodeBody(data.bodySrc, data.bodySrcFormat);
     }
+    if (data.captionSrc != null) {
+        encoded.captionSrc = encodeBody(data.captionSrc, data.captionSrcFormat);
+    }
     return encoded;
 }
 function decodeBody(name, encoded, format) {
@@ -126,6 +132,9 @@ function decodeBodies(name, data) {
     if (data.comments != null) {
         decoded.comments = data.comments.map((item) => decodeBodies(name, item));
     }
+    if (data.mediaCaptions != null) {
+        decoded.mediaCaptions = data.mediaCaptions.map((item) => decodeBodies(name, item));
+    }
     if (data.comment != null) {
         decoded.comment = decodeBodies(name, data.comment);
     }
@@ -141,6 +150,9 @@ function decodeBodies(name, data) {
     if (data.bodySrc != null) {
         decoded.bodySrc = decodeBody(name, data.bodySrc, data.bodySrcFormat);
     }
+    if (data.captionSrc != null) {
+        decoded.captionSrc = decodeBody(name, data.captionSrc, data.captionSrcFormat);
+    }
     return decoded;
 }
 /**

package/lib/node/fingerprints.js

@@ -8,6 +8,8 @@ exports.createCarteFingerprint1 = createCarteFingerprint1;
 exports.createCarteFingerprint0 = createCarteFingerprint0;
 exports.createCommentFingerprint1 = createCommentFingerprint1;
 exports.createCommentFingerprint0 = createCommentFingerprint0;
+exports.createMediaGrantFingerprint1 = createMediaGrantFingerprint1;
+exports.createMediaGrantFingerprint0 = createMediaGrantFingerprint0;
 exports.createNotificationPacketFingerprint1 = createNotificationPacketFingerprint1;
 exports.createNotificationPacketFingerprint0 = createNotificationPacketFingerprint0;
 exports.createPostingFingerprint1 = createPostingFingerprint1;
@@ -120,6 +122,35 @@ function createCommentFingerprint0(ownerName, postingFingerprint, repliedToFinge
     return (0, crypto_1.fingerprintBytes)({ "version": 0, "objectType": "COMMENT", ownerName, postingFingerprint, repliedToFingerprint, bodySrcHash,
         bodySrcFormat, body, bodyFormat, createdAt, permissions, attachments }, COMMENT_FINGERPRINT0_SCHEMA);
 }
+const MEDIA_GRANT_FINGERPRINT1_SCHEMA = [
+    ["version", "number"],
+    ["objectType", "string"],
+    ["nodeName", "string"],
+    ["mediaId", "string"],
+    ["expires", "number"],
+    ["download", "boolean"],
+    ["fileName", "string"],
+    ["salt", "bytes"],
+];
+function createMediaGrantFingerprint1(nodeName, mediaId, expires, download, fileName, salt) {
+    return (0, crypto_1.fingerprintBytes)({ "version": 1, "objectType": "MEDIA_GRANT", nodeName, mediaId, expires, download, fileName, salt }, MEDIA_GRANT_FINGERPRINT1_SCHEMA);
+}
+const MEDIA_GRANT_FINGERPRINT0_SCHEMA = [
+    ["version", "number"],
+    ["objectType", "string"],
+    ["nodeName", "string"],
+    ["postingId", "string"],
+    ["commentId", "string"],
+    ["mediaId", "string"],
+    ["expires", "number"],
+    ["download", "boolean"],
+    ["fileName", "string"],
+    ["salt", "bytes"],
+];
+function createMediaGrantFingerprint0(nodeName, postingId, commentId, mediaId, expires, download, fileName, salt) {
+    return (0, crypto_1.fingerprintBytes)({ "version": 0, "objectType": "MEDIA_GRANT", nodeName, postingId, commentId, mediaId, expires, download, fileName,
+        salt }, MEDIA_GRANT_FINGERPRINT0_SCHEMA);
+}
 const NOTIFICATION_PACKET_FINGERPRINT1_SCHEMA = [
     ["version", "number"],
     ["objectType", "string"],

package/lib/node/node.js

@@ -1360,33 +1360,40 @@ class MoeraNode extends caller_1.Caller {
         });
     }
     /**
-     * Upload a new media file owned by the node admin. The content of the file is passed in the request body.
+     * Parse the page located at the URL and return the title, the description and the picture that may be used to
+     * build a preview of the page.
      *
-     * @param {Buffer} body
-     * @param {string} contentType - content-type of ``body``
-     * @return {Promise<API.PrivateMediaFileInfo>}
+     * @param {string} url
+     * @return {Promise<API.LinkPreviewInfo>}
      */
-    uploadAdminMedia(body, contentType) {
+    createLinkPreview(url) {
         return __awaiter(this, void 0, void 0, function* () {
-            const location = "/media/private";
-            return yield this.call("uploadAdminMedia", location, {
-                method: "POST", body, contentType, schema: "PrivateMediaFileInfo"
+            const location = (0, util_1.ut) `/link-preview`;
+            const params = { url };
+            return yield this.call("createLinkPreview", location, {
+                method: "GET", params, schema: "LinkPreviewInfo"
             });
         });
     }
     /**
-     * Upload a new media file owned by the given node. The content of the file is passed in the request body.
+     * Upload a new private media file. The content of the file is passed in the request body. Alternatively, the file
+     * can be uploaded using Media upload API and its ID passed in the `upload` query parameter. The second alternative
+     * is to pass the URL of the media in the `url` query parameter, the media will be downloaded to the node.
      *
-     * @param {string} clientName - name of the node owning the media file
-     * @param {Buffer} body
-     * @param {string} contentType - content-type of ``body``
+     * @param {string | null} upload - ID of the media upload to be used instead of the request body
+     * @param {string | null} url - URL of the media to be used instead of the request body
+     * @param {boolean | null} downsize - `true` to scale the uploaded image down to the size recommended by the node,
+     * if possible; the default is `false`
+     * @param {Buffer | null} body - optional
+     * @param {string | null} contentType - optional content-type of ``body``
      * @return {Promise<API.PrivateMediaFileInfo>}
      */
-    uploadPrivateMedia(clientName, body, contentType) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const location = (0, util_1.ut) `/media/private/${clientName}`;
+    uploadPrivateMedia() {
+        return __awaiter(this, arguments, void 0, function* (body = null, contentType = null, upload = null, url = null, downsize = null) {
+            const location = (0, util_1.ut) `/media/private`;
+            const params = { upload, url, downsize };
             return yield this.call("uploadPrivateMedia", location, {
-                method: "POST", body, contentType, schema: "PrivateMediaFileInfo"
+                method: "POST", params, body, contentType, schema: "PrivateMediaFileInfo"
             });
         });
     }
@@ -1398,14 +1405,15 @@ class MoeraNode extends caller_1.Caller {
      * the smallest in size, but the best in quality variant of the media, according to the width provided
      * @param {boolean | null} download - if ``true``, the node will add ``Content-Disposition: attachment`` header to
      * the output
+     * @param {string | null} grant - media grant allowing access to the media file
      * @param {boolean | null} ignoremalware - if ``true``, the node will ignore malware detection and return the media
      * file; only admin may use this option
      * @return {Promise<Blob>}
      */
     getPrivateMedia(id_1) {
-        return __awaiter(this, arguments, void 0, function* (id, width = null, download = null, ignoremalware = null) {
+        return __awaiter(this, arguments, void 0, function* (id, width = null, download = null, grant = null, ignoremalware = null) {
             const location = (0, util_1.ut) `/media/private/${id}/data`;
-            const params = { width, download, ignoremalware };
+            const params = { width, download, grant, ignoremalware };
             return yield this.call("getPrivateMedia", location, {
                 method: "GET", params, schema: "blob"
             });
@@ -1415,13 +1423,15 @@ class MoeraNode extends caller_1.Caller {
      * Get media file details.
      *
      * @param {string} id - media file ID
+     * @param {string | null} grant - media grant allowing access to the media file
      * @return {Promise<API.PrivateMediaFileInfo>}
      */
-    getPrivateMediaInfo(id) {
-        return __awaiter(this, void 0, void 0, function* () {
+    getPrivateMediaInfo(id_1) {
+        return __awaiter(this, arguments, void 0, function* (id, grant = null) {
             const location = (0, util_1.ut) `/media/private/${id}/info`;
+            const params = { grant };
             return yield this.call("getPrivateMediaInfo", location, {
-                method: "GET", schema: "PrivateMediaFileInfo"
+                method: "GET", params, schema: "PrivateMediaFileInfo"
             });
         });
     }
@@ -1440,20 +1450,6 @@ class MoeraNode extends caller_1.Caller {
             });
         });
     }
-    /**
-     * Get the list of all postings and comments the media file is attached to.
-     *
-     * @param {string} id - media file ID
-     * @return {Promise<API.EntryInfo[]>}
-     */
-    getPrivateMediaParentEntry(id) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const location = (0, util_1.ut) `/media/private/${id}/parent`;
-            return yield this.call("getPrivateMediaParentEntry", location, {
-                method: "GET", schema: "EntryInfoArray", bodies: true
-            });
-        });
-    }
     /**
      * Upload a new media file. The content of the file is passed in the request body
      *
@@ -1502,6 +1498,93 @@ class MoeraNode extends caller_1.Caller {
             });
         });
     }
+    /**
+     * Create a lease for a media file stored on the node.
+     *
+     * @param {API.MediaLeaseAttributes} attributes
+     * @return {Promise<API.MediaLeaseInfo>}
+     */
+    createMediaLease(attributes) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const location = "/media/leases";
+            return yield this.call("createMediaLease", location, {
+                method: "POST", body: attributes, schema: "MediaLeaseInfo"
+            });
+        });
+    }
+    /**
+     * Delete the lease.
+     *
+     * @param {string} id - ID of the lease
+     * @return {Promise<API.Result>}
+     */
+    deleteMediaLease(id) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const location = (0, util_1.ut) `/media/leases/${id}`;
+            return yield this.call("deleteMediaLease", location, {
+                method: "DELETE", schema: "Result"
+            });
+        });
+    }
+    /**
+     * Create a new chunked upload of a private media source file.
+     *
+     * @param {API.MediaUploadAttributes} attributes
+     * @return {Promise<API.MediaUploadInfo>}
+     */
+    createMediaUpload(attributes) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const location = "/media/upload";
+            return yield this.call("createMediaUpload", location, {
+                method: "POST", body: attributes, schema: "MediaUploadInfo"
+            });
+        });
+    }
+    /**
+     * Get chunked upload details.
+     *
+     * @param {string} id - upload ID
+     * @return {Promise<API.MediaUploadInfo>}
+     */
+    getMediaUpload(id) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const location = (0, util_1.ut) `/media/upload/${id}`;
+            return yield this.call("getMediaUpload", location, {
+                method: "GET", schema: "MediaUploadInfo"
+            });
+        });
+    }
+    /**
+     * Upload one chunk of a private media source file.
+     *
+     * @param {string} id - upload ID
+     * @param {number} chunk - zero-based chunk number
+     * @param {Buffer} body
+     * @param {string} contentType - content-type of ``body``
+     * @return {Promise<API.MediaUploadInfo>}
+     */
+    uploadMediaChunk(id, chunk, body, contentType) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const location = (0, util_1.ut) `/media/upload/${id}/${chunk}`;
+            return yield this.call("uploadMediaChunk", location, {
+                method: "PUT", body, contentType, schema: "MediaUploadInfo"
+            });
+        });
+    }
+    /**
+     * Delete a chunked media upload and the corresponding source file.
+     *
+     * @param {string} id - upload ID
+     * @return {Promise<API.Result>}
+     */
+    deleteMediaUpload(id) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const location = (0, util_1.ut) `/media/upload/${id}`;
+            return yield this.call("deleteMediaUpload", location, {
+                method: "DELETE", schema: "Result"
+            });
+        });
+    }
     /**
      * Get the name of the node. Admin user receives the current status of the latest operation with the node name.
      *
@@ -2056,37 +2139,6 @@ class MoeraNode extends caller_1.Caller {
             });
         });
     }
-    /**
-     * Open the URL passed in the parameters and pass to the client the media file returned by the server.
-     *
-     * @param {string} url
-     * @return {Promise<Blob>}
-     */
-    proxyMedia(url) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const location = (0, util_1.ut) `/proxy/media`;
-            const params = { url };
-            return yield this.call("proxyMedia", location, {
-                method: "GET", params, schema: "blob"
-            });
-        });
-    }
-    /**
-     * Parse the page located at the URL and return the title, the description and the picture that may be used to
-     * build a preview of the page.
-     *
-     * @param {string} url
-     * @return {Promise<API.LinkPreviewInfo>}
-     */
-    proxyLinkPreview(url) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const location = (0, util_1.ut) `/proxy/link-preview`;
-            const params = { url };
-            return yield this.call("proxyLinkPreview", location, {
-                method: "GET", params, schema: "LinkPreviewInfo"
-            });
-        });
-    }
     /**
      * Register a client at the push relay server to receive messages from this node. The operation is synchronous.
      *
@@ -2377,13 +2429,14 @@ class MoeraNode extends caller_1.Caller {
      *
      * @param {string} remoteNodeName - name of the remote node
      * @param {string} id - id of the media file
+     * @param {API.MediaDownloadAttributes} attributes
      * @return {Promise<API.PrivateMediaFileInfo>}
      */
-    downloadRemoteMedia(remoteNodeName, id) {
+    downloadRemoteMedia(remoteNodeName, id, attributes) {
         return __awaiter(this, void 0, void 0, function* () {
             const location = (0, util_1.ut) `/nodes/${remoteNodeName}/media/private/${id}/download`;
             return yield this.call("downloadRemoteMedia", location, {
-                method: "POST", schema: "PrivateMediaFileInfo"
+                method: "POST", body: attributes, schema: "PrivateMediaFileInfo"
             });
         });
     }
@@ -3137,6 +3190,70 @@ class MoeraNode extends caller_1.Caller {
             });
         });
     }
+    /**
+     * Search for visited nodes matching the search ``query``. Every space-delimited word in the query must match
+     * case-insensitively a beginning of the node's name or a beginning of any space-delimited word in the node's full
+     * name. The order of words is not significant. \
+     * \
+     * The node may decide to return fewer nodes than the given ``limit``. \
+     * \
+     * The nodes are sorted by *social distance* from the node.
+     *
+     * @param {string | null} query - the search query
+     * @param {number | null} limit - maximum number of nodes returned
+     * @return {Promise<API.SearchNodeInfo[]>}
+     */
+    getVisitedNodes() {
+        return __awaiter(this, arguments, void 0, function* (query = null, limit = null) {
+            const location = (0, util_1.ut) `/people/visited`;
+            const params = { query, limit };
+            return yield this.call("getVisitedNodes", location, {
+                method: "GET", params, schema: "SearchNodeInfoArray"
+            });
+        });
+    }
+    /**
+     * Record a visit to the node.
+     *
+     * @param {API.VisitedNodeAttributes} node
+     * @return {Promise<API.Result>}
+     */
+    recordVisitedNode(node) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const location = "/people/visited";
+            return yield this.call("recordVisitedNode", location, {
+                method: "POST", body: node, schema: "Result"
+            });
+        });
+    }
+    /**
+     * Delete all visits to the node.
+     *
+     * @param {string} remoteNodeName - name of the visited node
+     * @return {Promise<API.Result>}
+     */
+    deleteVisitedNode(remoteNodeName) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const location = (0, util_1.ut) `/people/visited/${remoteNodeName}`;
+            return yield this.call("deleteVisitedNode", location, {
+                method: "DELETE", schema: "Result"
+            });
+        });
+    }
+    /**
+     * Record a visit to a posting, comment or media.
+     *
+     * @param {API.VisitDetails} visit
+     * @return {Promise<API.Result>}
+     */
+    recordVisit(visit) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const location = "/visits";
+            return yield this.call("recordVisit", location, {
+                method: "POST", body: visit, schema: "Result"
+            });
+        });
+    }
     /**
      * Get brief information about the node.
      *

package/lib/node/types.js

@@ -6,7 +6,6 @@ exports.SCOPE_VALUES = {
     "none": 0x00000000,
     "identify": 0x00000000,
     "other": 0x00000001,
-    "view-media": 0x00000002,
     "view-content": 0x00000004,
     "add-post": 0x00000008,
     "update-post": 0x00000010,
@@ -35,6 +34,7 @@ exports.SCOPE_VALUES = {
     "grant": 0x08000000,
     "upload-public-media": 0x10000000,
     "upload-private-media": 0x20000000,
-    "view-all": 0x00088406,
-    "all": 0x3fffffff,
+    "lease-media": 0x40000000,
+    "view-all": 0x00088404,
+    "all": 0x7ffffffd,
 };