moeralib 0.18.1 → 0.18.6

package/lib/naming/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.validateNamingSchema = exports.shorten = exports.resolve = exports.expand = exports.parseNodeName = exports.DEV_NAMING_SERVER = exports.MAIN_NAMING_SERVER = exports.MoeraNamingConnectionError = exports.MoeraNamingApiError = exports.MoeraNamingError = exports.MoeraNaming = void 0;
+exports.validateNamingSchema = exports.shorten = exports.resolve = exports.expand = exports.parseNodeName = exports.ANONYMOUS_NODE_PRIVATE_KEY = exports.ANONYMOUS_NODE_PUBLIC_KEY = exports.ANONYMOUS_NODE_NAME = exports.DEV_NAMING_SERVER = exports.MAIN_NAMING_SERVER = exports.MoeraNamingConnectionError = exports.MoeraNamingApiError = exports.MoeraNamingError = exports.MoeraNaming = void 0;
 var naming_1 = require("./naming");
 Object.defineProperty(exports, "MoeraNaming", { enumerable: true, get: function () { return naming_1.MoeraNaming; } });
 Object.defineProperty(exports, "MoeraNamingError", { enumerable: true, get: function () { return naming_1.MoeraNamingError; } });
@@ -8,6 +8,9 @@ Object.defineProperty(exports, "MoeraNamingApiError", { enumerable: true, get: f
 Object.defineProperty(exports, "MoeraNamingConnectionError", { enumerable: true, get: function () { return naming_1.MoeraNamingConnectionError; } });
 Object.defineProperty(exports, "MAIN_NAMING_SERVER", { enumerable: true, get: function () { return naming_1.MAIN_NAMING_SERVER; } });
 Object.defineProperty(exports, "DEV_NAMING_SERVER", { enumerable: true, get: function () { return naming_1.DEV_NAMING_SERVER; } });
+Object.defineProperty(exports, "ANONYMOUS_NODE_NAME", { enumerable: true, get: function () { return naming_1.ANONYMOUS_NODE_NAME; } });
+Object.defineProperty(exports, "ANONYMOUS_NODE_PUBLIC_KEY", { enumerable: true, get: function () { return naming_1.ANONYMOUS_NODE_PUBLIC_KEY; } });
+Object.defineProperty(exports, "ANONYMOUS_NODE_PRIVATE_KEY", { enumerable: true, get: function () { return naming_1.ANONYMOUS_NODE_PRIVATE_KEY; } });
 Object.defineProperty(exports, "parseNodeName", { enumerable: true, get: function () { return naming_1.parseNodeName; } });
 Object.defineProperty(exports, "expand", { enumerable: true, get: function () { return naming_1.expand; } });
 Object.defineProperty(exports, "resolve", { enumerable: true, get: function () { return naming_1.resolve; } });

package/lib/naming/naming.js

@@ -9,7 +9,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MoeraNaming = exports.MoeraNamingConnectionError = exports.MoeraNamingApiError = exports.MoeraNamingError = exports.DEV_NAMING_SERVER = exports.MAIN_NAMING_SERVER = void 0;
+exports.MoeraNaming = exports.MoeraNamingConnectionError = exports.MoeraNamingApiError = exports.MoeraNamingError = exports.ANONYMOUS_NODE_PRIVATE_KEY = exports.ANONYMOUS_NODE_PUBLIC_KEY = exports.ANONYMOUS_NODE_NAME = exports.DEV_NAMING_SERVER = exports.MAIN_NAMING_SERVER = void 0;
 exports.parseNodeName = parseNodeName;
 exports.shorten = shorten;
 exports.expand = expand;
@@ -25,6 +25,18 @@ exports.MAIN_NAMING_SERVER = "https://naming.moera.org/moera-naming";
  * Moera developers' naming server.
  */
 exports.DEV_NAMING_SERVER = "https://naming-dev.moera.org/moera-naming";
+/**
+ * Node name used to represent anonymous content author.
+ */
+exports.ANONYMOUS_NODE_NAME = "unk_0";
+/**
+ * Public key used to verify signatures of anonymous content.
+ */
+exports.ANONYMOUS_NODE_PUBLIC_KEY = Buffer.from("VNKYmrV8b1XR7phWvrTUbkfnxsPTKvHIcvJLGrBZQr0Z8eKVdTooBkIWS0CECPjLxPGaQkcKkMcZ6M6wEsJm9A==", "base64");
+/**
+ * Private key used to sign anonymous content.
+ */
+exports.ANONYMOUS_NODE_PRIVATE_KEY = Buffer.from("tCb+02pUSC6FLdQLPvrUhSBjD0xiV5Q+fQmZY3PKybo=", "base64");
 /**
  * Generic naming server error.
  */

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/cartes.js

@@ -116,8 +116,9 @@ function generateCarte(ownerName_1, signingKey_1, beginning_1) {
         if (Array.isArray(adminScope)) {
             adminScope = toScopeMask(adminScope);
         }
+        const addresses = address == null ? null : Array.isArray(address) ? address : [address];
         const salt = yield (0, util_1.promisify)(crypto_1.default.randomBytes)(8);
-        const fingerprint = (0, fingerprints_1.createCarteFingerprint2)(ownerName, address, beginning, beginning + ttl, nodeName, clientScope, adminScope, salt);
+        const fingerprint = (0, fingerprints_1.createCarteFingerprint3)(ownerName, addresses, beginning, beginning + ttl, nodeName, clientScope, adminScope, salt);
         const signature = (0, crypto_2.signFingerprint)(fingerprint, signingKey);
         return Buffer.concat([fingerprint, signature]).toString("base64url");
     });

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,31 +1360,15 @@ 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.
+     * Upload a new private media file. The content of the file is passed in the request body.
      *
      * @param {Buffer} body
      * @param {string} contentType - content-type of ``body``
      * @return {Promise<API.PrivateMediaFileInfo>}
      */
-    uploadAdminMedia(body, contentType) {
+    uploadPrivateMedia(body, contentType) {
         return __awaiter(this, void 0, void 0, function* () {
             const location = "/media/private";
-            return yield this.call("uploadAdminMedia", location, {
-                method: "POST", body, contentType, schema: "PrivateMediaFileInfo"
-            });
-        });
-    }
-    /**
-     * Upload a new media file owned by the given node. The content of the file is passed in the request body.
-     *
-     * @param {string} clientName - name of the node owning the media file
-     * @param {Buffer} body
-     * @param {string} contentType - 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}`;
             return yield this.call("uploadPrivateMedia", location, {
                 method: "POST", body, contentType, schema: "PrivateMediaFileInfo"
             });
@@ -1398,12 +1382,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) {
+        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 };
+            const params = { width, download, grant, ignoremalware };
             return yield this.call("getPrivateMedia", location, {
                 method: "GET", params, schema: "blob"
             });
@@ -1413,27 +1400,30 @@ 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"
             });
         });
     }
     /**
-     * Get the list of all postings and comments the media file is attached to.
+     * Update media file details.
      *
      * @param {string} id - media file ID
-     * @return {Promise<API.EntryInfo[]>}
+     * @param {API.PrivateMediaFileAttributes} attributes
+     * @return {Promise<API.PrivateMediaFileInfo>}
      */
-    getPrivateMediaParentEntry(id) {
+    updatePrivateMediaInfo(id, attributes) {
         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
+            const location = (0, util_1.ut) `/media/private/${id}/info`;
+            return yield this.call("updatePrivateMediaInfo", location, {
+                method: "PUT", body: attributes, schema: "PrivateMediaFileInfo"
             });
         });
     }
@@ -1485,6 +1475,34 @@ 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"
+            });
+        });
+    }
     /**
      * Get the name of the node. Admin user receives the current status of the latest operation with the node name.
      *
@@ -2355,6 +2373,22 @@ class MoeraNode extends caller_1.Caller {
             });
         });
     }
+    /**
+     * Download the private media file from the remote node and store it at the home node.
+     *
+     * @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, 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", body: attributes, schema: "PrivateMediaFileInfo"
+            });
+        });
+    }
     /**
      * Add a posting to the remote node and register it in the registry at the local node.
      *
@@ -3105,6 +3139,20 @@ class MoeraNode extends caller_1.Caller {
             });
         });
     }
+    /**
+     * 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,
 };