@minca/core 0.1.9 → 0.1.11

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.
Files changed (195) hide show
  1. package/README.md +2 -2
  2. package/dist/identity/abilities.d.ts +3 -3
  3. package/dist/identity/abilities.d.ts.map +1 -1
  4. package/dist/identity/abilities.js +9 -11
  5. package/dist/identity/abilities.js.map +1 -1
  6. package/dist/identity/contact-key.d.ts +15 -15
  7. package/dist/identity/contact-key.d.ts.map +1 -1
  8. package/dist/identity/contact-key.js +21 -28
  9. package/dist/identity/contact-key.js.map +1 -1
  10. package/dist/identity/root-signer.d.ts +0 -5
  11. package/dist/identity/root-signer.d.ts.map +1 -1
  12. package/dist/identity/root-signer.js +0 -1
  13. package/dist/identity/root-signer.js.map +1 -1
  14. package/dist/inbox/inbox.d.ts +140 -0
  15. package/dist/inbox/inbox.d.ts.map +1 -0
  16. package/dist/inbox/inbox.js +212 -0
  17. package/dist/inbox/inbox.js.map +1 -0
  18. package/dist/inbox/index.d.ts +9 -0
  19. package/dist/inbox/index.d.ts.map +1 -0
  20. package/dist/inbox/index.js +7 -0
  21. package/dist/inbox/index.js.map +1 -0
  22. package/dist/index.d.ts +3 -3
  23. package/dist/index.d.ts.map +1 -1
  24. package/dist/index.js +1 -1
  25. package/dist/index.js.map +1 -1
  26. package/dist/network/mailbox.d.ts +4 -4
  27. package/dist/network/mailbox.d.ts.map +1 -1
  28. package/dist/network/mailbox.js +5 -5
  29. package/dist/network/mailbox.js.map +1 -1
  30. package/dist/node/actions.d.ts.map +1 -1
  31. package/dist/node/actions.js +28 -18
  32. package/dist/node/actions.js.map +1 -1
  33. package/dist/node/api.d.ts +11 -10
  34. package/dist/node/api.d.ts.map +1 -1
  35. package/dist/node/api.js +11 -10
  36. package/dist/node/api.js.map +1 -1
  37. package/dist/node/carrier.d.ts +11 -5
  38. package/dist/node/carrier.d.ts.map +1 -1
  39. package/dist/node/carrier.js +42 -1
  40. package/dist/node/carrier.js.map +1 -1
  41. package/dist/node/copy.d.ts +1 -1
  42. package/dist/node/copy.d.ts.map +1 -1
  43. package/dist/node/copy.js +10 -4
  44. package/dist/node/copy.js.map +1 -1
  45. package/dist/node/host.d.ts +2 -0
  46. package/dist/node/host.d.ts.map +1 -1
  47. package/dist/node/host.js +2 -0
  48. package/dist/node/host.js.map +1 -1
  49. package/dist/node/index.d.ts +1 -1
  50. package/dist/node/index.d.ts.map +1 -1
  51. package/dist/node/node.d.ts.map +1 -1
  52. package/dist/node/node.js +720 -542
  53. package/dist/node/node.js.map +1 -1
  54. package/dist/node/remote.d.ts +6 -5
  55. package/dist/node/remote.d.ts.map +1 -1
  56. package/dist/node/remote.js +140 -195
  57. package/dist/node/remote.js.map +1 -1
  58. package/dist/node/space-runtime.d.ts +2 -1
  59. package/dist/node/space-runtime.d.ts.map +1 -1
  60. package/dist/node/space-runtime.js +71 -84
  61. package/dist/node/space-runtime.js.map +1 -1
  62. package/dist/node/types.d.ts +84 -47
  63. package/dist/node/types.d.ts.map +1 -1
  64. package/dist/node/worker.d.ts +1 -1
  65. package/dist/node/worker.d.ts.map +1 -1
  66. package/dist/node/worker.js +10 -6
  67. package/dist/node/worker.js.map +1 -1
  68. package/dist/react/use-invite-link.d.ts +1 -1
  69. package/dist/react/use-invite-link.d.ts.map +1 -1
  70. package/dist/react/use-invite-link.js +18 -11
  71. package/dist/react/use-invite-link.js.map +1 -1
  72. package/dist/records/loose.d.ts +52 -0
  73. package/dist/records/loose.d.ts.map +1 -0
  74. package/dist/records/loose.js +86 -0
  75. package/dist/records/loose.js.map +1 -0
  76. package/dist/schema/version.d.ts +2 -0
  77. package/dist/schema/version.d.ts.map +1 -1
  78. package/dist/schema/version.js +2 -1
  79. package/dist/schema/version.js.map +1 -1
  80. package/dist/schemas/choosing.d.ts +19 -0
  81. package/dist/schemas/choosing.d.ts.map +1 -0
  82. package/dist/schemas/choosing.js +69 -0
  83. package/dist/schemas/choosing.js.map +1 -0
  84. package/dist/schemas/contacts.d.ts +34 -87
  85. package/dist/schemas/contacts.d.ts.map +1 -1
  86. package/dist/schemas/contacts.js +32 -76
  87. package/dist/schemas/contacts.js.map +1 -1
  88. package/dist/schemas/index.d.ts +2 -2
  89. package/dist/schemas/index.d.ts.map +1 -1
  90. package/dist/schemas/index.js +1 -1
  91. package/dist/schemas/index.js.map +1 -1
  92. package/dist/schemas/library/annotations.d.ts +17 -285
  93. package/dist/schemas/library/annotations.d.ts.map +1 -1
  94. package/dist/schemas/library/annotations.js +9 -65
  95. package/dist/schemas/library/annotations.js.map +1 -1
  96. package/dist/schemas/library/community.d.ts +9 -17
  97. package/dist/schemas/library/community.d.ts.map +1 -1
  98. package/dist/schemas/library/community.js +5 -5
  99. package/dist/schemas/library/community.js.map +1 -1
  100. package/dist/schemas/library/life.d.ts +3 -3
  101. package/dist/schemas/library/life.d.ts.map +1 -1
  102. package/dist/schemas/library/life.js +2 -2
  103. package/dist/schemas/library/life.js.map +1 -1
  104. package/dist/schemas/library/media.d.ts +148 -541
  105. package/dist/schemas/library/media.d.ts.map +1 -1
  106. package/dist/schemas/library/media.js +28 -64
  107. package/dist/schemas/library/media.js.map +1 -1
  108. package/dist/schemas/library/money.d.ts +8 -8
  109. package/dist/schemas/library/money.d.ts.map +1 -1
  110. package/dist/schemas/library/money.js +4 -4
  111. package/dist/schemas/library/money.js.map +1 -1
  112. package/dist/schemas/library/planning.d.ts +23 -87
  113. package/dist/schemas/library/planning.d.ts.map +1 -1
  114. package/dist/schemas/library/planning.js +10 -26
  115. package/dist/schemas/library/planning.js.map +1 -1
  116. package/dist/schemas/library/publishing.d.ts +14 -14
  117. package/dist/schemas/library/publishing.d.ts.map +1 -1
  118. package/dist/schemas/library/publishing.js +7 -7
  119. package/dist/schemas/library/publishing.js.map +1 -1
  120. package/dist/schemas/library/social.d.ts +2 -2
  121. package/dist/schemas/library/social.d.ts.map +1 -1
  122. package/dist/schemas/library/social.js +1 -1
  123. package/dist/schemas/library/social.js.map +1 -1
  124. package/dist/schemas/standard.d.ts +1 -1
  125. package/dist/schemas/standard.d.ts.map +1 -1
  126. package/dist/schemas/standard.js +3 -3
  127. package/dist/schemas/standard.js.map +1 -1
  128. package/dist/session/auth.d.ts +20 -0
  129. package/dist/session/auth.d.ts.map +1 -1
  130. package/dist/session/auth.js +81 -64
  131. package/dist/session/auth.js.map +1 -1
  132. package/dist/session/connect.d.ts +50 -8
  133. package/dist/session/connect.d.ts.map +1 -1
  134. package/dist/session/connect.js +91 -27
  135. package/dist/session/connect.js.map +1 -1
  136. package/dist/session/connection.d.ts +39 -6
  137. package/dist/session/connection.d.ts.map +1 -1
  138. package/dist/session/connection.js +107 -38
  139. package/dist/session/connection.js.map +1 -1
  140. package/dist/session/hosting.d.ts +15 -0
  141. package/dist/session/hosting.d.ts.map +1 -1
  142. package/dist/session/hosting.js +55 -4
  143. package/dist/session/hosting.js.map +1 -1
  144. package/dist/session/index.d.ts +5 -5
  145. package/dist/session/index.d.ts.map +1 -1
  146. package/dist/session/index.js +2 -2
  147. package/dist/session/index.js.map +1 -1
  148. package/dist/space/account-registry.d.ts +36 -4
  149. package/dist/space/account-registry.d.ts.map +1 -1
  150. package/dist/space/account-registry.js +30 -3
  151. package/dist/space/account-registry.js.map +1 -1
  152. package/dist/space/invitation.d.ts +61 -0
  153. package/dist/space/invitation.d.ts.map +1 -0
  154. package/dist/space/invitation.js +84 -0
  155. package/dist/space/invitation.js.map +1 -0
  156. package/dist/space/invite-link.d.ts +64 -0
  157. package/dist/space/invite-link.d.ts.map +1 -0
  158. package/dist/space/invite-link.js +212 -0
  159. package/dist/space/invite-link.js.map +1 -0
  160. package/dist/space/roles.d.ts +59 -140
  161. package/dist/space/roles.d.ts.map +1 -1
  162. package/dist/space/roles.js +328 -427
  163. package/dist/space/roles.js.map +1 -1
  164. package/dist/space/space-manager.d.ts +21 -6
  165. package/dist/space/space-manager.d.ts.map +1 -1
  166. package/dist/space/space-manager.js +40 -23
  167. package/dist/space/space-manager.js.map +1 -1
  168. package/dist/types.d.ts +2 -0
  169. package/dist/types.d.ts.map +1 -1
  170. package/dist/types.js.map +1 -1
  171. package/docs/README.md +2 -2
  172. package/docs/actions.md +40 -40
  173. package/docs/agents.md +2 -2
  174. package/docs/automations.md +2 -2
  175. package/docs/blueprints-and-guides.md +61 -1
  176. package/docs/bots.md +1 -1
  177. package/docs/building-an-app.md +2 -2
  178. package/docs/contacts.md +48 -69
  179. package/docs/inbox.md +145 -0
  180. package/docs/node.md +135 -76
  181. package/docs/query-format.md +1 -1
  182. package/docs/sign-in.md +16 -9
  183. package/docs/spaces.md +33 -5
  184. package/docs/standard-library.md +111 -86
  185. package/docs/storage.md +1 -1
  186. package/package.json +5 -5
  187. package/dist/doors/doors.d.ts +0 -140
  188. package/dist/doors/doors.d.ts.map +0 -1
  189. package/dist/doors/doors.js +0 -226
  190. package/dist/doors/doors.js.map +0 -1
  191. package/dist/doors/index.d.ts +0 -9
  192. package/dist/doors/index.d.ts.map +0 -1
  193. package/dist/doors/index.js +0 -7
  194. package/dist/doors/index.js.map +0 -1
  195. package/docs/doors.md +0 -151
@@ -0,0 +1,84 @@
1
+ import { checkLoose, decodeLoose, encodeLoose, signLoose } from '../records/loose.js';
2
+ import { ACCESS_COMMAND, READ_COMMAND } from '../identity/abilities.js';
3
+ import { noteCovers, parseDelegation } from '../identity/ucan.js';
4
+ import { base64UrlDecode, base64UrlEncode } from '../utils/encoding.js';
5
+ import { isRecord } from '../utils/guards.js';
6
+ import { INVITE_COLLECTION } from './roles.js';
7
+ /** The collection an invitation is a loose version in */
8
+ export const INVITATION_COLLECTION = 'sys.invitation';
9
+ /** Signs an invitation, and writes it with its secret, if any, as an invite string */
10
+ export async function encodeInvitation(signer, body, provider, secret) {
11
+ const version = await signLoose(signer, INVITATION_COLLECTION, body, provider);
12
+ return writeInvitation(version, secret);
13
+ }
14
+ /** An invitation already signed, with a secret beside it */
15
+ export function writeInvitation(version, secret) {
16
+ return secret ? `${encodeLoose(version)}.${base64UrlEncode(secret)}` : encodeLoose(version);
17
+ }
18
+ /**
19
+ * Reads an invite string, checking only that it is an invitation with a space
20
+ * in it; whether it is signed as it says is {@link checkInvitation}'s question.
21
+ * @throws When it isn't one
22
+ */
23
+ export function readInvitation(text) {
24
+ const [encoded = '', secret, ...rest] = text.trim().split('.');
25
+ const version = decodeLoose(encoded);
26
+ if (rest.length > 0 ||
27
+ !isRecord(version) ||
28
+ version.collection !== INVITATION_COLLECTION ||
29
+ !isRecord(version.body) ||
30
+ !isRecord(version.body.space) ||
31
+ typeof version.body.space.id !== 'string' ||
32
+ typeof version.body.space.name !== 'string' ||
33
+ (secret !== undefined && !/^[A-Za-z0-9_-]{43}$/.test(secret)))
34
+ throw new Error('That invite could not be read — it may be truncated or from another app.');
35
+ // eslint-disable-next-line @typescript-eslint/consistent-type-assertions -- its space is checked above; checkInvitation checks the signature and the rest
36
+ const signed = version;
37
+ return secret !== undefined ? { version: signed, secret } : { version: signed };
38
+ }
39
+ /** Whether a value is 32 bytes, base64url: what a space key is carried as */
40
+ function isSpaceKey(value) {
41
+ if (typeof value !== 'string' || !/^[A-Za-z0-9_-]{43}$/.test(value))
42
+ return false;
43
+ return base64UrlDecode(value).length === 32;
44
+ }
45
+ /** The account an invitation says it is from, unchecked: its note's issuer, or its author */
46
+ export function invitedByOf(version) {
47
+ return parseDelegation(version.proof)?.payload.iss ?? version.author;
48
+ }
49
+ /**
50
+ * Why an invitation is not one its account signed, or null when it is: a
51
+ * loose version in `sys.invitation`, its body well formed, and its note one
52
+ * that lets the key act in that space: to change who may do what there when
53
+ * it opens a role (it names one, or a `secret` comes with it), to read there
54
+ * when it only shares it.
55
+ */
56
+ export async function checkInvitation(version, provider, secret) {
57
+ const checked = await checkLoose(version, INVITATION_COLLECTION, provider);
58
+ if (!checked)
59
+ return 'it is not signed by the account it names';
60
+ const body = checked.version.body;
61
+ if (!isRecord(body) || !isRecord(body.space) || typeof body.space.id !== 'string')
62
+ return 'it names no space';
63
+ for (const member of Object.keys(body))
64
+ if (!['space', 'key', 'role', 'relays', 'nodes'].includes(member))
65
+ return `it has a ${member} it shouldn't`;
66
+ if (body.key !== undefined && !isSpaceKey(body.key))
67
+ return 'its key is not a space key';
68
+ if (body.role !== undefined && (typeof body.role !== 'string' || body.role.length > 64))
69
+ return 'its role is not a role name';
70
+ for (const list of [body.relays, body.nodes])
71
+ if (list !== undefined && (!Array.isArray(list) || list.some((item) => typeof item !== 'string')))
72
+ return 'its relays and nodes are lists of addresses';
73
+ if (checked.note) {
74
+ const space = body.space.id;
75
+ // A secret beside it opens a role whatever the body says: the signer can't leave `role` out to need less.
76
+ const required = body.role !== undefined || secret !== undefined
77
+ ? { space, cmd: ACCESS_COMMAND, args: { collection: INVITE_COLLECTION, space } }
78
+ : { space, cmd: READ_COMMAND, args: { space } };
79
+ if (!noteCovers(checked.note, required))
80
+ return "its key's note doesn't let it invite to that space";
81
+ }
82
+ return null;
83
+ }
84
+ //# sourceMappingURL=invitation.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"invitation.js","sourceRoot":"","sources":["../../src/space/invitation.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,64 @@
1
+ import type { Version } from '../types.js';
2
+ /** At most this many places in a link, and asked of one */
3
+ export declare const MAX_LINK_PLACES = 2;
4
+ /** A short link, read */
5
+ export interface InviteLink {
6
+ readonly secret: Uint8Array;
7
+ readonly pin: Uint8Array;
8
+ /** Mailbox URLs the link names, at most two, each passing `checkRelays` */
9
+ readonly places: ReadonlyArray<string>;
10
+ }
11
+ /** What is derived from a link's secret and pin */
12
+ export interface InviteLinkKeys {
13
+ /** The 32-byte invite secret of spec 03 §7.1 */
14
+ readonly inviteSecret: Uint8Array;
15
+ readonly sealKey: CryptoKey;
16
+ readonly topic: string;
17
+ }
18
+ /** What a sealed invite holds: the signed invitation (spec 03 §7.4), whose secret the link gives */
19
+ export interface SealedInvite {
20
+ readonly invite: Version;
21
+ /** When the inviter stops serving it, ms; nothing a peer enforces */
22
+ readonly until?: number;
23
+ }
24
+ /** At most this many always-on nodes in an invite */
25
+ export declare const MAX_INVITE_NODES = 8;
26
+ /**
27
+ * An invite's nodes as a joiner may dial them, or null when the list is not
28
+ * one: at most eight node URLs (spec 04 §5.2), each pinned by a DID, so a
29
+ * socket to one is refused unless it is the node the inviter named.
30
+ */
31
+ export declare function checkInviteNodes(nodes: unknown): ReadonlyArray<string> | null;
32
+ /** The mailbox of the node at a `/peer` address: its relay, on the same address */
33
+ export declare function relayOfNode(node: string): string;
34
+ /** Whether a string, bare, is a short link rather than a long invite */
35
+ export declare function isShortInvite(value: string): boolean;
36
+ /** Writes a short link's text: what goes after `#invite=` */
37
+ export declare function encodeInviteLink(link: InviteLink): string;
38
+ /** Reads a short link's text; places that are no usable mailbox are left out */
39
+ export declare function parseInviteLink(value: string): InviteLink;
40
+ /** The mailbox topic of a pin */
41
+ export declare function linkTopic(pin: Uint8Array): Promise<string>;
42
+ /** The first 16 bytes of a blob's hash, the one a relay files it under */
43
+ export declare function pinOf(blob: string): Promise<Uint8Array>;
44
+ /** The invite secret, seal key and topic a link's secret and pin give */
45
+ export declare function inviteLinkKeys(secret: Uint8Array, pin: Uint8Array): Promise<InviteLinkKeys>;
46
+ /** A fresh link secret */
47
+ export declare function generateLinkSecret(): Uint8Array;
48
+ /** The invite secret a link's secret stands for, which the invite record is opened with */
49
+ export declare function linkInviteSecret(secret: Uint8Array): Promise<Uint8Array>;
50
+ /**
51
+ * Seals an invite under a link's secret: `nonce(12) ‖ AES-256-GCM(deflate(JSON))`,
52
+ * base64url. Returns the blob and the pin a link names it by.
53
+ */
54
+ export declare function sealInvite(secret: Uint8Array, sealed: SealedInvite): Promise<{
55
+ readonly blob: string;
56
+ readonly pin: Uint8Array;
57
+ }>;
58
+ /**
59
+ * Opens a blob a link names, or null when it is not that link's: its hash
60
+ * doesn't start with the pin, or it doesn't open. The pin is checked first,
61
+ * so a stranger's blob is never decrypted, let alone inflated.
62
+ */
63
+ export declare function openInvite(link: InviteLink, blob: string): Promise<SealedInvite | null>;
64
+ //# sourceMappingURL=invite-link.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"invite-link.d.ts","sourceRoot":"","sources":["../../src/space/invite-link.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAM3C,2DAA2D;AAC3D,eAAO,MAAM,eAAe,IAAI,CAAC;AASjC,yBAAyB;AACzB,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;IACzB,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CACxC;AAED,mDAAmD;AACnD,MAAM,WAAW,cAAc;IAC7B,gDAAgD;IAChD,QAAQ,CAAC,YAAY,EAAE,UAAU,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,oGAAoG;AACpG,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,qEAAqE;IACrE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qDAAqD;AACrD,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAElC;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,GAAG,IAAI,CAQ7E;AAED,mFAAmF;AACnF,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMhD;AAED,wEAAwE;AACxE,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEpD;AA8BD,6DAA6D;AAC7D,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAMzD;AAED,gFAAgF;AAChF,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAezD;AAED,iCAAiC;AACjC,wBAAsB,SAAS,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAEhE;AAED,0EAA0E;AAC1E,wBAAsB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAE7D;AAED,yEAAyE;AACzE,wBAAsB,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,cAAc,CAAC,CAMjG;AAOD,0BAA0B;AAC1B,wBAAgB,kBAAkB,IAAI,UAAU,CAE/C;AAED,2FAA2F;AAC3F,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAExE;AA8BD;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAA;CAAE,CAAC,CAY9D;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CA0B7F"}
@@ -0,0 +1,212 @@
1
+ /**
2
+ * Short invite links (spec 03 §7.7): a link carries a secret and the hash
3
+ * of one sealed invite, and names the mailboxes it is kept in. Everything
4
+ * the long invite carried sits in that sealed invite instead, so the link
5
+ * stays short however large the space's constitution is.
6
+ *
7
+ * code = base64url(S ‖ pin) — 43 characters
8
+ * link = code [ "@" place [ "," place ] ]
9
+ * pin = SHA-256(UTF-8(blob))[0..16) — the blob, exactly as kept
10
+ * topic = base64url(SHA-256("minca/invite-topic/v1|" + base64url(pin)))
11
+ *
12
+ * The pin is what makes a link fixed: whoever holds `S` can seal other
13
+ * blobs, but only the inviter's hashes to the pin, so only it is taken.
14
+ */
15
+ import { base64UrlDecode, base64UrlEncode, utf8Decode, utf8Encode } from '../utils/encoding.js';
16
+ import { bufferSource, isRecord } from '../utils/guards.js';
17
+ import { sha256 } from '../utils/hash.js';
18
+ import { expandSecret } from './space-access.js';
19
+ import { checkRelays } from './roles.js';
20
+ import { nodeAddress } from '../network/ws-transport.js';
21
+ /** The secret's length: 128 bits, out of reach of offline guessing */
22
+ const LINK_SECRET_BYTES = 16;
23
+ /** The pin's length: a second blob with the same pin is a 128-bit second preimage */
24
+ const LINK_PIN_BYTES = 16;
25
+ /** At most this many places in a link, and asked of one */
26
+ export const MAX_LINK_PLACES = 2;
27
+ /** A sealed invite opens to at most this much */
28
+ const MAX_SEALED_INVITE_BYTES = 64 * 1024;
29
+ /** A mailbox blob's limit (spec 07 §5): a sealed invite must fit it */
30
+ const MAX_SEALED_BLOB_CHARS = 12_000;
31
+ const CODE = /^[A-Za-z0-9_-]{43}$/;
32
+ const LOOPBACK = new Set(['localhost', '127.0.0.1', '[::1]']);
33
+ /** At most this many always-on nodes in an invite */
34
+ export const MAX_INVITE_NODES = 8;
35
+ /**
36
+ * An invite's nodes as a joiner may dial them, or null when the list is not
37
+ * one: at most eight node URLs (spec 04 §5.2), each pinned by a DID, so a
38
+ * socket to one is refused unless it is the node the inviter named.
39
+ */
40
+ export function checkInviteNodes(nodes) {
41
+ if (!Array.isArray(nodes) || nodes.length > MAX_INVITE_NODES)
42
+ return null;
43
+ for (const node of nodes) {
44
+ if (typeof node !== 'string' || node.length > 512)
45
+ return null;
46
+ const address = nodeAddress(node);
47
+ if (typeof address === 'string' || address.pin === null)
48
+ return null;
49
+ }
50
+ return nodes.length === new Set(nodes).size ? nodes : null;
51
+ }
52
+ /** The mailbox of the node at a `/peer` address: its relay, on the same address */
53
+ export function relayOfNode(node) {
54
+ const url = new URL(node);
55
+ url.hash = '';
56
+ url.search = '';
57
+ url.pathname = '/';
58
+ return url.href;
59
+ }
60
+ /** Whether a string, bare, is a short link rather than a long invite */
61
+ export function isShortInvite(value) {
62
+ return CODE.test(value.trim().split('@')[0] ?? '');
63
+ }
64
+ /** A place as a link writes it: no scheme for wss://, nor for ws:// on this machine */
65
+ function writePlace(url) {
66
+ const parsed = new URL(url);
67
+ const bare = `${parsed.host}${parsed.pathname === '/' ? '' : parsed.pathname}${parsed.search}`;
68
+ const plain = parsed.protocol === 'wss:' ? !LOOPBACK.has(parsed.hostname) : LOOPBACK.has(parsed.hostname);
69
+ return (plain ? bare : url).replace(/[%@,#&\s]/g, (c) => `%${c.charCodeAt(0).toString(16).toUpperCase().padStart(2, '0')}`);
70
+ }
71
+ /** A place as a link wrote it, or null for one that is no usable mailbox */
72
+ function readPlace(written) {
73
+ let text;
74
+ try {
75
+ text = decodeURIComponent(written);
76
+ }
77
+ catch {
78
+ return null;
79
+ }
80
+ if (!text)
81
+ return null;
82
+ let url = text;
83
+ if (!text.includes('://')) {
84
+ const host = text.split('/')[0].replace(/:\d+$/, '');
85
+ url = `${LOOPBACK.has(host) ? 'ws' : 'wss'}://${text}`;
86
+ }
87
+ return checkRelays([url]) === null ? url : null;
88
+ }
89
+ /** Writes a short link's text: what goes after `#invite=` */
90
+ export function encodeInviteLink(link) {
91
+ if (link.secret.length !== LINK_SECRET_BYTES || link.pin.length !== LINK_PIN_BYTES)
92
+ throw new Error('A short invite is a 16-byte secret and a 16-byte pin');
93
+ const code = base64UrlEncode(new Uint8Array([...link.secret, ...link.pin]));
94
+ const places = link.places.slice(0, MAX_LINK_PLACES).map(writePlace);
95
+ return places.length ? `${code}@${places.join(',')}` : code;
96
+ }
97
+ /** Reads a short link's text; places that are no usable mailbox are left out */
98
+ export function parseInviteLink(value) {
99
+ const [code = '', written = ''] = value.trim().split('@', 2);
100
+ if (!CODE.test(code))
101
+ throw new Error('That invite could not be read — it may be truncated or from another app.');
102
+ const bytes = base64UrlDecode(code);
103
+ const places = written
104
+ .split(',')
105
+ .slice(0, MAX_LINK_PLACES)
106
+ .map(readPlace)
107
+ .filter((url) => url !== null);
108
+ return {
109
+ secret: bytes.slice(0, LINK_SECRET_BYTES),
110
+ pin: bytes.slice(LINK_SECRET_BYTES),
111
+ places: [...new Set(places)],
112
+ };
113
+ }
114
+ /** The mailbox topic of a pin */
115
+ export async function linkTopic(pin) {
116
+ return base64UrlEncode(await sha256(utf8Encode(`minca/invite-topic/v1|${base64UrlEncode(pin)}`)));
117
+ }
118
+ /** The first 16 bytes of a blob's hash, the one a relay files it under */
119
+ export async function pinOf(blob) {
120
+ return (await sha256(utf8Encode(blob))).slice(0, LINK_PIN_BYTES);
121
+ }
122
+ /** The invite secret, seal key and topic a link's secret and pin give */
123
+ export async function inviteLinkKeys(secret, pin) {
124
+ return {
125
+ inviteSecret: await linkInviteSecret(secret),
126
+ sealKey: await sealKeyOf(secret),
127
+ topic: await linkTopic(pin),
128
+ };
129
+ }
130
+ async function sealKeyOf(secret) {
131
+ const raw = await expandSecret(secret, 'minca/invite-link/v1|seal');
132
+ return globalThis.crypto.subtle.importKey('raw', raw, 'AES-GCM', false, ['encrypt', 'decrypt']);
133
+ }
134
+ /** A fresh link secret */
135
+ export function generateLinkSecret() {
136
+ return globalThis.crypto.getRandomValues(new Uint8Array(LINK_SECRET_BYTES));
137
+ }
138
+ /** The invite secret a link's secret stands for, which the invite record is opened with */
139
+ export function linkInviteSecret(secret) {
140
+ return expandSecret(secret, 'minca/invite-link/v1|secret');
141
+ }
142
+ async function pipe(bytes, stream, limit) {
143
+ const reader = new Blob([bufferSource(bytes)]).stream().pipeThrough(stream).getReader();
144
+ const chunks = [];
145
+ let size = 0;
146
+ for (;;) {
147
+ const { done, value } = await reader.read();
148
+ if (done)
149
+ break;
150
+ size += value.length;
151
+ // Stop as soon as it is too large: a small blob can inflate to a great deal.
152
+ if (size > limit) {
153
+ await reader.cancel();
154
+ throw new Error('That invite opens to more than an invite can be');
155
+ }
156
+ chunks.push(value);
157
+ }
158
+ const out = new Uint8Array(size);
159
+ let at = 0;
160
+ for (const chunk of chunks) {
161
+ out.set(chunk, at);
162
+ at += chunk.length;
163
+ }
164
+ return out;
165
+ }
166
+ /**
167
+ * Seals an invite under a link's secret: `nonce(12) ‖ AES-256-GCM(deflate(JSON))`,
168
+ * base64url. Returns the blob and the pin a link names it by.
169
+ */
170
+ export async function sealInvite(secret, sealed) {
171
+ const json = utf8Encode(JSON.stringify({ v: 2, ...sealed }));
172
+ if (json.length > MAX_SEALED_INVITE_BYTES)
173
+ throw new Error('That invite is too large for a short link');
174
+ const plain = await pipe(json, new CompressionStream('deflate'), MAX_SEALED_INVITE_BYTES);
175
+ const nonce = globalThis.crypto.getRandomValues(new Uint8Array(12));
176
+ const key = await sealKeyOf(secret);
177
+ const cipher = new Uint8Array(await globalThis.crypto.subtle.encrypt({ name: 'AES-GCM', iv: nonce }, key, bufferSource(plain)));
178
+ const blob = base64UrlEncode(new Uint8Array([...nonce, ...cipher]));
179
+ if (blob.length > MAX_SEALED_BLOB_CHARS)
180
+ throw new Error('That invite is too large for a short link');
181
+ return { blob, pin: await pinOf(blob) };
182
+ }
183
+ /**
184
+ * Opens a blob a link names, or null when it is not that link's: its hash
185
+ * doesn't start with the pin, or it doesn't open. The pin is checked first,
186
+ * so a stranger's blob is never decrypted, let alone inflated.
187
+ */
188
+ export async function openInvite(link, blob) {
189
+ if (blob.length > MAX_SEALED_BLOB_CHARS || !/^[A-Za-z0-9_-]+$/.test(blob))
190
+ return null;
191
+ const pin = await pinOf(blob);
192
+ if (!pin.every((byte, i) => byte === link.pin[i]))
193
+ return null;
194
+ const bytes = base64UrlDecode(blob);
195
+ if (bytes.length < 12 + 16)
196
+ return null;
197
+ const sealKey = await sealKeyOf(link.secret);
198
+ let json;
199
+ try {
200
+ const plain = new Uint8Array(await globalThis.crypto.subtle.decrypt({ name: 'AES-GCM', iv: bufferSource(bytes.slice(0, 12)) }, sealKey, bufferSource(bytes.slice(12))));
201
+ json = JSON.parse(utf8Decode(await pipe(plain, new DecompressionStream('deflate'), MAX_SEALED_INVITE_BYTES)));
202
+ }
203
+ catch {
204
+ return null;
205
+ }
206
+ if (!isRecord(json) || json.v !== 2 || !isRecord(json.invite))
207
+ return null;
208
+ const until = typeof json.until === 'number' && Number.isFinite(json.until) ? json.until : undefined;
209
+ // eslint-disable-next-line @typescript-eslint/consistent-type-assertions -- an object; whoever joins with it reads it as an invitation and checks its signature
210
+ return { invite: json.invite, ...(until !== undefined ? { until } : {}) };
211
+ }
212
+ //# sourceMappingURL=invite-link.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"invite-link.js","sourceRoot":"","sources":["../../src/space/invite-link.ts"],"names":[],"mappings":"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"}