@colibri-social/lexicons 2.9.0 → 2.10.0

package/lexicons/social/colibri/beta/thread/moveMessages.json

@@ -4,7 +4,7 @@
 	"defs": {
 		"main": {
 			"type": "procedure",
-			"description": "Moves messages written by other people into another thread or channel. A message lives in its author's own repo and cannot be rewritten by a moderator, so the move is a `moved` label written into the source space for each message. Every label in one call shares a batch key, and the destination serves the moved messages ordered by that batch key and then by the messages' own record keys, which is what keeps a selection in the order it was in. The AppView withholds a moved message from the space it came from. A user moving only their own messages rewrites the records instead and does not call this method.",
+			"description": "Moves messages into another thread or channel. A message lives in its author's own repo and cannot be rewritten by a moderator, so the move is a `moved` label written into the source space for each message. The destination serves each moved message at its own record key, so a selection keeps the order it was written in and reads among the destination's own messages by send time. The AppView withholds a moved message from the space it came from.",
 			"input": {
 				"encoding": "application/json",
 				"schema": {
@@ -49,7 +49,7 @@
 						"batch": {
 							"type": "string",
 							"format": "tid",
-							"description": "The batch key shared by every label this call wrote, which is what orders the moved messages in the destination."
+							"description": "The batch key shared by every label this call wrote, which groups the move for auditing."
 						},
 						"count": {
 							"type": "integer",

package/lexicons/social/colibri/beta/thread/repoint.json

@@ -4,7 +4,7 @@
 	"defs": {
 		"main": {
 			"type": "procedure",
-			"description": "Moves a thread to another channel by rewriting the channel its record links to. Who may read the thread follows the new channel. The anchor is left as it was, so the thread's marker leaves the old channel's river while the thread itself still quotes the message it came from.",
+			"description": "Moves a thread to another channel by rewriting the channel its record links to, and optionally repoints it at another message. Who may read the thread follows the new channel. Left without an anchor the thread keeps the one it has, so its marker sits wherever that message now lives.",
 			"input": {
 				"encoding": "application/json",
 				"schema": {
@@ -20,6 +20,11 @@
 							"type": "string",
 							"format": "space-ref",
 							"description": "The text channel to move it to."
+						},
+						"anchor": {
+							"type": "ref",
+							"ref": "social.colibri.beta.defs#spaceRecordRef",
+							"description": "The message the thread should hang under, for a thread whose anchor was moved. It has to sit in the destination channel, and may be a message the AppView has not indexed yet. Absent keeps the anchor as it is."
 						}
 					}
 				}
@@ -45,7 +50,7 @@
 				},
 				{
 					"name": "Forbidden",
-					"description": "The requesting user lacks the thread.manage permission."
+					"description": "The requesting user lacks the thread.manage permission and did not write both the thread's current anchor and the message it is being repointed at."
 				},
 				{
 					"name": "ThreadNotFound",
@@ -57,7 +62,7 @@
 				},
 				{
 					"name": "InvalidRequest",
-					"description": "The destination channel belongs to another community, is not a text channel, or is the channel the thread is already in."
+					"description": "The destination channel belongs to another community, is not a text channel, or is the channel the thread is already in while no new anchor was given."
 				},
 				{
 					"name": "CredentialsUnavailable",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@colibri-social/lexicons",
-  "version": "2.9.0",
+  "version": "2.10.0",
   "description": "Colibri lexicon schemas and the types generated from them",
   "type": "module",
   "exports": {