@minca/core 0.1.15 → 0.1.17
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 +10 -10
- package/dist/elements/auth-styles.d.ts +1 -1
- package/dist/elements/auth-styles.d.ts.map +1 -1
- package/dist/elements/auth-styles.js +35 -9
- package/dist/elements/auth-styles.js.map +1 -1
- package/dist/elements/minca-auth.d.ts.map +1 -1
- package/dist/elements/minca-auth.js +169 -72
- package/dist/elements/minca-auth.js.map +1 -1
- package/dist/identity/abilities.d.ts +2 -0
- package/dist/identity/abilities.d.ts.map +1 -1
- package/dist/identity/abilities.js +2 -0
- package/dist/identity/abilities.js.map +1 -1
- package/dist/identity/account-vault.d.ts +15 -71
- package/dist/identity/account-vault.d.ts.map +1 -1
- package/dist/identity/account-vault.js +45 -104
- package/dist/identity/account-vault.js.map +1 -1
- package/dist/identity/channel.d.ts +3 -9
- package/dist/identity/channel.d.ts.map +1 -1
- package/dist/identity/channel.js +42 -42
- package/dist/identity/channel.js.map +1 -1
- package/dist/identity/contact-key.d.ts +14 -29
- package/dist/identity/contact-key.d.ts.map +1 -1
- package/dist/identity/contact-key.js +31 -51
- package/dist/identity/contact-key.js.map +1 -1
- package/dist/identity/crypto-p256.d.ts.map +1 -1
- package/dist/identity/crypto-p256.js +39 -53
- package/dist/identity/crypto-p256.js.map +1 -1
- package/dist/identity/hpke.d.ts.map +1 -1
- package/dist/identity/hpke.js +19 -19
- package/dist/identity/hpke.js.map +1 -1
- package/dist/identity/identity-manager.d.ts.map +1 -1
- package/dist/identity/identity-manager.js +1 -2
- package/dist/identity/identity-manager.js.map +1 -1
- package/dist/identity/policy.d.ts.map +1 -1
- package/dist/identity/policy.js +35 -61
- package/dist/identity/policy.js.map +1 -1
- package/dist/identity/recovery-code.d.ts +2 -8
- package/dist/identity/recovery-code.d.ts.map +1 -1
- package/dist/identity/recovery-code.js +4 -11
- package/dist/identity/recovery-code.js.map +1 -1
- package/dist/identity/root-signer.d.ts +1 -6
- package/dist/identity/root-signer.d.ts.map +1 -1
- package/dist/identity/root-signer.js +12 -15
- package/dist/identity/root-signer.js.map +1 -1
- package/dist/identity/ucan.d.ts.map +1 -1
- package/dist/identity/ucan.js +48 -39
- package/dist/identity/ucan.js.map +1 -1
- package/dist/identity/webauthn.d.ts +6 -11
- package/dist/identity/webauthn.d.ts.map +1 -1
- package/dist/identity/webauthn.js +18 -30
- package/dist/identity/webauthn.js.map +1 -1
- package/dist/inbox/inbox.d.ts.map +1 -1
- package/dist/inbox/inbox.js +40 -30
- package/dist/inbox/inbox.js.map +1 -1
- package/dist/inbox/index.d.ts +2 -0
- package/dist/inbox/index.d.ts.map +1 -1
- package/dist/inbox/index.js +1 -0
- package/dist/inbox/index.js.map +1 -1
- package/dist/inbox/names.d.ts +54 -0
- package/dist/inbox/names.d.ts.map +1 -0
- package/dist/inbox/names.js +299 -0
- package/dist/inbox/names.js.map +1 -0
- package/dist/index.d.ts +3 -6
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +9 -12
- package/dist/index.js.map +1 -1
- package/dist/network/mesh.d.ts +7 -20
- package/dist/network/mesh.d.ts.map +1 -1
- package/dist/network/mesh.js +267 -245
- package/dist/network/mesh.js.map +1 -1
- package/dist/network/relay-link.d.ts +31 -0
- package/dist/network/relay-link.d.ts.map +1 -0
- package/dist/network/relay-link.js +62 -0
- package/dist/network/relay-link.js.map +1 -0
- package/dist/network/relay-minca.d.ts.map +1 -1
- package/dist/network/relay-minca.js +11 -49
- package/dist/network/relay-minca.js.map +1 -1
- package/dist/network/relay-nostr.d.ts.map +1 -1
- package/dist/network/relay-nostr.js +23 -63
- package/dist/network/relay-nostr.js.map +1 -1
- package/dist/network/relay-socket.d.ts +1 -1
- package/dist/network/relay-socket.d.ts.map +1 -1
- package/dist/network/relay-socket.js +3 -1
- package/dist/network/relay-socket.js.map +1 -1
- package/dist/network/ws-transport.d.ts.map +1 -1
- package/dist/network/ws-transport.js +3 -0
- package/dist/network/ws-transport.js.map +1 -1
- package/dist/node/actions.d.ts +2 -0
- package/dist/node/actions.d.ts.map +1 -1
- package/dist/node/actions.js +89 -58
- package/dist/node/actions.js.map +1 -1
- package/dist/node/api.d.ts +7 -0
- package/dist/node/api.d.ts.map +1 -1
- package/dist/node/api.js +7 -0
- package/dist/node/api.js.map +1 -1
- package/dist/node/carrier.d.ts +5 -0
- package/dist/node/carrier.d.ts.map +1 -1
- package/dist/node/carrier.js +94 -73
- package/dist/node/carrier.js.map +1 -1
- package/dist/node/copy.d.ts +8 -7
- package/dist/node/copy.d.ts.map +1 -1
- package/dist/node/copy.js +54 -56
- package/dist/node/copy.js.map +1 -1
- package/dist/node/host.d.ts +39 -65
- package/dist/node/host.d.ts.map +1 -1
- package/dist/node/host.js +362 -379
- package/dist/node/host.js.map +1 -1
- package/dist/node/index.d.ts +2 -2
- package/dist/node/index.d.ts.map +1 -1
- package/dist/node/index.js +1 -1
- package/dist/node/index.js.map +1 -1
- package/dist/node/node-carriers.d.ts +35 -0
- package/dist/node/node-carriers.d.ts.map +1 -0
- package/dist/node/node-carriers.js +567 -0
- package/dist/node/node-carriers.js.map +1 -0
- package/dist/node/node-contacts.d.ts +11 -0
- package/dist/node/node-contacts.d.ts.map +1 -0
- package/dist/node/node-contacts.js +808 -0
- package/dist/node/node-contacts.js.map +1 -0
- package/dist/node/node-context.d.ts +76 -0
- package/dist/node/node-context.d.ts.map +1 -0
- package/dist/node/node-context.js +54 -0
- package/dist/node/node-context.js.map +1 -0
- package/dist/node/node-hosting.d.ts +20 -0
- package/dist/node/node-hosting.d.ts.map +1 -0
- package/dist/node/node-hosting.js +456 -0
- package/dist/node/node-hosting.js.map +1 -0
- package/dist/node/node-records.d.ts +18 -0
- package/dist/node/node-records.d.ts.map +1 -0
- package/dist/node/node-records.js +262 -0
- package/dist/node/node-records.js.map +1 -0
- package/dist/node/node.d.ts.map +1 -1
- package/dist/node/node.js +199 -1990
- package/dist/node/node.js.map +1 -1
- package/dist/node/remote.d.ts +5 -6
- package/dist/node/remote.d.ts.map +1 -1
- package/dist/node/remote.js +272 -260
- package/dist/node/remote.js.map +1 -1
- package/dist/node/space-catalog.d.ts +40 -0
- package/dist/node/space-catalog.d.ts.map +1 -0
- package/dist/node/space-catalog.js +158 -0
- package/dist/node/space-catalog.js.map +1 -0
- package/dist/node/space-checks.d.ts +25 -0
- package/dist/node/space-checks.d.ts.map +1 -0
- package/dist/node/space-checks.js +343 -0
- package/dist/node/space-checks.js.map +1 -0
- package/dist/node/space-history.d.ts +37 -0
- package/dist/node/space-history.d.ts.map +1 -0
- package/dist/node/space-history.js +350 -0
- package/dist/node/space-history.js.map +1 -0
- package/dist/node/space-holding.d.ts +53 -0
- package/dist/node/space-holding.d.ts.map +1 -0
- package/dist/node/space-holding.js +339 -0
- package/dist/node/space-holding.js.map +1 -0
- package/dist/node/space-index.d.ts +41 -0
- package/dist/node/space-index.d.ts.map +1 -0
- package/dist/node/space-index.js +217 -0
- package/dist/node/space-index.js.map +1 -0
- package/dist/node/space-keys.d.ts +34 -0
- package/dist/node/space-keys.d.ts.map +1 -0
- package/dist/node/space-keys.js +309 -0
- package/dist/node/space-keys.js.map +1 -0
- package/dist/node/space-lines.d.ts +33 -0
- package/dist/node/space-lines.d.ts.map +1 -0
- package/dist/node/space-lines.js +145 -0
- package/dist/node/space-lines.js.map +1 -0
- package/dist/node/space-membership.d.ts +69 -0
- package/dist/node/space-membership.d.ts.map +1 -0
- package/dist/node/space-membership.js +242 -0
- package/dist/node/space-membership.js.map +1 -0
- package/dist/node/space-mirrors.d.ts +43 -0
- package/dist/node/space-mirrors.d.ts.map +1 -0
- package/dist/node/space-mirrors.js +125 -0
- package/dist/node/space-mirrors.js.map +1 -0
- package/dist/node/space-peers.d.ts +104 -0
- package/dist/node/space-peers.d.ts.map +1 -0
- package/dist/node/space-peers.js +629 -0
- package/dist/node/space-peers.js.map +1 -0
- package/dist/node/space-profiles.d.ts +18 -0
- package/dist/node/space-profiles.d.ts.map +1 -0
- package/dist/node/space-profiles.js +105 -0
- package/dist/node/space-profiles.js.map +1 -0
- package/dist/node/space-rules.d.ts +29 -0
- package/dist/node/space-rules.d.ts.map +1 -0
- package/dist/node/space-rules.js +144 -0
- package/dist/node/space-rules.js.map +1 -0
- package/dist/node/space-runtime.d.ts +107 -140
- package/dist/node/space-runtime.d.ts.map +1 -1
- package/dist/node/space-runtime.js +331 -3985
- package/dist/node/space-runtime.js.map +1 -1
- package/dist/node/space-standing.d.ts +20 -0
- package/dist/node/space-standing.d.ts.map +1 -0
- package/dist/node/space-standing.js +317 -0
- package/dist/node/space-standing.js.map +1 -0
- package/dist/node/space-versions.d.ts +104 -0
- package/dist/node/space-versions.d.ts.map +1 -0
- package/dist/node/space-versions.js +153 -0
- package/dist/node/space-versions.js.map +1 -0
- package/dist/node/space-warrants.d.ts +25 -0
- package/dist/node/space-warrants.d.ts.map +1 -0
- package/dist/node/space-warrants.js +214 -0
- package/dist/node/space-warrants.js.map +1 -0
- package/dist/node/space-writing.d.ts +74 -0
- package/dist/node/space-writing.d.ts.map +1 -0
- package/dist/node/space-writing.js +442 -0
- package/dist/node/space-writing.js.map +1 -0
- package/dist/node/stores.d.ts +19 -50
- package/dist/node/stores.d.ts.map +1 -1
- package/dist/node/stores.js +14 -33
- package/dist/node/stores.js.map +1 -1
- package/dist/node/types.d.ts +243 -306
- package/dist/node/types.d.ts.map +1 -1
- package/dist/node/usage.d.ts +2 -24
- package/dist/node/usage.d.ts.map +1 -1
- package/dist/node/usage.js +118 -102
- package/dist/node/usage.js.map +1 -1
- package/dist/node/watch-notifications.d.ts.map +1 -1
- package/dist/node/watch-notifications.js +32 -29
- package/dist/node/watch-notifications.js.map +1 -1
- package/dist/node/worker.d.ts +5 -6
- package/dist/node/worker.d.ts.map +1 -1
- package/dist/node/worker.js +80 -72
- package/dist/node/worker.js.map +1 -1
- package/dist/node/writer-keys.d.ts +5 -6
- package/dist/node/writer-keys.d.ts.map +1 -1
- package/dist/node/writer-keys.js +66 -57
- package/dist/node/writer-keys.js.map +1 -1
- package/dist/node/writers.d.ts +12 -19
- package/dist/node/writers.d.ts.map +1 -1
- package/dist/node/writers.js +7 -15
- package/dist/node/writers.js.map +1 -1
- package/dist/privacy/direct.d.ts.map +1 -1
- package/dist/privacy/direct.js +31 -27
- package/dist/privacy/direct.js.map +1 -1
- package/dist/privacy/space-encryption.d.ts.map +1 -1
- package/dist/privacy/space-encryption.js +5 -9
- package/dist/privacy/space-encryption.js.map +1 -1
- package/dist/query/computed.d.ts.map +1 -1
- package/dist/query/computed.js +78 -77
- package/dist/query/computed.js.map +1 -1
- package/dist/query/engine.d.ts +3 -4
- package/dist/query/engine.d.ts.map +1 -1
- package/dist/query/engine.js +93 -86
- package/dist/query/engine.js.map +1 -1
- package/dist/query/filter.d.ts +8 -10
- package/dist/query/filter.d.ts.map +1 -1
- package/dist/query/filter.js +144 -161
- package/dist/query/filter.js.map +1 -1
- package/dist/records/cel-types.d.ts.map +1 -1
- package/dist/records/cel-types.js +13 -27
- package/dist/records/cel-types.js.map +1 -1
- package/dist/records/cel.d.ts.map +1 -1
- package/dist/records/cel.js +177 -242
- package/dist/records/cel.js.map +1 -1
- package/dist/records/rules.d.ts.map +1 -1
- package/dist/records/rules.js +46 -50
- package/dist/records/rules.js.map +1 -1
- package/dist/records/topics.d.ts.map +1 -1
- package/dist/records/topics.js +18 -22
- package/dist/records/topics.js.map +1 -1
- package/dist/schemas/automations.d.ts +8 -15
- package/dist/schemas/automations.d.ts.map +1 -1
- package/dist/schemas/automations.js +203 -165
- package/dist/schemas/automations.js.map +1 -1
- package/dist/schemas/blueprints.d.ts.map +1 -1
- package/dist/schemas/blueprints.js +14 -13
- package/dist/schemas/blueprints.js.map +1 -1
- package/dist/schemas/connectors.d.ts.map +1 -1
- package/dist/schemas/connectors.js +16 -11
- package/dist/schemas/connectors.js.map +1 -1
- package/dist/schemas/contacts.d.ts +57 -0
- package/dist/schemas/contacts.d.ts.map +1 -1
- package/dist/schemas/contacts.js +32 -0
- package/dist/schemas/contacts.js.map +1 -1
- package/dist/schemas/cron.d.ts.map +1 -1
- package/dist/schemas/cron.js +27 -28
- package/dist/schemas/cron.js.map +1 -1
- package/dist/schemas/defined.d.ts +6 -0
- package/dist/schemas/defined.d.ts.map +1 -0
- package/dist/schemas/defined.js +7 -0
- package/dist/schemas/defined.js.map +1 -0
- package/dist/schemas/guides.d.ts +3 -1
- package/dist/schemas/guides.d.ts.map +1 -1
- package/dist/schemas/guides.js +13 -12
- package/dist/schemas/guides.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 +18 -14
- package/dist/schemas/index.js.map +1 -1
- package/dist/schemas/library/social.d.ts +258 -0
- package/dist/schemas/library/social.d.ts.map +1 -1
- package/dist/schemas/library/social.js +28 -1
- package/dist/schemas/library/social.js.map +1 -1
- package/dist/session/account-hint.d.ts.map +1 -1
- package/dist/session/account-hint.js +8 -5
- package/dist/session/account-hint.js.map +1 -1
- package/dist/session/auth.d.ts +36 -2
- package/dist/session/auth.d.ts.map +1 -1
- package/dist/session/auth.js +95 -2
- package/dist/session/auth.js.map +1 -1
- package/dist/session/connect.d.ts +1 -0
- package/dist/session/connect.d.ts.map +1 -1
- package/dist/session/connect.js +3 -1
- package/dist/session/connect.js.map +1 -1
- package/dist/session/credentials.d.ts +8 -26
- package/dist/session/credentials.d.ts.map +1 -1
- package/dist/session/credentials.js +14 -32
- package/dist/session/credentials.js.map +1 -1
- package/dist/session/hosting.d.ts.map +1 -1
- package/dist/session/hosting.js +8 -2
- package/dist/session/hosting.js.map +1 -1
- package/dist/session/index.d.ts +1 -0
- package/dist/session/index.d.ts.map +1 -1
- package/dist/session/index.js +1 -0
- package/dist/session/index.js.map +1 -1
- package/dist/session/pairing.d.ts.map +1 -1
- package/dist/session/pairing.js +92 -88
- package/dist/session/pairing.js.map +1 -1
- package/dist/session/password-strength.d.ts.map +1 -1
- package/dist/session/password-strength.js +37 -37
- package/dist/session/password-strength.js.map +1 -1
- package/dist/session/places.d.ts.map +1 -1
- package/dist/session/places.js +18 -13
- package/dist/session/places.js.map +1 -1
- package/dist/session/popup.d.ts +13 -0
- package/dist/session/popup.d.ts.map +1 -0
- package/dist/session/popup.js +23 -0
- package/dist/session/popup.js.map +1 -0
- package/dist/space/constitution.d.ts.map +1 -1
- package/dist/space/constitution.js +22 -29
- package/dist/space/constitution.js.map +1 -1
- package/dist/space/grants.d.ts.map +1 -1
- package/dist/space/grants.js +37 -39
- package/dist/space/grants.js.map +1 -1
- package/dist/space/invite-link.d.ts.map +1 -1
- package/dist/space/invite-link.js +33 -33
- package/dist/space/invite-link.js.map +1 -1
- package/dist/space/own-automations.d.ts +13 -24
- package/dist/space/own-automations.d.ts.map +1 -1
- package/dist/space/own-automations.js +47 -37
- package/dist/space/own-automations.js.map +1 -1
- package/dist/space/presets.d.ts +2 -2
- package/dist/space/presets.d.ts.map +1 -1
- package/dist/space/presets.js +3 -2
- package/dist/space/presets.js.map +1 -1
- package/dist/space/roles.d.ts +56 -80
- package/dist/space/roles.d.ts.map +1 -1
- package/dist/space/roles.js +448 -441
- package/dist/space/roles.js.map +1 -1
- package/dist/space/space-access.d.ts +3 -4
- package/dist/space/space-access.d.ts.map +1 -1
- package/dist/space/space-access.js +3 -8
- package/dist/space/space-access.js.map +1 -1
- package/dist/storage/blob/directory.d.ts.map +1 -1
- package/dist/storage/blob/directory.js +39 -32
- package/dist/storage/blob/directory.js.map +1 -1
- package/dist/storage/blob/s3.d.ts.map +1 -1
- package/dist/storage/blob/s3.js +21 -19
- package/dist/storage/blob/s3.js.map +1 -1
- package/dist/storage/blob-store.d.ts +0 -9
- package/dist/storage/blob-store.d.ts.map +1 -1
- package/dist/storage/directory-access.d.ts +8 -32
- package/dist/storage/directory-access.d.ts.map +1 -1
- package/dist/storage/directory-access.js +11 -36
- package/dist/storage/directory-access.js.map +1 -1
- package/dist/storage/encrypted-adapter.d.ts +12 -32
- package/dist/storage/encrypted-adapter.d.ts.map +1 -1
- package/dist/storage/encrypted-adapter.js +31 -54
- package/dist/storage/encrypted-adapter.js.map +1 -1
- package/dist/storage/folder-adapter.d.ts +12 -26
- package/dist/storage/folder-adapter.d.ts.map +1 -1
- package/dist/storage/folder-adapter.js +37 -54
- package/dist/storage/folder-adapter.js.map +1 -1
- package/dist/storage/folder-reconcile.d.ts +12 -26
- package/dist/storage/folder-reconcile.d.ts.map +1 -1
- package/dist/storage/folder-reconcile.js +39 -48
- package/dist/storage/folder-reconcile.js.map +1 -1
- package/dist/storage/indexeddb-adapter.d.ts +2 -6
- package/dist/storage/indexeddb-adapter.d.ts.map +1 -1
- package/dist/storage/indexeddb-adapter.js +60 -114
- package/dist/storage/indexeddb-adapter.js.map +1 -1
- package/dist/storage/mirror.d.ts +0 -29
- package/dist/storage/mirror.d.ts.map +1 -1
- package/dist/storage/mirror.js +153 -110
- package/dist/storage/mirror.js.map +1 -1
- package/dist/storage/segment.d.ts.map +1 -1
- package/dist/storage/segment.js +3 -7
- package/dist/storage/segment.js.map +1 -1
- package/dist/storage/storage-provider.d.ts +6 -11
- package/dist/storage/storage-provider.d.ts.map +1 -1
- package/dist/storage/storage-provider.js +112 -116
- package/dist/storage/storage-provider.js.map +1 -1
- package/dist/sync/sync-engine.d.ts +10 -44
- package/dist/sync/sync-engine.d.ts.map +1 -1
- package/dist/sync/sync-engine.js +245 -247
- package/dist/sync/sync-engine.js.map +1 -1
- package/dist/sync/sync-messages.d.ts +1 -1
- package/dist/sync/sync-messages.d.ts.map +1 -1
- package/dist/sync/sync-messages.js +1 -1
- package/dist/sync/sync-messages.js.map +1 -1
- package/dist/utils/guards.d.ts +1 -0
- package/dist/utils/guards.d.ts.map +1 -1
- package/dist/utils/guards.js +1 -0
- package/dist/utils/guards.js.map +1 -1
- package/dist/utils/hmac.d.ts +5 -0
- package/dist/utils/hmac.d.ts.map +1 -0
- package/dist/utils/hmac.js +20 -0
- package/dist/utils/hmac.js.map +1 -0
- package/dist/utils/map.d.ts +10 -0
- package/dist/utils/map.d.ts.map +1 -0
- package/dist/utils/map.js +30 -0
- package/dist/utils/map.js.map +1 -0
- package/dist/utils/serial.d.ts +2 -0
- package/dist/utils/serial.d.ts.map +1 -1
- package/dist/utils/serial.js +9 -0
- package/dist/utils/serial.js.map +1 -1
- package/dist/validation/capability-gate.d.ts +7 -15
- package/dist/validation/capability-gate.d.ts.map +1 -1
- package/dist/validation/capability-gate.js +32 -36
- package/dist/validation/capability-gate.js.map +1 -1
- package/dist/validation/crypto-gate.d.ts.map +1 -1
- package/dist/validation/crypto-gate.js +12 -21
- package/dist/validation/crypto-gate.js.map +1 -1
- package/docs/README.md +1 -0
- package/docs/actions.md +32 -25
- package/docs/agents.md +28 -16
- package/docs/automations.md +1 -1
- package/docs/blueprints-and-guides.md +37 -5
- package/docs/building-an-app.md +7 -4
- package/docs/collections.md +3 -3
- package/docs/contacts.md +34 -1
- package/docs/contracts.md +1 -1
- package/docs/direct-messages.md +6 -2
- package/docs/inbox.md +5 -11
- package/docs/node.md +54 -22
- package/docs/records-and-queries.md +1 -1
- package/docs/sign-in.md +54 -26
- package/docs/spaces.md +9 -8
- package/docs/standard-library.md +37 -14
- package/docs/storage.md +5 -6
- package/docs/usernames.md +161 -0
- package/docs/warrants.md +1 -1
- package/package.json +1 -2
|
@@ -0,0 +1,242 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @module node/space-membership
|
|
3
|
+
* Who may do what in a space, as this account changes it: roles, members,
|
|
4
|
+
* invites, keys revoked, relays and keepers. Every change is a record in the
|
|
5
|
+
* access history (`space-history.ts`), refused here, with the reason, when
|
|
6
|
+
* every peer would refuse it.
|
|
7
|
+
*/
|
|
8
|
+
import { SPACE_RELAYS_RECORD, SPACE_KEEPERS_RECORD, deriveInviteKey, generateInviteSecret, inviteKey as inviteRecordKey, assignKey, removalKey, revokeKey, roleKey, signInvite, stepDownKey, succeedKey, } from '../space/space-access.js';
|
|
9
|
+
import { isSpaceId } from '../space/constitution.js';
|
|
10
|
+
import { ASSIGN_COLLECTION, INVITE_COLLECTION, RELAYS_COLLECTION, checkRelays, KEEPERS_COLLECTION, checkKeepers, REMOVE_COLLECTION, REVOKE_COLLECTION, ROLE_COLLECTION, STEPDOWN_COLLECTION, SUCCEED_COLLECTION, headless, isMember, holdsRole, may, readers, rolesOf, } from '../space/roles.js';
|
|
11
|
+
import { checkFoundingRole, definitionBody } from '../space/grants.js';
|
|
12
|
+
import { base64UrlEncode } from '../utils/encoding.js';
|
|
13
|
+
import { withCutoff } from './space-lines.js';
|
|
14
|
+
export function createMembership(deps) {
|
|
15
|
+
const { record, provider, history, writing, peers } = deps;
|
|
16
|
+
const { space } = record;
|
|
17
|
+
const { access } = history;
|
|
18
|
+
const { upsert } = writing;
|
|
19
|
+
const { cutoffFor } = deps.lines;
|
|
20
|
+
const { currentKey, changeKeyNow } = deps.keys;
|
|
21
|
+
/**
|
|
22
|
+
* Assigns a role to an account, or with `assigned: false` takes it away:
|
|
23
|
+
* one's own, to leave it. Taking a role leaves what this node has seen
|
|
24
|
+
* them write in it standing.
|
|
25
|
+
*/
|
|
26
|
+
async function assign(did, role, assigned) {
|
|
27
|
+
const { history } = await access();
|
|
28
|
+
if (!history.current.roles.has(role))
|
|
29
|
+
throw new Error(`There is no role "${role}" in "${space.name}"`);
|
|
30
|
+
const takes = !assigned && rolesOf(history.current, did).includes(role);
|
|
31
|
+
const cutoff = takes ? await cutoffFor(did) : {};
|
|
32
|
+
const body = withCutoff({ did, role, assigned }, cutoff);
|
|
33
|
+
const written = await upsert(ASSIGN_COLLECTION, await assignKey(did, role), body);
|
|
34
|
+
await changeKeyNow();
|
|
35
|
+
return written;
|
|
36
|
+
}
|
|
37
|
+
/** Removes an account from the space, every role it holds with it: one's own, to leave */
|
|
38
|
+
async function removeAccount(did) {
|
|
39
|
+
const { history } = await access();
|
|
40
|
+
if (!isMember(history.current, did))
|
|
41
|
+
throw new Error(`They hold no place in "${space.name}"`);
|
|
42
|
+
const cutoff = await cutoffFor(did);
|
|
43
|
+
const written = await upsert(REMOVE_COLLECTION, await removalKey(did), withCutoff({ did }, cutoff));
|
|
44
|
+
await changeKeyNow();
|
|
45
|
+
return written;
|
|
46
|
+
}
|
|
47
|
+
return {
|
|
48
|
+
async setRelays(named) {
|
|
49
|
+
const problem = checkRelays(named);
|
|
50
|
+
if (problem)
|
|
51
|
+
throw new Error(problem);
|
|
52
|
+
await upsert(RELAYS_COLLECTION, SPACE_RELAYS_RECORD, { relays: [...named] });
|
|
53
|
+
},
|
|
54
|
+
async setKeepers(keepers, copies = null) {
|
|
55
|
+
const named = keepers.map((k) => ({ did: k.did, name: k.name }));
|
|
56
|
+
const problem = checkKeepers(named, copies);
|
|
57
|
+
if (problem)
|
|
58
|
+
throw new Error(problem);
|
|
59
|
+
await upsert(KEEPERS_COLLECTION, SPACE_KEEPERS_RECORD, { keepers: named, copies });
|
|
60
|
+
},
|
|
61
|
+
async access() {
|
|
62
|
+
const { history } = await access();
|
|
63
|
+
const state = history.current;
|
|
64
|
+
const members = [...readers(state)].sort();
|
|
65
|
+
return Object.freeze({
|
|
66
|
+
roles: [...state.roles]
|
|
67
|
+
.map(([name, definitions]) => ({
|
|
68
|
+
name,
|
|
69
|
+
...(definitions[0]?.title !== undefined ? { title: definitions[0].title } : {}),
|
|
70
|
+
definitions: definitions.map((definition) => ({
|
|
71
|
+
event: definition.event,
|
|
72
|
+
by: definition.by,
|
|
73
|
+
grants: definition.grants,
|
|
74
|
+
nests: definition.nests,
|
|
75
|
+
})),
|
|
76
|
+
}))
|
|
77
|
+
.sort((a, b) => a.name.localeCompare(b.name)),
|
|
78
|
+
members: members.map((did) => ({
|
|
79
|
+
did,
|
|
80
|
+
founder: state.founders.has(did),
|
|
81
|
+
roles: rolesOf(state, did),
|
|
82
|
+
})),
|
|
83
|
+
invites: [...state.invites].map(([inviteDid, invite]) => ({
|
|
84
|
+
key: inviteDid,
|
|
85
|
+
role: invite.role,
|
|
86
|
+
open: invite.open,
|
|
87
|
+
})),
|
|
88
|
+
founder: state.founders.has(deps.rootDid),
|
|
89
|
+
top: space.top === 'none' ? 'none' : 'founders',
|
|
90
|
+
headless: headless(state),
|
|
91
|
+
successors: [...state.successors].map(([successor, by]) => ({ space: successor, by })),
|
|
92
|
+
mine: rolesOf(state, deps.rootDid),
|
|
93
|
+
heads: history.heads(),
|
|
94
|
+
key: state.keys.length ? { changes: state.keys.length - 1, held: currentKey(state) !== null } : null,
|
|
95
|
+
relays: state.relays.length ? state.relays : deps.meeting.relays(),
|
|
96
|
+
keepers: state.keepers,
|
|
97
|
+
copies: state.copies,
|
|
98
|
+
forks: history.forks(),
|
|
99
|
+
flagged: await deps.flagged(),
|
|
100
|
+
});
|
|
101
|
+
},
|
|
102
|
+
/** Whether this account, or another, may invoke a command with these arguments, now */
|
|
103
|
+
async may(cmd, args = {}, account = deps.rootDid) {
|
|
104
|
+
return may((await access()).history.current, account, cmd, args);
|
|
105
|
+
},
|
|
106
|
+
/** Whether this account, or another, holds every grant a role gives, as wide or wider, now */
|
|
107
|
+
async holdsRole(role, account = deps.rootDid) {
|
|
108
|
+
return holdsRole((await access()).history.current, account, role);
|
|
109
|
+
},
|
|
110
|
+
async assign(did, role) {
|
|
111
|
+
await assign(did, role, true);
|
|
112
|
+
},
|
|
113
|
+
async unassign(did, role) {
|
|
114
|
+
await assign(did, role, false);
|
|
115
|
+
},
|
|
116
|
+
async removeMember(did) {
|
|
117
|
+
await removeAccount(did);
|
|
118
|
+
},
|
|
119
|
+
/** Stops being a founder, keeping the roles held, and `keep` first when given */
|
|
120
|
+
async stepDown(keep) {
|
|
121
|
+
const { history } = await access();
|
|
122
|
+
if (!history.current.founders.has(deps.rootDid))
|
|
123
|
+
throw new Error(`You are not a founder of "${space.name}"`);
|
|
124
|
+
if (keep !== undefined && !rolesOf(history.current, deps.rootDid).includes(keep))
|
|
125
|
+
await assign(deps.rootDid, keep, true);
|
|
126
|
+
if (rolesOf((await access()).history.current, deps.rootDid).length === 0)
|
|
127
|
+
throw new Error(`You hold no role in "${space.name}", so stepping down would leave it: keep a role, or leave`);
|
|
128
|
+
const cutoff = await cutoffFor(deps.rootDid);
|
|
129
|
+
const body = withCutoff({ did: deps.rootDid }, cutoff);
|
|
130
|
+
await upsert(STEPDOWN_COLLECTION, await stepDownKey(deps.rootDid), body);
|
|
131
|
+
},
|
|
132
|
+
/** Names a space that succeeds this one. It changes nothing here */
|
|
133
|
+
async succeed(successor) {
|
|
134
|
+
if (!isSpaceId(successor) || successor === space.id)
|
|
135
|
+
throw new Error('A successor is named by its space id');
|
|
136
|
+
// Refused here, with the reason, when this account may not: as every peer would.
|
|
137
|
+
await upsert(SUCCEED_COLLECTION, await succeedKey(successor), { space: successor });
|
|
138
|
+
},
|
|
139
|
+
/**
|
|
140
|
+
* Gives up this account's place before it forgets the space: its own
|
|
141
|
+
* member record with no role, so the others stop counting it a reader and
|
|
142
|
+
* a key change becomes due. Nothing sends the removal once the space is
|
|
143
|
+
* closed, so this waits up to `waitMs` for a peer of another account to
|
|
144
|
+
* say it has it. False when it couldn't be written, or nobody took it in
|
|
145
|
+
* time.
|
|
146
|
+
*/
|
|
147
|
+
async giveUpPlace(waitMs) {
|
|
148
|
+
const state = (await access()).history.current;
|
|
149
|
+
// Shared to view, or already gone: there is nothing to remove.
|
|
150
|
+
if (!isMember(state, deps.rootDid))
|
|
151
|
+
return true;
|
|
152
|
+
// Nobody else holds a place, so nobody else needs to know.
|
|
153
|
+
if ([...readers(state)].every((did) => did === deps.rootDid))
|
|
154
|
+
return true;
|
|
155
|
+
try {
|
|
156
|
+
return await peers.writeUntilStored(async () => (await removeAccount(deps.rootDid)).version, {
|
|
157
|
+
waitMs,
|
|
158
|
+
othersOnly: true,
|
|
159
|
+
reachable: true,
|
|
160
|
+
});
|
|
161
|
+
}
|
|
162
|
+
catch {
|
|
163
|
+
// A note that may not change access; another of the account's devices can.
|
|
164
|
+
return false;
|
|
165
|
+
}
|
|
166
|
+
},
|
|
167
|
+
/** Writes a role's definition: its grants, issued by this account, and the roles it nests */
|
|
168
|
+
async defineRole(role) {
|
|
169
|
+
const problem = checkFoundingRole(role);
|
|
170
|
+
if (problem)
|
|
171
|
+
throw new Error(problem);
|
|
172
|
+
const nonce = () => base64UrlEncode(globalThis.crypto.getRandomValues(new Uint8Array(12)));
|
|
173
|
+
await upsert(ROLE_COLLECTION, roleKey(role.name), definitionBody(role, { root: deps.rootDid, spaceId: space.id }, nonce));
|
|
174
|
+
},
|
|
175
|
+
/** Opens an invite to a role, with its own fresh secret unless a short link's gives it one */
|
|
176
|
+
async openInvite(role, secret = generateInviteSecret()) {
|
|
177
|
+
const pair = await deriveInviteKey(secret, provider);
|
|
178
|
+
await upsert(INVITE_COLLECTION, await inviteRecordKey(pair.did), { key: pair.did, role, open: true });
|
|
179
|
+
return { secret, key: pair.did };
|
|
180
|
+
},
|
|
181
|
+
async closeInvite(inviteDid) {
|
|
182
|
+
const { history } = await access();
|
|
183
|
+
const invite = history.current.invites.get(inviteDid);
|
|
184
|
+
if (!invite)
|
|
185
|
+
throw new Error('There is no such invite in this space');
|
|
186
|
+
// Who joined with it before this node closed it stays: the close names what it saw, and the replay does the rest.
|
|
187
|
+
await upsert(INVITE_COLLECTION, await inviteRecordKey(inviteDid), {
|
|
188
|
+
key: inviteDid,
|
|
189
|
+
role: invite.role,
|
|
190
|
+
open: false,
|
|
191
|
+
});
|
|
192
|
+
},
|
|
193
|
+
/**
|
|
194
|
+
* Revokes a key of this account's. With `waitMs`, it then waits up to that
|
|
195
|
+
* long for a peer to say it has the revoke: a device about to stop sends
|
|
196
|
+
* nothing after, so true means it left. A node with no network configured
|
|
197
|
+
* can't send it anywhere, so false at once. Without, true once written.
|
|
198
|
+
*/
|
|
199
|
+
async revoke(key, options = {}) {
|
|
200
|
+
const waitMs = options.waitMs ?? 0;
|
|
201
|
+
const write = async () => {
|
|
202
|
+
const cutoff = await cutoffFor(deps.rootDid, key);
|
|
203
|
+
const body = withCutoff({ key }, cutoff);
|
|
204
|
+
return (await upsert(REVOKE_COLLECTION, await revokeKey(key, deps.rootDid), body)).version;
|
|
205
|
+
};
|
|
206
|
+
if (waitMs <= 0) {
|
|
207
|
+
await write();
|
|
208
|
+
return true;
|
|
209
|
+
}
|
|
210
|
+
// With a network configured a peer may still be on its way, through a socket not yet
|
|
211
|
+
// joined or a host not yet reached; with none, nobody can come.
|
|
212
|
+
return peers.writeUntilStored(write, { waitMs, othersOnly: false, reachable: deps.networked });
|
|
213
|
+
},
|
|
214
|
+
async isRevoked(key) {
|
|
215
|
+
return (await access()).history.revoked(key, deps.rootDid).length > 0;
|
|
216
|
+
},
|
|
217
|
+
/** Uses an invite's secret, once its record has arrived. True when this account is a member. */
|
|
218
|
+
async join(secret) {
|
|
219
|
+
const { history } = await access();
|
|
220
|
+
const pair = await deriveInviteKey(secret, provider);
|
|
221
|
+
const invite = history.current.invites.get(pair.did);
|
|
222
|
+
if (isMember(history.current, deps.rootDid) &&
|
|
223
|
+
(!invite || rolesOf(history.current, deps.rootDid).includes(invite.role))) {
|
|
224
|
+
writing.joined();
|
|
225
|
+
deps.onJoined?.();
|
|
226
|
+
return true;
|
|
227
|
+
}
|
|
228
|
+
if (!invite?.open)
|
|
229
|
+
return false;
|
|
230
|
+
await upsert(ASSIGN_COLLECTION, await assignKey(deps.rootDid, invite.role), {
|
|
231
|
+
did: deps.rootDid,
|
|
232
|
+
role: invite.role,
|
|
233
|
+
assigned: true,
|
|
234
|
+
invite: { key: pair.did, signature: await signInvite(space.id, deps.rootDid, pair, provider) },
|
|
235
|
+
}, { joining: true });
|
|
236
|
+
writing.joined();
|
|
237
|
+
deps.onJoined?.();
|
|
238
|
+
return true;
|
|
239
|
+
},
|
|
240
|
+
};
|
|
241
|
+
}
|
|
242
|
+
//# sourceMappingURL=space-membership.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"space-membership.js","sourceRoot":"","sources":["../../src/node/space-membership.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @module node/space-mirrors
|
|
3
|
+
* The copies of a space beside its own store: file stores (`storage/mirror.ts`),
|
|
4
|
+
* the data folder, and other tabs of the same browser.
|
|
5
|
+
*
|
|
6
|
+
* Every mirror is one more peer: what it holds goes through the same gates
|
|
7
|
+
* as a peer's records, and what this node holds goes out to it. A data
|
|
8
|
+
* folder is written by other apps, and by other devices behind whatever
|
|
9
|
+
* syncs it; a directory store by another process (a command beside a
|
|
10
|
+
* daemon). Nothing announces either, so both are looked for.
|
|
11
|
+
*/
|
|
12
|
+
import type { StorageAdapter, Version } from '../types.js';
|
|
13
|
+
import type { BlobStore } from '../storage/blob-store.js';
|
|
14
|
+
import type { StoreFactory } from './stores.js';
|
|
15
|
+
import { type Standing, type SpaceBase } from './space-versions.js';
|
|
16
|
+
export interface MirrorsDeps extends SpaceBase {
|
|
17
|
+
readonly stores: StoreFactory;
|
|
18
|
+
readonly adapter: StorageAdapter;
|
|
19
|
+
readonly mirrors: ReadonlyArray<BlobStore> | undefined;
|
|
20
|
+
readonly watchIntervalMs: number;
|
|
21
|
+
/** Whether a version from outside may be stored, as for a peer's */
|
|
22
|
+
readonly admit: (version: Version) => Promise<Standing>;
|
|
23
|
+
readonly recordsChanged: () => void;
|
|
24
|
+
/** Tells the peers this node took in something new */
|
|
25
|
+
readonly announceSoon: () => void;
|
|
26
|
+
}
|
|
27
|
+
export declare function openMirrors(deps: MirrorsDeps): Promise<{
|
|
28
|
+
/** Every mirror's store and writer, for files */
|
|
29
|
+
all: () => {
|
|
30
|
+
store: BlobStore;
|
|
31
|
+
writer: string;
|
|
32
|
+
}[];
|
|
33
|
+
pull: () => Promise<void[]>;
|
|
34
|
+
watch: () => void;
|
|
35
|
+
/** Records changed here: soon written to every mirror */
|
|
36
|
+
changed(): void;
|
|
37
|
+
/** Tells the other tabs a write landed in the store they share */
|
|
38
|
+
tellTabs(): void;
|
|
39
|
+
/** What this device holds and the folder lacks (copied in, or written before the folder was) goes out soon */
|
|
40
|
+
fillFolder(): void;
|
|
41
|
+
close(): Promise<void>;
|
|
42
|
+
}>;
|
|
43
|
+
//# sourceMappingURL=space-mirrors.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"space-mirrors.d.ts","sourceRoot":"","sources":["../../src/node/space-mirrors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAG1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EAAE,KAAK,QAAQ,EAAY,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAE9E,MAAM,WAAW,WAAY,SAAQ,SAAS;IAC5C,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC;IACvD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,oEAAoE;IACpE,QAAQ,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IACxD,QAAQ,CAAC,cAAc,EAAE,MAAM,IAAI,CAAC;IACpC,sDAAsD;IACtD,QAAQ,CAAC,YAAY,EAAE,MAAM,IAAI,CAAC;CACnC;AAKD,wBAAsB,WAAW,CAAC,IAAI,EAAE,WAAW;IAmG/C,iDAAiD;;;;;;iBAnCjC,IAAI;IAuCpB,yDAAyD;eAC9C,IAAI;IAGf,kEAAkE;gBACtD,IAAI;IAGhB,8GAA8G;kBAChG,IAAI;aAGH,OAAO,CAAC,IAAI,CAAC;GAM/B"}
|
|
@@ -0,0 +1,125 @@
|
|
|
1
|
+
import { reconcileFolder } from '../storage/folder-reconcile.js';
|
|
2
|
+
import { createMirror } from '../storage/mirror.js';
|
|
3
|
+
import { unref } from '../utils/guards.js';
|
|
4
|
+
import { storable } from './space-versions.js';
|
|
5
|
+
const isFolderAdapter = (adapter) => 'reload' in adapter && typeof adapter.reload === 'function';
|
|
6
|
+
export async function openMirrors(deps) {
|
|
7
|
+
const { space, storage, adapter, admit, recordsChanged, announceSoon } = deps;
|
|
8
|
+
const fromMirror = async (version) => {
|
|
9
|
+
const verdict = await admit(version);
|
|
10
|
+
if (!verdict.ok && !verdict.withdrawn)
|
|
11
|
+
return verdict.later ? 'later' : 'refused';
|
|
12
|
+
await storage.addVersion(version);
|
|
13
|
+
return 'stored';
|
|
14
|
+
};
|
|
15
|
+
const mirrors = [];
|
|
16
|
+
for (const [index, store] of (deps.mirrors ?? []).entries()) {
|
|
17
|
+
mirrors.push(await createMirror({
|
|
18
|
+
store,
|
|
19
|
+
space: space.id,
|
|
20
|
+
storage,
|
|
21
|
+
state: await deps.stores(`mirrors/${space.id}/${index}`),
|
|
22
|
+
accept: fromMirror,
|
|
23
|
+
}));
|
|
24
|
+
}
|
|
25
|
+
// A data folder is one more: its spaces are segments, like a bucket's, and
|
|
26
|
+
// what this device holds of them is its own (`node/stores.ts`).
|
|
27
|
+
const folderMirror = deps.stores.folder
|
|
28
|
+
? await createMirror({
|
|
29
|
+
store: deps.stores.folder,
|
|
30
|
+
space: space.id,
|
|
31
|
+
storage,
|
|
32
|
+
state: await deps.stores(`folder/${space.id}`),
|
|
33
|
+
accept: fromMirror,
|
|
34
|
+
// Apps and the CLI on one computer meet through the folder: soon, not in a bucket's time.
|
|
35
|
+
flushMs: 1000,
|
|
36
|
+
})
|
|
37
|
+
: null;
|
|
38
|
+
if (folderMirror)
|
|
39
|
+
mirrors.push(folderMirror);
|
|
40
|
+
/** Reads every mirror in the background: a space that opens from nothing — a host that lost its disk — fills in as it goes */
|
|
41
|
+
const pullMirrors = () => Promise.all(mirrors.map((mirror) => mirror
|
|
42
|
+
.pull()
|
|
43
|
+
.then(({ added }) => {
|
|
44
|
+
if (added === 0)
|
|
45
|
+
return;
|
|
46
|
+
recordsChanged();
|
|
47
|
+
announceSoon();
|
|
48
|
+
})
|
|
49
|
+
.catch(() => {
|
|
50
|
+
// Out of reach now; what this node holds goes out on the next change.
|
|
51
|
+
})));
|
|
52
|
+
const look = async () => {
|
|
53
|
+
// The same verdict as for a version from a peer.
|
|
54
|
+
const reconciled = isFolderAdapter(adapter)
|
|
55
|
+
? (await reconcileFolder(storage, adapter, async (version) => storable(await admit(version)))).changed
|
|
56
|
+
: false;
|
|
57
|
+
const pulled = folderMirror ? (await folderMirror.pull()).added > 0 : false;
|
|
58
|
+
return reconciled || pulled;
|
|
59
|
+
};
|
|
60
|
+
let watchTimer = null;
|
|
61
|
+
let channel = null;
|
|
62
|
+
/** Looks for what other writers changed, from now on */
|
|
63
|
+
function watch() {
|
|
64
|
+
if (deps.watchIntervalMs > 0 && (folderMirror || isFolderAdapter(adapter))) {
|
|
65
|
+
let running = false;
|
|
66
|
+
watchTimer = setInterval(() => {
|
|
67
|
+
if (running)
|
|
68
|
+
return;
|
|
69
|
+
running = true;
|
|
70
|
+
look()
|
|
71
|
+
.then((changed) => {
|
|
72
|
+
if (!changed)
|
|
73
|
+
return;
|
|
74
|
+
recordsChanged();
|
|
75
|
+
announceSoon();
|
|
76
|
+
})
|
|
77
|
+
.catch(() => {
|
|
78
|
+
// A revoked permission or a folder that went away; the next pass will tell.
|
|
79
|
+
})
|
|
80
|
+
.finally(() => {
|
|
81
|
+
running = false;
|
|
82
|
+
});
|
|
83
|
+
}, deps.watchIntervalMs);
|
|
84
|
+
}
|
|
85
|
+
// Tabs of one browser share one IndexedDB but not memory, so a write in one
|
|
86
|
+
// is invisible to the other until it is told. A nudge is enough: the store
|
|
87
|
+
// already holds the data.
|
|
88
|
+
if (typeof globalThis.BroadcastChannel !== 'function')
|
|
89
|
+
return;
|
|
90
|
+
channel = new globalThis.BroadcastChannel(`minca-node:${deps.rootDid}:${space.id}`);
|
|
91
|
+
channel.onmessage = () => {
|
|
92
|
+
// The other tab wrote to the store underneath: what sync compares is read again.
|
|
93
|
+
storage.invalidate();
|
|
94
|
+
recordsChanged();
|
|
95
|
+
};
|
|
96
|
+
// In Node a channel holds the process open; it must never be the only thing doing so.
|
|
97
|
+
unref(channel);
|
|
98
|
+
}
|
|
99
|
+
return {
|
|
100
|
+
/** Every mirror's store and writer, for files */
|
|
101
|
+
all: () => mirrors.map((mirror) => ({ store: mirror.store, writer: mirror.writer })),
|
|
102
|
+
pull: pullMirrors,
|
|
103
|
+
watch,
|
|
104
|
+
/** Records changed here: soon written to every mirror */
|
|
105
|
+
changed() {
|
|
106
|
+
for (const mirror of mirrors)
|
|
107
|
+
mirror.changed();
|
|
108
|
+
},
|
|
109
|
+
/** Tells the other tabs a write landed in the store they share */
|
|
110
|
+
tellTabs() {
|
|
111
|
+
channel?.postMessage('changed');
|
|
112
|
+
},
|
|
113
|
+
/** What this device holds and the folder lacks (copied in, or written before the folder was) goes out soon */
|
|
114
|
+
fillFolder() {
|
|
115
|
+
folderMirror?.changed();
|
|
116
|
+
},
|
|
117
|
+
async close() {
|
|
118
|
+
await Promise.all(mirrors.map((mirror) => mirror.close()));
|
|
119
|
+
if (watchTimer)
|
|
120
|
+
clearInterval(watchTimer);
|
|
121
|
+
channel?.close();
|
|
122
|
+
},
|
|
123
|
+
};
|
|
124
|
+
}
|
|
125
|
+
//# sourceMappingURL=space-mirrors.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"space-mirrors.js","sourceRoot":"","sources":["../../src/node/space-mirrors.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEjE,OAAO,EAAE,YAAY,EAA2B,MAAM,sBAAsB,CAAC;AAG7E,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAiB,QAAQ,EAAkB,MAAM,qBAAqB,CAAC;AAc9E,MAAM,eAAe,GAAG,CAAC,OAAuB,EAA4B,EAAE,CAC5E,QAAQ,IAAI,OAAO,IAAI,OAAO,OAAO,CAAC,MAAM,KAAK,UAAU,CAAC;AAE9D,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAiB;IACjD,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;IAE9E,MAAM,UAAU,GAAG,KAAK,EAAE,OAAgB,EAAkB,EAAE;QAC5D,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS;YAAE,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;QAClF,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAClC,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC;IACF,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;QAC5D,OAAO,CAAC,IAAI,CACV,MAAM,YAAY,CAAC;YACjB,KAAK;YACL,KAAK,EAAE,KAAK,CAAC,EAAE;YACf,OAAO;YACP,KAAK,EAAE,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,KAAK,CAAC,EAAE,IAAI,KAAK,EAAE,CAAC;YACxD,MAAM,EAAE,UAAU;SACnB,CAAC,CACH,CAAC;IACJ,CAAC;IACD,2EAA2E;IAC3E,gEAAgE;IAChE,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM;QACrC,CAAC,CAAC,MAAM,YAAY,CAAC;YACjB,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;YACzB,KAAK,EAAE,KAAK,CAAC,EAAE;YACf,OAAO;YACP,KAAK,EAAE,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,KAAK,CAAC,EAAE,EAAE,CAAC;YAC9C,MAAM,EAAE,UAAU;YAClB,0FAA0F;YAC1F,OAAO,EAAE,IAAI;SACd,CAAC;QACJ,CAAC,CAAC,IAAI,CAAC;IACT,IAAI,YAAY;QAAE,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC7C,8HAA8H;IAC9H,MAAM,WAAW,GAAG,GAAG,EAAE,CACvB,OAAO,CAAC,GAAG,CACT,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CACrB,MAAM;SACH,IAAI,EAAE;SACN,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE;QAClB,IAAI,KAAK,KAAK,CAAC;YAAE,OAAO;QACxB,cAAc,EAAE,CAAC;QACjB,YAAY,EAAE,CAAC;IACjB,CAAC,CAAC;SACD,KAAK,CAAC,GAAG,EAAE;QACV,sEAAsE;IACxE,CAAC,CAAC,CACL,CACF,CAAC;IAEJ,MAAM,IAAI,GAAG,KAAK,IAAsB,EAAE;QACxC,iDAAiD;QACjD,MAAM,UAAU,GAAG,eAAe,CAAC,OAAO,CAAC;YACzC,CAAC,CAAC,CAAC,MAAM,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO;YACtG,CAAC,CAAC,KAAK,CAAC;QACV,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,MAAM,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QAC5E,OAAO,UAAU,IAAI,MAAM,CAAC;IAC9B,CAAC,CAAC;IACF,IAAI,UAAU,GAA0C,IAAI,CAAC;IAC7D,IAAI,OAAO,GAA4B,IAAI,CAAC;IAE5C,wDAAwD;IACxD,SAAS,KAAK;QACZ,IAAI,IAAI,CAAC,eAAe,GAAG,CAAC,IAAI,CAAC,YAAY,IAAI,eAAe,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;YAC3E,IAAI,OAAO,GAAG,KAAK,CAAC;YACpB,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE;gBAC5B,IAAI,OAAO;oBAAE,OAAO;gBACpB,OAAO,GAAG,IAAI,CAAC;gBACf,IAAI,EAAE;qBACH,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE;oBAChB,IAAI,CAAC,OAAO;wBAAE,OAAO;oBACrB,cAAc,EAAE,CAAC;oBACjB,YAAY,EAAE,CAAC;gBACjB,CAAC,CAAC;qBACD,KAAK,CAAC,GAAG,EAAE;oBACV,4EAA4E;gBAC9E,CAAC,CAAC;qBACD,OAAO,CAAC,GAAG,EAAE;oBACZ,OAAO,GAAG,KAAK,CAAC;gBAClB,CAAC,CAAC,CAAC;YACP,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;QAC3B,CAAC;QACD,4EAA4E;QAC5E,2EAA2E;QAC3E,0BAA0B;QAC1B,IAAI,OAAO,UAAU,CAAC,gBAAgB,KAAK,UAAU;YAAE,OAAO;QAC9D,OAAO,GAAG,IAAI,UAAU,CAAC,gBAAgB,CAAC,cAAc,IAAI,CAAC,OAAO,IAAI,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;QACpF,OAAO,CAAC,SAAS,GAAG,GAAG,EAAE;YACvB,iFAAiF;YACjF,OAAO,CAAC,UAAU,EAAE,CAAC;YACrB,cAAc,EAAE,CAAC;QACnB,CAAC,CAAC;QACF,sFAAsF;QACtF,KAAK,CAAC,OAAO,CAAC,CAAC;IACjB,CAAC;IAED,OAAO;QACL,iDAAiD;QACjD,GAAG,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QACpF,IAAI,EAAE,WAAW;QACjB,KAAK;QACL,yDAAyD;QACzD,OAAO;YACL,KAAK,MAAM,MAAM,IAAI,OAAO;gBAAE,MAAM,CAAC,OAAO,EAAE,CAAC;QACjD,CAAC;QACD,kEAAkE;QAClE,QAAQ;YACN,OAAO,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;QAClC,CAAC;QACD,8GAA8G;QAC9G,UAAU;YACR,YAAY,EAAE,OAAO,EAAE,CAAC;QAC1B,CAAC;QACD,KAAK,CAAC,KAAK;YACT,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YAC3D,IAAI,UAAU;gBAAE,aAAa,CAAC,UAAU,CAAC,CAAC;YAC1C,OAAO,EAAE,KAAK,EAAE,CAAC;QACnB,CAAC;KACF,CAAC;AACJ,CAAC"}
|
|
@@ -0,0 +1,104 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @module node/space-peers
|
|
3
|
+
* The peers of one open space: the networks it meets them on, who is at the
|
|
4
|
+
* other end of each connection, sync, and live messages.
|
|
5
|
+
*
|
|
6
|
+
* A space is the unit of sync — its own rooms and sockets — so a peer you
|
|
7
|
+
* share one space with learns nothing about the others.
|
|
8
|
+
*/
|
|
9
|
+
import type { NetworkMessage, Version } from '../types.js';
|
|
10
|
+
import type { SpaceRecord } from '../space/space-manager.js';
|
|
11
|
+
import { type NetworkManager } from '../network/network-manager.js';
|
|
12
|
+
import { type Mesh } from '../network/mesh.js';
|
|
13
|
+
import { type MeshAuth, type ReadAccess } from '../network/peer-auth.js';
|
|
14
|
+
import { type AccessState } from '../space/roles.js';
|
|
15
|
+
import { type Holds } from '../sync/sync-engine.js';
|
|
16
|
+
import type { SpaceFiles } from '../files/space-files.js';
|
|
17
|
+
import type { ConnectionState, NodeEvent, NodeNetworkConfig } from './types.js';
|
|
18
|
+
import type { Standing, SpaceBase } from './space-versions.js';
|
|
19
|
+
import type { History } from './space-history.js';
|
|
20
|
+
import type { Keys } from './space-keys.js';
|
|
21
|
+
/**
|
|
22
|
+
* The room a space's peers meet in on a relay. A hash of the space's id, so a
|
|
23
|
+
* relay learns which connections belong together but not which space they are.
|
|
24
|
+
*/
|
|
25
|
+
export declare function relayRoom(spaceId: string): Promise<string>;
|
|
26
|
+
/** The one mesh a node's spaces share, when it has relays to meet on */
|
|
27
|
+
export declare function meshFor(network: NodeNetworkConfig | undefined, session: {
|
|
28
|
+
readonly did: string;
|
|
29
|
+
readonly key: CryptoKey;
|
|
30
|
+
}): Mesh | undefined;
|
|
31
|
+
/** The relays a node was configured with that a space may name */
|
|
32
|
+
export declare const usableRelays: (network: NodeNetworkConfig | undefined) => string[];
|
|
33
|
+
/**
|
|
34
|
+
* Where the members meet, and the read key a reader must prove now: both
|
|
35
|
+
* follow the access history, and a handshake asks for them without waiting.
|
|
36
|
+
*/
|
|
37
|
+
export declare function createMeeting(record: SpaceRecord, mesh: Mesh | undefined, onRelays?: (relays: ReadonlyArray<string>) => Promise<void>): {
|
|
38
|
+
relays: () => readonly string[];
|
|
39
|
+
readKey: () => string;
|
|
40
|
+
/** The access history was read anew */
|
|
41
|
+
heard(state: AccessState): void;
|
|
42
|
+
/** Joins the space's room on the mesh, with the relays it meets on */
|
|
43
|
+
join(mesh: Mesh, auth: MeshAuth): Promise<NetworkManager>;
|
|
44
|
+
};
|
|
45
|
+
type Meeting = ReturnType<typeof createMeeting>;
|
|
46
|
+
export interface PeersDeps extends SpaceBase {
|
|
47
|
+
readonly network: NodeNetworkConfig | undefined;
|
|
48
|
+
readonly mesh: Mesh | undefined;
|
|
49
|
+
readonly meeting: Meeting;
|
|
50
|
+
readonly history: History;
|
|
51
|
+
readonly keys: Keys;
|
|
52
|
+
readonly holds: () => Holds;
|
|
53
|
+
readonly files: SpaceFiles;
|
|
54
|
+
readonly emit: (event: NodeEvent) => void;
|
|
55
|
+
readonly statusChanged: () => void;
|
|
56
|
+
readonly admit: (version: Version) => Promise<Standing>;
|
|
57
|
+
readonly recordsChanged: (placed?: ReadonlyArray<Version>) => void;
|
|
58
|
+
readonly filesChanged: () => void;
|
|
59
|
+
readonly onArrived: ((version: Version) => void) | undefined;
|
|
60
|
+
}
|
|
61
|
+
export declare function openPeers(deps: PeersDeps): Promise<{
|
|
62
|
+
sync: import("../index.js").SyncEngine;
|
|
63
|
+
readAccess: ReadAccess | null;
|
|
64
|
+
connectedPeers: () => string[];
|
|
65
|
+
letGoOfOutsiders: () => Promise<void>;
|
|
66
|
+
announceSoon: () => void;
|
|
67
|
+
send: (message: unknown, to?: string) => Promise<void>;
|
|
68
|
+
writeUntilStored: (write: () => Promise<string>, options: {
|
|
69
|
+
readonly waitMs: number;
|
|
70
|
+
readonly othersOnly: boolean;
|
|
71
|
+
readonly reachable: boolean;
|
|
72
|
+
}) => Promise<boolean>;
|
|
73
|
+
/** Sends a message to a peer, the way it was met */
|
|
74
|
+
toPeer(peer: string, message: NetworkMessage): void;
|
|
75
|
+
/** Starts every network */
|
|
76
|
+
connect(): void;
|
|
77
|
+
/** How this space connects, who is connected, and what they sent that was refused */
|
|
78
|
+
status: () => {
|
|
79
|
+
connection: ConnectionState;
|
|
80
|
+
peers: string[];
|
|
81
|
+
accounts: {
|
|
82
|
+
[k: string]: string;
|
|
83
|
+
};
|
|
84
|
+
rejected: number;
|
|
85
|
+
};
|
|
86
|
+
/**
|
|
87
|
+
* Waits up to `waitMs` for this node to be level with `peer` here: nothing
|
|
88
|
+
* left in flight either way, so the peer holds everything this node does.
|
|
89
|
+
* False when that long passed first.
|
|
90
|
+
*/
|
|
91
|
+
syncedWith: (peer: string, waitMs: number) => Promise<boolean>;
|
|
92
|
+
/**
|
|
93
|
+
* Always-on nodes to hold a socket to besides those configured: the hosts
|
|
94
|
+
* the account or the space uses. Sockets to any given before and not now
|
|
95
|
+
* are closed.
|
|
96
|
+
*/
|
|
97
|
+
useNodes: (nodes: ReadonlyArray<string>) => void;
|
|
98
|
+
/** Stops telling of relays coming and going */
|
|
99
|
+
quiet(): void;
|
|
100
|
+
close(): void;
|
|
101
|
+
}>;
|
|
102
|
+
export type Peers = Awaited<ReturnType<typeof openPeers>>;
|
|
103
|
+
export {};
|
|
104
|
+
//# sourceMappingURL=space-peers.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"space-peers.d.ts","sourceRoot":"","sources":["../../src/node/space-peers.ts"],"names":[],"mappings":"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"}
|