@minca/core 0.1.14 → 0.1.16

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 (528) hide show
  1. package/README.md +4 -4
  2. package/dist/elements/auth-styles.d.ts +1 -1
  3. package/dist/elements/auth-styles.d.ts.map +1 -1
  4. package/dist/elements/auth-styles.js +21 -4
  5. package/dist/elements/auth-styles.js.map +1 -1
  6. package/dist/elements/minca-auth.d.ts.map +1 -1
  7. package/dist/elements/minca-auth.js +151 -57
  8. package/dist/elements/minca-auth.js.map +1 -1
  9. package/dist/files/space-files.d.ts +15 -3
  10. package/dist/files/space-files.d.ts.map +1 -1
  11. package/dist/files/space-files.js +225 -37
  12. package/dist/files/space-files.js.map +1 -1
  13. package/dist/identity/abilities.d.ts +2 -0
  14. package/dist/identity/abilities.d.ts.map +1 -1
  15. package/dist/identity/abilities.js +2 -0
  16. package/dist/identity/abilities.js.map +1 -1
  17. package/dist/identity/account-vault.d.ts +15 -71
  18. package/dist/identity/account-vault.d.ts.map +1 -1
  19. package/dist/identity/account-vault.js +45 -104
  20. package/dist/identity/account-vault.js.map +1 -1
  21. package/dist/identity/channel.d.ts +3 -9
  22. package/dist/identity/channel.d.ts.map +1 -1
  23. package/dist/identity/channel.js +42 -42
  24. package/dist/identity/channel.js.map +1 -1
  25. package/dist/identity/contact-key.d.ts +14 -29
  26. package/dist/identity/contact-key.d.ts.map +1 -1
  27. package/dist/identity/contact-key.js +31 -51
  28. package/dist/identity/contact-key.js.map +1 -1
  29. package/dist/identity/crypto-p256.d.ts.map +1 -1
  30. package/dist/identity/crypto-p256.js +39 -53
  31. package/dist/identity/crypto-p256.js.map +1 -1
  32. package/dist/identity/hpke.d.ts.map +1 -1
  33. package/dist/identity/hpke.js +19 -19
  34. package/dist/identity/hpke.js.map +1 -1
  35. package/dist/identity/identity-manager.d.ts.map +1 -1
  36. package/dist/identity/identity-manager.js +1 -2
  37. package/dist/identity/identity-manager.js.map +1 -1
  38. package/dist/identity/policy.d.ts.map +1 -1
  39. package/dist/identity/policy.js +35 -61
  40. package/dist/identity/policy.js.map +1 -1
  41. package/dist/identity/recovery-code.d.ts +2 -8
  42. package/dist/identity/recovery-code.d.ts.map +1 -1
  43. package/dist/identity/recovery-code.js +4 -11
  44. package/dist/identity/recovery-code.js.map +1 -1
  45. package/dist/identity/root-signer.d.ts +1 -6
  46. package/dist/identity/root-signer.d.ts.map +1 -1
  47. package/dist/identity/root-signer.js +12 -15
  48. package/dist/identity/root-signer.js.map +1 -1
  49. package/dist/identity/ucan.d.ts.map +1 -1
  50. package/dist/identity/ucan.js +48 -39
  51. package/dist/identity/ucan.js.map +1 -1
  52. package/dist/identity/webauthn.d.ts +6 -11
  53. package/dist/identity/webauthn.d.ts.map +1 -1
  54. package/dist/identity/webauthn.js +18 -30
  55. package/dist/identity/webauthn.js.map +1 -1
  56. package/dist/inbox/inbox.d.ts.map +1 -1
  57. package/dist/inbox/inbox.js +40 -30
  58. package/dist/inbox/inbox.js.map +1 -1
  59. package/dist/inbox/index.d.ts +2 -0
  60. package/dist/inbox/index.d.ts.map +1 -1
  61. package/dist/inbox/index.js +1 -0
  62. package/dist/inbox/index.js.map +1 -1
  63. package/dist/inbox/names.d.ts +54 -0
  64. package/dist/inbox/names.d.ts.map +1 -0
  65. package/dist/inbox/names.js +299 -0
  66. package/dist/inbox/names.js.map +1 -0
  67. package/dist/index.d.ts +3 -6
  68. package/dist/index.d.ts.map +1 -1
  69. package/dist/index.js +9 -12
  70. package/dist/index.js.map +1 -1
  71. package/dist/network/mesh.d.ts +7 -20
  72. package/dist/network/mesh.d.ts.map +1 -1
  73. package/dist/network/mesh.js +267 -245
  74. package/dist/network/mesh.js.map +1 -1
  75. package/dist/network/relay-link.d.ts +31 -0
  76. package/dist/network/relay-link.d.ts.map +1 -0
  77. package/dist/network/relay-link.js +62 -0
  78. package/dist/network/relay-link.js.map +1 -0
  79. package/dist/network/relay-minca.d.ts +12 -1
  80. package/dist/network/relay-minca.d.ts.map +1 -1
  81. package/dist/network/relay-minca.js +25 -55
  82. package/dist/network/relay-minca.js.map +1 -1
  83. package/dist/network/relay-nostr.d.ts +14 -3
  84. package/dist/network/relay-nostr.d.ts.map +1 -1
  85. package/dist/network/relay-nostr.js +34 -72
  86. package/dist/network/relay-nostr.js.map +1 -1
  87. package/dist/network/relay-socket.d.ts +1 -1
  88. package/dist/network/relay-socket.d.ts.map +1 -1
  89. package/dist/network/relay-socket.js +3 -1
  90. package/dist/network/relay-socket.js.map +1 -1
  91. package/dist/network/relays.d.ts +26 -17
  92. package/dist/network/relays.d.ts.map +1 -1
  93. package/dist/network/relays.js +21 -28
  94. package/dist/network/relays.js.map +1 -1
  95. package/dist/network/rendezvous.d.ts +1 -1
  96. package/dist/network/rendezvous.d.ts.map +1 -1
  97. package/dist/network/rendezvous.js +2 -2
  98. package/dist/network/rendezvous.js.map +1 -1
  99. package/dist/node/actions.d.ts.map +1 -1
  100. package/dist/node/actions.js +56 -39
  101. package/dist/node/actions.js.map +1 -1
  102. package/dist/node/api.d.ts +6 -0
  103. package/dist/node/api.d.ts.map +1 -1
  104. package/dist/node/api.js +6 -0
  105. package/dist/node/api.js.map +1 -1
  106. package/dist/node/carrier.d.ts +5 -0
  107. package/dist/node/carrier.d.ts.map +1 -1
  108. package/dist/node/carrier.js +94 -73
  109. package/dist/node/carrier.js.map +1 -1
  110. package/dist/node/copy.d.ts +8 -7
  111. package/dist/node/copy.d.ts.map +1 -1
  112. package/dist/node/copy.js +54 -56
  113. package/dist/node/copy.js.map +1 -1
  114. package/dist/node/host.d.ts +39 -65
  115. package/dist/node/host.d.ts.map +1 -1
  116. package/dist/node/host.js +362 -379
  117. package/dist/node/host.js.map +1 -1
  118. package/dist/node/index.d.ts +2 -2
  119. package/dist/node/index.d.ts.map +1 -1
  120. package/dist/node/index.js +1 -1
  121. package/dist/node/index.js.map +1 -1
  122. package/dist/node/node-carriers.d.ts +35 -0
  123. package/dist/node/node-carriers.d.ts.map +1 -0
  124. package/dist/node/node-carriers.js +562 -0
  125. package/dist/node/node-carriers.js.map +1 -0
  126. package/dist/node/node-contacts.d.ts +11 -0
  127. package/dist/node/node-contacts.d.ts.map +1 -0
  128. package/dist/node/node-contacts.js +808 -0
  129. package/dist/node/node-contacts.js.map +1 -0
  130. package/dist/node/node-context.d.ts +76 -0
  131. package/dist/node/node-context.d.ts.map +1 -0
  132. package/dist/node/node-context.js +54 -0
  133. package/dist/node/node-context.js.map +1 -0
  134. package/dist/node/node-hosting.d.ts +20 -0
  135. package/dist/node/node-hosting.d.ts.map +1 -0
  136. package/dist/node/node-hosting.js +449 -0
  137. package/dist/node/node-hosting.js.map +1 -0
  138. package/dist/node/node-records.d.ts +18 -0
  139. package/dist/node/node-records.d.ts.map +1 -0
  140. package/dist/node/node-records.js +262 -0
  141. package/dist/node/node-records.js.map +1 -0
  142. package/dist/node/node.d.ts.map +1 -1
  143. package/dist/node/node.js +197 -1989
  144. package/dist/node/node.js.map +1 -1
  145. package/dist/node/remote.d.ts +5 -6
  146. package/dist/node/remote.d.ts.map +1 -1
  147. package/dist/node/remote.js +272 -260
  148. package/dist/node/remote.js.map +1 -1
  149. package/dist/node/space-catalog.d.ts +40 -0
  150. package/dist/node/space-catalog.d.ts.map +1 -0
  151. package/dist/node/space-catalog.js +158 -0
  152. package/dist/node/space-catalog.js.map +1 -0
  153. package/dist/node/space-checks.d.ts +25 -0
  154. package/dist/node/space-checks.d.ts.map +1 -0
  155. package/dist/node/space-checks.js +343 -0
  156. package/dist/node/space-checks.js.map +1 -0
  157. package/dist/node/space-history.d.ts +37 -0
  158. package/dist/node/space-history.d.ts.map +1 -0
  159. package/dist/node/space-history.js +350 -0
  160. package/dist/node/space-history.js.map +1 -0
  161. package/dist/node/space-holding.d.ts +49 -0
  162. package/dist/node/space-holding.d.ts.map +1 -0
  163. package/dist/node/space-holding.js +267 -0
  164. package/dist/node/space-holding.js.map +1 -0
  165. package/dist/node/space-index.d.ts +41 -0
  166. package/dist/node/space-index.d.ts.map +1 -0
  167. package/dist/node/space-index.js +217 -0
  168. package/dist/node/space-index.js.map +1 -0
  169. package/dist/node/space-keys.d.ts +34 -0
  170. package/dist/node/space-keys.d.ts.map +1 -0
  171. package/dist/node/space-keys.js +309 -0
  172. package/dist/node/space-keys.js.map +1 -0
  173. package/dist/node/space-lines.d.ts +33 -0
  174. package/dist/node/space-lines.d.ts.map +1 -0
  175. package/dist/node/space-lines.js +145 -0
  176. package/dist/node/space-lines.js.map +1 -0
  177. package/dist/node/space-membership.d.ts +69 -0
  178. package/dist/node/space-membership.d.ts.map +1 -0
  179. package/dist/node/space-membership.js +242 -0
  180. package/dist/node/space-membership.js.map +1 -0
  181. package/dist/node/space-mirrors.d.ts +43 -0
  182. package/dist/node/space-mirrors.d.ts.map +1 -0
  183. package/dist/node/space-mirrors.js +125 -0
  184. package/dist/node/space-mirrors.js.map +1 -0
  185. package/dist/node/space-peers.d.ts +104 -0
  186. package/dist/node/space-peers.d.ts.map +1 -0
  187. package/dist/node/space-peers.js +595 -0
  188. package/dist/node/space-peers.js.map +1 -0
  189. package/dist/node/space-profiles.d.ts +18 -0
  190. package/dist/node/space-profiles.d.ts.map +1 -0
  191. package/dist/node/space-profiles.js +105 -0
  192. package/dist/node/space-profiles.js.map +1 -0
  193. package/dist/node/space-rules.d.ts +29 -0
  194. package/dist/node/space-rules.d.ts.map +1 -0
  195. package/dist/node/space-rules.js +144 -0
  196. package/dist/node/space-rules.js.map +1 -0
  197. package/dist/node/space-runtime.d.ts +104 -143
  198. package/dist/node/space-runtime.d.ts.map +1 -1
  199. package/dist/node/space-runtime.js +293 -3954
  200. package/dist/node/space-runtime.js.map +1 -1
  201. package/dist/node/space-standing.d.ts +20 -0
  202. package/dist/node/space-standing.d.ts.map +1 -0
  203. package/dist/node/space-standing.js +317 -0
  204. package/dist/node/space-standing.js.map +1 -0
  205. package/dist/node/space-versions.d.ts +104 -0
  206. package/dist/node/space-versions.d.ts.map +1 -0
  207. package/dist/node/space-versions.js +153 -0
  208. package/dist/node/space-versions.js.map +1 -0
  209. package/dist/node/space-warrants.d.ts +25 -0
  210. package/dist/node/space-warrants.d.ts.map +1 -0
  211. package/dist/node/space-warrants.js +214 -0
  212. package/dist/node/space-warrants.js.map +1 -0
  213. package/dist/node/space-writing.d.ts +72 -0
  214. package/dist/node/space-writing.d.ts.map +1 -0
  215. package/dist/node/space-writing.js +440 -0
  216. package/dist/node/space-writing.js.map +1 -0
  217. package/dist/node/stores.d.ts +19 -50
  218. package/dist/node/stores.d.ts.map +1 -1
  219. package/dist/node/stores.js +14 -33
  220. package/dist/node/stores.js.map +1 -1
  221. package/dist/node/types.d.ts +225 -305
  222. package/dist/node/types.d.ts.map +1 -1
  223. package/dist/node/usage.d.ts +2 -24
  224. package/dist/node/usage.d.ts.map +1 -1
  225. package/dist/node/usage.js +118 -102
  226. package/dist/node/usage.js.map +1 -1
  227. package/dist/node/watch-notifications.d.ts.map +1 -1
  228. package/dist/node/watch-notifications.js +32 -29
  229. package/dist/node/watch-notifications.js.map +1 -1
  230. package/dist/node/worker.d.ts +5 -6
  231. package/dist/node/worker.d.ts.map +1 -1
  232. package/dist/node/worker.js +80 -72
  233. package/dist/node/worker.js.map +1 -1
  234. package/dist/node/writer-keys.d.ts +5 -6
  235. package/dist/node/writer-keys.d.ts.map +1 -1
  236. package/dist/node/writer-keys.js +66 -57
  237. package/dist/node/writer-keys.js.map +1 -1
  238. package/dist/node/writers.d.ts +12 -19
  239. package/dist/node/writers.d.ts.map +1 -1
  240. package/dist/node/writers.js +7 -15
  241. package/dist/node/writers.js.map +1 -1
  242. package/dist/privacy/direct.d.ts.map +1 -1
  243. package/dist/privacy/direct.js +31 -27
  244. package/dist/privacy/direct.js.map +1 -1
  245. package/dist/privacy/space-encryption.d.ts.map +1 -1
  246. package/dist/privacy/space-encryption.js +5 -9
  247. package/dist/privacy/space-encryption.js.map +1 -1
  248. package/dist/query/computed.d.ts.map +1 -1
  249. package/dist/query/computed.js +78 -77
  250. package/dist/query/computed.js.map +1 -1
  251. package/dist/query/engine.d.ts +3 -4
  252. package/dist/query/engine.d.ts.map +1 -1
  253. package/dist/query/engine.js +93 -86
  254. package/dist/query/engine.js.map +1 -1
  255. package/dist/query/filter.d.ts +8 -10
  256. package/dist/query/filter.d.ts.map +1 -1
  257. package/dist/query/filter.js +144 -161
  258. package/dist/query/filter.js.map +1 -1
  259. package/dist/records/cel-types.d.ts.map +1 -1
  260. package/dist/records/cel-types.js +13 -27
  261. package/dist/records/cel-types.js.map +1 -1
  262. package/dist/records/cel.d.ts.map +1 -1
  263. package/dist/records/cel.js +177 -242
  264. package/dist/records/cel.js.map +1 -1
  265. package/dist/records/rules.d.ts.map +1 -1
  266. package/dist/records/rules.js +46 -50
  267. package/dist/records/rules.js.map +1 -1
  268. package/dist/records/topics.d.ts.map +1 -1
  269. package/dist/records/topics.js +18 -22
  270. package/dist/records/topics.js.map +1 -1
  271. package/dist/schema/collection-def.d.ts.map +1 -1
  272. package/dist/schema/collection-def.js +16 -5
  273. package/dist/schema/collection-def.js.map +1 -1
  274. package/dist/schemas/automations.d.ts +16 -15
  275. package/dist/schemas/automations.d.ts.map +1 -1
  276. package/dist/schemas/automations.js +203 -165
  277. package/dist/schemas/automations.js.map +1 -1
  278. package/dist/schemas/blueprints.d.ts.map +1 -1
  279. package/dist/schemas/blueprints.js +14 -13
  280. package/dist/schemas/blueprints.js.map +1 -1
  281. package/dist/schemas/connectors.d.ts +12 -0
  282. package/dist/schemas/connectors.d.ts.map +1 -1
  283. package/dist/schemas/connectors.js +16 -11
  284. package/dist/schemas/connectors.js.map +1 -1
  285. package/dist/schemas/contacts.d.ts +57 -0
  286. package/dist/schemas/contacts.d.ts.map +1 -1
  287. package/dist/schemas/contacts.js +32 -0
  288. package/dist/schemas/contacts.js.map +1 -1
  289. package/dist/schemas/cron.d.ts.map +1 -1
  290. package/dist/schemas/cron.js +27 -28
  291. package/dist/schemas/cron.js.map +1 -1
  292. package/dist/schemas/defined.d.ts +6 -0
  293. package/dist/schemas/defined.d.ts.map +1 -0
  294. package/dist/schemas/defined.js +7 -0
  295. package/dist/schemas/defined.js.map +1 -0
  296. package/dist/schemas/fragments.d.ts +22 -2
  297. package/dist/schemas/fragments.d.ts.map +1 -1
  298. package/dist/schemas/fragments.js +20 -12
  299. package/dist/schemas/fragments.js.map +1 -1
  300. package/dist/schemas/guides.d.ts +3 -1
  301. package/dist/schemas/guides.d.ts.map +1 -1
  302. package/dist/schemas/guides.js +13 -12
  303. package/dist/schemas/guides.js.map +1 -1
  304. package/dist/schemas/index.d.ts +2 -2
  305. package/dist/schemas/index.d.ts.map +1 -1
  306. package/dist/schemas/index.js +18 -14
  307. package/dist/schemas/index.js.map +1 -1
  308. package/dist/schemas/library/annotations.d.ts +30 -0
  309. package/dist/schemas/library/annotations.d.ts.map +1 -1
  310. package/dist/schemas/library/annotations.js +1 -0
  311. package/dist/schemas/library/annotations.js.map +1 -1
  312. package/dist/schemas/library/community.d.ts +28 -0
  313. package/dist/schemas/library/community.d.ts.map +1 -1
  314. package/dist/schemas/library/life.d.ts +62 -2
  315. package/dist/schemas/library/life.d.ts.map +1 -1
  316. package/dist/schemas/library/media.d.ts +36 -0
  317. package/dist/schemas/library/media.d.ts.map +1 -1
  318. package/dist/schemas/library/money.d.ts +74 -2
  319. package/dist/schemas/library/money.d.ts.map +1 -1
  320. package/dist/schemas/library/planning.d.ts +56 -0
  321. package/dist/schemas/library/planning.d.ts.map +1 -1
  322. package/dist/schemas/library/publishing.d.ts +80 -4
  323. package/dist/schemas/library/publishing.d.ts.map +1 -1
  324. package/dist/schemas/library/social.d.ts +44 -0
  325. package/dist/schemas/library/social.d.ts.map +1 -1
  326. package/dist/session/account-hint.d.ts.map +1 -1
  327. package/dist/session/account-hint.js +8 -5
  328. package/dist/session/account-hint.js.map +1 -1
  329. package/dist/session/auth.d.ts +36 -2
  330. package/dist/session/auth.d.ts.map +1 -1
  331. package/dist/session/auth.js +95 -2
  332. package/dist/session/auth.js.map +1 -1
  333. package/dist/session/connect.d.ts +1 -0
  334. package/dist/session/connect.d.ts.map +1 -1
  335. package/dist/session/connect.js +3 -1
  336. package/dist/session/connect.js.map +1 -1
  337. package/dist/session/credentials.d.ts +8 -26
  338. package/dist/session/credentials.d.ts.map +1 -1
  339. package/dist/session/credentials.js +14 -32
  340. package/dist/session/credentials.js.map +1 -1
  341. package/dist/session/index.d.ts +1 -0
  342. package/dist/session/index.d.ts.map +1 -1
  343. package/dist/session/index.js +1 -0
  344. package/dist/session/index.js.map +1 -1
  345. package/dist/session/pairing.d.ts.map +1 -1
  346. package/dist/session/pairing.js +92 -88
  347. package/dist/session/pairing.js.map +1 -1
  348. package/dist/session/password-strength.d.ts.map +1 -1
  349. package/dist/session/password-strength.js +37 -37
  350. package/dist/session/password-strength.js.map +1 -1
  351. package/dist/session/places.d.ts.map +1 -1
  352. package/dist/session/places.js +18 -13
  353. package/dist/session/places.js.map +1 -1
  354. package/dist/session/popup.d.ts +13 -0
  355. package/dist/session/popup.d.ts.map +1 -0
  356. package/dist/session/popup.js +23 -0
  357. package/dist/session/popup.js.map +1 -0
  358. package/dist/space/constitution.d.ts.map +1 -1
  359. package/dist/space/constitution.js +22 -29
  360. package/dist/space/constitution.js.map +1 -1
  361. package/dist/space/grants.d.ts.map +1 -1
  362. package/dist/space/grants.js +37 -39
  363. package/dist/space/grants.js.map +1 -1
  364. package/dist/space/invite-link.d.ts.map +1 -1
  365. package/dist/space/invite-link.js +33 -33
  366. package/dist/space/invite-link.js.map +1 -1
  367. package/dist/space/own-automations.d.ts +13 -24
  368. package/dist/space/own-automations.d.ts.map +1 -1
  369. package/dist/space/own-automations.js +47 -37
  370. package/dist/space/own-automations.js.map +1 -1
  371. package/dist/space/roles.d.ts +56 -80
  372. package/dist/space/roles.d.ts.map +1 -1
  373. package/dist/space/roles.js +448 -441
  374. package/dist/space/roles.js.map +1 -1
  375. package/dist/space/space-access.d.ts +3 -4
  376. package/dist/space/space-access.d.ts.map +1 -1
  377. package/dist/space/space-access.js +3 -8
  378. package/dist/space/space-access.js.map +1 -1
  379. package/dist/storage/blob/directory.d.ts.map +1 -1
  380. package/dist/storage/blob/directory.js +39 -32
  381. package/dist/storage/blob/directory.js.map +1 -1
  382. package/dist/storage/blob/s3.d.ts.map +1 -1
  383. package/dist/storage/blob/s3.js +21 -19
  384. package/dist/storage/blob/s3.js.map +1 -1
  385. package/dist/storage/blob-store.d.ts +0 -9
  386. package/dist/storage/blob-store.d.ts.map +1 -1
  387. package/dist/storage/directory-access.d.ts +8 -32
  388. package/dist/storage/directory-access.d.ts.map +1 -1
  389. package/dist/storage/directory-access.js +11 -36
  390. package/dist/storage/directory-access.js.map +1 -1
  391. package/dist/storage/encrypted-adapter.d.ts +12 -32
  392. package/dist/storage/encrypted-adapter.d.ts.map +1 -1
  393. package/dist/storage/encrypted-adapter.js +31 -54
  394. package/dist/storage/encrypted-adapter.js.map +1 -1
  395. package/dist/storage/folder-adapter.d.ts +12 -26
  396. package/dist/storage/folder-adapter.d.ts.map +1 -1
  397. package/dist/storage/folder-adapter.js +37 -54
  398. package/dist/storage/folder-adapter.js.map +1 -1
  399. package/dist/storage/folder-reconcile.d.ts +12 -26
  400. package/dist/storage/folder-reconcile.d.ts.map +1 -1
  401. package/dist/storage/folder-reconcile.js +39 -48
  402. package/dist/storage/folder-reconcile.js.map +1 -1
  403. package/dist/storage/indexeddb-adapter.d.ts +2 -6
  404. package/dist/storage/indexeddb-adapter.d.ts.map +1 -1
  405. package/dist/storage/indexeddb-adapter.js +60 -114
  406. package/dist/storage/indexeddb-adapter.js.map +1 -1
  407. package/dist/storage/mirror.d.ts +0 -29
  408. package/dist/storage/mirror.d.ts.map +1 -1
  409. package/dist/storage/mirror.js +153 -110
  410. package/dist/storage/mirror.js.map +1 -1
  411. package/dist/storage/segment.d.ts.map +1 -1
  412. package/dist/storage/segment.js +3 -7
  413. package/dist/storage/segment.js.map +1 -1
  414. package/dist/storage/storage-provider.d.ts +6 -11
  415. package/dist/storage/storage-provider.d.ts.map +1 -1
  416. package/dist/storage/storage-provider.js +112 -116
  417. package/dist/storage/storage-provider.js.map +1 -1
  418. package/dist/sync/sync-engine.d.ts +10 -44
  419. package/dist/sync/sync-engine.d.ts.map +1 -1
  420. package/dist/sync/sync-engine.js +245 -247
  421. package/dist/sync/sync-engine.js.map +1 -1
  422. package/dist/sync/sync-messages.d.ts +1 -1
  423. package/dist/sync/sync-messages.d.ts.map +1 -1
  424. package/dist/sync/sync-messages.js +1 -1
  425. package/dist/sync/sync-messages.js.map +1 -1
  426. package/dist/utils/guards.d.ts +1 -0
  427. package/dist/utils/guards.d.ts.map +1 -1
  428. package/dist/utils/guards.js +1 -0
  429. package/dist/utils/guards.js.map +1 -1
  430. package/dist/utils/hmac.d.ts +5 -0
  431. package/dist/utils/hmac.d.ts.map +1 -0
  432. package/dist/utils/hmac.js +20 -0
  433. package/dist/utils/hmac.js.map +1 -0
  434. package/dist/utils/map.d.ts +10 -0
  435. package/dist/utils/map.d.ts.map +1 -0
  436. package/dist/utils/map.js +30 -0
  437. package/dist/utils/map.js.map +1 -0
  438. package/dist/utils/serial.d.ts +2 -0
  439. package/dist/utils/serial.d.ts.map +1 -1
  440. package/dist/utils/serial.js +9 -0
  441. package/dist/utils/serial.js.map +1 -1
  442. package/dist/validation/capability-gate.d.ts +7 -15
  443. package/dist/validation/capability-gate.d.ts.map +1 -1
  444. package/dist/validation/capability-gate.js +32 -36
  445. package/dist/validation/capability-gate.js.map +1 -1
  446. package/dist/validation/crypto-gate.d.ts.map +1 -1
  447. package/dist/validation/crypto-gate.js +12 -21
  448. package/dist/validation/crypto-gate.js.map +1 -1
  449. package/docs/README.md +3 -2
  450. package/docs/actions.md +47 -20
  451. package/docs/automations.md +1 -1
  452. package/docs/blueprints-and-guides.md +57 -13
  453. package/docs/building-an-app.md +11 -8
  454. package/docs/collections.md +33 -5
  455. package/docs/contacts.md +34 -1
  456. package/docs/contracts.md +1 -1
  457. package/docs/direct-messages.md +1 -1
  458. package/docs/inbox.md +5 -11
  459. package/docs/node.md +36 -26
  460. package/docs/records-and-queries.md +1 -1
  461. package/docs/sign-in.md +54 -26
  462. package/docs/spaces.md +6 -6
  463. package/docs/standard-library.md +33 -31
  464. package/docs/storage.md +37 -15
  465. package/docs/usernames.md +161 -0
  466. package/docs/warrants.md +1 -1
  467. package/package.json +2 -21
  468. package/dist/calls/calls.d.ts +0 -140
  469. package/dist/calls/calls.d.ts.map +0 -1
  470. package/dist/calls/calls.js +0 -861
  471. package/dist/calls/calls.js.map +0 -1
  472. package/dist/calls/index.d.ts +0 -4
  473. package/dist/calls/index.d.ts.map +0 -1
  474. package/dist/calls/index.js +0 -3
  475. package/dist/calls/index.js.map +0 -1
  476. package/dist/react/context.d.ts +0 -81
  477. package/dist/react/context.d.ts.map +0 -1
  478. package/dist/react/context.js +0 -97
  479. package/dist/react/context.js.map +0 -1
  480. package/dist/react/follow.d.ts +0 -11
  481. package/dist/react/follow.d.ts.map +0 -1
  482. package/dist/react/follow.js +0 -7
  483. package/dist/react/follow.js.map +0 -1
  484. package/dist/react/index.d.ts +0 -44
  485. package/dist/react/index.d.ts.map +0 -1
  486. package/dist/react/index.js +0 -40
  487. package/dist/react/index.js.map +0 -1
  488. package/dist/react/minca-auth.d.ts +0 -19
  489. package/dist/react/minca-auth.d.ts.map +0 -1
  490. package/dist/react/minca-auth.js +0 -36
  491. package/dist/react/minca-auth.js.map +0 -1
  492. package/dist/react/use-calls.d.ts +0 -21
  493. package/dist/react/use-calls.d.ts.map +0 -1
  494. package/dist/react/use-calls.js +0 -39
  495. package/dist/react/use-calls.js.map +0 -1
  496. package/dist/react/use-invite-link.d.ts +0 -24
  497. package/dist/react/use-invite-link.d.ts.map +0 -1
  498. package/dist/react/use-invite-link.js +0 -62
  499. package/dist/react/use-invite-link.js.map +0 -1
  500. package/dist/react/use-live.d.ts +0 -16
  501. package/dist/react/use-live.d.ts.map +0 -1
  502. package/dist/react/use-live.js +0 -56
  503. package/dist/react/use-live.js.map +0 -1
  504. package/dist/react/use-my-name.d.ts +0 -12
  505. package/dist/react/use-my-name.d.ts.map +0 -1
  506. package/dist/react/use-my-name.js +0 -38
  507. package/dist/react/use-my-name.js.map +0 -1
  508. package/dist/react/use-names.d.ts +0 -7
  509. package/dist/react/use-names.d.ts.map +0 -1
  510. package/dist/react/use-names.js +0 -13
  511. package/dist/react/use-names.js.map +0 -1
  512. package/dist/react/use-network.d.ts +0 -9
  513. package/dist/react/use-network.d.ts.map +0 -1
  514. package/dist/react/use-network.js +0 -33
  515. package/dist/react/use-network.js.map +0 -1
  516. package/dist/react/use-query.d.ts +0 -14
  517. package/dist/react/use-query.d.ts.map +0 -1
  518. package/dist/react/use-query.js +0 -26
  519. package/dist/react/use-query.js.map +0 -1
  520. package/dist/react/use-space.d.ts +0 -29
  521. package/dist/react/use-space.d.ts.map +0 -1
  522. package/dist/react/use-space.js +0 -57
  523. package/dist/react/use-space.js.map +0 -1
  524. package/dist/react/use-spaces.d.ts +0 -29
  525. package/dist/react/use-spaces.d.ts.map +0 -1
  526. package/dist/react/use-spaces.js +0 -78
  527. package/dist/react/use-spaces.js.map +0 -1
  528. package/docs/calls.md +0 -189
package/docs/storage.md CHANGED
@@ -38,7 +38,7 @@ records changed once per message taken in, not once per version.
38
38
 
39
39
  _Source: `packages/core/src/sync/sync-engine.ts` (`MAX_WANTS_IN_FLIGHT`,
40
40
  `MAX_ROUNDS`, `STALE_MS`, `MAX_WAITING`, `MAX_REFUSED`, `want`, `pump`,
41
- `sweep`), `packages/core/src/node/space-runtime.ts` (heartbeat,
41
+ `sweep`), `packages/core/src/node/space-peers.ts` (heartbeat,
42
42
  `announceSoon`). Tests: `packages/core/tests/reconcile.test.ts` ("a want whose
43
43
  answer is lost is given up, and the peer is synced again"),
44
44
  `packages/core/tests/sync.test.ts`._
@@ -172,8 +172,12 @@ change and on close.
172
172
  directory store (`localPath` in `packages/cli/src/home.ts`). A command and
173
173
  the daemon share it, and the daemon finds the command's writes as it finds
174
174
  any directory store's (`reconcileFolder`). Writer keys are beside it in
175
- `writers/`; a slot left in the home from before is not read. `minca agent`
176
- still keeps its key and stores together in `<home>/agent`.
175
+ `writer-keys/`; a slot left in the home from before is not read, nor
176
+ `writers/`, where a minca from before the numbered lock keeps its keys, so
177
+ the two never sign with one key. `minca agent`
178
+ and `minca mcp` keep each session's key and stores together in a slot of
179
+ `<home>/agent`, beside the data folder the sessions share
180
+ ([actions](actions.md#the-agent-on-a-computer)).
177
181
  - **Elsewhere** it must be given: `folderStores` refuses to start without
178
182
  one, since a lasting key's places kept in memory would be handed out again
179
183
  after a restart.
@@ -209,8 +213,7 @@ _Source: `packages/core/src/node/stores.ts` (`folderStores`),
209
213
  `packages/core/src/storage/blob/directory.ts`,
210
214
  `packages/core/src/storage/directory-access.ts`,
211
215
  `packages/cli/src/fs-directory.ts`, `packages/cli/src/home.ts` (`unlock`),
212
- `packages/core/src/node/space-runtime.ts` ("Mirrors", "Writers outside this
213
- process"). Tests: `packages/core/tests/folder-adapter.test.ts`,
216
+ `packages/core/src/node/space-mirrors.ts` (`openMirrors`, `watch`). Tests: `packages/core/tests/folder-adapter.test.ts`,
214
217
  `packages/cli/tests/path-safety.test.ts`._
215
218
 
216
219
  ## Blob stores
@@ -275,7 +278,7 @@ and twice as many as its last compaction left, it compacts them, keeping
275
278
  only what its store holds.
276
279
 
277
280
  _Source: `packages/core/src/storage/mirror.ts`,
278
- `packages/core/src/node/space-runtime.ts` ("Mirrors"),
281
+ `packages/core/src/node/space-mirrors.ts` (`openMirrors`),
279
282
  `packages/core/src/node/host.ts`. Tests: `packages/core/tests/mirror.test.ts`._
280
283
 
281
284
  ### Planned: mirrors in your own storage
@@ -326,16 +329,35 @@ How this library does the rest:
326
329
  (`fileRefsIn`, at most 16), so the envelope and the body always agree.
327
330
  - **Reading.** `records.readFile(space, ref)` gives the bytes: held here, or
328
331
  fetched from connected peers, one after another, then from mirrors,
329
- checking every chunk. It asks only for files a version this node keeps
330
- whole names. For a picture, `URL.createObjectURL(new Blob([bytes], { type:
331
- ref.mime }))` shows it.
332
+ checking every chunk. When none has them it waits, asking everyone again
333
+ whenever records change or a peer connects, and every 15 s, and resolves
334
+ once one does. It rejects for a file no version this node keeps whole
335
+ names, one whose id is here whole yet won't open as named, and when the
336
+ space closes. For a picture, `URL.createObjectURL(new Blob([bytes], {
337
+ type: ref.mime }))` shows it.
332
338
  - **Where chunks live.** Entries in the space's own store: `f/<id>/list`,
333
- `f/<id>/<n>`, and `f/<id>/own` with the time a file was added and not yet
334
- named. A data folder keeps these in this device's own stores, not the
339
+ `f/<id>/<n>`, `f/<id>/own` with the time a file was added here (0 once a
340
+ version names it), and `f/<id>/used` with when it was last fetched or
341
+ read. A data folder keeps these in this device's own stores, not the
335
342
  folder.
336
- - **What a node fetches.** A node with `fetchFiles: 'all'` (carriers and
337
- hosts) fetches every named file about 2 s after its records change. Any
338
- other node fetches a file when it is read.
343
+ - **What a node fetches.** Files follow records. A node fetches every file
344
+ named by a version it keeps whole about 2 s after its records change,
345
+ while the writer is likely still connected. A file this sweep found
346
+ nobody had is not asked of everyone again for 10 minutes, but is asked at
347
+ once of each peer that connects meanwhile.
348
+ - **A device's limits.** A node limits the files it did not add, in every
349
+ space: it fetches unread only files of up to 5 MiB, so photos and
350
+ documents come ahead and video when played. Past 256 MiB of them in a
351
+ space, counting each at the size its list proves, or every chunk held of
352
+ one never whole, it drops those fetched or opened longest ago, down to
353
+ 90%, at the start of each pass and as it fetches. One never whole goes
354
+ first. A file added here is never dropped, nor one being fetched or read;
355
+ one larger than the limit is dropped on the pass after it is read, and
356
+ fetched again at the next read. A dropped file that was whole keeps its
357
+ `used` entry, so it is not fetched unread again while a version names it;
358
+ reading it fetches it. The limit is per space, so a device in many spaces
359
+ holds more. A node with `fetchFiles: 'all'`, a carrier or host, fetches
360
+ and keeps every file.
339
361
  - **Serving.** A `want-file` is answered with at most 4 chunks; the asker
340
362
  asks again for the rest, so a large file never floods a connection.
341
363
  - **Keeping.** About 2 s after records change, files no version kept whole
@@ -346,7 +368,7 @@ ref.mime }))` shows it.
346
368
  writer's copies of files no longer named.
347
369
 
348
370
  _Source: `packages/core/src/files/space-files.ts`, `packages/core/src/files/file-id.ts`,
349
- `packages/core/src/files/seal.ts`, `packages/core/src/node/space-runtime.ts` ("Files").
371
+ `packages/core/src/files/seal.ts`, `packages/core/src/node/space-runtime.ts` (`filesChanged`).
350
372
  Tests: `packages/core/tests/files.test.ts`._
351
373
 
352
374
  ### Planned: video and pictures
@@ -0,0 +1,161 @@
1
+ # Usernames
2
+
3
+ A username, `leif@minca.social`, is a name at a domain that leads to an
4
+ inbox code, so someone can find you by a name they can say aloud. What a
5
+ username is, how it is looked up and what a reader checks are protocol
6
+ ([spec 07 §9](https://github.com/leifriksheim/minca/blob/main/spec/07-inbox.md)):
7
+ every reader must agree on them.
8
+
9
+ How a name is claimed at a domain is not. A domain can answer from a file it
10
+ edits by hand, or from anything else. This page describes the **Minca name
11
+ service** (`packages/names`), which minca.social runs and anyone can run for a
12
+ domain of their own, and how the library claims a name on one.
13
+
14
+ ## Looking a name up
15
+
16
+ ```ts
17
+ import { resolveUsername } from '@minca/core/inbox';
18
+
19
+ const { code, inbox } = await resolveUsername('leif@minca.social', provider);
20
+ ```
21
+
22
+ It asks `https://minca.social/.well-known/minca.json?name=leif`, refuses a
23
+ redirect, and checks the code it gets as any other. The code then works
24
+ wherever one does: knock on it.
25
+
26
+ ## On the node
27
+
28
+ `node.inbox.claim('leif@minca.social')` does all of the below for the
29
+ account's inbox, and keeps the name in `std.inbox` so every device knows it:
30
+ replacing the inbox, or changing its name or mailboxes, points the name at
31
+ the new code, and reading knocks renews it a month before its year is up.
32
+ `node.inbox.release()` gives it up. `node.inbox.knock('anna@minca.social')`
33
+ knocks by username, and the contact it becomes keeps the username
34
+ (`ContactView.username`). See [node.md](node.md#the-inbox).
35
+
36
+ **At sign-up.** `createMincaAuth({ usernames: 'minca.social' })` makes the
37
+ create screen of `<minca-auth>` one field: the username, with a tick once the
38
+ service says it is free and a cross once it is taken. A bare name is at that
39
+ domain, and is how it is shown and handed out (`leif`); a whole username,
40
+ `leif@example.org`, is checked and claimed at its own domain, and one that
41
+ gives out no Minca usernames says so, with a link to running a service. The account's name
42
+ starts as the username's (`nameFromUsername`: `leif.r` is Leif R) and is
43
+ changed on the account page. "Continue without a username" makes the account with none, so nobody
44
+ finds it by one, and a made-up name to show until it is given one
45
+ (`adHocName`: Swift Otter). `createAccount(name,
46
+ { username })` claims it in the background while the recovery code and
47
+ password screens are up, and those screens say how it went: `state.username`
48
+ is `claiming`, `claimed`, or `failed` with an `error`, when it was taken
49
+ meanwhile or the service was down. The account is made either way.
50
+
51
+ The claim is made on the home's node, which may be the only one holding the
52
+ inbox: a connect page that closes once it answers keeps the window open
53
+ until the app's node holds the contacts space too (`spaces.reached`, keyed
54
+ by the app's key from its request), or else the app would read no knocks
55
+ until the two next met. The account home waits for what setup began in
56
+ the background (`auth.settled()`: the claim, and the host's handover) to
57
+ finish, however long, so neither is cut off halfway; then up to 30 s for the app,
58
+ and only for an account that claimed a name there. If the claim failed, the
59
+ app's contacts screen asks for a name again.
60
+
61
+ _Source: `packages/core/src/session/auth.ts` (`createAccount`, `claimInBackground`), `packages/core/src/elements/minca-auth.ts` (`#create`), `packages/core/src/inbox/names.ts` (`adHocName`, `nameFromUsername`, `usernameFree`), `apps/home/src/components/ConnectPage.tsx` (`handOver`). Tests: `packages/core/tests/usernames.test.ts` ("a username at sign-up")._
62
+
63
+ Renewing claims the code of the inbox this device knows. A device that
64
+ hasn't yet synced a replacement made on another one points the name back at
65
+ the old inbox until the inbox next changes; renewal starts only within a
66
+ month of the name lapsing, so this is rare.
67
+
68
+ ## Claiming a name
69
+
70
+ ```ts
71
+ import { claimUsername } from '@minca/core/inbox';
72
+
73
+ const until = await claimUsername('leif@minca.social', contactKey, inboxCode);
74
+ ```
75
+
76
+ `claimUsername` looks the name up first. A Minca name service says, in every
77
+ answer, where claims go and how much work one needs:
78
+
79
+ ```json
80
+ { "names": {}, "claim": "https://usernames.minca.social/.well-known/minca.json", "work": 20 }
81
+ ```
82
+
83
+ Then it posts the claim there:
84
+
85
+ ```json
86
+ {
87
+ "name": "leif",
88
+ "key": "<name key public half>",
89
+ "at": 1790000000000,
90
+ "work": 731042,
91
+ "code": "<inbox code>",
92
+ "bind": "<base64url>",
93
+ "sig": "<base64url>"
94
+ }
95
+ ```
96
+
97
+ | Field | |
98
+ | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------ |
99
+ | `key` | The **name key**'s public half, compressed P-256, base64url |
100
+ | `at` | When the claim was made, ms. It must be within 10 minutes of the service's clock, and later than the claim it follows |
101
+ | `work` | A counter: SHA-256 of `minca/name-work/v1\|<name>@<domain>\|<key>\|<at>\|<work>` starts with `work` zero bits |
102
+ | `code` | The inbox code, at most 4,096 characters. None gives the name up |
103
+ | `bind` | With a code: the inbox signing key's signature over `minca/name-bind/v1\|<name>@<domain>`, so a name leads only to an inbox whose owner chose it |
104
+ | `sig` | The name key's ECDSA P-256 signature over `minca/name-claim/v1\|<name>@<domain>\|<at>\|<code, or empty>` |
105
+
106
+ The answer is `{ "until": <ms> }`, when the name lapses, or
107
+ `{ "error": "…" }` with a 4xx status.
108
+
109
+ **The name key** is derived from the contact key, one per username:
110
+ `HKDF-SHA-256(contact key, info = "minca/p256-name-key/v1|" + name@domain)`,
111
+ with the username as `formatUsername` writes it, so every spelling a reader takes gives one key. `claimUsername` derives it itself. Every device that holds the contact key
112
+ derives the same one; it is not an inbox key, so replacing the inbox keeps
113
+ the name, and nothing ties it to the account. Only the key that holds a name
114
+ can point it elsewhere, renew it or give it up.
115
+
116
+ **Who may.** A name leads to the account's inbox, so only what may run the
117
+ inbox may claim one: a node whose note grants `/account/write` for the whole
118
+ account, holding the contact key. An app given the contact key could claim
119
+ the account's names too, and its hold outlasts revoking it, since a name key
120
+ has no generation to move on to
121
+ ([#313](https://github.com/leifriksheim/minca/issues/313)).
122
+
123
+ ## What the service keeps to
124
+
125
+ | Rule | On minca.social |
126
+ | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
127
+ | How long a claim holds | A year. Claiming again, with the same code or a new one, renews it |
128
+ | New names from one address | 3 a day (an IPv4 address, or an IPv6 /48). Changing or renewing a name is free |
129
+ | Work | 18 bits: a fraction of a second on a laptop, about a second on a phone |
130
+ | Names held | 50,000: each is a file of up to 8 KB, so a 1 GB volume holds them, inodes included |
131
+ | Reserved | `admin`, `support`, `security`, `minca` and a few more that pass for the service. A lookup of one answers `"reserved": true`, so `usernameFree` says it isn't |
132
+ | Given up | Free again after 10 minutes, so no earlier claim can be replayed to take it back |
133
+
134
+ The work is a speed bump for bots, not a gate: a server does it ten times
135
+ faster than a phone. The address budget and the year are what keep squatting
136
+ in check; a name nobody renews comes back. The budget is kept in memory, so a
137
+ restart forgets it; nothing a client sends can make the service stop, since
138
+ whatever goes wrong with one request answers that request.
139
+
140
+ Each name is a file of its own on the service's disk, so nothing grows in
141
+ memory and no large file is rewritten. Lookups are open to any page
142
+ (`Access-Control-Allow-Origin: *`).
143
+
144
+ ## Running one for your domain
145
+
146
+ The service is `packages/names/server.mjs`, with no dependencies:
147
+
148
+ ```bash
149
+ NAMES_DOMAIN=example.org \
150
+ NAMES_CLAIM_URL=https://names.example.org/.well-known/minca.json \
151
+ NAMES_DIR=/data/names \
152
+ node packages/names/server.mjs 8080
153
+ ```
154
+
155
+ Then answer `https://example.org/.well-known/minca.json` from it, by serving
156
+ the domain from it or proxying that one path (minca.social's site does this,
157
+ in `apps/site/public/_redirects`). Claims go to `NAMES_CLAIM_URL` directly, so
158
+ the service sees each client's address. `packages/names/fly.toml` deploys it
159
+ on Fly.
160
+
161
+ _Source: `packages/core/src/inbox/names.ts` (`claimUsername`, `claimMessage`), `packages/core/src/identity/contact-key.ts` (`deriveNameKeyBytes`), `packages/names/names.mjs` (`createNames`, `NAMES_LIMITS`), `packages/names/server.mjs`, `apps/site/public/_redirects`. Tests: `packages/names/tests/names.test.ts`._
package/docs/warrants.md CHANGED
@@ -76,4 +76,4 @@ Like any record, a warrant is withdrawn when its writer is removed by a
76
76
  change whose cutoff doesn't cover it, or revokes the key that signed it ([#166](https://github.com/leifriksheim/minca/issues/166)). More kinds are planned after v1, in
77
77
  [#148](https://github.com/leifriksheim/minca/issues/148).
78
78
 
79
- _Source: `packages/core/src/records/warrant.ts` (`readWarrant`, `knownKind`), `packages/core/src/node/space-runtime.ts` (`ownView`, `warrantShape`, `warrantVerdict`, `evidenceHolds`, `violationIn`, `warrantIfDue`, `flagged`), `packages/core/src/space/space-access.ts` (`WARRANT_COLLECTION`). Tests: `packages/core/tests/warrants.test.ts`._
79
+ _Source: `packages/core/src/records/warrant.ts` (`readWarrant`, `knownKind`), `packages/core/src/node/space-history.ts` (`ownView`), `packages/core/src/node/space-warrants.ts` (`warrantShape`, `warrantVerdict`, `evidenceHolds`, `violationIn`, `warrantIfDue`, `flagged`), `packages/core/src/space/space-access.ts` (`WARRANT_COLLECTION`). Tests: `packages/core/tests/warrants.test.ts`._
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@minca/core",
3
- "version": "0.1.14",
3
+ "version": "0.1.16",
4
4
  "type": "module",
5
5
  "description": "Self-sovereign P2P protocol for the browser — identity, schemas, storage, networking, and gossip sync",
6
6
  "repository": {
@@ -51,16 +51,6 @@
51
51
  "types": "./dist/elements/index.d.ts",
52
52
  "import": "./dist/elements/index.js"
53
53
  },
54
- "./react": {
55
- "@minca/source": "./src/react/index.ts",
56
- "types": "./dist/react/index.d.ts",
57
- "import": "./dist/react/index.js"
58
- },
59
- "./calls": {
60
- "@minca/source": "./src/calls/index.ts",
61
- "types": "./dist/calls/index.d.ts",
62
- "import": "./dist/calls/index.js"
63
- },
64
54
  "./inbox": {
65
55
  "@minca/source": "./src/inbox/index.ts",
66
56
  "types": "./dist/inbox/index.d.ts",
@@ -70,13 +60,12 @@
70
60
  "scripts": {
71
61
  "build": "rm -rf dist && tsc",
72
62
  "typecheck": "tsc --noEmit && tsc -p tests",
73
- "test": "node --experimental-vm-modules --import tsx --test --test-concurrency=4 --test-timeout=60000 --test-force-exit tests/*.test.ts",
63
+ "test": "node --experimental-vm-modules --import tsx --test --test-concurrency=8 --test-timeout=60000 --test-force-exit tests/*.test.ts",
74
64
  "prepack": "node ../../scripts/npm-readme.mjs",
75
65
  "postpack": "rm -f README.md",
76
66
  "prepublishOnly": "npm run build"
77
67
  },
78
68
  "devDependencies": {
79
- "@types/react": "^19.3.0",
80
69
  "@types/ws": "^8.18.2",
81
70
  "esbuild": "^0.28.2",
82
71
  "tsx": "^4.19.0",
@@ -95,14 +84,6 @@
95
84
  "@scure/base": "^2.4.0",
96
85
  "aws4fetch": "^1.0.20"
97
86
  },
98
- "peerDependencies": {
99
- "react": "^19.3.1"
100
- },
101
- "peerDependenciesMeta": {
102
- "react": {
103
- "optional": true
104
- }
105
- },
106
87
  "publishConfig": {
107
88
  "access": "public"
108
89
  }
@@ -1,140 +0,0 @@
1
- /**
2
- * Voice and video calls between the people in a space.
3
- *
4
- * Nothing here is new to the protocol. A call is live messages
5
- * (`node.spaces.send`) in the space it belongs to, and a WebRTC connection of
6
- * its own between each pair of people in it — the shape Matrix gives group
7
- * calls (MSC3401, Element Call's full mesh):
8
- *
9
- * ```
10
- * call.here { call, since, camera, muted } to the space, every few seconds while in it
11
- * call.ring { call } to one account: ring its devices
12
- * call.answered { call } / call.declined to the caller, and to your own other devices
13
- * call.cancel { call } the caller gave up ringing
14
- * call.signal { call, description | candidate } to one device: setting up the connection
15
- * call.leave { call } to the space: gone now, not in 15 seconds
16
- * ```
17
- *
18
- * The setup travels over the space's own peer connection, whose handshake
19
- * proved who is at the other end — so the offer, and the fingerprint of the
20
- * key the browser will insist on, really come from that person. A relay only
21
- * ever introduced the two devices; it never sees a call.
22
- *
23
- * Only members of the space (anyone holding a role) are rung by, heard in or
24
- * connected to a call; a view-only reader of a public space is not.
25
- *
26
- * A call belongs to the space, not to a screen: it keeps the space open
27
- * (`spaces.hold`) for as long as it runs, so moving between spaces
28
- * never interrupts it. One call at a time.
29
- *
30
- * Each connection is made with an audio and a video transceiver from the
31
- * start. Turning the camera on or off, or sharing the screen, swaps the track
32
- * a sender carries and never renegotiates — so neither side can offer at the
33
- * same moment as the other, and the side with the lower session DID always
34
- * makes the offer.
35
- */
36
- import type { P2PNode } from '../node/types.js';
37
- export interface CallsOptions {
38
- /** How a WebRTC connection is made. `new RTCPeerConnection` by default. */
39
- readonly createConnection?: (config: RTCConfiguration) => RTCPeerConnection;
40
- /** Camera and microphone. `navigator.mediaDevices.getUserMedia` by default. */
41
- readonly getUserMedia?: (constraints: MediaStreamConstraints) => Promise<MediaStream>;
42
- /** The screen, for sharing it. `navigator.mediaDevices.getDisplayMedia` by default. */
43
- readonly getDisplayMedia?: (constraints: DisplayMediaStreamOptions) => Promise<MediaStream>;
44
- /** How a set of tracks becomes something a `<video>` can show. `new MediaStream` by default. */
45
- readonly createStream?: (tracks: ReadonlyArray<MediaStreamTrack>) => MediaStream | null;
46
- /** Where the call you're in is remembered, to offer rejoining after a reload. `sessionStorage` by default; null for nowhere. */
47
- readonly storage?: Pick<Storage, 'getItem' | 'setItem' | 'removeItem'> | null;
48
- /** How often you say you're in a call. Default 5 s. */
49
- readonly heartbeatMs?: number;
50
- /** How long without hearing that someone is gone. Default 15 s. */
51
- readonly goneMs?: number;
52
- /** How long a ring rings before it's a missed call. Default 45 s. */
53
- readonly ringMs?: number;
54
- }
55
- /** Someone else in the call you're in: one device of theirs */
56
- export interface CallPeer {
57
- /** Their device's session DID */
58
- readonly peer: string;
59
- /** Their account */
60
- readonly account: string;
61
- /** What they send: sound, and video when their camera is on. Null until it arrives. */
62
- readonly stream: MediaStream | null;
63
- readonly muted: boolean;
64
- readonly camera: boolean;
65
- readonly connection: 'connecting' | 'connected' | 'failed';
66
- }
67
- /** The call you're in */
68
- export interface CurrentCall {
69
- readonly id: string;
70
- readonly space: string;
71
- /** When you joined it, ms */
72
- readonly joinedAt: number;
73
- /** Your own camera and microphone, for showing yourself */
74
- readonly local: MediaStream | null;
75
- readonly muted: boolean;
76
- readonly camera: boolean;
77
- readonly sharing: boolean;
78
- readonly people: ReadonlyArray<CallPeer>;
79
- /** Who you're ringing, while it rings — and what came of it, for a moment after */
80
- readonly outgoing: {
81
- readonly to: string;
82
- readonly since: number;
83
- readonly state: 'ringing' | 'declined' | 'missed';
84
- } | null;
85
- /** Something went wrong that you should hear about: no microphone, say */
86
- readonly problem: string | null;
87
- }
88
- /** Someone ringing you */
89
- export interface IncomingCall {
90
- readonly id: string;
91
- readonly space: string;
92
- /** The caller's account */
93
- readonly from: string;
94
- readonly since: number;
95
- }
96
- /** A call going on in a space you have open, that you're not in */
97
- export interface CallAround {
98
- readonly id: string;
99
- readonly space: string;
100
- /** Accounts in it, each once */
101
- readonly people: ReadonlyArray<string>;
102
- /** When the first of them joined, ms */
103
- readonly since: number;
104
- }
105
- export interface CallsState {
106
- readonly current: CurrentCall | null;
107
- readonly ringing: ReadonlyArray<IncomingCall>;
108
- readonly around: ReadonlyArray<CallAround>;
109
- /** The call you were in before this page loaded, while it's still going on */
110
- readonly rejoin: CallAround | null;
111
- }
112
- export interface CallOptions {
113
- /** Start with the camera on. Default false: sound only. */
114
- readonly video?: boolean;
115
- }
116
- export interface Calls {
117
- /** What's going on now. The same object until something changes. */
118
- getState(): CallsState;
119
- subscribe(listener: () => void): () => void;
120
- /** Joins the call going on in a space, or starts one. Leaves any other call first. */
121
- start(space: string, options?: CallOptions & {
122
- readonly call?: string;
123
- }): Promise<void>;
124
- /** Starts a call in a space, and rings one person there — all their devices, until one answers */
125
- ring(space: string, account: string, options?: CallOptions): Promise<void>;
126
- answer(id: string, options?: CallOptions): Promise<void>;
127
- decline(id: string): Promise<void>;
128
- leave(): Promise<void>;
129
- setMuted(muted: boolean): void;
130
- setCamera(on: boolean): Promise<void>;
131
- /** Shows your screen in place of your camera, until you stop it (or the browser does) */
132
- shareScreen(): Promise<void>;
133
- stopSharing(): Promise<void>;
134
- /** Stops offering `rejoin` */
135
- forgetRejoin(): void;
136
- /** Leaves any call and stops listening */
137
- close(): Promise<void>;
138
- }
139
- export declare function createCalls(node: P2PNode, options?: CallsOptions): Calls;
140
- //# sourceMappingURL=calls.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"calls.d.ts","sourceRoot":"","sources":["../../src/calls/calls.ts"],"names":[],"mappings":"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"}