moeralib 0.19.1 → 0.19.3

package/AGENTS.md

@@ -0,0 +1,5 @@
+# TypeScript
+
+1. Do not use `enum` or `namespace`. Represent string-valued enumerations as
+   string literal union types, adding new values with `|`. For example:
+   `type NodeSourceUriService = "telegram" | "rss" | "livejournal"`.

package/lib/index.js

@@ -1,2 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodeSourceUri = void 0;
+var node_source_uri_1 = require("./node-source-uri");
+Object.defineProperty(exports, "NodeSourceUri", { enumerable: true, get: function () { return node_source_uri_1.NodeSourceUri; } });

package/lib/node/fingerprints.js

@@ -10,6 +10,7 @@ exports.createCommentFingerprint1 = createCommentFingerprint1;
 exports.createCommentFingerprint0 = createCommentFingerprint0;
 exports.createMediaGrantFingerprint1 = createMediaGrantFingerprint1;
 exports.createMediaGrantFingerprint0 = createMediaGrantFingerprint0;
+exports.createNotificationPacketFingerprint2 = createNotificationPacketFingerprint2;
 exports.createNotificationPacketFingerprint1 = createNotificationPacketFingerprint1;
 exports.createNotificationPacketFingerprint0 = createNotificationPacketFingerprint0;
 exports.createPostingFingerprint1 = createPostingFingerprint1;
@@ -151,6 +152,21 @@ function createMediaGrantFingerprint0(nodeName, postingId, commentId, mediaId, e
     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_FINGERPRINT2_SCHEMA = [
+    ["version", "number"],
+    ["objectType", "string"],
+    ["id", "string"],
+    ["nodeName", "string"],
+    ["fullName", "string"],
+    ["nodeSourceUri", "string"],
+    ["createdAt", "number"],
+    ["type", "string"],
+    ["notification", "string"],
+];
+function createNotificationPacketFingerprint2(id, nodeName, fullName, nodeSourceUri, createdAt, type, notification) {
+    return (0, crypto_1.fingerprintBytes)({ "version": 2, "objectType": "NOTIFICATION_PACKET", id, nodeName, fullName, nodeSourceUri, createdAt, type,
+        notification }, NOTIFICATION_PACKET_FINGERPRINT2_SCHEMA);
+}
 const NOTIFICATION_PACKET_FINGERPRINT1_SCHEMA = [
     ["version", "number"],
     ["objectType", "string"],

package/lib/node/node.js

@@ -1715,62 +1715,6 @@ class MoeraNode extends caller_1.Caller {
             });
         });
     }
-    /**
-     * Register the plugin. If the plugin authenticates as root admin, the plugin is registered at the server level. If
-     * the plugin authenticates as node admin, the plugin is registered at the node level.
-     *
-     * @param {API.PluginDescription} plugin
-     * @return {Promise<API.PluginInfo>}
-     */
-    registerPlugin(plugin) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const location = "/plugins";
-            return yield this.call("registerPlugin", location, {
-                method: "POST", body: plugin, schema: "PluginInfo"
-            });
-        });
-    }
-    /**
-     * Get information about all plugins registered for the node and server.
-     *
-     * @return {Promise<API.PluginInfo[]>}
-     */
-    getPlugins() {
-        return __awaiter(this, void 0, void 0, function* () {
-            const location = "/plugins";
-            return yield this.call("getPlugins", location, {
-                method: "GET", schema: "PluginInfoArray"
-            });
-        });
-    }
-    /**
-     * Get information about the plugin.
-     *
-     * @param {string} pluginName - name of the plugin
-     * @return {Promise<API.PluginInfo>}
-     */
-    getPlugin(pluginName) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const location = (0, util_1.ut) `/plugins/${pluginName}`;
-            return yield this.call("getPlugin", location, {
-                method: "GET", schema: "PluginInfo"
-            });
-        });
-    }
-    /**
-     * Unregister the plugin.
-     *
-     * @param {string} pluginName - name of the plugin
-     * @return {Promise<API.Result>}
-     */
-    unregisterPlugin(pluginName) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const location = (0, util_1.ut) `/plugins/${pluginName}`;
-            return yield this.call("unregisterPlugin", location, {
-                method: "DELETE", schema: "Result"
-            });
-        });
-    }
     /**
      * Create a new posting from the text given and publish it in the given feeds (if any). The heading and the preview
      * of the posting are created automatically, if needed. The posting owner must authenticate in some way. If the
@@ -1804,7 +1748,9 @@ class MoeraNode extends caller_1.Caller {
         });
     }
     /**
-     * Update the posting, creating a new revision of it. The text is processed just like in the ``POST`` request.
+     * Update the posting, creating a new revision of it. The text is processed just like in the ``POST`` request. If
+     * the posting is not original (a cached copy of a remote posting), only its permissions can be changed; all other
+     * fields are ignored and no new revision is created.
      *
      * @param {string} id - ID of the posting
      * @param {API.PostingText} posting
@@ -1850,6 +1796,21 @@ class MoeraNode extends caller_1.Caller {
             });
         });
     }
+    /**
+     * Update the posting visibility if requested and publish it in the specified feeds.
+     *
+     * @param {string} id - ID of the posting
+     * @param {API.PostingRepublishAttributes} attributes
+     * @return {Promise<API.Result>}
+     */
+    republishPosting(id, attributes) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const location = (0, util_1.ut) `/postings/${id}/republish`;
+            return yield this.call("republishPosting", location, {
+                method: "POST", body: attributes, schema: "Result"
+            });
+        });
+    }
     /**
      * Get all postings linked to media attached to the given posting.
      *
@@ -2056,6 +2017,26 @@ class MoeraNode extends caller_1.Caller {
             });
         });
     }
+    /**
+     * Get a slice of the sharings of the posting, delimited by the ``before`` moment and the given ``limit``. If
+     * ``before`` is not provided, the latest sharings are returned. The node may decide to return fewer sharings than
+     * the given ``limit``. The sharings are always sorted by moment, descending. The list is empty when viewing
+     * sharings is not permitted. The total is zero when viewing the sharing counter is not permitted.
+     *
+     * @param {string} postingId - ID of the posting
+     * @param {number | null} before - filter sharings created at or before this moment
+     * @param {number | null} limit - maximum number of sharings returned
+     * @return {Promise<API.SharingsSliceInfo>}
+     */
+    getPostingSharings(postingId_1) {
+        return __awaiter(this, arguments, void 0, function* (postingId, before = null, limit = null) {
+            const location = (0, util_1.ut) `/postings/${postingId}/sharings`;
+            const params = { before, limit };
+            return yield this.call("getPostingSharings", location, {
+                method: "GET", params, schema: "SharingsSliceInfo"
+            });
+        });
+    }
     /**
      * Get the profile.
      *
@@ -2073,8 +2054,9 @@ class MoeraNode extends caller_1.Caller {
         });
     }
     /**
-     * Update the profile. Fields that are not set in the request body are left intact. Fields that are set to an empty
-     * value are reset to their defaults.
+     * To update a profile attribute, include the field with its new value. For a partial update, include only the
+     * fields to be changed; omitted fields remain unchanged. To delete an attribute, include the field with an empty
+     * value, which resets it to its default.
      *
      * @param {API.ProfileAttributes} profile
      * @return {Promise<API.ProfileInfo>}
@@ -2487,6 +2469,22 @@ class MoeraNode extends caller_1.Caller {
             });
         });
     }
+    /**
+     * Download the posting from the remote node and publish it in the specified feeds.
+     *
+     * @param {string} remoteNodeName - name of the remote node
+     * @param {string} id - ID of the posting on the remote node
+     * @param {API.RemotePostingRepublishAttributes} attributes
+     * @return {Promise<API.Result>}
+     */
+    republishRemotePosting(remoteNodeName, id, attributes) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const location = (0, util_1.ut) `/nodes/${remoteNodeName}/postings/${id}/republish`;
+            return yield this.call("republishRemotePosting", location, {
+                method: "POST", body: attributes, schema: "Result"
+            });
+        });
+    }
     /**
      * Verify the signature of the given posting.
      *
@@ -2850,6 +2848,21 @@ class MoeraNode extends caller_1.Caller {
             });
         });
     }
+    /**
+     * Get all stories coming from the given external source.
+     *
+     * @param {string} external - URI of the external source of the story
+     * @return {Promise<API.StoryInfo[]>}
+     */
+    getStoriesByExternalSource(external) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const location = (0, util_1.ut) `/stories`;
+            const params = { external };
+            return yield this.call("getStoriesByExternalSource", location, {
+                method: "GET", params, schema: "StoryInfoArray", bodies: true
+            });
+        });
+    }
     /**
      * Get an individual story.
      *

package/lib/node/types.js

@@ -22,7 +22,6 @@ exports.SCOPE_VALUES = {
     "view-feeds": 0x00008000,
     "update-feeds": 0x00010000,
     "name": 0x00020000,
-    "plugins": 0x00040000,
     "view-profile": 0x00080000,
     "update-profile": 0x00100000,
     "sheriff": 0x00200000,
@@ -36,5 +35,5 @@ exports.SCOPE_VALUES = {
     "upload-private-media": 0x20000000,
     "lease-media": 0x40000000,
     "view-all": 0x00088404,
-    "all": 0x7ffffffd,
+    "all": 0x7ffbfffd,
 };