API updates.

Author: smelamud

src/moeralib/node/node.py

@@ -1202,6 +1202,32 @@ def delete_node_name(self) -> types.Result:
         data = self.call("delete_node_name", location, method="DELETE", schema=schemas.RESULT_SCHEMA)
         return types.Result.from_json(data)
 
+    def get_stored_mnemonic(self) -> types.KeyMnemonic:
+        """
+        Get the updating key mnemonic stored on the node.
+        """
+        location = "/node-name/mnemonic"
+        data = self.call("get_stored_mnemonic", location, method="GET", schema=schemas.KEY_MNEMONIC_SCHEMA)
+        return types.KeyMnemonic.from_json(data)
+
+    def store_mnemonic(self, mnemonic: types.KeyMnemonic) -> types.Result:
+        """
+        Store the updating key mnemonic on the node.
+
+        :param mnemonic:
+        """
+        location = "/node-name/mnemonic"
+        data = self.call("store_mnemonic", location, method="POST", body=mnemonic, schema=schemas.RESULT_SCHEMA)
+        return types.Result.from_json(data)
+
+    def delete_stored_mnemonic(self) -> types.Result:
+        """
+        Delete the updating key mnemonic stored on the node.
+        """
+        location = "/node-name/mnemonic"
+        data = self.call("delete_stored_mnemonic", location, method="DELETE", schema=schemas.RESULT_SCHEMA)
+        return types.Result.from_json(data)
+
     def send_notification(self, packet: types.NotificationPacket) -> types.Result:
         """
         Accept a notification packet from another node. Notification packets older than 10 minutes are ignored. The
@@ -2075,6 +2101,16 @@ def update_story(self, id: str, story: types.StoryAttributes) -> types.StoryInfo
         )
         return types.StoryInfo.from_json(data)
 
+    def delete_story(self, id: str) -> types.Result:
+        """
+        Delete the story.
+
+        :param id: ID of the story
+        """
+        location = "/stories/{id}".format(id=quote_plus(id))
+        data = self.call("delete_story", location, method="DELETE", schema=schemas.RESULT_SCHEMA)
+        return types.Result.from_json(data)
+
     def get_subscribers(
         self, node_name: str | None = None, type: types.SubscriptionType | None = None, feed_name: str | None = None,
         entry_id: str | None = None

src/moeralib/node/schemas.py

@@ -939,6 +939,22 @@
 
 GRANT_INFO_ARRAY_SCHEMA = array_schema(GRANT_INFO_SCHEMA)
 
+KEY_MNEMONIC_SCHEMA: Any = {
+    "type": "object",
+    "properties": {
+        "mnemonic": {
+            "type": "array",
+            "items": {
+                "type": "string"
+            }
+        },
+    },
+    "required": [
+        "mnemonic",
+    ],
+    "additionalProperties": False
+}
+
 LINK_PREVIEW_SCHEMA: Any = {
     "type": "object",
     "properties": {
@@ -1028,6 +1044,9 @@
         "operationErrorMessage": {
             "type": ["string", "null"]
         },
+        "storedMnemonic": {
+            "type": ["boolean", "null"]
+        },
         "operations": to_nullable_object_schema(NODE_NAME_OPERATIONS_SCHEMA),
     },
     "additionalProperties": False
@@ -1923,6 +1942,26 @@
     "additionalProperties": False
 }
 
+STORY_SUMMARY_PAGE_CLICKS_SCHEMA: Any = {
+    "type": "object",
+    "properties": {
+        "heading": {
+            "type": ["string", "null"]
+        },
+        "href": {
+            "type": "string"
+        },
+        "clicks": {
+            "type": "integer"
+        },
+    },
+    "required": [
+        "href",
+        "clicks",
+    ],
+    "additionalProperties": False
+}
+
 STORY_SUMMARY_REACTION_SCHEMA: Any = {
     "type": "object",
     "properties": {
@@ -2796,6 +2835,10 @@
         "description": {
             "type": ["string", "null"]
         },
+        "clicks": {
+            "type": ["array", "null"],
+            "items": STORY_SUMMARY_PAGE_CLICKS_SCHEMA
+        },
     },
     "additionalProperties": False
 }

src/moeralib/node/types.py

@@ -73,6 +73,8 @@
     "all": 0x3fffffff,
 }
 
+SearchEngine = Literal["google"]
+
 SettingType = Literal[
     "bool", "int", "string", "json", "Duration", "PrivateKey", "PublicKey", "Timestamp", "UUID", "Principal"
 ]
@@ -88,7 +90,7 @@
     "unlawful", "defamatory", "threat", "spam", "scam", "malware", "copyright", "impersonating", "privacy", "other"
 ]
 
-SourceFormat = Literal["plain-text", "html", "markdown", "application"]
+SourceFormat = Literal["plain-text", "html", "markdown", "html/visual", "application"]
 
 StoryType = Literal[
     "asked-to-friend", "asked-to-subscribe", "blocked-user", "blocked-user-in-posting", "comment-added",
@@ -99,7 +101,8 @@
     "posting-media-reaction-added-negative", "posting-media-reaction-added-positive", "posting-media-reaction-failed",
     "posting-post-task-failed", "posting-reaction-task-failed", "posting-subscribe-task-failed",
     "posting-update-task-failed", "posting-updated", "reaction-added-negative", "reaction-added-positive",
-    "remote-comment-added", "reply-comment", "sheriff-complaint-added", "sheriff-complaint-decided", "sheriff-marked",
+    "reminder-avatar", "reminder-email", "reminder-full-name", "reminder-sheriff-allow", "remote-comment-added",
+    "reply-comment", "search-report", "sheriff-complaint-added", "sheriff-complaint-decided", "sheriff-marked",
     "sheriff-unmarked", "subscriber-added", "subscriber-deleted", "unblocked-user", "unblocked-user-in-posting"
 ]
 
@@ -1148,6 +1151,11 @@ class GrantInfo(Structure):
     """the set of administrative permissions granted to the node"""
 
 
+class KeyMnemonic(Structure):
+    mnemonic: List[str]
+    """the words"""
+
+
 class LinkPreview(Structure):
     site_name: str | None = None
     """name of the site"""
@@ -1234,6 +1242,8 @@ class NodeNameInfo(Structure):
     """if the operation with the node name was failed, the code of the failure"""
     operation_error_message: str | None = None
     """if the operation with the node name was failed, the human-readable description of the failure"""
+    stored_mnemonic: bool | None = None
+    """``True``, if updating key mnemonic is being stored on the node, ``False`` otherwise"""
     operations: NodeNameOperations | None = None
     """the supported operations and the corresponding principals"""
 
@@ -1990,6 +2000,15 @@ class StorySummaryNode(Structure):
     """node owner's gender"""
 
 
+class StorySummaryPageClicks(Structure):
+    heading: str | None = None
+    """page heading, ``None`` for the blog itself"""
+    href: str
+    """page URL"""
+    clicks: int
+    """number of clicks on the page"""
+
+
 class StorySummaryReaction(Structure):
     owner_name: str | None = None
     """reaction owner's name"""
@@ -2805,6 +2824,8 @@ class StorySummaryData(Structure):
     """summary of an action of a sheriff"""
     description: str | None = None
     """additional descriptive text"""
+    clicks: List[StorySummaryPageClicks] | None = None
+    """list of pages with number of clicks on each of them"""
 
 
 class CommentInfo(Structure):