@joe-broadhead/messaging 0.7.0 → 0.8.0

package/dist/lib/modules/core/conversation/link.js

@@ -0,0 +1,35 @@
+/**
+ * Linked channels (spec §16.10), reserved: the checks a person's own devices make on `via` lines against the link
+ * records of the person's `self` conversation. No daemon uses them yet. Pure.
+ */
+import { parseWith } from "../check.js";
+import { LinkRecord as LinkRecordSchema } from "../schema/conversation.js";
+import { MessagingError } from "../schema/errors.js";
+/** The links in force: for each link id the record written last (records are in `seq` order), unless revoked. */
+export function currentLinks(records) {
+    const last = new Map();
+    for (const raw of records) {
+        const record = parseWith(LinkRecordSchema, raw, "link record");
+        last.set(record.id, record);
+    }
+    return [...last.values()].filter((r) => r.revokedAt === undefined);
+}
+/**
+ * Checks a line's `via` against the author's links, as the author's own devices can (other members cannot see the
+ * person's links): only a person writes from a linked channel, never an agent, and only through a link of that
+ * channel that the authoring device hosts and that is in force. Throws `forbidden`.
+ */
+export function checkVia(body, by, links) {
+    if (body.t !== "line" || body.via === undefined)
+        return;
+    if (by.agent !== undefined)
+        throw new MessagingError("forbidden", "only a person writes from a linked channel");
+    const channel = body.via.channel;
+    if (!currentLinks(links).some((l) => l.channel === channel && l.host === by.device)) {
+        throw new MessagingError("forbidden", "no link of this channel is in force on the authoring device");
+    }
+}
+/** The reader id of a link's channel provider, for the audience guard: `ext:<channel>:<link id>`. */
+export function linkReader(link) {
+    return `ext:${link.channel}:${link.id}`;
+}