@solarpunkltd/swarm-chat-js 7.2.0 → 8.0.0

package/dist/index.js

@@ -1,7 +1,7 @@
-import { ChatMessageError as e, DEFAULT_NOTE_HEARTBEAT_MS as t, DEFAULT_NOTE_SLOT_MS as n, MAX_ENTRY_BYTES as r, MAX_MESSAGE_BYTES as i, MAX_NAME_CHARACTERS as a, MAX_NOTE_BYTES as o, MAX_TEXT_CHARACTERS as s, MAX_TOPIC_CHARACTERS as c, MESSAGE_VERSION as l, MessageType as u, NOTE_VERSION as d, chatMessageSchema as f, checkChatMessage as p, countCharacters as m, createChatMessage as h, encodeChatMessage as g, encodeSlotNote as _, feedEntrySchema as v, hasValidSignature as ee, historyFileSchema as te, historyLinkSchema as y, historyRowSchema as ne, newMessageId as b, noteAddress as x, noteIdentifier as S, noteIdentifierText as C, noteSlotEnd as w, noteSlotOf as T, parseChatMessage as E, parseFeedEntry as D, parseHistoryFile as O, parseSlotNote as k, signedBytes as A, slotNoteSchema as re } from "./message.js";
-import { Bee as j, BeeResponseError as M, Identifier as N, PrivateKey as P, Topic as F } from "@ethersphere/bee-js";
+import { A as e, B as t, C as n, D as r, E as i, F as a, H as o, I as s, L as c, M as l, N as ee, O as u, P as d, R as f, S as p, T as m, V as te, _ as ne, a as re, b as ie, c as h, d as g, f as _, g as v, h as y, i as ae, j as oe, k as b, l as x, m as S, n as C, o as w, p as T, r as E, s as D, t as O, u as k, v as A, w as se, x as ce, y as j, z as M } from "./message-Dbh8qrpg.js";
+import { Bee as N, BeeResponseError as P, Identifier as F, PrivateKey as I, Topic as L } from "@ethersphere/bee-js";
 //#region src/events.ts
-var I = {
+var R = {
 	LOADING_INIT: "loadingInit",
 	LOADING_PREVIOUS_MESSAGES: "loadingPreviousMessages",
 	MESSAGE_RECEIVED: "messageReceived",
@@ -13,13 +13,13 @@ var I = {
 	MESSAGE_SKIPPED: "messageSkipped",
 	ERROR: "error"
 };
-function L(e) {
-	return z(e, -1, e.ts);
+function z(e) {
+	return V(e, -1, e.ts);
 }
-function R(e) {
-	return z(e.msg, e.seq, e.at);
+function B(e) {
+	return V(e.msg, e.seq, e.at);
 }
-function z(e, t, n) {
+function V(e, t, n) {
 	return {
 		id: e.id,
 		type: e.type,
@@ -28,13 +28,11 @@ function z(e, t, n) {
 		address: e.addr,
 		timestamp: n,
 		...e.target ? { targetMessageId: e.target } : {},
-		chatTopic: e.topic,
-		signature: e.sig,
 		index: t,
-		sentAt: e.ts
+		signedMessage: e
 	};
 }
-var B = class {
+var H = class {
 	constructor() {
 		this.listeners = /* @__PURE__ */ new Map(), this.on = (e, t) => {
 			this.listeners.set(e, [...this.listeners.get(e) ?? [], t]);
@@ -51,67 +49,92 @@ var B = class {
 			console.error(`a listener for ${e} threw`, t);
 		}
 	}
-}, V = class extends Error {
+}, U = 2e4, W = class {
+	constructor(e, t) {
+		this.spacingMs = e, this.now = t, this.missedAt = /* @__PURE__ */ new Map();
+	}
+	readableAt(e, t = this.now()) {
+		let n = this.missedAt.get(e);
+		return n === void 0 || this.expired(n, t) ? -Infinity : n + this.spacingMs;
+	}
+	mayRead(e, t = this.now()) {
+		return t >= this.readableAt(e, t);
+	}
+	missed(e, t = this.now()) {
+		for (let [e, n] of this.missedAt) this.expired(n, t) && this.missedAt.delete(e);
+		this.missedAt.set(e, t);
+	}
+	found(e) {
+		this.missedAt.delete(e);
+	}
+	clear() {
+		this.missedAt.clear();
+	}
+	expired(e, t) {
+		return e > t || t - e >= this.spacingMs;
+	}
+}, G = class extends Error {
 	constructor(e) {
 		super("the feed head lookup did not answer in time", e), this.name = "HeadLookupTimeoutError";
 	}
-}, H = class extends Error {
+}, K = class extends Error {
 	constructor(e, t) {
 		super(`feed slot ${e} was served but could not be read`, t), this.index = e, this.name = "UnreadableSlotError";
 	}
 };
-function U(e) {
-	return e instanceof M && (e.status === 404 || e.status === 500);
+function q(e) {
+	return e instanceof P && (e.status === 404 || e.status === 500);
 }
-async function W(e, t) {
+async function J(e, t) {
 	try {
 		return await t();
 	} catch (t) {
-		if (U(t)) return null;
-		throw t instanceof M ? t : new H(e, { cause: t });
+		if (q(t)) return null;
+		throw t instanceof P ? t : new K(e, { cause: t });
 	}
 }
-function G(e, t, r, i, a = n) {
-	let o = F.fromString(r), s = (n) => e.feed.makeReader(o, t, K(n));
+function le(e, t, n, r, i = C) {
+	let a = L.fromString(n), o = (n) => e.feed.makeReader(a, t, Y(n));
 	return {
-		readNote: (n) => W(n, async () => (await e.soc.makeReader(t, K(i.slotReadMs)).download(S(r, a, n))).payload.toUint8Array()),
-		readSlot: (e) => W(e, async () => (await s(i.slotReadMs).downloadPayload({ index: e })).payload.toUint8Array()),
+		readNote: (a) => J(a, async () => (await e.soc.makeReader(t, Y(r.slotReadMs)).download(D(n, i, a))).payload.toUint8Array()),
+		readSlot: (e) => J(e, async () => (await o(r.slotReadMs).downloadPayload({ index: e })).payload.toUint8Array()),
 		async readHead() {
-			let n = K(i.feedReadMs);
+			let n = Y(r.feedReadMs);
 			try {
-				let { payload: r, feedIndex: i } = await e.feed.makeReader(o, t, n).downloadPayload();
+				let { payload: r, feedIndex: i } = await e.feed.makeReader(a, t, n).downloadPayload();
 				return {
 					index: Number(i.toBigInt()),
 					payload: r.toUint8Array()
 				};
 			} catch (e) {
-				if (U(e)) return null;
-				throw n.signal?.aborted ? new V({ cause: e }) : e;
+				if (q(e)) return null;
+				throw n.signal?.aborted ? new G({ cause: e }) : e;
 			}
 		},
 		async readFile(t) {
-			return (await e.data.download(t, void 0, K(i.feedReadMs))).toUint8Array();
+			return (await e.data.download(t, void 0, Y(r.feedReadMs))).toUint8Array();
 		}
 	};
 }
-function K(e) {
+function Y(e) {
 	return { signal: AbortSignal.timeout(e) };
 }
-var ie = "0123456789abcdef".repeat(4);
-function q(e, t, n, r, i) {
-	let a = new P(n), o = N.fromString(r);
+var ue = "0123456789abcdef".repeat(4);
+function de(e, t, n, r, i) {
+	let a = new I(n), o = F.fromString(r);
 	return async (n) => {
-		await e.messaging.gsocSend(t, a, o, n, { deferred: !1 }, K(i.writeMs));
+		await e.messaging.gsocSend(t, a, o, n, { deferred: !1 }, Y(i.writeMs));
 	};
 }
 //#endregion
 //#region src/follower.ts
-var J = {
+var X = {
 	LIVE: "live",
 	RECONNECTING: "reconnecting",
 	STALLED: "stalled"
-}, Y = {
+}, fe = {
 	pollIntervalMs: 1e3,
+	missingReadSpacingMs: U,
 	maxSlotsPerPoll: 16,
 	unservedPollsBeforeProbe: 3,
 	unreadablePollsBeforeFailure: 3,
@@ -129,16 +152,16 @@ var J = {
 	stallAfterMs: 8e3,
 	random: Math.random,
 	now: Date.now
-}, X = class extends Error {
+}, Z = class extends Error {
 	constructor(e) {
 		super(`the gateway keeps answering feed slot ${e} with something that is not a chunk`), this.index = e, this.name = "UnreadableGatewayError";
 	}
-}, ae = class {
+}, pe = class {
 	constructor(e, t, n, r = {}, i = null) {
 		this.source = e, this.topic = t, this.events = n, this.notes = i, this.next = 0, this.ceiling = null, this.nextNoteSlot = 0, this.lastNoteFoundAt = 0, this.unservedPolls = 0, this.nextProbeAt = 0, this.unreadablePolls = 0, this.gatewayFailures = 0, this.missed = /* @__PURE__ */ new Map(), this.timer = null, this.generation = 0, this.running = !1, this.status = null, this.settings = {
-			...Y,
+			...fe,
 			...r
-		};
+		}, this.pacer = new W(this.settings.missingReadSpacingMs, this.settings.now);
 	}
 	get nextIndex() {
 		return this.next;
@@ -150,7 +173,7 @@ var J = {
 		return this.ceiling !== null;
 	}
 	start(e, t = null) {
-		this.stop(), this.next = e, this.ceiling = t?.newest ?? null, this.nextNoteSlot = t?.nextNoteSlot ?? (this.notes ? this.notes.lastReadableSlot() + 1 : 0), this.lastNoteFoundAt = this.settings.now(), this.resetRefusals(), this.unreadablePolls = 0, this.gatewayFailures = 0, this.missed.clear(), this.status = null, this.running = !0, this.schedule(0);
+		this.stop(), this.next = e, this.ceiling = t?.newest ?? null, this.nextNoteSlot = t?.nextNoteSlot ?? (this.notes ? this.notes.lastReadableSlot() + 1 : 0), this.lastNoteFoundAt = this.settings.now(), this.resetRefusals(), this.unreadablePolls = 0, this.gatewayFailures = 0, this.missed.clear(), this.pacer.clear(), this.status = null, this.running = !0, this.schedule(0);
 	}
 	stop() {
 		this.running = !1, this.generation++, this.timer &&= (clearTimeout(this.timer), null);
@@ -177,7 +200,11 @@ var J = {
 		}
 	}
 	untilNextRead() {
-		return this.ceiling === null || this.notes === null ? this.settings.pollIntervalMs : Math.max(0, this.notes.readableAt(this.nextNoteSlot) - this.settings.now());
+		let e = this.settings.now(), t = (t) => {
+			let n = this.pacer.readableAt(t);
+			return n > e ? n : e + this.settings.pollIntervalMs;
+		}, n = [...this.missed.keys()].map(t);
+		return this.notes !== null && n.push(this.notes.readableAt(this.nextNoteSlot)), this.ceiling === null && n.push(t(this.next)), Math.max(0, Math.min(...n) - e);
 	}
 	async readDueNotes(e, t) {
 		let n = this.settings.now(), r = e.lastReadableSlot(n);
@@ -192,19 +219,24 @@ var J = {
 		}
 	}
 	async read(e) {
+		let t;
 		try {
-			return await this.source.readSlot(e);
+			t = await this.source.readSlot(e);
 		} catch (e) {
-			if (e instanceof H) return "unreadable";
+			if (e instanceof K) return "unreadable";
 			throw e;
 		}
+		return t === null ? this.pacer.missed(e) : this.pacer.found(e), t;
+	}
+	async readUnnamed(e) {
+		return this.pacer.mayRead(e) ? this.read(e) : "held";
 	}
 	async walk(e) {
 		for (let t = 0; t < this.settings.maxSlotsPerPoll; t++) {
 			let n = this.next;
 			if (this.ceiling !== null && n > this.ceiling) return t;
-			let r = await this.read(n);
-			if (e !== this.generation) return t;
+			let r = this.ceiling === null ? await this.readUnnamed(n) : await this.read(n);
+			if (e !== this.generation || r === "held") return t;
 			if (this.ceiling !== null && (r === null || r === "unreadable")) {
 				this.remember(n), this.next = n + 1;
 				continue;
@@ -215,7 +247,7 @@ var J = {
 						this.unreadablePolls = 0;
 						continue;
 					}
-					if (this.unreadablePolls >= this.settings.unreadablePollsBeforeFailure) throw new X(n);
+					if (this.unreadablePolls >= this.settings.unreadablePollsBeforeFailure) throw new Z(n);
 				}
 				return t;
 			}
@@ -225,8 +257,8 @@ var J = {
 	}
 	shouldProbe() {
 		if (this.unservedPolls !== this.nextProbeAt) return !1;
-		let { probeIntervalCapMs: e, pollIntervalMs: t } = this.settings, n = Math.max(1, Math.ceil(e / t));
-		return this.nextProbeAt += Math.min(this.nextProbeAt, n), !0;
+		let { probeIntervalCapMs: e, pollIntervalMs: t, missingReadSpacingMs: n } = this.settings, r = Math.max(1, Math.ceil(e / Math.max(t, n)));
+		return this.nextProbeAt += Math.min(this.nextProbeAt, r), !0;
 	}
 	resetRefusals() {
 		this.unservedPolls = 0, this.nextProbeAt = this.settings.unservedPollsBeforeProbe;
@@ -234,17 +266,17 @@ var J = {
 	async probePast(e, t) {
 		let n = /* @__PURE__ */ new Set([e]);
 		for (let r of this.settings.probeDistances) {
-			let i = e + r, a = await this.read(i);
+			let i = e + r, a = await this.readUnnamed(i);
 			if (t !== this.generation) return !1;
-			if (a === null || a === "unreadable") {
+			if (a === null || a === "unreadable" || a === "held") {
 				n.add(i);
 				continue;
 			}
 			this.resetRefusals(), this.remember(e);
 			for (let r = e + 1; r < i; r++) {
-				let e = n.has(r) ? null : await this.read(r);
+				let e = n.has(r) ? null : await this.readUnnamed(r);
 				if (t !== this.generation) return !1;
-				e === null || e === "unreadable" ? this.remember(r) : this.accept(r, e);
+				e === null || e === "unreadable" || e === "held" ? this.remember(r) : this.accept(r, e);
 			}
 			return this.next = i + 1, this.accept(i, a), !0;
 		}
@@ -262,7 +294,7 @@ var J = {
 	async readMissed(e) {
 		let t = this.settings.now();
 		for (let [e, n] of this.missed) t - n >= this.settings.missedExpiryMs && (this.missed.delete(e), this.events.skipped(e, "unreachable", "not served within the time a stepped-past slot is kept"));
-		let n = [...this.missed.keys()].slice(0, this.settings.missedReadsPerPoll);
+		let n = [...this.missed.keys()].filter((e) => this.pacer.mayRead(e, t)).slice(0, this.settings.missedReadsPerPoll);
 		for (let t of n) {
 			let n = await this.read(t);
 			if (e !== this.generation) return;
@@ -271,16 +303,16 @@ var J = {
 		}
 	}
 	accept(e, t) {
-		let n = D(t, e, this.topic);
+		let n = A(t, e, this.topic);
 		n.ok ? (this.notes?.clock.observe(n.value.at, this.settings.now()), this.events.entry(n.value)) : this.events.skipped(e, n.reason, n.detail);
 	}
 	gatewayFailed(e) {
-		this.gatewayFailures++, this.setStatus(J.RECONNECTING), this.events.error(e);
+		this.gatewayFailures++, this.setStatus(X.RECONNECTING), this.events.error(e);
 	}
 	gatewayAnswered() {
 		this.gatewayFailures = 0;
 		let e = this.settings.now(), t = [...this.missed.values()].some((t) => e - t >= this.settings.stallAfterMs);
-		this.setStatus(t ? J.STALLED : J.LIVE);
+		this.setStatus(t ? X.STALLED : X.LIVE);
 	}
 	backoffMs() {
 		let { pollIntervalMs: e, backoffCapMs: t, random: n } = this.settings, r = Math.min(t, e * 2 ** this.gatewayFailures);
@@ -289,7 +321,7 @@ var J = {
 	setStatus(e) {
 		e !== this.status && (this.status = e, this.events.status(e));
 	}
-}, oe = 16, se = class {
+}, me = 16, he = class {
 	constructor(e, t, n, r = null) {
 		this.source = e, this.topic = t, this.events = n, this.notes = r, this.older = null, this.loading = null;
 	}
@@ -334,7 +366,7 @@ var J = {
 		try {
 			return await this.source.readHead();
 		} catch (e) {
-			if (e instanceof V) return this.events.error(e), null;
+			if (e instanceof G) return this.events.error(e), null;
 			throw e;
 		}
 	}
@@ -349,30 +381,30 @@ var J = {
 	async loadOlderOnce() {
 		let e = this.older;
 		if (e === null) return [];
-		let t = await this.source.readFile(e.ref), n = O(t, this.topic, e);
+		let t = await this.source.readFile(e.ref), n = j(t, this.topic, e);
 		if (!n.ok) throw this.older = null, Error(`history file ${e.ref} refused (${n.reason}): ${n.detail}`);
 		return this.report(n.value.skipped), this.older = n.value.prev, n.value.rows;
 	}
 	async newestLink(e, t) {
 		let n = t === void 0 ? e : e - 1;
 		if (t !== void 0) {
-			let n = D(t, e, this.topic);
+			let n = A(t, e, this.topic);
 			if (n.ok) return n.value.history;
 		}
-		for (let t = n; t >= Math.max(0, e - oe); t--) {
+		for (let t = n; t >= Math.max(0, e - me); t--) {
 			let e = await this.source.readSlot(t).catch((e) => {
-				if (e instanceof H) return null;
+				if (e instanceof K) return null;
 				throw e;
 			});
 			if (e === null) continue;
-			let n = D(e, t, this.topic);
+			let n = A(e, t, this.topic);
 			if (n.ok) return n.value.history;
 		}
 		return null;
 	}
 	async readFile(e) {
 		try {
-			let t = O(await this.source.readFile(e.ref), this.topic, e);
+			let t = j(await this.source.readFile(e.ref), this.topic, e);
 			return t.ok ? (this.report(t.value.skipped), this.older = t.value.prev, t.value.rows) : (this.events.error(/* @__PURE__ */ Error(`history file ${e.ref} refused (${t.reason}): ${t.detail}`)), "refused");
 		} catch (t) {
 			return this.events.error(t), this.older = e, null;
@@ -381,17 +413,18 @@ var J = {
 	report(e) {
 		e > 0 && this.events.skipped(e);
 	}
-}, ce = {
-	slotMs: n,
-	heartbeatMs: t,
+}, ge = {
+	slotMs: C,
+	heartbeatMs: O,
 	marginMs: 1e3,
 	scanBatch: 4,
-	clockLimitMs: 3e5
+	clockLimitMs: 3e5,
+	missingReadSpacingMs: U
 };
-function le(e) {
+function _e(e) {
 	return typeof e.readNote == "function";
 }
-var ue = class {
+var ve = class {
 	constructor(e) {
 		this.limitMs = e, this.aheadAtMost = Infinity, this.trusted = !0;
 	}
@@ -408,21 +441,21 @@ var ue = class {
 		let e = Number.isFinite(this.aheadAtMost), t = this.trusted || !e ? Math.min(0, this.aheadAtMost) : this.aheadAtMost;
 		return Math.max(-this.limitMs, Math.min(this.limitMs, t));
 	}
-}, Z = class {
+}, ye = class {
 	constructor(e, t, n) {
 		this.source = e, this.now = n, this.counts = {
 			found: 0,
 			empty: 0
 		}, this.settings = {
-			...ce,
+			...ge,
 			...t
-		}, this.clock = new ue(this.settings.clockLimitMs);
+		}, this.clock = new ve(this.settings.clockLimitMs), this.pacer = new W(this.settings.missingReadSpacingMs, n);
 	}
 	lastReadableSlot(e = this.now()) {
-		return T(e - this.settings.marginMs - this.clock.ms, this.settings.slotMs) - 1;
+		return k(e - this.settings.marginMs - this.clock.ms, this.settings.slotMs) - 1;
 	}
 	readableAt(e) {
-		return w(e, this.settings.slotMs) + this.settings.marginMs + this.clock.ms;
+		return x(e, this.settings.slotMs) + this.settings.marginMs + this.clock.ms;
 	}
 	get lookBackSlots() {
 		return Math.ceil(this.settings.heartbeatMs / this.settings.slotMs) + 2;
@@ -431,14 +464,15 @@ var ue = class {
 		return this.settings.heartbeatMs + 2 * this.settings.slotMs + this.settings.marginMs;
 	}
 	async read(e) {
+		if (!this.pacer.mayRead(e)) return null;
 		let t;
 		try {
-			t = await this.source.readNote(e);
+			t = await this.source.readNote(e), t === null && this.pacer.missed(e);
 		} catch (e) {
-			if (!(e instanceof H)) throw e;
+			if (!(e instanceof K)) throw e;
 			t = null;
 		}
-		let n = t === null ? null : k(t);
+		let n = t === null ? null : g(t);
 		return n === null ? (this.counts.empty++, null) : (this.counts.found++, this.clock.observe(n.writtenAt, this.now()), n);
 	}
 	async scan(e, t) {
@@ -458,17 +492,18 @@ var ue = class {
 	maxResends: 5,
 	reactionWindowMs: 1e3,
 	isLive: () => !0
-}, de = class {
+}, be = class {
 	constructor(e, t, n, r, i = Q) {
-		this.key = e, this.name = t, this.write = n, this.events = r, this.settings = i, this.outgoing = /* @__PURE__ */ new Map(), this.reactions = /* @__PURE__ */ new Map(), this.stopped = !1;
+		this.key = e, this.profile = t, this.write = n, this.events = r, this.settings = i, this.outgoing = /* @__PURE__ */ new Map(), this.reactions = /* @__PURE__ */ new Map(), this.stopped = !1;
 	}
 	get address() {
 		return this.key.publicKey().address().toHex();
 	}
 	send(e) {
-		let { message: t, bytes: n } = h(this.key, {
+		let { message: t, bytes: n } = l(this.key, {
 			...e,
-			name: this.name
+			...this.profile,
+			own: !1
 		}), r = {
 			message: t,
 			bytes: n,
@@ -545,22 +580,26 @@ var ue = class {
 	clearTimer(e) {
 		e.timer &&= (clearTimeout(e.timer), null);
 	}
-}, fe = [
+}, xe = [
 	1e3,
 	2e3,
 	4e3,
 	8e3
-], pe = 3;
+], Se = 3;
 function $(e) {
 	return (e.startsWith("0x") ? e.slice(2) : e).toLowerCase();
 }
-var me = class {
+var Ce = class {
 	constructor(e, t = {}) {
-		this.emitter = new B(), this.seen = /* @__PURE__ */ new Set(), this.status = null, this.generation = 0, this.running = !1, this.starting = null, this.openTimer = null, this.wakeOpen = null;
+		this.emitter = new H(), this.seen = /* @__PURE__ */ new Set(), this.status = null, this.generation = 0, this.running = !1, this.starting = null, this.openTimer = null, this.wakeOpen = null;
 		let { user: n, infra: r } = e;
-		this.key = new P($(n.privateKey)), this.topic = r.chatTopic, this.nickname = n.nickname, this.openRetryMs = t.openRetryMs ?? fe, this.senderSettings = {
+		this.key = new I($(n.privateKey)), this.topic = r.chatTopic, this.profile = {
+			name: n.nickname,
+			via: r.via,
+			...n.binding ? { idb: n.binding } : {}
+		}, this.openRetryMs = t.openRetryMs ?? xe, this.senderSettings = {
 			...Q,
-			isLive: () => this.status === J.LIVE,
+			isLive: () => this.status === X.LIVE,
 			...t.sender
 		};
 		let i = {
@@ -572,28 +611,28 @@ var me = class {
 			...r.noteHeartbeatMs === void 0 ? {} : { heartbeatMs: r.noteHeartbeatMs },
 			...t.notes
 		};
-		this.source = t.source ?? G(new j(r.beeUrl), $(r.chatAddress), r.chatTopic, i, a.slotMs), this.write = t.write ?? q(new j(r.writeUrl ?? r.beeUrl), r.stamp ? $(r.stamp) : ie, $(r.gsocResourceId), r.gsocTopic, i);
+		this.source = t.source ?? le(new N(r.beeUrl), $(r.chatAddress), r.chatTopic, i, a.slotMs), this.write = t.write ?? de(new N(r.writeUrl ?? r.beeUrl), r.stamp ? $(r.stamp) : ue, $(r.gsocResourceId), r.gsocTopic, i);
 		let o = t.follower?.now ?? (() => Date.now()), s = {
 			pollIntervalMs: r.pollingInterval ?? 1e3,
 			...t.follower,
 			now: o
 		}, c = this.source;
-		this.notes = le(c) ? new Z(c, a, o) : null, this.follower = new ae(this.source, this.topic, {
+		this.notes = _e(c) ? new ye(c, a, o) : null, this.follower = new pe(this.source, this.topic, {
 			entry: (e) => this.show(e),
-			skipped: (e, t, n) => this.emitter.emit(I.MESSAGE_SKIPPED, {
+			skipped: (e, t, n) => this.emitter.emit(R.MESSAGE_SKIPPED, {
 				index: e,
 				reason: t,
 				detail: n
 			}),
 			status: (e) => this.setStatus(e),
-			error: (e) => this.emitter.emit(I.ERROR, e)
-		}, s, this.notes), this.history = new se(this.source, this.topic, {
-			skipped: (e) => this.emitter.emit(I.MESSAGE_SKIPPED, {
+			error: (e) => this.emitter.emit(R.ERROR, e)
+		}, s, this.notes), this.history = new he(this.source, this.topic, {
+			skipped: (e) => this.emitter.emit(R.MESSAGE_SKIPPED, {
 				index: -1,
 				reason: "history-row",
 				detail: `${e} rows of a history file`
 			}),
-			error: (e) => this.emitter.emit(I.ERROR, e)
+			error: (e) => this.emitter.emit(R.ERROR, e)
 		}, this.notes), this.sender = this.makeSender();
 	}
 	getEmitter() {
@@ -621,7 +660,7 @@ var me = class {
 			if (!n) throw Error("a reaction names the message it reacts to");
 			return this.sender.react(this.topic, n, e), null;
 		}
-		return L(this.sender.send({
+		return z(this.sender.send({
 			topic: this.topic,
 			type: t,
 			target: n ?? "",
@@ -632,12 +671,12 @@ var me = class {
 		return this.sender.retry(typeof e == "string" ? e : e.id);
 	}
 	async fetchPreviousMessages() {
-		this.emitter.emit(I.LOADING_PREVIOUS_MESSAGES, !0);
+		this.emitter.emit(R.LOADING_PREVIOUS_MESSAGES, !0);
 		try {
 			let e = this.generation, t = await this.history.loadOlder();
 			return e === this.generation ? this.showRows(t) : [];
 		} finally {
-			this.emitter.emit(I.LOADING_PREVIOUS_MESSAGES, !1);
+			this.emitter.emit(R.LOADING_PREVIOUS_MESSAGES, !1);
 		}
 	}
 	hasPreviousMessages() {
@@ -647,16 +686,16 @@ var me = class {
 		return [...e].sort((e, t) => e.index >= 0 && t.index >= 0 ? e.index - t.index : e.index >= 0 || t.index >= 0 ? e.index >= 0 ? -1 : 1 : e.timestamp - t.timestamp);
 	}
 	async open(e) {
-		this.emitter.emit(I.LOADING_INIT, !0);
+		this.emitter.emit(R.LOADING_INIT, !0);
 		let t = 0;
 		for (; e === this.generation;) try {
 			let t = await this.history.open();
 			if (e !== this.generation) return;
-			this.showRows(t.rows), this.follower.start(t.startAt, t.notes), this.emitter.emit(I.LOADING_INIT, !1);
+			this.showRows(t.rows), this.follower.start(t.startAt, t.notes), this.emitter.emit(R.LOADING_INIT, !1);
 			return;
 		} catch (n) {
 			if (e !== this.generation) return;
-			t++, this.emitter.emit(I.ERROR, n), this.setStatus(J.RECONNECTING), t === pe && this.emitter.emit(I.CRITICAL_ERROR, n), await this.waitToOpen(this.openRetryMs[Math.min(t, this.openRetryMs.length) - 1] ?? 8e3);
+			t++, this.emitter.emit(R.ERROR, n), this.setStatus(X.RECONNECTING), t === Se && this.emitter.emit(R.CRITICAL_ERROR, n), await this.waitToOpen(this.openRetryMs[Math.min(t, this.openRetryMs.length) - 1] ?? 8e3);
 		}
 	}
 	waitToOpen(e) {
@@ -669,31 +708,31 @@ var me = class {
 		});
 	}
 	makeSender() {
-		return new de(this.key, this.nickname, this.write, {
-			pending: (e) => this.emitter.emit(I.MESSAGE_REQUEST_INITIATED, L(e)),
-			written: (e) => this.emitter.emit(I.MESSAGE_REQUEST_UPLOADED, L(e)),
+		return new be(this.key, this.profile, this.write, {
+			pending: (e) => this.emitter.emit(R.MESSAGE_REQUEST_INITIATED, z(e)),
+			written: (e) => this.emitter.emit(R.MESSAGE_REQUEST_UPLOADED, z(e)),
 			failed: (e, t) => {
-				this.emitter.emit(I.ERROR, t), this.emitter.emit(I.MESSAGE_REQUEST_ERROR, L(e));
+				this.emitter.emit(R.ERROR, t), this.emitter.emit(R.MESSAGE_REQUEST_ERROR, z(e));
 			},
 			confirmed: () => {}
 		}, this.senderSettings);
 	}
 	show(e) {
-		this.seen.has(e.seq) || (this.seen.add(e.seq), this.sender.confirm(e.msg), this.emitter.emit(I.MESSAGE_RECEIVED, R(e)));
+		this.seen.has(e.seq) || (this.seen.add(e.seq), this.sender.confirm(e.msg), this.emitter.emit(R.MESSAGE_RECEIVED, B(e)));
 	}
 	showRows(e) {
 		let t = [];
 		for (let n of e) {
 			if (this.seen.has(n.seq)) continue;
 			this.seen.add(n.seq), this.sender.confirm(n.msg);
-			let e = R(n);
-			t.push(e), this.emitter.emit(I.MESSAGE_RECEIVED, e);
+			let e = B(n);
+			t.push(e), this.emitter.emit(R.MESSAGE_RECEIVED, e);
 		}
 		return t;
 	}
 	setStatus(e) {
-		e !== this.status && (this.status = e, this.emitter.emit(I.STATUS, e));
+		e !== this.status && (this.status = e, this.emitter.emit(R.STATUS, e));
 	}
 };
 //#endregion
-export { B as ChatEmitter, e as ChatMessageError, t as DEFAULT_NOTE_HEARTBEAT_MS, n as DEFAULT_NOTE_SLOT_MS, I as EVENTS, J as FeedStatus, V as HeadLookupTimeoutError, r as MAX_ENTRY_BYTES, i as MAX_MESSAGE_BYTES, a as MAX_NAME_CHARACTERS, o as MAX_NOTE_BYTES, s as MAX_TEXT_CHARACTERS, c as MAX_TOPIC_CHARACTERS, l as MESSAGE_VERSION, u as MessageType, d as NOTE_VERSION, me as SwarmChat, X as UnreadableGatewayError, H as UnreadableSlotError, f as chatMessageSchema, p as checkChatMessage, m as countCharacters, h as createChatMessage, g as encodeChatMessage, _ as encodeSlotNote, v as feedEntrySchema, ee as hasValidSignature, te as historyFileSchema, y as historyLinkSchema, ne as historyRowSchema, b as newMessageId, x as noteAddress, S as noteIdentifier, C as noteIdentifierText, w as noteSlotEnd, T as noteSlotOf, E as parseChatMessage, D as parseFeedEntry, O as parseHistoryFile, k as parseSlotNote, A as signedBytes, re as slotNoteSchema };
+export { M as CHAT_BINDING_TITLE, H as ChatEmitter, p as ChatMessageError, O as DEFAULT_NOTE_HEARTBEAT_MS, C as DEFAULT_NOTE_SLOT_MS, R as EVENTS, X as FeedStatus, G as HeadLookupTimeoutError, t as MAX_BINDING_CHARACTERS, T as MAX_ENTRY_BYTES, n as MAX_MESSAGE_BYTES, se as MAX_NAME_CHARACTERS, E as MAX_NOTE_BYTES, m as MAX_TEXT_CHARACTERS, i as MAX_TOPIC_CHARACTERS, r as MESSAGE_VERSION, u as MessageType, b as MessageVia, ae as NOTE_VERSION, ie as OWN_FEED_TOPIC_PREFIX, Ce as SwarmChat, Z as UnreadableGatewayError, K as UnreadableSlotError, te as chatBindingSchema, e as chatMessageSchema, o as checkChatBinding, oe as countCharacters, l as createChatMessage, ee as encodeChatMessage, re as encodeSlotNote, S as feedEntrySchema, d as hasValidSignature, y as historyFileSchema, v as historyLinkSchema, ne as historyRowSchema, a as newMessageId, w as noteAddress, D as noteIdentifier, h as noteIdentifierText, x as noteSlotEnd, k as noteSlotOf, ce as ownFeedTopic, s as parseChatMessage, A as parseFeedEntry, j as parseHistoryFile, g as parseSlotNote, c as signedBytes, _ as slotNoteSchema, f as verifyChatMessage };

package/dist/message/binding.d.ts

@@ -0,0 +1,48 @@
+import { z } from 'zod';
+/**
+ * The Swarm ID chat binding: the account's statement, signed with its own key, that a chat address on one site is its
+ * own. The Swarm ID fork (solarpunk-id, `lib/src/utils/chat-binding.ts`) makes it, and this module reads it exactly as
+ * the fork's `verifyChatBinding` does, without importing the fork: the same four lines, the same clean site origin,
+ * the same EIP-191 personal_sign recovery with v 27 or 28 and a low s.
+ */
+/** The first line, which also versions the binding format. */
+export declare const CHAT_BINDING_TITLE = "Swarm ID chat binding v1";
+/** The fork's own bound on a binding's text. */
+export declare const MAX_BINDING_CHARACTERS = 512;
+/**
+ * A binding as a message carries it. `sig` is spelled as the fork writes it, `0x` and 130 lowercase hex characters
+ * of r, s and v, so one binding has one spelling inside the signed bytes.
+ */
+export declare const chatBindingSchema: z.ZodObject<{
+    msg: z.ZodString;
+    sig: z.ZodString;
+}, z.core.$strict>;
+export type ChatBinding = z.infer<typeof chatBindingSchema>;
+/** Who a verified binding says the sender is. */
+export interface ChatIdentity {
+    /** The Swarm ID account that signed the binding, `0x` and 40 lowercase hex characters. */
+    account: string;
+    /** The site the binding was signed for, a bare origin. */
+    site: string;
+    /** When the account says it signed, ISO 8601 UTC. */
+    date: string;
+}
+export interface BindingOptions {
+    /** The origin the reader runs on. When given, a binding for any other site is refused. */
+    origin?: string;
+    /** Accept a binding for `http://localhost`, `http://127.0.0.1` or `http://[::1]`, as only a development build signs. */
+    allowLocalHttp?: boolean;
+}
+export type BindingCheck = {
+    ok: true;
+    identity: ChatIdentity;
+} | {
+    ok: false;
+    detail: string;
+};
+/**
+ * Reads a binding for the chat address `addr` (40 lowercase hex characters, no `0x`). Refuses every text but the four
+ * lines the fork writes, a binding for another chat address, one for another site than `origin` when that is given,
+ * and a signature nothing recovers an account from. Never throws.
+ */
+export declare function checkChatBinding(binding: ChatBinding, addr: string, options?: BindingOptions): BindingCheck;

package/dist/message/canonicalSignature.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Whether r and s, 64 hex characters each, are in range with s in the lower half of the curve order. Every ECDSA
+ * signature has a second valid spelling with s replaced by n - s and v flipped, which recovers the same signer, so
+ * refusing the high s one leaves one valid signature per signed text. bee-js and the Swarm ID fork both sign low s.
+ */
+export declare function isCanonicalSignature(rHex: string, sHex: string): boolean;