moeralib 0.18.6 → 0.19.0

package/lib/node/node.js

@@ -1360,17 +1360,41 @@ class MoeraNode extends caller_1.Caller {
         });
     }
     /**
-     * Upload a new private media file. 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>}
      */
-    uploadPrivateMedia(body, contentType) {
+    createLinkPreview(url) {
         return __awaiter(this, void 0, void 0, function* () {
-            const location = "/media/private";
+            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 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 | 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
+     * or asynchronously compress an uploaded video to the recommended playback format and size, 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() {
+        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"
             });
         });
     }
@@ -1503,6 +1527,65 @@ class MoeraNode extends caller_1.Caller {
             });
         });
     }
+    /**
+     * 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.
      *
@@ -2057,37 +2140,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.
      *
@@ -3139,6 +3191,56 @@ 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.
      *