@open-e2ee/signal-protocol-sdk 2.0.2 → 4.0.0
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/ADAPTERS.md +14 -21
- package/ARCHITECTURE.md +1 -2
- package/CHANGELOG.md +90 -0
- package/LICENSE +11 -655
- package/LICENSE-APACHE +201 -0
- package/LICENSE-MIT +21 -0
- package/NOTICE +5 -7
- package/README.md +11 -11
- package/SECURITY.md +2 -2
- package/TROUBLESHOOTING.md +6 -10
- package/client/README.md +36 -18
- package/device/README.md +1 -1
- package/dist/blocking/manager.d.ts +2 -2
- package/dist/blocking/manager.d.ts.map +1 -1
- package/dist/blocking/manager.js.map +1 -1
- package/dist/client/client.d.ts +45 -34
- package/dist/client/client.d.ts.map +1 -1
- package/dist/client/client.js +178 -115
- package/dist/client/client.js.map +1 -1
- package/dist/client/compose.d.ts +7 -7
- package/dist/client/compose.d.ts.map +1 -1
- package/dist/client/compose.js +2 -2
- package/dist/client/compose.js.map +1 -1
- package/dist/client/config.d.ts +24 -28
- package/dist/client/config.d.ts.map +1 -1
- package/dist/client/config.js.map +1 -1
- package/dist/client/content-adapter.d.ts +2 -0
- package/dist/client/content-adapter.d.ts.map +1 -1
- package/dist/client/content-adapter.js +4 -0
- package/dist/client/content-adapter.js.map +1 -1
- package/dist/client/dual-store.d.ts +5 -5
- package/dist/client/dual-store.d.ts.map +1 -1
- package/dist/client/dual-store.js.map +1 -1
- package/dist/client/endorsement-manager.d.ts +6 -3
- package/dist/client/endorsement-manager.d.ts.map +1 -1
- package/dist/client/endorsement-manager.js +14 -6
- package/dist/client/endorsement-manager.js.map +1 -1
- package/dist/client/files.d.ts +1 -1
- package/dist/client/files.js +1 -1
- package/dist/client/group-authority.d.ts +8 -0
- package/dist/client/group-authority.d.ts.map +1 -0
- package/dist/client/group-authority.js +2 -0
- package/dist/client/group-authority.js.map +1 -0
- package/dist/client/group-outbox.d.ts +4 -4
- package/dist/client/group-outbox.d.ts.map +1 -1
- package/dist/client/group-sealed-sender.d.ts +2 -2
- package/dist/client/group-sealed-sender.d.ts.map +1 -1
- package/dist/client/groups.d.ts +1 -1
- package/dist/client/groups.js +1 -1
- package/dist/client/headless.d.ts +11 -16
- package/dist/client/headless.d.ts.map +1 -1
- package/dist/client/headless.js +4 -9
- package/dist/client/headless.js.map +1 -1
- package/dist/client/hosted-anonymous-delivery.d.ts +32 -0
- package/dist/client/hosted-anonymous-delivery.d.ts.map +1 -0
- package/dist/client/hosted-anonymous-delivery.js +239 -0
- package/dist/client/hosted-anonymous-delivery.js.map +1 -0
- package/dist/client/hosted-connection.d.ts +1 -1
- package/dist/client/hosted-connection.d.ts.map +1 -1
- package/dist/client/hosted-connection.js +18 -51
- package/dist/client/hosted-connection.js.map +1 -1
- package/dist/client/hosted-group-authority.d.ts +11 -0
- package/dist/client/hosted-group-authority.d.ts.map +1 -0
- package/dist/client/hosted-group-authority.js +96 -0
- package/dist/client/hosted-group-authority.js.map +1 -0
- package/dist/client/hosted-groups.d.ts +31 -0
- package/dist/client/hosted-groups.d.ts.map +1 -0
- package/dist/client/hosted-groups.js +217 -0
- package/dist/client/hosted-groups.js.map +1 -0
- package/dist/client/hosted-mailbox-subscription.d.ts +34 -0
- package/dist/client/hosted-mailbox-subscription.d.ts.map +1 -0
- package/dist/client/hosted-mailbox-subscription.js +257 -0
- package/dist/client/hosted-mailbox-subscription.js.map +1 -0
- package/dist/client/hosted-prekey-publication.d.ts +51 -0
- package/dist/client/hosted-prekey-publication.d.ts.map +1 -0
- package/dist/client/hosted-prekey-publication.js +249 -0
- package/dist/client/hosted-prekey-publication.js.map +1 -0
- package/dist/client/hosted-push.d.ts +5 -6
- package/dist/client/hosted-push.d.ts.map +1 -1
- package/dist/client/hosted-push.js +22 -22
- package/dist/client/hosted-push.js.map +1 -1
- package/dist/client/hosted-transport.d.ts +62 -40
- package/dist/client/hosted-transport.d.ts.map +1 -1
- package/dist/client/hosted-transport.js +666 -341
- package/dist/client/hosted-transport.js.map +1 -1
- package/dist/client/hosted-trust.d.ts +29 -0
- package/dist/client/hosted-trust.d.ts.map +1 -0
- package/dist/client/hosted-trust.js +28 -0
- package/dist/client/hosted-trust.js.map +1 -0
- package/dist/client/hosted.d.ts +26 -21
- package/dist/client/hosted.d.ts.map +1 -1
- package/dist/client/hosted.js +80 -36
- package/dist/client/hosted.js.map +1 -1
- package/dist/client/index.d.ts +15 -15
- package/dist/client/index.d.ts.map +1 -1
- package/dist/client/index.js +7 -7
- package/dist/client/index.js.map +1 -1
- package/dist/client/key-rotation-core.d.ts +16 -8
- package/dist/client/key-rotation-core.d.ts.map +1 -1
- package/dist/client/key-rotation-core.js +14 -3
- package/dist/client/key-rotation-core.js.map +1 -1
- package/dist/client/key-rotation.d.ts +3 -2
- package/dist/client/key-rotation.d.ts.map +1 -1
- package/dist/client/key-rotation.js +5 -5
- package/dist/client/key-rotation.js.map +1 -1
- package/dist/client/media-queue-persistence.d.ts +14 -0
- package/dist/client/media-queue-persistence.d.ts.map +1 -0
- package/dist/client/media-queue-persistence.js +123 -0
- package/dist/client/media-queue-persistence.js.map +1 -0
- package/dist/client/media-upload-budget.d.ts +3 -0
- package/dist/client/media-upload-budget.d.ts.map +1 -0
- package/dist/client/media-upload-budget.js +27 -0
- package/dist/client/media-upload-budget.js.map +1 -0
- package/dist/client/media.d.ts +51 -15
- package/dist/client/media.d.ts.map +1 -1
- package/dist/client/media.js +541 -73
- package/dist/client/media.js.map +1 -1
- package/dist/client/messages.d.ts +1 -1
- package/dist/client/messages.d.ts.map +1 -1
- package/dist/client/messages.js +14 -15
- package/dist/client/messages.js.map +1 -1
- package/dist/client/multi-device.d.ts +1 -1
- package/dist/client/multi-device.js +1 -1
- package/dist/client/prekeys.d.ts +1 -1
- package/dist/client/prekeys.d.ts.map +1 -1
- package/dist/client/prekeys.js +132 -44
- package/dist/client/prekeys.js.map +1 -1
- package/dist/client/relay-subscription.d.ts +5 -1
- package/dist/client/relay-subscription.d.ts.map +1 -1
- package/dist/client/relay-subscription.js +59 -26
- package/dist/client/relay-subscription.js.map +1 -1
- package/dist/client/retry.d.ts +3 -3
- package/dist/client/retry.d.ts.map +1 -1
- package/dist/client/retry.js +1 -1
- package/dist/client/retry.js.map +1 -1
- package/dist/client/sealed-sender.d.ts +5 -5
- package/dist/client/sealed-sender.d.ts.map +1 -1
- package/dist/client/sealed-sender.js.map +1 -1
- package/dist/client/sender-key-distribution.d.ts +8 -0
- package/dist/client/sender-key-distribution.d.ts.map +1 -0
- package/dist/client/sender-key-distribution.js +59 -0
- package/dist/client/sender-key-distribution.js.map +1 -0
- package/dist/client/sessions.d.ts +3 -3
- package/dist/client/sessions.d.ts.map +1 -1
- package/dist/client/sessions.js +1 -1
- package/dist/client/sessions.js.map +1 -1
- package/dist/client/signal-service-cipher.d.ts +12 -8
- package/dist/client/signal-service-cipher.d.ts.map +1 -1
- package/dist/client/signal-service-cipher.js +41 -16
- package/dist/client/signal-service-cipher.js.map +1 -1
- package/dist/client/state.d.ts +1 -1
- package/dist/client/state.js +1 -1
- package/dist/client/types.d.ts +10 -10
- package/dist/client/types.d.ts.map +1 -1
- package/dist/client/types.js +1 -1
- package/dist/device/connection.d.ts.map +1 -1
- package/dist/device/connection.js.map +1 -1
- package/dist/device/device-id.d.ts +2 -2
- package/dist/device/device-id.d.ts.map +1 -1
- package/dist/device/device-id.js.map +1 -1
- package/dist/device/{expo-metadata.d.ts → expo/index.d.ts} +3 -3
- package/dist/device/expo/index.d.ts.map +1 -0
- package/dist/device/{expo-metadata.js → expo/index.js} +2 -2
- package/dist/device/expo/index.js.map +1 -0
- package/dist/device/index.d.ts +1 -1
- package/dist/device/index.d.ts.map +1 -1
- package/dist/device/index.js +1 -1
- package/dist/device/index.js.map +1 -1
- package/dist/device/lifecycle/index.d.ts +1 -1
- package/dist/device/lifecycle/index.d.ts.map +1 -1
- package/dist/device/lifecycle/types.d.ts +8 -8
- package/dist/device/lifecycle/types.d.ts.map +1 -1
- package/dist/device/provisioning.d.ts +13 -13
- package/dist/device/provisioning.d.ts.map +1 -1
- package/dist/device/provisioning.js +1 -1
- package/dist/device/provisioning.js.map +1 -1
- package/dist/device/transfer.d.ts +13 -13
- package/dist/device/transfer.d.ts.map +1 -1
- package/dist/device/transfer.js.map +1 -1
- package/dist/device/types.d.ts +3 -3
- package/dist/device/types.d.ts.map +1 -1
- package/dist/groups/index.d.ts +1 -1
- package/dist/groups/index.d.ts.map +1 -1
- package/dist/groups/server.d.ts +10 -0
- package/dist/groups/server.d.ts.map +1 -0
- package/dist/groups/server.js +6 -0
- package/dist/groups/server.js.map +1 -0
- package/dist/hooks/use-connection-presence.d.ts +6 -8
- package/dist/hooks/use-connection-presence.d.ts.map +1 -1
- package/dist/hooks/use-connection-presence.js +2 -4
- package/dist/hooks/use-connection-presence.js.map +1 -1
- package/dist/hooks/use-group-membership.d.ts +2 -2
- package/dist/hooks/use-group-membership.d.ts.map +1 -1
- package/dist/hooks/use-group-membership.js.map +1 -1
- package/dist/hooks/use-key-rotation.d.ts +2 -2
- package/dist/hooks/use-key-rotation.d.ts.map +1 -1
- package/dist/hooks/use-session-health.d.ts +2 -2
- package/dist/hooks/use-session-health.d.ts.map +1 -1
- package/dist/index.d.ts +57 -55
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +27 -26
- package/dist/index.js.map +1 -1
- package/dist/internal/crypto/ec/x25519-validation.d.ts +4 -4
- package/dist/internal/crypto/ec/x25519-validation.d.ts.map +1 -1
- package/dist/internal/crypto/ec/x25519-validation.js.map +1 -1
- package/dist/internal/groups/authority-certificate.d.ts +22 -0
- package/dist/internal/groups/authority-certificate.d.ts.map +1 -0
- package/dist/internal/groups/authority-certificate.js +99 -0
- package/dist/internal/groups/authority-certificate.js.map +1 -0
- package/dist/internal/groups/error-details.d.ts +9 -0
- package/dist/internal/groups/error-details.d.ts.map +1 -0
- package/dist/internal/groups/error-details.js +30 -0
- package/dist/internal/groups/error-details.js.map +1 -0
- package/dist/internal/groups/index.d.ts +1 -1
- package/dist/internal/groups/index.d.ts.map +1 -1
- package/dist/internal/groups/manager.d.ts +9 -4
- package/dist/internal/groups/manager.d.ts.map +1 -1
- package/dist/internal/groups/manager.js +3 -0
- package/dist/internal/groups/manager.js.map +1 -1
- package/dist/internal/groups/sdk-store.d.ts +4 -4
- package/dist/internal/groups/sdk-store.d.ts.map +1 -1
- package/dist/internal/groups/sdk-store.js.map +1 -1
- package/dist/internal/groups/server-engine.d.ts +9 -2
- package/dist/internal/groups/server-engine.d.ts.map +1 -1
- package/dist/internal/groups/server-engine.js +51 -19
- package/dist/internal/groups/server-engine.js.map +1 -1
- package/dist/internal/groups/wire.d.ts.map +1 -1
- package/dist/internal/groups/wire.js +10 -9
- package/dist/internal/groups/wire.js.map +1 -1
- package/dist/internal/manager/index.d.ts +2 -2
- package/dist/internal/manager/index.d.ts.map +1 -1
- package/dist/internal/manager/index.js +1 -1
- package/dist/internal/manager/index.js.map +1 -1
- package/dist/internal/manager/manager.d.ts +23 -23
- package/dist/internal/manager/manager.d.ts.map +1 -1
- package/dist/internal/manager/manager.js +40 -43
- package/dist/internal/manager/manager.js.map +1 -1
- package/dist/internal/protocol/double-ratchet/chains.d.ts +9 -9
- package/dist/internal/protocol/double-ratchet/chains.d.ts.map +1 -1
- package/dist/internal/protocol/double-ratchet/chains.js.map +1 -1
- package/dist/internal/protocol/double-ratchet/ratchet.d.ts +2 -2
- package/dist/internal/protocol/double-ratchet/ratchet.d.ts.map +1 -1
- package/dist/internal/protocol/double-ratchet/ratchet.js.map +1 -1
- package/dist/internal/protocol/pqxdh/pqxdh.d.ts +3 -3
- package/dist/internal/protocol/pqxdh/pqxdh.d.ts.map +1 -1
- package/dist/internal/protocol/pqxdh/pqxdh.js.map +1 -1
- package/dist/internal/protocol/sender-keys/manager.d.ts +4 -4
- package/dist/internal/protocol/sender-keys/manager.d.ts.map +1 -1
- package/dist/internal/protocol/sender-keys/manager.js +27 -14
- package/dist/internal/protocol/sender-keys/manager.js.map +1 -1
- package/dist/internal/protocol/spqr/ml-kem-braid/authenticator.d.ts +3 -3
- package/dist/internal/protocol/spqr/ml-kem-braid/authenticator.d.ts.map +1 -1
- package/dist/internal/protocol/spqr/ml-kem-braid/incremental-kem.d.ts +3 -3
- package/dist/internal/protocol/spqr/ml-kem-braid/incremental-kem.d.ts.map +1 -1
- package/dist/internal/protocol/spqr/ml-kem-braid/index.d.ts +2 -2
- package/dist/internal/protocol/spqr/ml-kem-braid/index.d.ts.map +1 -1
- package/dist/internal/protocol/spqr/ml-kem-braid/index.js +1 -1
- package/dist/internal/protocol/spqr/ml-kem-braid/index.js.map +1 -1
- package/dist/internal/protocol/spqr/ml-kem-braid/state-machine.d.ts +3 -3
- package/dist/internal/protocol/spqr/ml-kem-braid/state-machine.d.ts.map +1 -1
- package/dist/internal/protocol/spqr/ml-kem-braid/state-machine.js +2 -2
- package/dist/internal/protocol/spqr/ml-kem-braid/state-machine.js.map +1 -1
- package/dist/internal/protocol/spqr/ml-kem-braid/types.d.ts +3 -3
- package/dist/internal/protocol/spqr/ml-kem-braid/types.d.ts.map +1 -1
- package/dist/internal/protocol/spqr/spqr.d.ts +5 -5
- package/dist/internal/protocol/spqr/spqr.d.ts.map +1 -1
- package/dist/internal/protocol/spqr/spqr.js.map +1 -1
- package/dist/internal/protocol/triple-ratchet/ratchet.d.ts +4 -4
- package/dist/internal/protocol/triple-ratchet/ratchet.d.ts.map +1 -1
- package/dist/internal/protocol/triple-ratchet/ratchet.js.map +1 -1
- package/dist/internal/protocol/x3dh/x3dh.d.ts +3 -3
- package/dist/internal/protocol/x3dh/x3dh.d.ts.map +1 -1
- package/dist/internal/protocol/x3dh/x3dh.js.map +1 -1
- package/dist/internal/sesame/device-registry.d.ts +16 -16
- package/dist/internal/sesame/device-registry.d.ts.map +1 -1
- package/dist/internal/sesame/device-registry.js +6 -6
- package/dist/internal/sesame/device-registry.js.map +1 -1
- package/dist/internal/sesame/index.d.ts +4 -4
- package/dist/internal/sesame/index.d.ts.map +1 -1
- package/dist/internal/sesame/index.js +2 -2
- package/dist/internal/sesame/index.js.map +1 -1
- package/dist/internal/sesame/manager.d.ts +10 -10
- package/dist/internal/sesame/manager.d.ts.map +1 -1
- package/dist/internal/sesame/manager.js +13 -13
- package/dist/internal/sesame/manager.js.map +1 -1
- package/dist/internal/sesame/types.d.ts +5 -5
- package/dist/internal/sesame/types.d.ts.map +1 -1
- package/dist/internal/session/cipher.d.ts +4 -4
- package/dist/internal/session/cipher.d.ts.map +1 -1
- package/dist/internal/session/cipher.js +31 -28
- package/dist/internal/session/cipher.js.map +1 -1
- package/dist/internal/session/decryption.js.map +1 -1
- package/dist/internal/session/factory.d.ts +3 -3
- package/dist/internal/session/factory.d.ts.map +1 -1
- package/dist/internal/session/factory.js.map +1 -1
- package/dist/internal/session/handshake.d.ts +2 -2
- package/dist/internal/session/handshake.d.ts.map +1 -1
- package/dist/internal/session/handshake.js.map +1 -1
- package/dist/internal/session/ratchet.d.ts +4 -4
- package/dist/internal/session/ratchet.d.ts.map +1 -1
- package/dist/internal/session/ratchet.js.map +1 -1
- package/dist/internal/session/types.d.ts +5 -5
- package/dist/internal/session/types.d.ts.map +1 -1
- package/dist/internal/session/validation.d.ts +3 -3
- package/dist/internal/session/validation.d.ts.map +1 -1
- package/dist/internal/session/validation.js.map +1 -1
- package/dist/layers.d.ts +4 -4
- package/dist/layers.d.ts.map +1 -1
- package/dist/layers.js +12 -12
- package/dist/layers.js.map +1 -1
- package/dist/local/store/expo/adapter.d.ts +15 -9
- package/dist/local/store/expo/adapter.d.ts.map +1 -1
- package/dist/local/store/expo/adapter.js +29 -10
- package/dist/local/store/expo/adapter.js.map +1 -1
- package/dist/local/store/expo/database-key.d.ts +5 -5
- package/dist/local/store/expo/database-key.d.ts.map +1 -1
- package/dist/local/store/expo/database-key.js.map +1 -1
- package/dist/local/store/expo/index.d.ts +3 -3
- package/dist/local/store/expo/index.d.ts.map +1 -1
- package/dist/local/store/expo/key-storage.d.ts +11 -5
- package/dist/local/store/expo/key-storage.d.ts.map +1 -1
- package/dist/local/store/expo/key-storage.js +82 -17
- package/dist/local/store/expo/key-storage.js.map +1 -1
- package/dist/local/store/expo/models/kyber-prekey-used.d.ts +1 -4
- package/dist/local/store/expo/models/kyber-prekey-used.d.ts.map +1 -1
- package/dist/local/store/expo/models/kyber-prekey-used.js +23 -9
- package/dist/local/store/expo/models/kyber-prekey-used.js.map +1 -1
- package/dist/local/store/expo/models/kyber-prekey.d.ts +4 -4
- package/dist/local/store/expo/models/kyber-prekey.d.ts.map +1 -1
- package/dist/local/store/expo/models/kyber-prekey.js +67 -26
- package/dist/local/store/expo/models/kyber-prekey.js.map +1 -1
- package/dist/local/store/expo/schema.d.ts +21 -2
- package/dist/local/store/expo/schema.d.ts.map +1 -1
- package/dist/local/store/expo/schema.js +10 -2
- package/dist/local/store/expo/schema.js.map +1 -1
- package/dist/local/store/index.d.ts +3 -3
- package/dist/local/store/index.d.ts.map +1 -1
- package/dist/local/store/index.js +1 -1
- package/dist/local/store/kyber-prekey-lifecycle.d.ts +46 -0
- package/dist/local/store/kyber-prekey-lifecycle.d.ts.map +1 -0
- package/dist/local/store/kyber-prekey-lifecycle.js +88 -0
- package/dist/local/store/kyber-prekey-lifecycle.js.map +1 -0
- package/dist/local/store/memory/adapter.d.ts +14 -6
- package/dist/local/store/memory/adapter.d.ts.map +1 -1
- package/dist/local/store/memory/adapter.js +114 -29
- package/dist/local/store/memory/adapter.js.map +1 -1
- package/dist/local/store/node/adapter.d.ts +9 -3
- package/dist/local/store/node/adapter.d.ts.map +1 -1
- package/dist/local/store/node/adapter.js +31 -13
- package/dist/local/store/node/adapter.js.map +1 -1
- package/dist/local/store/node/database-file-commit.d.ts +8 -0
- package/dist/local/store/node/database-file-commit.d.ts.map +1 -0
- package/dist/local/store/node/database-file-commit.js +62 -0
- package/dist/local/store/node/database-file-commit.js.map +1 -0
- package/dist/local/store/node/database-key.d.ts +6 -1
- package/dist/local/store/node/database-key.d.ts.map +1 -1
- package/dist/local/store/node/database-key.js +79 -44
- package/dist/local/store/node/database-key.js.map +1 -1
- package/dist/local/store/node/database-lock.d.ts +8 -0
- package/dist/local/store/node/database-lock.d.ts.map +1 -0
- package/dist/local/store/node/database-lock.js +44 -0
- package/dist/local/store/node/database-lock.js.map +1 -0
- package/dist/local/store/node/database.d.ts +17 -16
- package/dist/local/store/node/database.d.ts.map +1 -1
- package/dist/local/store/node/database.js +197 -202
- package/dist/local/store/node/database.js.map +1 -1
- package/dist/local/store/react-native/adapter.d.ts +10 -4
- package/dist/local/store/react-native/adapter.d.ts.map +1 -1
- package/dist/local/store/react-native/adapter.js +151 -66
- package/dist/local/store/react-native/adapter.js.map +1 -1
- package/dist/local/store/received-content.d.ts +9 -0
- package/dist/local/store/received-content.d.ts.map +1 -0
- package/dist/local/store/received-content.js +46 -0
- package/dist/local/store/received-content.js.map +1 -0
- package/dist/local/store/reliability.d.ts +4 -4
- package/dist/local/store/reliability.d.ts.map +1 -1
- package/dist/local/store/reliability.js +7 -4
- package/dist/local/store/reliability.js.map +1 -1
- package/dist/local/store/web/adapter.d.ts +11 -5
- package/dist/local/store/web/adapter.d.ts.map +1 -1
- package/dist/local/store/web/adapter.js +207 -74
- package/dist/local/store/web/adapter.js.map +1 -1
- package/dist/local/vault/expo-secure-store.d.ts +2 -2
- package/dist/local/vault/expo-secure-store.d.ts.map +1 -1
- package/dist/local/vault/index.d.ts +1 -1
- package/dist/local/vault/index.d.ts.map +1 -1
- package/dist/logger.d.ts +4 -4
- package/dist/logger.d.ts.map +1 -1
- package/dist/logger.js.map +1 -1
- package/dist/media/index.d.ts +71 -61
- package/dist/media/index.d.ts.map +1 -1
- package/dist/media/index.js +550 -386
- package/dist/media/index.js.map +1 -1
- package/dist/media/prepared-upload.d.ts +37 -0
- package/dist/media/prepared-upload.d.ts.map +1 -0
- package/dist/media/prepared-upload.js +46 -0
- package/dist/media/prepared-upload.js.map +1 -0
- package/dist/profile/contact-state.d.ts +2 -2
- package/dist/profile/contact-state.d.ts.map +1 -1
- package/dist/profile/contact-state.js.map +1 -1
- package/dist/profile/profile-key.d.ts +2 -2
- package/dist/profile/profile-key.d.ts.map +1 -1
- package/dist/profile/profile-key.js.map +1 -1
- package/dist/profile/update-service.d.ts +2 -2
- package/dist/profile/update-service.d.ts.map +1 -1
- package/dist/profile/update-service.js.map +1 -1
- package/dist/remote/object-store/convex-r2/server.d.ts +2 -1
- package/dist/remote/object-store/convex-r2/server.d.ts.map +1 -1
- package/dist/remote/object-store/convex-r2/server.js +4 -0
- package/dist/remote/object-store/convex-r2/server.js.map +1 -1
- package/dist/remote/object-store/convex-r2/storage.d.ts.map +1 -1
- package/dist/remote/object-store/convex-r2/storage.js +1 -0
- package/dist/remote/object-store/convex-r2/storage.js.map +1 -1
- package/dist/remote/object-store/index.d.ts +3 -1
- package/dist/remote/object-store/index.d.ts.map +1 -1
- package/dist/remote/object-store/index.js +1 -1
- package/dist/remote/object-store/index.js.map +1 -1
- package/dist/remote/object-store/s3/storage.d.ts +3 -1
- package/dist/remote/object-store/s3/storage.d.ts.map +1 -1
- package/dist/remote/object-store/s3/storage.js +9 -2
- package/dist/remote/object-store/s3/storage.js.map +1 -1
- package/dist/remote/object-store/types.d.ts +33 -4
- package/dist/remote/object-store/types.d.ts.map +1 -1
- package/dist/remote/object-store/upload-error.d.ts +23 -0
- package/dist/remote/object-store/upload-error.d.ts.map +1 -0
- package/dist/remote/object-store/upload-error.js +33 -0
- package/dist/remote/object-store/upload-error.js.map +1 -0
- package/dist/remote/object-store/validation.d.ts +7 -1
- package/dist/remote/object-store/validation.d.ts.map +1 -1
- package/dist/remote/object-store/validation.js +39 -25
- package/dist/remote/object-store/validation.js.map +1 -1
- package/dist/remote/relay/index.d.ts +7 -14
- package/dist/remote/relay/index.d.ts.map +1 -1
- package/dist/remote/relay/index.js +6 -13
- package/dist/remote/relay/index.js.map +1 -1
- package/dist/remote/relay/memory/adapter.d.ts +5 -4
- package/dist/remote/relay/memory/adapter.d.ts.map +1 -1
- package/dist/remote/relay/memory/adapter.js +14 -4
- package/dist/remote/relay/memory/adapter.js.map +1 -1
- package/dist/remote/relay/types.d.ts +36 -25
- package/dist/remote/relay/types.d.ts.map +1 -1
- package/dist/remote/relay/types.js +1 -1
- package/dist/types/api.d.ts +59 -24
- package/dist/types/api.d.ts.map +1 -1
- package/dist/types/index.js +1 -1
- package/dist/types/index.js.map +1 -1
- package/dist/types/session.d.ts +6 -0
- package/dist/types/session.d.ts.map +1 -1
- package/dist/types/session.js.map +1 -1
- package/docs/ASSURANCE.md +7 -7
- package/docs/CLIENT_COMPOSITION.md +16 -23
- package/docs/DEVIATIONS.md +1 -1
- package/docs/DOCUMENTATION_STANDARDS.md +4 -0
- package/docs/ERROR_HANDLING.md +2 -2
- package/docs/GETTING_STARTED.md +23 -38
- package/docs/INTERFACES.md +36 -27
- package/docs/PACKAGE_SURFACE.md +9 -16
- package/docs/RECIPES.md +10 -23
- package/examples/browser/index.html +2 -2
- package/groups/README.md +4 -4
- package/local/store/README.md +22 -7
- package/local/store/expo/README.md +24 -20
- package/local/store/memory/README.md +1 -1
- package/local/store/node/README.md +31 -2
- package/local/store/react-native/README.md +1 -1
- package/local/store/web/README.md +1 -1
- package/local/vault/README.md +1 -1
- package/media/README.md +94 -0
- package/package.json +17 -27
- package/remote/README.md +24 -24
- package/remote/object-store/README.md +8 -0
- package/remote/object-store/s3/README.md +10 -1
- package/remote/relay/README.md +4 -3
- package/remote/relay/memory/README.md +1 -1
- package/types/README.md +2 -2
- package/COMMERCIAL.md +0 -56
- package/dist/device/expo-metadata.d.ts.map +0 -1
- package/dist/device/expo-metadata.js.map +0 -1
- package/dist/remote/relay/convex/backend.d.ts +0 -394
- package/dist/remote/relay/convex/backend.d.ts.map +0 -1
- package/dist/remote/relay/convex/backend.js +0 -678
- package/dist/remote/relay/convex/backend.js.map +0 -1
- package/dist/remote/relay/convex/component/_generated/api.d.ts +0 -58
- package/dist/remote/relay/convex/component/_generated/api.d.ts.map +0 -1
- package/dist/remote/relay/convex/component/_generated/api.js +0 -31
- package/dist/remote/relay/convex/component/_generated/api.js.map +0 -1
- package/dist/remote/relay/convex/component/_generated/component.d.ts +0 -475
- package/dist/remote/relay/convex/component/_generated/component.d.ts.map +0 -1
- package/dist/remote/relay/convex/component/_generated/component.js +0 -11
- package/dist/remote/relay/convex/component/_generated/component.js.map +0 -1
- package/dist/remote/relay/convex/component/_generated/dataModel.d.ts +0 -46
- package/dist/remote/relay/convex/component/_generated/dataModel.d.ts.map +0 -1
- package/dist/remote/relay/convex/component/_generated/dataModel.js +0 -11
- package/dist/remote/relay/convex/component/_generated/dataModel.js.map +0 -1
- package/dist/remote/relay/convex/component/_generated/server.d.ts +0 -129
- package/dist/remote/relay/convex/component/_generated/server.d.ts.map +0 -1
- package/dist/remote/relay/convex/component/_generated/server.js +0 -79
- package/dist/remote/relay/convex/component/_generated/server.js.map +0 -1
- package/dist/remote/relay/convex/component/accounts.d.ts +0 -45
- package/dist/remote/relay/convex/component/accounts.d.ts.map +0 -1
- package/dist/remote/relay/convex/component/accounts.js +0 -184
- package/dist/remote/relay/convex/component/accounts.js.map +0 -1
- package/dist/remote/relay/convex/component/certificates.d.ts +0 -10
- package/dist/remote/relay/convex/component/certificates.d.ts.map +0 -1
- package/dist/remote/relay/convex/component/certificates.js +0 -126
- package/dist/remote/relay/convex/component/certificates.js.map +0 -1
- package/dist/remote/relay/convex/component/cleanup.d.ts +0 -32
- package/dist/remote/relay/convex/component/cleanup.d.ts.map +0 -1
- package/dist/remote/relay/convex/component/cleanup.js +0 -146
- package/dist/remote/relay/convex/component/cleanup.js.map +0 -1
- package/dist/remote/relay/convex/component/convex.config.d.ts +0 -5
- package/dist/remote/relay/convex/component/convex.config.d.ts.map +0 -1
- package/dist/remote/relay/convex/component/convex.config.js +0 -35
- package/dist/remote/relay/convex/component/convex.config.js.map +0 -1
- package/dist/remote/relay/convex/component/crons.d.ts +0 -3
- package/dist/remote/relay/convex/component/crons.d.ts.map +0 -1
- package/dist/remote/relay/convex/component/crons.js +0 -10
- package/dist/remote/relay/convex/component/crons.js.map +0 -1
- package/dist/remote/relay/convex/component/devices.d.ts +0 -102
- package/dist/remote/relay/convex/component/devices.d.ts.map +0 -1
- package/dist/remote/relay/convex/component/devices.js +0 -300
- package/dist/remote/relay/convex/component/devices.js.map +0 -1
- package/dist/remote/relay/convex/component/errors.d.ts +0 -22
- package/dist/remote/relay/convex/component/errors.d.ts.map +0 -1
- package/dist/remote/relay/convex/component/errors.js +0 -17
- package/dist/remote/relay/convex/component/errors.js.map +0 -1
- package/dist/remote/relay/convex/component/groups.d.ts +0 -63
- package/dist/remote/relay/convex/component/groups.d.ts.map +0 -1
- package/dist/remote/relay/convex/component/groups.js +0 -341
- package/dist/remote/relay/convex/component/groups.js.map +0 -1
- package/dist/remote/relay/convex/component/keys.d.ts +0 -130
- package/dist/remote/relay/convex/component/keys.d.ts.map +0 -1
- package/dist/remote/relay/convex/component/keys.js +0 -578
- package/dist/remote/relay/convex/component/keys.js.map +0 -1
- package/dist/remote/relay/convex/component/messages.d.ts +0 -105
- package/dist/remote/relay/convex/component/messages.d.ts.map +0 -1
- package/dist/remote/relay/convex/component/messages.js +0 -702
- package/dist/remote/relay/convex/component/messages.js.map +0 -1
- package/dist/remote/relay/convex/component/provisioning.d.ts +0 -92
- package/dist/remote/relay/convex/component/provisioning.d.ts.map +0 -1
- package/dist/remote/relay/convex/component/provisioning.js +0 -360
- package/dist/remote/relay/convex/component/provisioning.js.map +0 -1
- package/dist/remote/relay/convex/component/runtime.d.ts +0 -18
- package/dist/remote/relay/convex/component/runtime.d.ts.map +0 -1
- package/dist/remote/relay/convex/component/runtime.js +0 -144
- package/dist/remote/relay/convex/component/runtime.js.map +0 -1
- package/dist/remote/relay/convex/component/schema.d.ts +0 -358
- package/dist/remote/relay/convex/component/schema.d.ts.map +0 -1
- package/dist/remote/relay/convex/component/schema.js +0 -288
- package/dist/remote/relay/convex/component/schema.js.map +0 -1
- package/dist/remote/relay/convex/component/zkAuth.d.ts +0 -18
- package/dist/remote/relay/convex/component/zkAuth.d.ts.map +0 -1
- package/dist/remote/relay/convex/component/zkAuth.js +0 -86
- package/dist/remote/relay/convex/component/zkAuth.js.map +0 -1
- package/dist/remote/relay/convex/constants.d.ts +0 -3
- package/dist/remote/relay/convex/constants.d.ts.map +0 -1
- package/dist/remote/relay/convex/constants.js +0 -3
- package/dist/remote/relay/convex/constants.js.map +0 -1
- package/dist/remote/relay/convex/group-server.d.ts +0 -123
- package/dist/remote/relay/convex/group-server.d.ts.map +0 -1
- package/dist/remote/relay/convex/group-server.js +0 -184
- package/dist/remote/relay/convex/group-server.js.map +0 -1
- package/dist/remote/relay/convex/index.d.ts +0 -42
- package/dist/remote/relay/convex/index.d.ts.map +0 -1
- package/dist/remote/relay/convex/index.js +0 -38
- package/dist/remote/relay/convex/index.js.map +0 -1
- package/dist/remote/relay/convex/relay.d.ts +0 -323
- package/dist/remote/relay/convex/relay.d.ts.map +0 -1
- package/dist/remote/relay/convex/relay.js +0 -1144
- package/dist/remote/relay/convex/relay.js.map +0 -1
- package/dist/remote/relay/convex/types.d.ts +0 -24
- package/dist/remote/relay/convex/types.d.ts.map +0 -1
- package/dist/remote/relay/convex/types.js +0 -14
- package/dist/remote/relay/convex/types.js.map +0 -1
- package/remote/relay/convex/README.md +0 -61
- package/remote/relay/convex/component/README.md +0 -462
package/dist/client/client.js
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
/**
|
|
2
|
-
*
|
|
2
|
+
* DefaultSignalProtocolClient - initialized client class for encrypted messaging.
|
|
3
3
|
*
|
|
4
4
|
* @layer 1 - API
|
|
5
|
-
* @boundary
|
|
5
|
+
* @boundary SignalProtocolClient
|
|
6
6
|
*
|
|
7
7
|
* Application code should usually create clients with `createSignalProtocolClient()`.
|
|
8
|
-
* Use `
|
|
8
|
+
* Use `DefaultSignalProtocolClient.create()` directly when lower-level integration code already
|
|
9
9
|
* owns the flattened config shape.
|
|
10
10
|
*
|
|
11
11
|
* @example Basic usage
|
|
@@ -35,17 +35,17 @@
|
|
|
35
35
|
*
|
|
36
36
|
* @example Low-level factory
|
|
37
37
|
* ```typescript
|
|
38
|
-
* import {
|
|
38
|
+
* import { DefaultSignalProtocolClient } from '@open-e2ee/signal-protocol-sdk';
|
|
39
39
|
*
|
|
40
|
-
* const signal = await
|
|
40
|
+
* const signal = await DefaultSignalProtocolClient.create(userId, {
|
|
41
41
|
* storage,
|
|
42
42
|
* relay,
|
|
43
43
|
* });
|
|
44
44
|
* ```
|
|
45
45
|
*/
|
|
46
46
|
import AsyncLock from 'async-lock';
|
|
47
|
-
import {
|
|
48
|
-
import {
|
|
47
|
+
import { DefaultSignalProtocolManager } from '../internal/manager/index.js';
|
|
48
|
+
import { DefaultSesameManager } from '../internal/sesame/index.js';
|
|
49
49
|
import { createCompositeIdentityV1 } from '../keys/identity.js';
|
|
50
50
|
import { EncryptionError, EncryptionErrorCode } from '../types/index.js';
|
|
51
51
|
import { base64ToBytes, bytesToBase64, constantTimeEqual } from '../internal/crypto/index.js';
|
|
@@ -78,7 +78,7 @@ import { deriveAccessKey } from '../internal/protocol/sealed-sender/delivery-tok
|
|
|
78
78
|
export { IMPLICIT_ENVELOPE_TYPES } from './constants.js';
|
|
79
79
|
/**
|
|
80
80
|
* Module-level lock for storage initialization.
|
|
81
|
-
* Prevents multiple concurrent
|
|
81
|
+
* Prevents multiple concurrent DefaultSignalProtocolClient.create() calls from creating
|
|
82
82
|
* duplicate storage adapters that compete for database locks.
|
|
83
83
|
*/
|
|
84
84
|
const storageLock = new AsyncLock({
|
|
@@ -106,12 +106,12 @@ function isDataMessage(content) {
|
|
|
106
106
|
* - Clear error handling
|
|
107
107
|
* - Type-safe API
|
|
108
108
|
*
|
|
109
|
-
* This client implements the
|
|
110
|
-
*
|
|
109
|
+
* This client implements the SignalProtocolClient interface and wraps
|
|
110
|
+
* DefaultSignalProtocolManager with additional high-level functionality.
|
|
111
111
|
*
|
|
112
112
|
* @category Primary API
|
|
113
113
|
*/
|
|
114
|
-
export class
|
|
114
|
+
export class DefaultSignalProtocolClient {
|
|
115
115
|
manager;
|
|
116
116
|
_storage;
|
|
117
117
|
relay;
|
|
@@ -125,7 +125,7 @@ export class SignalProtocolClient {
|
|
|
125
125
|
deviceId; // 1 = primary, 2-5 = linked devices
|
|
126
126
|
/**
|
|
127
127
|
* Get user ID for this client instance
|
|
128
|
-
* @see
|
|
128
|
+
* @see SignalProtocolClient.userId
|
|
129
129
|
*/
|
|
130
130
|
get userId() {
|
|
131
131
|
return this._userId;
|
|
@@ -136,6 +136,7 @@ export class SignalProtocolClient {
|
|
|
136
136
|
senderKeyManager;
|
|
137
137
|
// Group state management
|
|
138
138
|
groupManager;
|
|
139
|
+
groupSessionFor;
|
|
139
140
|
groupStore;
|
|
140
141
|
// Cipher coordination (encrypts/decrypts, routes to appropriate cipher)
|
|
141
142
|
cipher;
|
|
@@ -176,7 +177,7 @@ export class SignalProtocolClient {
|
|
|
176
177
|
// Constants are now imported from state.ts for single source of truth
|
|
177
178
|
// See SIGNAL_PROTOCOL_CLIENT_CONSTANTS for timing and retry configuration
|
|
178
179
|
/**
|
|
179
|
-
* Private constructor - use
|
|
180
|
+
* Private constructor - use DefaultSignalProtocolClient.create() to instantiate
|
|
180
181
|
*
|
|
181
182
|
* @param userId - User identifier
|
|
182
183
|
* @param deviceId - Device identifier (1 = primary, 2-5 = linked devices)
|
|
@@ -195,7 +196,7 @@ export class SignalProtocolClient {
|
|
|
195
196
|
this.remoteObjectStore = config.remoteObjectStore;
|
|
196
197
|
// Dependency injection: Storage is always provided by create() callers.
|
|
197
198
|
if (!config.storage) {
|
|
198
|
-
throw new Error('Storage must be provided by
|
|
199
|
+
throw new Error('Storage must be provided by DefaultSignalProtocolClient.create() callers');
|
|
199
200
|
}
|
|
200
201
|
this._storage = config.storage;
|
|
201
202
|
this._storage.setLogger?.(this.logger);
|
|
@@ -207,13 +208,13 @@ export class SignalProtocolClient {
|
|
|
207
208
|
// Dependency injection: Use provided protocol manager or create new one with our storage and protocol strategy
|
|
208
209
|
this.manager =
|
|
209
210
|
config.protocolManager ??
|
|
210
|
-
new
|
|
211
|
+
new DefaultSignalProtocolManager(this._storage, config.protocolStrategy, this.logger);
|
|
211
212
|
// Validate manager was created successfully before initializing Sesame
|
|
212
213
|
if (!this.manager) {
|
|
213
214
|
throw new EncryptionError('Protocol manager must be initialized before Sesame manager', EncryptionErrorCode.INITIALIZATION_FAILED);
|
|
214
215
|
}
|
|
215
216
|
// Initialize Sesame manager for multi-device support
|
|
216
|
-
this.sesameManager = new
|
|
217
|
+
this.sesameManager = new DefaultSesameManager(this._storage, {}, // Use default Sesame config
|
|
217
218
|
this.manager, undefined, this.logger);
|
|
218
219
|
// Wire up MessageRecord storage for retry request support (SESAME spec §6.2)
|
|
219
220
|
this.sesameManager.setMessageRecordStore(this._storage);
|
|
@@ -221,56 +222,68 @@ export class SignalProtocolClient {
|
|
|
221
222
|
this.senderKeyManager = new SenderKeyManager(this._storage, config?.senderKeys, this.logger);
|
|
222
223
|
// Initialize the group manager if configured
|
|
223
224
|
if (config?.groups) {
|
|
224
|
-
const
|
|
225
|
-
const server = config.groups.server ?? capability?.server;
|
|
226
|
-
const issueCredential = config.groups.issueCredential ??
|
|
227
|
-
(capability ? () => capability.issueAuthCredential(this._userId) : undefined);
|
|
228
|
-
const issueProfileKeyCredential = config.groups.issueProfileKeyCredential ??
|
|
229
|
-
(capability
|
|
230
|
-
? async (request) => {
|
|
231
|
-
const accessKey = await deriveAccessKey(config.groups.profileKey);
|
|
232
|
-
await capability.setUnidentifiedAccessKey(this._userId, accessKey);
|
|
233
|
-
return capability.issueProfileKeyCredential(this._userId, request);
|
|
234
|
-
}
|
|
235
|
-
: undefined);
|
|
236
|
-
if (!server || !issueCredential || !issueProfileKeyCredential) {
|
|
237
|
-
const missing = [
|
|
238
|
-
!server ? 'server' : undefined,
|
|
239
|
-
!issueCredential ? 'issueCredential' : undefined,
|
|
240
|
-
!issueProfileKeyCredential ? 'issueProfileKeyCredential' : undefined,
|
|
241
|
-
].filter((value) => value !== undefined);
|
|
242
|
-
throw new Error(`Groups require the relay.groupServer capability or explicit overrides; missing: ${missing.join(', ')}`);
|
|
243
|
-
}
|
|
244
|
-
if (!config.aci) {
|
|
245
|
-
throw new Error('Groups require the client identity ACI; set identity.aci');
|
|
246
|
-
}
|
|
247
|
-
const trustRoot = decodeGroupTrustRoot(config.groups.trustRoot);
|
|
225
|
+
const groupConfig = config.groups;
|
|
248
226
|
this.groupStore = config.groups.store ?? new SignalProtocolGroupStateStore(this._storage);
|
|
249
|
-
const
|
|
250
|
-
|
|
251
|
-
|
|
252
|
-
|
|
253
|
-
|
|
254
|
-
|
|
255
|
-
|
|
256
|
-
|
|
257
|
-
|
|
258
|
-
|
|
259
|
-
|
|
260
|
-
|
|
261
|
-
|
|
262
|
-
|
|
263
|
-
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
|
|
267
|
-
|
|
268
|
-
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
|
|
272
|
-
:
|
|
273
|
-
|
|
227
|
+
const sessions = new WeakMap();
|
|
228
|
+
this.groupSessionFor = (authority) => {
|
|
229
|
+
const cached = sessions.get(authority);
|
|
230
|
+
if (cached)
|
|
231
|
+
return cached;
|
|
232
|
+
const capability = this.relay?.groupServer;
|
|
233
|
+
const server = groupConfig.server ?? capability?.server;
|
|
234
|
+
const issueCredential = groupConfig.issueCredential ??
|
|
235
|
+
(capability ? () => capability.issueAuthCredential(this._userId, authority.authorityKeyId) : undefined);
|
|
236
|
+
const issueProfileKeyCredential = groupConfig.issueProfileKeyCredential ??
|
|
237
|
+
(capability
|
|
238
|
+
? async (request) => {
|
|
239
|
+
const accessKey = await deriveAccessKey(groupConfig.profileKey);
|
|
240
|
+
await capability.setUnidentifiedAccessKey(this._userId, accessKey);
|
|
241
|
+
return capability.issueProfileKeyCredential(this._userId, request, authority.authorityKeyId);
|
|
242
|
+
}
|
|
243
|
+
: undefined);
|
|
244
|
+
if (!server || !issueCredential || !issueProfileKeyCredential) {
|
|
245
|
+
const missing = [
|
|
246
|
+
!server ? 'server' : undefined,
|
|
247
|
+
!issueCredential ? 'issueCredential' : undefined,
|
|
248
|
+
!issueProfileKeyCredential ? 'issueProfileKeyCredential' : undefined,
|
|
249
|
+
].filter((value) => value !== undefined);
|
|
250
|
+
throw new Error(`Groups require the relay.groupServer capability or explicit overrides; missing: ${missing.join(', ')}`);
|
|
251
|
+
}
|
|
252
|
+
if (!config.aci) {
|
|
253
|
+
throw new Error('Groups require the client identity ACI; set identity.aci');
|
|
254
|
+
}
|
|
255
|
+
const trustRoot = decodeGroupTrustRoot(authority.trustRoot);
|
|
256
|
+
const endorsementManager = authority.endorsementManager;
|
|
257
|
+
endorsementManager?.assertEndorsementRootPublicKey(trustRoot.endorsementRootPublicKey);
|
|
258
|
+
const manager = new GroupManager({
|
|
259
|
+
store: this.groupStore,
|
|
260
|
+
authorityKeyId: authority.authorityKeyId,
|
|
261
|
+
server,
|
|
262
|
+
issueCredential,
|
|
263
|
+
credentialPublicKey: trustRoot.credentialPublicKey,
|
|
264
|
+
serverSigningPublicKey: trustRoot.serverSigningPublicKey,
|
|
265
|
+
allowUnauthenticatedGroupHistory: groupConfig.allowUnauthenticatedGroupHistory,
|
|
266
|
+
onConfigurationWarning: groupConfig.onConfigurationWarning,
|
|
267
|
+
aci: config.aci,
|
|
268
|
+
pni: config.pni,
|
|
269
|
+
issueProfileKeyCredential,
|
|
270
|
+
profileKeyCredentialPublicKey: trustRoot.profileKeyCredentialPublicKey,
|
|
271
|
+
profileKey: groupConfig.profileKey,
|
|
272
|
+
onSenderKeyRotation: async (groupId) => {
|
|
273
|
+
// Forward to existing sender key rotation
|
|
274
|
+
await this.rotateGroupSenderKey(groupId);
|
|
275
|
+
},
|
|
276
|
+
onEndorsementsInvalidated: endorsementManager
|
|
277
|
+
? async (groupId) => {
|
|
278
|
+
await endorsementManager.clearGroupEndorsements(groupId);
|
|
279
|
+
}
|
|
280
|
+
: undefined,
|
|
281
|
+
});
|
|
282
|
+
const session = { manager, endorsementManager };
|
|
283
|
+
sessions.set(authority, session);
|
|
284
|
+
return session;
|
|
285
|
+
};
|
|
286
|
+
this.groupManager = this.groupSessionFor(config.groups).manager;
|
|
274
287
|
}
|
|
275
288
|
// Initialize cipher for encrypt/decrypt coordination
|
|
276
289
|
this.cipher = new SignalProtocolServiceCipher(this._userId, deviceId, this.sesameManager, this.senderKeyManager, this._storage, this.relay, this.remoteObjectStore, this.contentAdapter, this.logger);
|
|
@@ -359,11 +372,25 @@ export class SignalProtocolClient {
|
|
|
359
372
|
}
|
|
360
373
|
// Set up endorsement manager if configured
|
|
361
374
|
if (config?.groups?.endorsementManager) {
|
|
362
|
-
this.cipher.setEndorsementManager(config.groups.endorsementManager);
|
|
375
|
+
this.cipher.setEndorsementManager(config.groups.endorsementManager, config.groups.resolveAuthority ? async () => (await this.resolveGroupSession()).endorsementManager : undefined);
|
|
363
376
|
}
|
|
364
377
|
// Set up group secret params provider. Derives params from master key in store
|
|
365
378
|
if (this.groupStore) {
|
|
366
379
|
const store = this.groupStore;
|
|
380
|
+
const resolveAcis = config.groups?.resolveAciBytesByUserIds;
|
|
381
|
+
const localAci = config.aci?.uuid;
|
|
382
|
+
this.cipher.setGroupReceiveAuthorizer(async (groupId, senderId) => {
|
|
383
|
+
if (!resolveAcis || !localAci) {
|
|
384
|
+
throw new Error('Group reception requires authenticated account ACI resolution');
|
|
385
|
+
}
|
|
386
|
+
const state = await store.getGroupState(groupId);
|
|
387
|
+
const senderAci = (await resolveAcis([senderId])).get(senderId);
|
|
388
|
+
if (!state || !senderAci ||
|
|
389
|
+
!state.members.some((member) => constantTimeEqual(member.aciBytes, senderAci)) ||
|
|
390
|
+
!state.members.some((member) => constantTimeEqual(member.aciBytes, localAci))) {
|
|
391
|
+
throw new Error('Group sender and recipient must be members of the verified local group');
|
|
392
|
+
}
|
|
393
|
+
});
|
|
367
394
|
this.cipher.setGroupSecretParamsProvider(async (groupId) => {
|
|
368
395
|
const masterKey = await store.getMasterKey(groupId);
|
|
369
396
|
if (!masterKey)
|
|
@@ -380,22 +407,23 @@ export class SignalProtocolClient {
|
|
|
380
407
|
this.relay?.refreshGroupSendEndorsements &&
|
|
381
408
|
this.groupManager) {
|
|
382
409
|
const groupConfig = config.groups;
|
|
383
|
-
const endorsementManager = groupConfig.endorsementManager;
|
|
384
410
|
const groupStore = this.groupStore;
|
|
385
|
-
const groupManager = this.groupManager;
|
|
386
411
|
const relay = this.relay;
|
|
387
412
|
const selfUserId = this._userId;
|
|
388
413
|
this.cipher.setEndorsementRefresher(async (groupId, memberUserIds) => {
|
|
414
|
+
const { manager: groupManager, endorsementManager } = await this.resolveGroupSession();
|
|
415
|
+
if (!endorsementManager)
|
|
416
|
+
return false;
|
|
389
417
|
// 1. Build ZK authorization (credential presentation + group public params)
|
|
390
418
|
const authorization = await groupManager.getAuthorization(groupId);
|
|
391
419
|
// 2. Get group secret params for endorsement processing
|
|
392
420
|
const masterKey = await groupStore.getMasterKey(groupId);
|
|
393
421
|
if (!masterKey)
|
|
394
422
|
return false;
|
|
395
|
-
const { deriveGroupSecretParams } = await import('../internal/protocol/zk/groups/index.js');
|
|
423
|
+
const { deriveGroupSecretParams, getGroupPublicParams } = await import('../internal/protocol/zk/groups/index.js');
|
|
396
424
|
const secretParams = deriveGroupSecretParams(masterKey);
|
|
397
|
-
// 3.
|
|
398
|
-
const groupIdBytes =
|
|
425
|
+
// 3. Derive the protocol identifier, not the display identifier's UTF-8 bytes.
|
|
426
|
+
const groupIdBytes = getGroupPublicParams(secretParams).groupId;
|
|
399
427
|
// 4. Fetch fresh endorsements from server
|
|
400
428
|
const { endorsements } = await relay.refreshGroupSendEndorsements(groupIdBytes, authorization);
|
|
401
429
|
// 5. Get cached group state for member ordering (server order)
|
|
@@ -440,7 +468,7 @@ export class SignalProtocolClient {
|
|
|
440
468
|
}
|
|
441
469
|
// NOTE: hooks are initialized in constructor (this.hooks = config?.hooks || {})
|
|
442
470
|
if (config?.enableDebugLogging) {
|
|
443
|
-
this.logger.debug('
|
|
471
|
+
this.logger.debug('DefaultSignalProtocolClient created', {
|
|
444
472
|
category: 'E2EE',
|
|
445
473
|
data: { userId, deviceId, config: this.sanitizeConfig(config) },
|
|
446
474
|
});
|
|
@@ -537,11 +565,17 @@ export class SignalProtocolClient {
|
|
|
537
565
|
/**
|
|
538
566
|
* Get GroupManager, throwing if not configured.
|
|
539
567
|
*/
|
|
540
|
-
|
|
541
|
-
if (!this.
|
|
542
|
-
throw new EncryptionError('Groups not configured. Provide groups config to
|
|
568
|
+
async resolveGroupSession() {
|
|
569
|
+
if (!this.groupSessionFor || !this.config.groups) {
|
|
570
|
+
throw new EncryptionError('Groups not configured. Provide groups config to DefaultSignalProtocolClient.create().', EncryptionErrorCode.INITIALIZATION_FAILED);
|
|
543
571
|
}
|
|
544
|
-
|
|
572
|
+
const authority = this.config.groups.resolveAuthority
|
|
573
|
+
? await this.config.groups.resolveAuthority()
|
|
574
|
+
: this.config.groups;
|
|
575
|
+
return this.groupSessionFor(authority);
|
|
576
|
+
}
|
|
577
|
+
get groups() {
|
|
578
|
+
return this.resolveGroupSession().then((session) => session.manager);
|
|
545
579
|
}
|
|
546
580
|
/**
|
|
547
581
|
* Get retry configuration for retry operations
|
|
@@ -577,7 +611,7 @@ export class SignalProtocolClient {
|
|
|
577
611
|
return this.state.getRelaySubscriptionState();
|
|
578
612
|
}
|
|
579
613
|
/**
|
|
580
|
-
* Get relay subscription callbacks (delegate back to
|
|
614
|
+
* Get relay subscription callbacks (delegate back to DefaultSignalProtocolClient methods)
|
|
581
615
|
*/
|
|
582
616
|
get relaySubscriptionCallbacks() {
|
|
583
617
|
return {
|
|
@@ -596,7 +630,7 @@ export class SignalProtocolClient {
|
|
|
596
630
|
};
|
|
597
631
|
}
|
|
598
632
|
/**
|
|
599
|
-
* Create and initialize a new
|
|
633
|
+
* Create and initialize a new DefaultSignalProtocolClient instance.
|
|
600
634
|
*
|
|
601
635
|
* This low-level factory fully initializes the client before it returns
|
|
602
636
|
* it. Most app code should prefer `createSignalProtocolClient()`, which
|
|
@@ -607,27 +641,27 @@ export class SignalProtocolClient {
|
|
|
607
641
|
*
|
|
608
642
|
* @param userId - User identifier for this device/client
|
|
609
643
|
* @param config - Optional configuration for the client
|
|
610
|
-
* @returns Fully initialized
|
|
644
|
+
* @returns Fully initialized DefaultSignalProtocolClient instance
|
|
611
645
|
*
|
|
612
646
|
* @example
|
|
613
647
|
* ```typescript
|
|
614
|
-
* import {
|
|
615
|
-
* import {
|
|
648
|
+
* import { DefaultSignalProtocolClient } from '@open-e2ee/signal-protocol-sdk';
|
|
649
|
+
* import { inMemoryRelay } from '@open-e2ee/signal-protocol-sdk/remote/relay/memory';
|
|
616
650
|
*
|
|
617
651
|
* // Local-only primary device.
|
|
618
|
-
* const signal = await
|
|
652
|
+
* const signal = await DefaultSignalProtocolClient.create('user-123', {
|
|
619
653
|
* storage,
|
|
620
654
|
* });
|
|
621
655
|
*
|
|
622
656
|
* // Linked device; storage must already contain provisioned identity material.
|
|
623
|
-
* const signal = await
|
|
657
|
+
* const signal = await DefaultSignalProtocolClient.create('user-123', {
|
|
624
658
|
* deviceId: 2,
|
|
625
659
|
* storage: provisionedLinkedDeviceStorage
|
|
626
660
|
* });
|
|
627
661
|
*
|
|
628
662
|
* // With relay sync.
|
|
629
|
-
* const relay =
|
|
630
|
-
* const signal = await
|
|
663
|
+
* const relay = inMemoryRelay();
|
|
664
|
+
* const signal = await DefaultSignalProtocolClient.create('user-123', {
|
|
631
665
|
* storage,
|
|
632
666
|
* relay,
|
|
633
667
|
* onProgress: ({ stage, percent, message }) => {
|
|
@@ -636,7 +670,7 @@ export class SignalProtocolClient {
|
|
|
636
670
|
* });
|
|
637
671
|
*
|
|
638
672
|
* // With full configuration
|
|
639
|
-
* const signal = await
|
|
673
|
+
* const signal = await DefaultSignalProtocolClient.create('user-123', {
|
|
640
674
|
* deviceId: 1,
|
|
641
675
|
* storage,
|
|
642
676
|
* relay,
|
|
@@ -647,7 +681,7 @@ export class SignalProtocolClient {
|
|
|
647
681
|
* });
|
|
648
682
|
*
|
|
649
683
|
* // For local development with in-memory adapters
|
|
650
|
-
* const signal = await
|
|
684
|
+
* const signal = await DefaultSignalProtocolClient.create('local-user', {
|
|
651
685
|
* protocolManager: inMemoryManager,
|
|
652
686
|
* storage: inMemoryStorage
|
|
653
687
|
* });
|
|
@@ -659,10 +693,10 @@ export class SignalProtocolClient {
|
|
|
659
693
|
// The lock allows only one storage instance per userId, which prevents database lock
|
|
660
694
|
// contention and session state corruption.
|
|
661
695
|
return storageLock.acquire(`storage-init-${userId}`, async () => {
|
|
662
|
-
// Storage is required -
|
|
696
|
+
// Storage is required - DefaultSignalProtocolClient is platform-agnostic
|
|
663
697
|
// Each platform must provide its own storage implementation
|
|
664
698
|
if (!config?.storage) {
|
|
665
|
-
throw new Error('
|
|
699
|
+
throw new Error('DefaultSignalProtocolClient.create() requires storage. ' +
|
|
666
700
|
'Expo: import { expoStore } from "@open-e2ee/signal-protocol-sdk/local/store/expo"; ' +
|
|
667
701
|
'Web: import { indexedDbStore } from "@open-e2ee/signal-protocol-sdk/local/store/web"; ' +
|
|
668
702
|
'Node: import { nodeStore } from "@open-e2ee/signal-protocol-sdk/local/store/node";');
|
|
@@ -682,7 +716,7 @@ export class SignalProtocolClient {
|
|
|
682
716
|
}
|
|
683
717
|
}
|
|
684
718
|
}
|
|
685
|
-
const client = new
|
|
719
|
+
const client = new DefaultSignalProtocolClient(userId, deviceId, finalConfig);
|
|
686
720
|
await client.initialize();
|
|
687
721
|
await client.hydratePersistedState();
|
|
688
722
|
// Cleanup expired sessions and message records on startup.
|
|
@@ -906,8 +940,8 @@ export class SignalProtocolClient {
|
|
|
906
940
|
*
|
|
907
941
|
* @example
|
|
908
942
|
* ```typescript
|
|
909
|
-
* const alice = await
|
|
910
|
-
* const bob = await
|
|
943
|
+
* const alice = await DefaultSignalProtocolClient.create('alice', { storage: aliceStorage });
|
|
944
|
+
* const bob = await DefaultSignalProtocolClient.create('bob', { storage: bobStorage });
|
|
911
945
|
*
|
|
912
946
|
* // Use address() to reference the local device
|
|
913
947
|
* await alice.encryptMessage(bob.address(), 'Hello');
|
|
@@ -1173,6 +1207,35 @@ export class SignalProtocolClient {
|
|
|
1173
1207
|
}
|
|
1174
1208
|
return results;
|
|
1175
1209
|
}
|
|
1210
|
+
/**
|
|
1211
|
+
* Receive a pulled batch through the subscription content handler.
|
|
1212
|
+
* The application must register onMessageDecrypted before calling this method.
|
|
1213
|
+
* Successful IDs are ready for transport acknowledgment.
|
|
1214
|
+
*/
|
|
1215
|
+
async receiveIncomingEnvelopes(envelopes) {
|
|
1216
|
+
if (!this.hooks?.onMessageDecrypted) {
|
|
1217
|
+
throw new Error('Register onMessageDecrypted before receiving Relay messages');
|
|
1218
|
+
}
|
|
1219
|
+
const processedMessageIds = [];
|
|
1220
|
+
const failedMessageIds = [];
|
|
1221
|
+
const context = { ...this.ctx, cipher: this.cipher };
|
|
1222
|
+
for (const envelope of sortEnvelopesForDecryption(envelopes)) {
|
|
1223
|
+
try {
|
|
1224
|
+
const processed = await RelaySubscriptionOps.processRelayMessage(context, {
|
|
1225
|
+
...envelope,
|
|
1226
|
+
targetUserId: this.userId,
|
|
1227
|
+
targetDeviceId: this.deviceId,
|
|
1228
|
+
deliveryClass: 'user-visible',
|
|
1229
|
+
messageType: (envelope.messageType ?? 'ciphertext'),
|
|
1230
|
+
}, this.relaySubscriptionState, this.relaySubscriptionCallbacks, { ...this.relaySubscriptionConfig, acknowledgeFailures: false });
|
|
1231
|
+
(processed ? processedMessageIds : failedMessageIds).push(envelope.id);
|
|
1232
|
+
}
|
|
1233
|
+
catch {
|
|
1234
|
+
failedMessageIds.push(envelope.id);
|
|
1235
|
+
}
|
|
1236
|
+
}
|
|
1237
|
+
return { processedMessageIds, failedMessageIds };
|
|
1238
|
+
}
|
|
1176
1239
|
/**
|
|
1177
1240
|
* Internal: Send SESAME retry request for failed decryption.
|
|
1178
1241
|
*
|
|
@@ -1306,7 +1369,7 @@ export class SignalProtocolClient {
|
|
|
1306
1369
|
}
|
|
1307
1370
|
async downloadAttachment(attachment, options) {
|
|
1308
1371
|
if (!this.remoteObjectStore) {
|
|
1309
|
-
throw new EncryptionError('Remote object storage not configured. Provide remoteObjectStore in
|
|
1372
|
+
throw new EncryptionError('Remote object storage not configured. Provide remoteObjectStore in DefaultSignalProtocolClient.create() config.', EncryptionErrorCode.INITIALIZATION_FAILED);
|
|
1310
1373
|
}
|
|
1311
1374
|
return resolveMediaAttachment(attachment, {
|
|
1312
1375
|
remoteObjectStore: this.remoteObjectStore,
|
|
@@ -1321,7 +1384,7 @@ export class SignalProtocolClient {
|
|
|
1321
1384
|
}
|
|
1322
1385
|
async deleteRemoteAttachment(attachment, options) {
|
|
1323
1386
|
if (!this.remoteObjectStore) {
|
|
1324
|
-
throw new EncryptionError('Remote object storage not configured. Provide remoteObjectStore in
|
|
1387
|
+
throw new EncryptionError('Remote object storage not configured. Provide remoteObjectStore in DefaultSignalProtocolClient.create() config.', EncryptionErrorCode.INITIALIZATION_FAILED);
|
|
1325
1388
|
}
|
|
1326
1389
|
await deleteMediaAttachment(attachment, {
|
|
1327
1390
|
remoteObjectStore: this.remoteObjectStore,
|
|
@@ -1407,7 +1470,7 @@ export class SignalProtocolClient {
|
|
|
1407
1470
|
* Register a hook callback after construction
|
|
1408
1471
|
*
|
|
1409
1472
|
* Enables dependency injection patterns where callers register hooks
|
|
1410
|
-
* after the
|
|
1473
|
+
* after the DefaultSignalProtocolClient exists. ServicesProvider uses this
|
|
1411
1474
|
* to wire up ContentManager's decryption hook.
|
|
1412
1475
|
*
|
|
1413
1476
|
* @param name - The hook name to register
|
|
@@ -1416,14 +1479,14 @@ export class SignalProtocolClient {
|
|
|
1416
1479
|
* @example
|
|
1417
1480
|
* ```typescript
|
|
1418
1481
|
* // In ServicesProvider: wire up ContentManager after creation
|
|
1419
|
-
* const signal = await
|
|
1482
|
+
* const signal = await DefaultSignalProtocolClient.create(userId, { storage, relay });
|
|
1420
1483
|
* const content = new ContentManager({ db, signal });
|
|
1421
1484
|
*
|
|
1422
1485
|
* signal.registerHook('onMessageDecrypted', content.getDecryptionHook());
|
|
1423
1486
|
* signal.startRelaySubscription(); // Now safe to start
|
|
1424
1487
|
* ```
|
|
1425
1488
|
*
|
|
1426
|
-
* @see
|
|
1489
|
+
* @see SignalProtocolClient.registerHook
|
|
1427
1490
|
*/
|
|
1428
1491
|
registerHook(name, callback) {
|
|
1429
1492
|
this.hooks[name] = callback;
|
|
@@ -1438,7 +1501,7 @@ export class SignalProtocolClient {
|
|
|
1438
1501
|
/**
|
|
1439
1502
|
* Start relay subscription for automatic message decryption
|
|
1440
1503
|
*
|
|
1441
|
-
* When configured with both `relay` and `onMessageDecrypted` hook,
|
|
1504
|
+
* When configured with both `relay` and `onMessageDecrypted` hook, DefaultSignalProtocolClient will:
|
|
1442
1505
|
* 1. Subscribe to incoming envelopes from the relay
|
|
1443
1506
|
* 2. Decrypt messages appropriately (pairwise vs group/sender key)
|
|
1444
1507
|
* 3. Call onMessageDecrypted hook with DecryptedEnvelope (for ContentManager storage)
|
|
@@ -1450,7 +1513,7 @@ export class SignalProtocolClient {
|
|
|
1450
1513
|
* Callers can run this manually after registering hooks via registerHook().
|
|
1451
1514
|
* Called automatically by create() when relay + hook configured.
|
|
1452
1515
|
*
|
|
1453
|
-
* @see
|
|
1516
|
+
* @see SignalProtocolClient.startRelaySubscription
|
|
1454
1517
|
*/
|
|
1455
1518
|
startRelaySubscription() {
|
|
1456
1519
|
if (!this.relay) {
|
|
@@ -1493,12 +1556,12 @@ export class SignalProtocolClient {
|
|
|
1493
1556
|
* Stop the relay subscription
|
|
1494
1557
|
*
|
|
1495
1558
|
* Pauses message processing via the relay subscription without destroying
|
|
1496
|
-
*
|
|
1559
|
+
* DefaultSignalProtocolClient state. startRelaySubscription() restarts the subscription.
|
|
1497
1560
|
*
|
|
1498
1561
|
* Use this when the app backgrounds to let the background task handle messages.
|
|
1499
1562
|
* Resume when the app foregrounds for real-time message delivery.
|
|
1500
1563
|
*
|
|
1501
|
-
* @see
|
|
1564
|
+
* @see SignalProtocolClient.stopRelaySubscription
|
|
1502
1565
|
*/
|
|
1503
1566
|
stopRelaySubscription() {
|
|
1504
1567
|
// Flush any pending batched delivery receipts before unsubscribing
|
|
@@ -1792,7 +1855,7 @@ export class SignalProtocolClient {
|
|
|
1792
1855
|
}
|
|
1793
1856
|
// 5. Clear internal tracking state via state manager
|
|
1794
1857
|
this.state.clearForStop();
|
|
1795
|
-
this.logger.debug('
|
|
1858
|
+
this.logger.debug('DefaultSignalProtocolClient stopped', {
|
|
1796
1859
|
category: 'E2EE',
|
|
1797
1860
|
data: { userId: this.userId, deviceId: this.deviceId },
|
|
1798
1861
|
});
|
|
@@ -2299,77 +2362,77 @@ export class SignalProtocolClient {
|
|
|
2299
2362
|
* Create a new group.
|
|
2300
2363
|
*/
|
|
2301
2364
|
async createGroup(creatorAci, creatorProfileKey, members, title, options) {
|
|
2302
|
-
return GroupOps.createGroup(this.ctx, this.groups, creatorAci, creatorProfileKey, members, title, options);
|
|
2365
|
+
return GroupOps.createGroup(this.ctx, await this.groups, creatorAci, creatorProfileKey, members, title, options);
|
|
2303
2366
|
}
|
|
2304
2367
|
/**
|
|
2305
2368
|
* Get decrypted group state (from cache or server).
|
|
2306
2369
|
*/
|
|
2307
2370
|
async getGroupState(groupId) {
|
|
2308
|
-
return GroupOps.getGroupState(this.ctx, this.groups, groupId);
|
|
2371
|
+
return GroupOps.getGroupState(this.ctx, await this.groups, groupId);
|
|
2309
2372
|
}
|
|
2310
2373
|
/**
|
|
2311
2374
|
* Sync group state from server.
|
|
2312
2375
|
*/
|
|
2313
2376
|
async syncGroup(groupId) {
|
|
2314
|
-
return GroupOps.syncGroup(this.ctx, this.groups, groupId);
|
|
2377
|
+
return GroupOps.syncGroup(this.ctx, await this.groups, groupId);
|
|
2315
2378
|
}
|
|
2316
2379
|
/**
|
|
2317
2380
|
* Add a member to a group.
|
|
2318
2381
|
*/
|
|
2319
2382
|
async addGroupMember(groupId, editorAci, member) {
|
|
2320
|
-
return GroupOps.addGroupMember(this.ctx, this.groups, groupId, editorAci, member);
|
|
2383
|
+
return GroupOps.addGroupMember(this.ctx, await this.groups, groupId, editorAci, member);
|
|
2321
2384
|
}
|
|
2322
2385
|
/** Accept this client's pending profile-key invitation. */
|
|
2323
2386
|
async acceptGroupMemberInvitation(groupId) {
|
|
2324
|
-
return GroupOps.acceptGroupMemberInvitation(this.ctx, this.groups, groupId);
|
|
2387
|
+
return GroupOps.acceptGroupMemberInvitation(this.ctx, await this.groups, groupId);
|
|
2325
2388
|
}
|
|
2326
2389
|
/**
|
|
2327
2390
|
* Decline this account's ACI- or PNI-keyed pending invitation.
|
|
2328
2391
|
*/
|
|
2329
2392
|
async declineGroupMemberInvitation(groupId, identity = 'aci') {
|
|
2330
|
-
return GroupOps.declineGroupMemberInvitation(this.ctx, this.groups, groupId, identity);
|
|
2393
|
+
return GroupOps.declineGroupMemberInvitation(this.ctx, await this.groups, groupId, identity);
|
|
2331
2394
|
}
|
|
2332
2395
|
/**
|
|
2333
2396
|
* Remove a member from a group. Triggers sender key rotation.
|
|
2334
2397
|
*/
|
|
2335
2398
|
async removeGroupMember(groupId, editorAci, targetAci) {
|
|
2336
|
-
return GroupOps.removeGroupMember(this.ctx, this.groups, groupId, editorAci, targetAci);
|
|
2399
|
+
return GroupOps.removeGroupMember(this.ctx, await this.groups, groupId, editorAci, targetAci);
|
|
2337
2400
|
}
|
|
2338
2401
|
/**
|
|
2339
2402
|
* Leave a group.
|
|
2340
2403
|
*/
|
|
2341
2404
|
async leaveGroup(groupId, userAci) {
|
|
2342
|
-
return GroupOps.leaveGroup(this.ctx, this.groups, groupId, userAci);
|
|
2405
|
+
return GroupOps.leaveGroup(this.ctx, await this.groups, groupId, userAci);
|
|
2343
2406
|
}
|
|
2344
2407
|
/**
|
|
2345
2408
|
* Update a group's title.
|
|
2346
2409
|
*/
|
|
2347
2410
|
async updateGroupTitle(groupId, editorAci, title) {
|
|
2348
|
-
return GroupOps.updateGroupTitle(this.ctx, this.groups, groupId, editorAci, title);
|
|
2411
|
+
return GroupOps.updateGroupTitle(this.ctx, await this.groups, groupId, editorAci, title);
|
|
2349
2412
|
}
|
|
2350
2413
|
/**
|
|
2351
2414
|
* Update a group's description.
|
|
2352
2415
|
*/
|
|
2353
2416
|
async updateGroupDescription(groupId, editorAci, description) {
|
|
2354
|
-
return GroupOps.updateGroupDescription(this.ctx, this.groups, groupId, editorAci, description);
|
|
2417
|
+
return GroupOps.updateGroupDescription(this.ctx, await this.groups, groupId, editorAci, description);
|
|
2355
2418
|
}
|
|
2356
2419
|
/**
|
|
2357
2420
|
* Update a group's access control.
|
|
2358
2421
|
*/
|
|
2359
2422
|
async updateGroupAccessControl(groupId, editorAci, updates) {
|
|
2360
|
-
return GroupOps.updateGroupAccessControl(this.ctx, this.groups, groupId, editorAci, updates);
|
|
2423
|
+
return GroupOps.updateGroupAccessControl(this.ctx, await this.groups, groupId, editorAci, updates);
|
|
2361
2424
|
}
|
|
2362
2425
|
/**
|
|
2363
2426
|
* Create an invite link for a group.
|
|
2364
2427
|
*/
|
|
2365
2428
|
async createGroupInviteLink(groupId, editorAci) {
|
|
2366
|
-
return GroupOps.createGroupInviteLink(this.ctx, this.groups, groupId, editorAci);
|
|
2429
|
+
return GroupOps.createGroupInviteLink(this.ctx, await this.groups, groupId, editorAci);
|
|
2367
2430
|
}
|
|
2368
2431
|
/**
|
|
2369
2432
|
* Join a group via invite link.
|
|
2370
2433
|
*/
|
|
2371
2434
|
async joinGroupViaInviteLink(url, userAci, userProfileKey) {
|
|
2372
|
-
return GroupOps.joinGroupViaInviteLink(this.ctx, this.groups, url, userAci, userProfileKey);
|
|
2435
|
+
return GroupOps.joinGroupViaInviteLink(this.ctx, await this.groups, url, userAci, userProfileKey);
|
|
2373
2436
|
}
|
|
2374
2437
|
// ============================================================================
|
|
2375
2438
|
// PRIVATE METHODS
|