@minca/core 0.1.10 → 0.1.12
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +1 -1
- package/dist/identity/abilities.js +1 -1
- package/dist/identity/channel.d.ts +1 -1
- package/dist/identity/channel.d.ts.map +1 -1
- package/dist/identity/channel.js +1 -1
- package/dist/identity/channel.js.map +1 -1
- package/dist/identity/contact-key.d.ts +15 -15
- package/dist/identity/contact-key.d.ts.map +1 -1
- package/dist/identity/contact-key.js +21 -28
- package/dist/identity/contact-key.js.map +1 -1
- package/dist/inbox/inbox.d.ts +132 -0
- package/dist/inbox/inbox.d.ts.map +1 -0
- package/dist/inbox/inbox.js +197 -0
- package/dist/inbox/inbox.js.map +1 -0
- package/dist/inbox/index.d.ts +9 -0
- package/dist/inbox/index.d.ts.map +1 -0
- package/dist/inbox/index.js +7 -0
- package/dist/inbox/index.js.map +1 -0
- package/dist/index.d.ts +8 -6
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +3 -3
- package/dist/index.js.map +1 -1
- package/dist/network/introductions.d.ts +1 -1
- package/dist/network/introductions.d.ts.map +1 -1
- package/dist/network/mesh.d.ts +4 -2
- package/dist/network/mesh.d.ts.map +1 -1
- package/dist/network/mesh.js +31 -45
- package/dist/network/mesh.js.map +1 -1
- package/dist/network/peer-auth.d.ts +4 -0
- package/dist/network/peer-auth.d.ts.map +1 -1
- package/dist/network/peer-auth.js +9 -7
- package/dist/network/peer-auth.js.map +1 -1
- package/dist/network/relay-minca.d.ts +6 -0
- package/dist/network/relay-minca.d.ts.map +1 -0
- package/dist/network/relay-minca.js +146 -0
- package/dist/network/relay-minca.js.map +1 -0
- package/dist/network/relay-nostr.d.ts +10 -0
- package/dist/network/relay-nostr.d.ts.map +1 -0
- package/dist/network/relay-nostr.js +247 -0
- package/dist/network/relay-nostr.js.map +1 -0
- package/dist/network/relay-socket.d.ts +87 -0
- package/dist/network/relay-socket.d.ts.map +1 -0
- package/dist/network/{signaling.js → relay-socket.js} +201 -167
- package/dist/network/relay-socket.js.map +1 -0
- package/dist/network/relays.d.ts +87 -0
- package/dist/network/relays.d.ts.map +1 -0
- package/dist/network/relays.js +43 -0
- package/dist/network/relays.js.map +1 -0
- package/dist/network/remote-transport.d.ts +1 -1
- package/dist/network/remote-transport.d.ts.map +1 -1
- package/dist/network/remote-transport.js +6 -31
- package/dist/network/remote-transport.js.map +1 -1
- package/dist/network/rendezvous.d.ts +59 -0
- package/dist/network/rendezvous.d.ts.map +1 -0
- package/dist/network/rendezvous.js +380 -0
- package/dist/network/rendezvous.js.map +1 -0
- package/dist/network/rtc-transport.d.ts.map +1 -1
- package/dist/network/rtc-transport.js +32 -17
- package/dist/network/rtc-transport.js.map +1 -1
- package/dist/network/transport.d.ts +7 -5
- package/dist/network/transport.d.ts.map +1 -1
- package/dist/node/actions.d.ts.map +1 -1
- package/dist/node/actions.js +28 -18
- package/dist/node/actions.js.map +1 -1
- package/dist/node/api.d.ts +11 -10
- package/dist/node/api.d.ts.map +1 -1
- package/dist/node/api.js +11 -10
- package/dist/node/api.js.map +1 -1
- package/dist/node/carrier.d.ts +11 -5
- package/dist/node/carrier.d.ts.map +1 -1
- package/dist/node/carrier.js +43 -2
- package/dist/node/carrier.js.map +1 -1
- package/dist/node/copy.d.ts +1 -1
- package/dist/node/copy.d.ts.map +1 -1
- package/dist/node/copy.js +10 -4
- package/dist/node/copy.js.map +1 -1
- package/dist/node/host.d.ts +2 -0
- package/dist/node/host.d.ts.map +1 -1
- package/dist/node/host.js +2 -0
- package/dist/node/host.js.map +1 -1
- package/dist/node/index.d.ts +1 -1
- package/dist/node/index.d.ts.map +1 -1
- package/dist/node/node.d.ts.map +1 -1
- package/dist/node/node.js +490 -298
- package/dist/node/node.js.map +1 -1
- package/dist/node/remote.d.ts.map +1 -1
- package/dist/node/remote.js +0 -2
- package/dist/node/remote.js.map +1 -1
- package/dist/node/space-runtime.d.ts +6 -2
- package/dist/node/space-runtime.d.ts.map +1 -1
- package/dist/node/space-runtime.js +5 -8
- package/dist/node/space-runtime.js.map +1 -1
- package/dist/node/types.d.ts +75 -46
- package/dist/node/types.d.ts.map +1 -1
- package/dist/react/use-invite-link.d.ts +1 -1
- package/dist/react/use-invite-link.d.ts.map +1 -1
- package/dist/react/use-invite-link.js +18 -11
- package/dist/react/use-invite-link.js.map +1 -1
- package/dist/records/loose.d.ts +52 -0
- package/dist/records/loose.d.ts.map +1 -0
- package/dist/records/loose.js +86 -0
- package/dist/records/loose.js.map +1 -0
- package/dist/schema/version.d.ts +2 -0
- package/dist/schema/version.d.ts.map +1 -1
- package/dist/schema/version.js +2 -1
- package/dist/schema/version.js.map +1 -1
- package/dist/schemas/choosing.d.ts +19 -0
- package/dist/schemas/choosing.d.ts.map +1 -0
- package/dist/schemas/choosing.js +69 -0
- package/dist/schemas/choosing.js.map +1 -0
- package/dist/schemas/contacts.d.ts +34 -87
- package/dist/schemas/contacts.d.ts.map +1 -1
- package/dist/schemas/contacts.js +32 -76
- package/dist/schemas/contacts.js.map +1 -1
- package/dist/schemas/index.d.ts +2 -2
- package/dist/schemas/index.d.ts.map +1 -1
- package/dist/schemas/index.js +1 -1
- package/dist/schemas/index.js.map +1 -1
- package/dist/schemas/library/annotations.d.ts +17 -285
- package/dist/schemas/library/annotations.d.ts.map +1 -1
- package/dist/schemas/library/annotations.js +9 -65
- package/dist/schemas/library/annotations.js.map +1 -1
- package/dist/schemas/library/community.d.ts +9 -17
- package/dist/schemas/library/community.d.ts.map +1 -1
- package/dist/schemas/library/community.js +5 -5
- package/dist/schemas/library/community.js.map +1 -1
- package/dist/schemas/library/life.d.ts +3 -3
- package/dist/schemas/library/life.d.ts.map +1 -1
- package/dist/schemas/library/life.js +2 -2
- package/dist/schemas/library/life.js.map +1 -1
- package/dist/schemas/library/media.d.ts +148 -541
- package/dist/schemas/library/media.d.ts.map +1 -1
- package/dist/schemas/library/media.js +28 -64
- package/dist/schemas/library/media.js.map +1 -1
- package/dist/schemas/library/money.d.ts +8 -8
- package/dist/schemas/library/money.d.ts.map +1 -1
- package/dist/schemas/library/money.js +4 -4
- package/dist/schemas/library/money.js.map +1 -1
- package/dist/schemas/library/planning.d.ts +23 -87
- package/dist/schemas/library/planning.d.ts.map +1 -1
- package/dist/schemas/library/planning.js +10 -26
- package/dist/schemas/library/planning.js.map +1 -1
- package/dist/schemas/library/publishing.d.ts +14 -14
- package/dist/schemas/library/publishing.d.ts.map +1 -1
- package/dist/schemas/library/publishing.js +7 -7
- package/dist/schemas/library/publishing.js.map +1 -1
- package/dist/schemas/library/social.d.ts +2 -2
- package/dist/schemas/library/social.d.ts.map +1 -1
- package/dist/schemas/library/social.js +1 -1
- package/dist/schemas/library/social.js.map +1 -1
- package/dist/schemas/standard.d.ts +1 -1
- package/dist/schemas/standard.d.ts.map +1 -1
- package/dist/schemas/standard.js +3 -3
- package/dist/schemas/standard.js.map +1 -1
- package/dist/session/auth.d.ts +5 -6
- package/dist/session/auth.d.ts.map +1 -1
- package/dist/session/auth.js +5 -6
- package/dist/session/auth.js.map +1 -1
- package/dist/session/channel-room.d.ts.map +1 -1
- package/dist/session/channel-room.js +3 -2
- package/dist/session/channel-room.js.map +1 -1
- package/dist/session/connect-code.d.ts +69 -55
- package/dist/session/connect-code.d.ts.map +1 -1
- package/dist/session/connect-code.js +189 -89
- package/dist/session/connect-code.js.map +1 -1
- package/dist/session/connect.d.ts +11 -15
- package/dist/session/connect.d.ts.map +1 -1
- package/dist/session/connect.js +8 -21
- package/dist/session/connect.js.map +1 -1
- package/dist/session/index.d.ts +2 -2
- package/dist/session/index.d.ts.map +1 -1
- package/dist/session/index.js +1 -1
- package/dist/session/index.js.map +1 -1
- package/dist/space/account-registry.d.ts +22 -0
- package/dist/space/account-registry.d.ts.map +1 -1
- package/dist/space/account-registry.js +18 -0
- package/dist/space/account-registry.js.map +1 -1
- package/dist/space/invitation.d.ts +61 -0
- package/dist/space/invitation.d.ts.map +1 -0
- package/dist/space/invitation.js +84 -0
- package/dist/space/invitation.js.map +1 -0
- package/dist/space/invite-link.d.ts +64 -0
- package/dist/space/invite-link.d.ts.map +1 -0
- package/dist/space/invite-link.js +212 -0
- package/dist/space/invite-link.js.map +1 -0
- package/dist/space/roles.d.ts.map +1 -1
- package/dist/space/roles.js +4 -2
- package/dist/space/roles.js.map +1 -1
- package/dist/space/space-manager.d.ts +21 -6
- package/dist/space/space-manager.d.ts.map +1 -1
- package/dist/space/space-manager.js +40 -23
- package/dist/space/space-manager.js.map +1 -1
- package/dist/types.d.ts +2 -0
- package/dist/types.d.ts.map +1 -1
- package/dist/types.js.map +1 -1
- package/docs/README.md +2 -2
- package/docs/actions.md +37 -37
- package/docs/agents.md +59 -37
- package/docs/automations.md +2 -2
- package/docs/blueprints-and-guides.md +44 -3
- package/docs/building-an-app.md +2 -2
- package/docs/contacts.md +48 -69
- package/docs/inbox.md +145 -0
- package/docs/node.md +68 -45
- package/docs/query-format.md +1 -1
- package/docs/sign-in.md +5 -7
- package/docs/spaces.md +33 -5
- package/docs/standard-library.md +111 -86
- package/package.json +6 -5
- package/dist/doors/doors.d.ts +0 -140
- package/dist/doors/doors.d.ts.map +0 -1
- package/dist/doors/doors.js +0 -226
- package/dist/doors/doors.js.map +0 -1
- package/dist/doors/index.d.ts +0 -9
- package/dist/doors/index.d.ts.map +0 -1
- package/dist/doors/index.js +0 -7
- package/dist/doors/index.js.map +0 -1
- package/dist/network/mailbox.d.ts +0 -45
- package/dist/network/mailbox.d.ts.map +0 -1
- package/dist/network/mailbox.js +0 -135
- package/dist/network/mailbox.js.map +0 -1
- package/dist/network/multi-signaling.d.ts +0 -41
- package/dist/network/multi-signaling.d.ts.map +0 -1
- package/dist/network/multi-signaling.js +0 -209
- package/dist/network/multi-signaling.js.map +0 -1
- package/dist/network/signaling.d.ts +0 -95
- package/dist/network/signaling.d.ts.map +0 -1
- package/dist/network/signaling.js.map +0 -1
- package/docs/doors.md +0 -151
package/dist/doors/doors.js
DELETED
|
@@ -1,226 +0,0 @@
|
|
|
1
|
-
import { contactKeyPair, contactPublicKey, isContactPublicKey, signWithScalar, verifyWithPoint, } from '../identity/contact-key.js';
|
|
2
|
-
import { openValueFrom, sealValueTo } from '../identity/hpke.js';
|
|
3
|
-
import { didToPublicKey } from '../identity/did.js';
|
|
4
|
-
import { noteCovers, verifyNote, UCAN_CLOCK_SKEW_SECONDS } from '../identity/ucan.js';
|
|
5
|
-
import { ACCOUNT_REQUIREMENT } from '../identity/abilities.js';
|
|
6
|
-
import { canonicalize } from '../schema/version.js';
|
|
7
|
-
import { parseSpaceInvite } from '../space/space-manager.js';
|
|
8
|
-
import { checkSpace, soleFounder } from '../space/constitution.js';
|
|
9
|
-
import { checkRelays } from '../space/roles.js';
|
|
10
|
-
import { sha256 } from '../utils/hash.js';
|
|
11
|
-
import { isObject } from '../utils/guards.js';
|
|
12
|
-
import { base64UrlDecode, base64UrlEncode, utf8Decode, utf8Encode } from '../utils/encoding.js';
|
|
13
|
-
/** A door names at most this many relays: enough that one going away doesn't matter */
|
|
14
|
-
export const MAX_DOOR_RELAYS = 3;
|
|
15
|
-
/** How long a knock waits in a mailbox, and so how old one may be when opened */
|
|
16
|
-
export const KNOCK_TTL_SECONDS = 14 * 24 * 3600;
|
|
17
|
-
/**
|
|
18
|
-
* How far a knock's own time may be from when the relay took it. A knock is
|
|
19
|
-
* dropped as soon as it is signed, so its time is checked against the relay's
|
|
20
|
-
* — which the knocker can't choose — and a note that ran out can't be used by
|
|
21
|
-
* dating a knock back to when it was good.
|
|
22
|
-
*/
|
|
23
|
-
export const KNOCK_DROP_WINDOW_SECONDS = 600;
|
|
24
|
-
const MAX_NAME = 64;
|
|
25
|
-
const MAX_NOTE = 2000;
|
|
26
|
-
const MAX_INVITE = 6000;
|
|
27
|
-
const MAX_PROOF = 4096;
|
|
28
|
-
/** Cuts text to at most `max` characters without splitting one (a surrogate pair stays whole) */
|
|
29
|
-
export function clip(text, max) {
|
|
30
|
-
const chars = Array.from(text);
|
|
31
|
-
return chars.length <= max ? text : chars.slice(0, max).join('');
|
|
32
|
-
}
|
|
33
|
-
/** Encodes a door code: what goes in a link or a QR code */
|
|
34
|
-
export function encodeDoorCode(code) {
|
|
35
|
-
const problem = checkDoorCode({ v: 1, ...code });
|
|
36
|
-
if (problem)
|
|
37
|
-
throw new Error(problem);
|
|
38
|
-
return base64UrlEncode(utf8Encode(canonicalize({
|
|
39
|
-
v: 1,
|
|
40
|
-
key: code.key,
|
|
41
|
-
sign: code.sign,
|
|
42
|
-
relays: [...code.relays],
|
|
43
|
-
...(code.name ? { name: code.name } : {}),
|
|
44
|
-
})));
|
|
45
|
-
}
|
|
46
|
-
/**
|
|
47
|
-
* Reads a door code, or a link carrying one after `#door=` or `door=`.
|
|
48
|
-
* @throws When it isn't one, saying why
|
|
49
|
-
*/
|
|
50
|
-
export function parseDoorCode(text) {
|
|
51
|
-
const trimmed = text.trim();
|
|
52
|
-
const found = /(?:^|[#?&])door=([A-Za-z0-9_-]+)/.exec(trimmed);
|
|
53
|
-
const raw = found ? found[1] : trimmed;
|
|
54
|
-
let parsed;
|
|
55
|
-
try {
|
|
56
|
-
parsed = JSON.parse(utf8Decode(base64UrlDecode(raw)));
|
|
57
|
-
}
|
|
58
|
-
catch {
|
|
59
|
-
throw new Error('That is not a door code — it may be cut short.');
|
|
60
|
-
}
|
|
61
|
-
if (!isDoorCode(parsed))
|
|
62
|
-
throw new Error(`That door code doesn't work: ${checkDoorCode(parsed)}`);
|
|
63
|
-
const code = parsed;
|
|
64
|
-
return Object.freeze({
|
|
65
|
-
v: 1,
|
|
66
|
-
key: code.key,
|
|
67
|
-
sign: code.sign,
|
|
68
|
-
relays: Object.freeze([...code.relays]),
|
|
69
|
-
...(code.name ? { name: code.name } : {}),
|
|
70
|
-
});
|
|
71
|
-
}
|
|
72
|
-
const isDoorCode = (value) => checkDoorCode(value) === null;
|
|
73
|
-
/** Why a value is not a door code, or null */
|
|
74
|
-
export function checkDoorCode(value) {
|
|
75
|
-
const code = value;
|
|
76
|
-
if (!isObject(code) || code.v !== 1)
|
|
77
|
-
return 'it is not a version 1 door';
|
|
78
|
-
if (!isContactPublicKey(code.key))
|
|
79
|
-
return 'its key is not a P-256 public key';
|
|
80
|
-
if (!isContactPublicKey(code.sign) || code.sign === code.key)
|
|
81
|
-
return 'its signing key is not a P-256 public key of its own';
|
|
82
|
-
if (!Array.isArray(code.relays) || code.relays.length === 0 || code.relays.length > MAX_DOOR_RELAYS) {
|
|
83
|
-
return `it names 1–${MAX_DOOR_RELAYS} relays`;
|
|
84
|
-
}
|
|
85
|
-
const relays = checkRelays(code.relays);
|
|
86
|
-
if (relays)
|
|
87
|
-
return relays;
|
|
88
|
-
if (code.name !== undefined && (typeof code.name !== 'string' || Array.from(code.name).length > MAX_NAME))
|
|
89
|
-
return `its name is text of at most ${MAX_NAME} characters`;
|
|
90
|
-
return null;
|
|
91
|
-
}
|
|
92
|
-
/**
|
|
93
|
-
* The mailbox topic of a door: a hash of its signing key. The relay can't tell
|
|
94
|
-
* whose door it is, and can check that whoever clears it holds that key.
|
|
95
|
-
*/
|
|
96
|
-
export async function doorTopic(sign) {
|
|
97
|
-
return base64UrlEncode(await sha256(utf8Encode(`minca/door-topic/v1|${sign}`)));
|
|
98
|
-
}
|
|
99
|
-
/**
|
|
100
|
-
* What a door's owner signs to clear knocks from a relay's mailbox: the topic,
|
|
101
|
-
* the relay's one-time challenge, and which knocks (`*` for all of them).
|
|
102
|
-
*/
|
|
103
|
-
export const purgeMessage = (topic, nonce, ids) => utf8Encode(`minca/door-purge/v1|${topic}|${nonce}|${ids ? [...ids].sort().join(',') : '*'}`);
|
|
104
|
-
/** Signs a relay's purge challenge with the door's signing key */
|
|
105
|
-
export function signPurge(signKey, topic, nonce, ids) {
|
|
106
|
-
return signWithScalar(signKey, purgeMessage(topic, nonce, ids));
|
|
107
|
-
}
|
|
108
|
-
/**
|
|
109
|
-
* The answer to a knock: the door's owner, signing with the door's signing key
|
|
110
|
-
* that the account which joined the space for two is theirs. Without it,
|
|
111
|
-
* whoever joined first — someone the invite was passed on to — would be taken
|
|
112
|
-
* for the person behind the door.
|
|
113
|
-
*/
|
|
114
|
-
const answerMessage = (pairSpace, did) => utf8Encode(`minca/knock-answer/v1|${pairSpace}|${did}`);
|
|
115
|
-
export function signAnswer(signKey, pairSpace, did) {
|
|
116
|
-
return signWithScalar(signKey, answerMessage(pairSpace, did));
|
|
117
|
-
}
|
|
118
|
-
export function checkAnswer(sign, pairSpace, did, signature) {
|
|
119
|
-
return verifyWithPoint(sign, answerMessage(pairSpace, did), signature);
|
|
120
|
-
}
|
|
121
|
-
/** A knock's id: the hash of its sealed blob, as relays file it */
|
|
122
|
-
export async function knockId(blob) {
|
|
123
|
-
return base64UrlEncode(await sha256(utf8Encode(blob)));
|
|
124
|
-
}
|
|
125
|
-
/** The HPKE label a knock is sealed under; bound to `{ door }`, the door key */
|
|
126
|
-
const KNOCK_LABEL = 'minca/knock/v1';
|
|
127
|
-
/**
|
|
128
|
-
* Makes a knock: the body, signed by the session key, sealed to the door key.
|
|
129
|
-
* @returns The sealed blob, for relays' mailboxes
|
|
130
|
-
*/
|
|
131
|
-
export async function sealKnock(door, knock, session, provider) {
|
|
132
|
-
const note = knock.note ? clip(knock.note.trim(), MAX_NOTE) : undefined;
|
|
133
|
-
const body = {
|
|
134
|
-
v: 2,
|
|
135
|
-
door,
|
|
136
|
-
from: knock.from,
|
|
137
|
-
name: clip(knock.name.trim(), MAX_NAME) || 'Someone',
|
|
138
|
-
invite: knock.invite,
|
|
139
|
-
...(note ? { note } : {}),
|
|
140
|
-
at: Math.floor(Date.now() / 1000),
|
|
141
|
-
session: session.did,
|
|
142
|
-
proof: session.proof,
|
|
143
|
-
};
|
|
144
|
-
const sig = base64UrlEncode(await provider.sign(session.key, utf8Encode(canonicalize(body))));
|
|
145
|
-
return sealValueTo(door, KNOCK_LABEL, { door }, { body, sig });
|
|
146
|
-
}
|
|
147
|
-
/**
|
|
148
|
-
* Opens a knock left on a door, and checks it through: sealed to this door;
|
|
149
|
-
* signed by a session key that its account's note vouches for, for the whole
|
|
150
|
-
* account and not by an agent; signed when the relay took it; recent; and
|
|
151
|
-
* carrying an invite to a private space that account made.
|
|
152
|
-
* @param doorKey The door key's private scalar (`deriveDoorKeyBytes`)
|
|
153
|
-
* @param receivedAt When the relay took it, ms, as `fetch` says
|
|
154
|
-
* @returns The knock, or null when it is anything less
|
|
155
|
-
*/
|
|
156
|
-
export async function openKnock(doorKey, blob, receivedAt, provider) {
|
|
157
|
-
const door = contactPublicKey(doorKey);
|
|
158
|
-
const opened = await openValueFrom(await contactKeyPair(doorKey), KNOCK_LABEL, { door }, blob);
|
|
159
|
-
if (!isObject(opened))
|
|
160
|
-
return null;
|
|
161
|
-
const { body, sig } = opened;
|
|
162
|
-
if (!isObject(body) || typeof sig !== 'string')
|
|
163
|
-
return null;
|
|
164
|
-
if (body.v !== 2 || body.door !== door)
|
|
165
|
-
return null;
|
|
166
|
-
if (typeof body.from !== 'string' || typeof body.session !== 'string' || typeof body.name !== 'string')
|
|
167
|
-
return null;
|
|
168
|
-
if (Array.from(body.name).length > MAX_NAME)
|
|
169
|
-
return null;
|
|
170
|
-
if (typeof body.invite !== 'string' || body.invite.length > MAX_INVITE)
|
|
171
|
-
return null;
|
|
172
|
-
if (!isObject(body.proof) || canonicalize(body.proof).length > MAX_PROOF)
|
|
173
|
-
return null;
|
|
174
|
-
if (body.note !== undefined && (typeof body.note !== 'string' || Array.from(body.note).length > MAX_NOTE))
|
|
175
|
-
return null;
|
|
176
|
-
if (typeof body.at !== 'number' || !Number.isSafeInteger(body.at) || !Number.isFinite(receivedAt))
|
|
177
|
-
return null;
|
|
178
|
-
const now = Math.floor(Date.now() / 1000);
|
|
179
|
-
if (body.at > now + UCAN_CLOCK_SKEW_SECONDS || body.at < now - KNOCK_TTL_SECONDS)
|
|
180
|
-
return null;
|
|
181
|
-
// Signed when it was dropped, not dated back to when a note was still good.
|
|
182
|
-
const dropped = Math.floor(receivedAt / 1000);
|
|
183
|
-
if (body.at > dropped + UCAN_CLOCK_SKEW_SECONDS || body.at < dropped - KNOCK_DROP_WINDOW_SECONDS)
|
|
184
|
-
return null;
|
|
185
|
-
// Signed by the session key it names…
|
|
186
|
-
let signed = false;
|
|
187
|
-
try {
|
|
188
|
-
const key = await provider.importPublicKey(didToPublicKey(body.session).publicKeyBytes);
|
|
189
|
-
signed = await provider.verify(key, base64UrlDecode(sig), utf8Encode(canonicalize(body)));
|
|
190
|
-
}
|
|
191
|
-
catch {
|
|
192
|
-
return null;
|
|
193
|
-
}
|
|
194
|
-
if (!signed)
|
|
195
|
-
return null;
|
|
196
|
-
// …which the account it claims had delegated to when it signed.
|
|
197
|
-
const checked = await verifyNote(body.proof, provider, { at: body.at }).catch(() => null);
|
|
198
|
-
if (!checked?.valid || checked.audience !== body.session || checked.root !== body.from)
|
|
199
|
-
return null;
|
|
200
|
-
// Knocking makes a space and hands out its invite: only a note that may write
|
|
201
|
-
// for the whole account may. An app given one space, or a key the account
|
|
202
|
-
// trusts less, may not.
|
|
203
|
-
if (!noteCovers(checked.note, ACCOUNT_REQUIREMENT))
|
|
204
|
-
return null;
|
|
205
|
-
// A private space the knocker made, with its key: anything else isn't a space for two from them.
|
|
206
|
-
let invited;
|
|
207
|
-
try {
|
|
208
|
-
invited = parseSpaceInvite(body.invite);
|
|
209
|
-
}
|
|
210
|
-
catch {
|
|
211
|
-
return null;
|
|
212
|
-
}
|
|
213
|
-
if (soleFounder(invited.space) !== body.from || invited.space.visibility !== 'private' || !invited.key)
|
|
214
|
-
return null;
|
|
215
|
-
if ((await checkSpace(invited.space)) !== null)
|
|
216
|
-
return null;
|
|
217
|
-
return Object.freeze({
|
|
218
|
-
from: body.from,
|
|
219
|
-
name: clip(body.name, MAX_NAME) || 'Someone',
|
|
220
|
-
...(typeof body.note === 'string' && body.note ? { note: body.note } : {}),
|
|
221
|
-
invite: body.invite,
|
|
222
|
-
pairSpace: invited.space.id,
|
|
223
|
-
at: body.at * 1000,
|
|
224
|
-
});
|
|
225
|
-
}
|
|
226
|
-
//# sourceMappingURL=doors.js.map
|
package/dist/doors/doors.js.map
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"doors.js","sourceRoot":"","sources":["../../src/doors/doors.ts"],"names":[],"mappings":"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"}
|
package/dist/doors/index.d.ts
DELETED
|
@@ -1,9 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* @module doors
|
|
3
|
-
* Doors and knocks — see `doors.ts`, and `node.doors` for the API an app uses.
|
|
4
|
-
*/
|
|
5
|
-
export { encodeDoorCode, parseDoorCode, checkDoorCode, doorTopic, knockId, sealKnock, openKnock, signPurge, purgeMessage, signAnswer, checkAnswer, clip, KNOCK_DROP_WINDOW_SECONDS, MAX_DOOR_RELAYS, KNOCK_TTL_SECONDS, } from './doors.js';
|
|
6
|
-
export type { DoorCode, KnockBody, OpenedKnock } from './doors.js';
|
|
7
|
-
export { createMailboxClient } from '../network/mailbox.js';
|
|
8
|
-
export type { MailboxClient, MailboxOptions, MailItem } from '../network/mailbox.js';
|
|
9
|
-
//# sourceMappingURL=index.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/doors/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,cAAc,EACd,aAAa,EACb,aAAa,EACb,SAAS,EACT,OAAO,EACP,SAAS,EACT,SAAS,EACT,SAAS,EACT,YAAY,EACZ,UAAU,EACV,WAAW,EACX,IAAI,EACJ,yBAAyB,EACzB,eAAe,EACf,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC"}
|
package/dist/doors/index.js
DELETED
|
@@ -1,7 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* @module doors
|
|
3
|
-
* Doors and knocks — see `doors.ts`, and `node.doors` for the API an app uses.
|
|
4
|
-
*/
|
|
5
|
-
export { encodeDoorCode, parseDoorCode, checkDoorCode, doorTopic, knockId, sealKnock, openKnock, signPurge, purgeMessage, signAnswer, checkAnswer, clip, KNOCK_DROP_WINDOW_SECONDS, MAX_DOOR_RELAYS, KNOCK_TTL_SECONDS, } from './doors.js';
|
|
6
|
-
export { createMailboxClient } from '../network/mailbox.js';
|
|
7
|
-
//# sourceMappingURL=index.js.map
|
package/dist/doors/index.js.map
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/doors/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,cAAc,EACd,aAAa,EACb,aAAa,EACb,SAAS,EACT,OAAO,EACP,SAAS,EACT,SAAS,EACT,SAAS,EACT,YAAY,EACZ,UAAU,EACV,WAAW,EACX,IAAI,EACJ,yBAAyB,EACzB,eAAe,EACf,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC"}
|
|
@@ -1,45 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Talking to a relay's mailbox: leaving a sealed knock under a door's topic,
|
|
3
|
-
* and reading what was left under one's own (`packages/relay/relay.mjs`).
|
|
4
|
-
*
|
|
5
|
-
* Each call opens its own short-lived socket, says one thing, waits for the
|
|
6
|
-
* answer and closes. A mailbox socket never joins a room, so it names no DID,
|
|
7
|
-
* and the relay can't tie a knock to the peer that left it or fetched it.
|
|
8
|
-
*
|
|
9
|
-
* client → { type: 'drop', topic, blob, ttl? } relay → { type: 'dropped', topic, id } | { type: 'refused', topic, reason }
|
|
10
|
-
* client → { type: 'fetch', topic, after? } relay → { type: 'mail', topic, items: [{ seq, id, at, blob }], more }
|
|
11
|
-
* client → { type: 'challenge' } relay → { type: 'challenge', nonce }
|
|
12
|
-
* client → { type: 'purge', topic, sign, ids?, sig } relay → { type: 'purged', topic, count } | { type: 'refused', topic, reason }
|
|
13
|
-
*/
|
|
14
|
-
/** One sealed knock, as a relay holds it */
|
|
15
|
-
export interface MailItem {
|
|
16
|
-
/** Increases with every drop on that relay */
|
|
17
|
-
readonly seq: number;
|
|
18
|
-
/** base64url SHA-256 of the blob: the same on every relay it was left at */
|
|
19
|
-
readonly id: string;
|
|
20
|
-
/** When it was dropped, ms, by the relay's clock */
|
|
21
|
-
readonly at: number;
|
|
22
|
-
readonly blob: string;
|
|
23
|
-
}
|
|
24
|
-
export interface MailboxClient {
|
|
25
|
-
/**
|
|
26
|
-
* Leaves a blob under a topic.
|
|
27
|
-
* @throws When the relay refuses it, or can't be reached
|
|
28
|
-
*/
|
|
29
|
-
drop(relay: string, topic: string, blob: string, ttlSeconds?: number): Promise<string>;
|
|
30
|
-
/** Everything a relay holds under a topic, after a sequence number */
|
|
31
|
-
fetch(relay: string, topic: string, after?: number): Promise<ReadonlyArray<MailItem>>;
|
|
32
|
-
/**
|
|
33
|
-
* Clears knocks from a topic — all of them, or those named — as the door's
|
|
34
|
-
* owner: shows the signing key and signs the relay's challenge with it.
|
|
35
|
-
*/
|
|
36
|
-
purge(relay: string, topic: string, sign: string, ids: ReadonlyArray<string> | null, signChallenge: (nonce: string) => Promise<string>): Promise<number>;
|
|
37
|
-
}
|
|
38
|
-
export interface MailboxOptions {
|
|
39
|
-
/** How long to wait for a relay to answer. Default 8 seconds. */
|
|
40
|
-
readonly timeoutMs?: number;
|
|
41
|
-
/** The WebSocket to use. Default the global one (browsers, Node 22+). */
|
|
42
|
-
readonly WebSocket?: typeof WebSocket;
|
|
43
|
-
}
|
|
44
|
-
export declare function createMailboxClient(options?: MailboxOptions): MailboxClient;
|
|
45
|
-
//# sourceMappingURL=mailbox.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"mailbox.d.ts","sourceRoot":"","sources":["../../src/network/mailbox.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,4CAA4C;AAC5C,MAAM,WAAW,QAAQ;IACvB,8CAA8C;IAC9C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACvF,sEAAsE;IACtE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC;IACtF;;;OAGG;IACH,KAAK,CACH,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,IAAI,EACjC,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GAChD,OAAO,CAAC,MAAM,CAAC,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,iEAAiE;IACjE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,yEAAyE;IACzE,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,SAAS,CAAC;CACvC;AAKD,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,cAAmB,GAAG,aAAa,CA2H/E"}
|
package/dist/network/mailbox.js
DELETED
|
@@ -1,135 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Talking to a relay's mailbox: leaving a sealed knock under a door's topic,
|
|
3
|
-
* and reading what was left under one's own (`packages/relay/relay.mjs`).
|
|
4
|
-
*
|
|
5
|
-
* Each call opens its own short-lived socket, says one thing, waits for the
|
|
6
|
-
* answer and closes. A mailbox socket never joins a room, so it names no DID,
|
|
7
|
-
* and the relay can't tie a knock to the peer that left it or fetched it.
|
|
8
|
-
*
|
|
9
|
-
* client → { type: 'drop', topic, blob, ttl? } relay → { type: 'dropped', topic, id } | { type: 'refused', topic, reason }
|
|
10
|
-
* client → { type: 'fetch', topic, after? } relay → { type: 'mail', topic, items: [{ seq, id, at, blob }], more }
|
|
11
|
-
* client → { type: 'challenge' } relay → { type: 'challenge', nonce }
|
|
12
|
-
* client → { type: 'purge', topic, sign, ids?, sig } relay → { type: 'purged', topic, count } | { type: 'refused', topic, reason }
|
|
13
|
-
*/
|
|
14
|
-
import { isObject } from '../utils/guards.js';
|
|
15
|
-
/** At most this many pages per fetch: 16 knocks each, and a door holds 64 */
|
|
16
|
-
const MAX_PAGES = 8;
|
|
17
|
-
export function createMailboxClient(options = {}) {
|
|
18
|
-
const timeoutMs = options.timeoutMs ?? 8000;
|
|
19
|
-
/** Opens a socket, sends one message, and resolves with the first answer `pick` accepts */
|
|
20
|
-
function ask(relay, message, pick) {
|
|
21
|
-
return talk(relay, (send) => send(message), async (answer) => pick(answer));
|
|
22
|
-
}
|
|
23
|
-
/**
|
|
24
|
-
* Opens a socket and holds a short conversation: `start` says the first
|
|
25
|
-
* thing, `hear` answers what comes back (it may `send` again) and settles it
|
|
26
|
-
* by returning a value.
|
|
27
|
-
*/
|
|
28
|
-
function talk(relay, start, hear) {
|
|
29
|
-
const Socket = options.WebSocket ?? globalThis.WebSocket;
|
|
30
|
-
if (!Socket)
|
|
31
|
-
return Promise.reject(new Error('No WebSocket here to reach a relay with'));
|
|
32
|
-
return new Promise((resolve, reject) => {
|
|
33
|
-
let settled = false;
|
|
34
|
-
const ws = new Socket(relay);
|
|
35
|
-
const settle = () => {
|
|
36
|
-
if (settled)
|
|
37
|
-
return false;
|
|
38
|
-
settled = true;
|
|
39
|
-
clearTimeout(timer);
|
|
40
|
-
try {
|
|
41
|
-
ws.close();
|
|
42
|
-
}
|
|
43
|
-
catch {
|
|
44
|
-
// already closing
|
|
45
|
-
}
|
|
46
|
-
return true;
|
|
47
|
-
};
|
|
48
|
-
const fail = (error) => {
|
|
49
|
-
if (settle())
|
|
50
|
-
reject(error);
|
|
51
|
-
};
|
|
52
|
-
const timer = setTimeout(() => fail(new Error(`${relay} did not answer`)), timeoutMs);
|
|
53
|
-
const say = (message) => ws.send(JSON.stringify(message));
|
|
54
|
-
ws.onopen = () => start(say);
|
|
55
|
-
ws.onerror = () => fail(new Error(`Could not reach ${relay}`));
|
|
56
|
-
ws.onclose = () => fail(new Error(`${relay} closed the connection`));
|
|
57
|
-
ws.onmessage = (event) => {
|
|
58
|
-
let answer;
|
|
59
|
-
try {
|
|
60
|
-
answer = JSON.parse(String(event.data));
|
|
61
|
-
}
|
|
62
|
-
catch {
|
|
63
|
-
return;
|
|
64
|
-
}
|
|
65
|
-
if (!isObject(answer))
|
|
66
|
-
return;
|
|
67
|
-
hear(answer, say).then((value) => {
|
|
68
|
-
if (value !== undefined && settle())
|
|
69
|
-
resolve(value);
|
|
70
|
-
}, (error) => fail(error instanceof Error ? error : new Error(String(error))));
|
|
71
|
-
};
|
|
72
|
-
});
|
|
73
|
-
}
|
|
74
|
-
const client = {
|
|
75
|
-
drop(relay, topic, blob, ttlSeconds) {
|
|
76
|
-
return ask(relay, { type: 'drop', topic, blob, ...(ttlSeconds ? { ttl: ttlSeconds } : {}) }, (answer) => {
|
|
77
|
-
if (answer.topic !== topic)
|
|
78
|
-
return undefined;
|
|
79
|
-
if (answer.type === 'dropped' && typeof answer.id === 'string')
|
|
80
|
-
return answer.id;
|
|
81
|
-
if (answer.type === 'refused')
|
|
82
|
-
throw new Error(`${relay} refused the knock: ${reasonOf(answer)}`);
|
|
83
|
-
return undefined;
|
|
84
|
-
});
|
|
85
|
-
},
|
|
86
|
-
async fetch(relay, topic, after = 0) {
|
|
87
|
-
const found = [];
|
|
88
|
-
let from = after;
|
|
89
|
-
for (let page = 0; page < MAX_PAGES; page++) {
|
|
90
|
-
const { items, more } = await ask(relay, { type: 'fetch', topic, after: from }, (answer) => answer.type === 'mail' && answer.topic === topic && Array.isArray(answer.items)
|
|
91
|
-
? { items: answer.items.filter(isMailItem), more: answer.more === true }
|
|
92
|
-
: undefined);
|
|
93
|
-
found.push(...items);
|
|
94
|
-
if (!more || items.length === 0)
|
|
95
|
-
break;
|
|
96
|
-
from = Math.max(...items.map((item) => item.seq));
|
|
97
|
-
}
|
|
98
|
-
return found;
|
|
99
|
-
},
|
|
100
|
-
purge(relay, topic, sign, ids, signChallenge) {
|
|
101
|
-
return talk(relay, (send) => send({ type: 'challenge' }), async (answer, send) => {
|
|
102
|
-
if (answer.type === 'challenge' && typeof answer.nonce === 'string') {
|
|
103
|
-
send({
|
|
104
|
-
type: 'purge',
|
|
105
|
-
topic,
|
|
106
|
-
sign,
|
|
107
|
-
...(ids ? { ids: [...ids] } : {}),
|
|
108
|
-
sig: await signChallenge(answer.nonce),
|
|
109
|
-
});
|
|
110
|
-
return undefined;
|
|
111
|
-
}
|
|
112
|
-
if (answer.topic !== topic)
|
|
113
|
-
return undefined;
|
|
114
|
-
if (answer.type === 'purged' && typeof answer.count === 'number')
|
|
115
|
-
return answer.count;
|
|
116
|
-
if (answer.type === 'refused')
|
|
117
|
-
throw new Error(`${relay} refused to clear the door: ${reasonOf(answer)}`);
|
|
118
|
-
return undefined;
|
|
119
|
-
});
|
|
120
|
-
},
|
|
121
|
-
};
|
|
122
|
-
return Object.freeze(client);
|
|
123
|
-
}
|
|
124
|
-
/** Why a relay refused; relays send a string */
|
|
125
|
-
function reasonOf(answer) {
|
|
126
|
-
return typeof answer.reason === 'string' ? answer.reason : 'no reason given';
|
|
127
|
-
}
|
|
128
|
-
function isMailItem(value) {
|
|
129
|
-
return (isObject(value) &&
|
|
130
|
-
Number.isSafeInteger(value.seq) &&
|
|
131
|
-
typeof value.id === 'string' &&
|
|
132
|
-
typeof value.at === 'number' &&
|
|
133
|
-
typeof value.blob === 'string');
|
|
134
|
-
}
|
|
135
|
-
//# sourceMappingURL=mailbox.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"mailbox.js","sourceRoot":"","sources":["../../src/network/mailbox.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAyC9C,6EAA6E;AAC7E,MAAM,SAAS,GAAG,CAAC,CAAC;AAEpB,MAAM,UAAU,mBAAmB,CAAC,OAAO,GAAmB,EAAE;IAC9D,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC;IAE5C,2FAA2F;IAC3F,SAAS,GAAG,CACV,KAAa,EACb,OAAgB,EAChB,IAAwD;QAExD,OAAO,IAAI,CACT,KAAK,EACL,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,EACvB,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAC/B,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,SAAS,IAAI,CACX,KAAa,EACb,KAAiD,EACjD,IAAmG;QAEnG,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,IAAI,UAAU,CAAC,SAAS,CAAC;QACzD,IAAI,CAAC,MAAM;YAAE,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC,CAAC;QACzF,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACxC,IAAI,OAAO,GAAG,KAAK,CAAC;YACpB,MAAM,EAAE,GAAG,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;YAC7B,MAAM,MAAM,GAAG,GAAY,EAAE;gBAC3B,IAAI,OAAO;oBAAE,OAAO,KAAK,CAAC;gBAC1B,OAAO,GAAG,IAAI,CAAC;gBACf,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,IAAI,CAAC;oBACH,EAAE,CAAC,KAAK,EAAE,CAAC;gBACb,CAAC;gBAAC,MAAM,CAAC;oBACP,kBAAkB;gBACpB,CAAC;gBACD,OAAO,IAAI,CAAC;YACd,CAAC,CAAC;YACF,MAAM,IAAI,GAAG,CAAC,KAAY,EAAE,EAAE;gBAC5B,IAAI,MAAM,EAAE;oBAAE,MAAM,CAAC,KAAK,CAAC,CAAC;YAC9B,CAAC,CAAC;YACF,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,GAAG,KAAK,iBAAiB,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;YACtF,MAAM,GAAG,GAAG,CAAC,OAAgB,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;YACnE,EAAE,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC7B,EAAE,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,mBAAmB,KAAK,EAAE,CAAC,CAAC,CAAC;YAC/D,EAAE,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,GAAG,KAAK,wBAAwB,CAAC,CAAC,CAAC;YACrE,EAAE,CAAC,SAAS,GAAG,CAAC,KAAmB,EAAE,EAAE;gBACrC,IAAI,MAAe,CAAC;gBACpB,IAAI,CAAC;oBACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;gBAC1C,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO;gBACT,CAAC;gBACD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;oBAAE,OAAO;gBAC9B,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,CACpB,CAAC,KAAK,EAAE,EAAE;oBACR,IAAI,KAAK,KAAK,SAAS,IAAI,MAAM,EAAE;wBAAE,OAAO,CAAC,KAAK,CAAC,CAAC;gBACtD,CAAC,EACD,CAAC,KAAc,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CACpF,CAAC;YACJ,CAAC,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,MAAM,GAAkB;QAC5B,IAAI,CAAC,KAAa,EAAE,KAAa,EAAE,IAAY,EAAE,UAAmB;YAClE,OAAO,GAAG,CACR,KAAK,EACL,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EACzE,CAAC,MAAM,EAAE,EAAE;gBACT,IAAI,MAAM,CAAC,KAAK,KAAK,KAAK;oBAAE,OAAO,SAAS,CAAC;gBAC7C,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,MAAM,CAAC,EAAE,KAAK,QAAQ;oBAAE,OAAO,MAAM,CAAC,EAAE,CAAC;gBACjF,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;oBAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,uBAAuB,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBAClG,OAAO,SAAS,CAAC;YACnB,CAAC,CACF,CAAC;QACJ,CAAC;QAED,KAAK,CAAC,KAAK,CAAC,KAAa,EAAE,KAAa,EAAE,KAAK,GAAG,CAAC;YACjD,MAAM,KAAK,GAAe,EAAE,CAAC;YAC7B,IAAI,IAAI,GAAG,KAAK,CAAC;YACjB,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC;gBAC5C,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,GAAG,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,MAAM,EAAE,EAAE,CACzF,MAAM,CAAC,IAAI,KAAK,MAAM,IAAI,MAAM,CAAC,KAAK,KAAK,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;oBAC7E,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,KAAK,IAAI,EAAE;oBACxE,CAAC,CAAC,SAAS,CACd,CAAC;gBACF,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;gBACrB,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;oBAAE,MAAM;gBACvC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;YACpD,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,aAAa;YAC1C,OAAO,IAAI,CACT,KAAK,EACL,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,EACrC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;gBACrB,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;oBACpE,IAAI,CAAC;wBACH,IAAI,EAAE,OAAO;wBACb,KAAK;wBACL,IAAI;wBACJ,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;wBACjC,GAAG,EAAE,MAAM,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC;qBACvC,CAAC,CAAC;oBACH,OAAO,SAAS,CAAC;gBACnB,CAAC;gBACD,IAAI,MAAM,CAAC,KAAK,KAAK,KAAK;oBAAE,OAAO,SAAS,CAAC;gBAC7C,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ;oBAAE,OAAO,MAAM,CAAC,KAAK,CAAC;gBACtF,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;oBAC3B,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,+BAA+B,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBAC7E,OAAO,SAAS,CAAC;YACnB,CAAC,CACF,CAAC;QACJ,CAAC;KACF,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC;AAED,gDAAgD;AAChD,SAAS,QAAQ,CAAC,MAA+B;IAC/C,OAAO,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC;AAC/E,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,CACL,QAAQ,CAAC,KAAK,CAAC;QACf,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC;QAC/B,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ;QAC5B,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ;QAC5B,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAC/B,CAAC;AACJ,CAAC"}
|
|
@@ -1,41 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Several rendezvous points behind one interface.
|
|
3
|
-
*
|
|
4
|
-
* A relay is a phone book, not an authority: it forwards connection offers and
|
|
5
|
-
* never sees a version. But with exactly one of them configured there is
|
|
6
|
-
* still, in practice, a single point of failure and a single operator who can
|
|
7
|
-
* decide nobody gets introduced today. Pointing at several removes that without
|
|
8
|
-
* changing what any of them can do.
|
|
9
|
-
*
|
|
10
|
-
* They are used all at once rather than in order. Failover would still leave two
|
|
11
|
-
* people stranded when one is on the first relay and the other on the second;
|
|
12
|
-
* being present on all of them means they meet wherever either is looking. The
|
|
13
|
-
* cost is a handful of websockets, which is what a torrent client has always
|
|
14
|
-
* done with its tracker list.
|
|
15
|
-
*
|
|
16
|
-
* Peers are announced once per room however many relays mention them, because a
|
|
17
|
-
* duplicate announcement would have both sides opening a second connection.
|
|
18
|
-
*
|
|
19
|
-
* A room can name relays of its own: a space says where its members meet
|
|
20
|
-
* (`sys.relays`), so two people whose apps use different relays still find
|
|
21
|
-
* each other there. Those are joined for that room only, and dropped once no
|
|
22
|
-
* room names them.
|
|
23
|
-
*/
|
|
24
|
-
import { type RelayStatus, type SignalingClient, type SignalingEvents } from './signaling.js';
|
|
25
|
-
/** A client over several relays, where a room may name relays of its own */
|
|
26
|
-
export interface MultiSignalingClient extends Omit<SignalingClient, 'status' | 'on' | 'off'> {
|
|
27
|
-
/** Joins a room on every relay, and on `relays` as well — joining again with a different list moves to it */
|
|
28
|
-
readonly join: (room: string, relays?: ReadonlyArray<string>) => void;
|
|
29
|
-
/** Every relay in use and where its socket stands */
|
|
30
|
-
readonly relays: () => ReadonlyArray<RelayStatus>;
|
|
31
|
-
readonly on: <K extends keyof MultiSignalingEvents>(event: K, callback: MultiSignalingEvents[K]) => void;
|
|
32
|
-
readonly off: <K extends keyof MultiSignalingEvents>(event: K, callback: MultiSignalingEvents[K]) => void;
|
|
33
|
-
}
|
|
34
|
-
/** One relay's `status` becomes the whole list's */
|
|
35
|
-
export type MultiSignalingEvents = Omit<SignalingEvents, 'status'> & {
|
|
36
|
-
/** A relay opened, closed or is waiting to try again; carries every relay */
|
|
37
|
-
status: (relays: ReadonlyArray<RelayStatus>) => void;
|
|
38
|
-
};
|
|
39
|
-
/** Creates a signaling client spanning several relays. */
|
|
40
|
-
export declare function createMultiSignalingClient(urls: ReadonlyArray<string>, did: string): MultiSignalingClient;
|
|
41
|
-
//# sourceMappingURL=multi-signaling.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"multi-signaling.d.ts","sourceRoot":"","sources":["../../src/network/multi-signaling.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,eAAe,EAErB,MAAM,gBAAgB,CAAC;AAExB,4EAA4E;AAC5E,MAAM,WAAW,oBAAqB,SAAQ,IAAI,CAAC,eAAe,EAAE,QAAQ,GAAG,IAAI,GAAG,KAAK,CAAC;IAC1F,6GAA6G;IAC7G,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;IACtE,qDAAqD;IACrD,QAAQ,CAAC,MAAM,EAAE,MAAM,aAAa,CAAC,WAAW,CAAC,CAAC;IAClD,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC,SAAS,MAAM,oBAAoB,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,oBAAoB,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IACzG,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,SAAS,MAAM,oBAAoB,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,oBAAoB,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;CAC3G;AAED,oDAAoD;AACpD,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,GAAG;IACnE,6EAA6E;IAC7E,MAAM,EAAE,CAAC,MAAM,EAAE,aAAa,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;CACtD,CAAC;AAEF,0DAA0D;AAC1D,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,oBAAoB,CA2LzG"}
|