@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
|
@@ -9,25 +9,24 @@
|
|
|
9
9
|
* Security-critical mutable state (contact trust, one-time prekeys, and
|
|
10
10
|
* sessions) is committed through one encrypted, versioned state file. A
|
|
11
11
|
* write-fsync/rename/directory-fsync sequence provides a crash-durable commit
|
|
12
|
-
* point
|
|
12
|
+
* point. A kernel file lock serializes state transactions across processes.
|
|
13
13
|
* Other independent collections remain encrypted JSON records.
|
|
14
14
|
*
|
|
15
15
|
* All sensitive data encrypted before storage.
|
|
16
16
|
*/
|
|
17
|
-
import { access, mkdir,
|
|
18
|
-
import { join } from 'node:path';
|
|
17
|
+
import { access, mkdir, readFile, readdir, rm, unlink } from 'node:fs/promises';
|
|
18
|
+
import { join, resolve } from 'node:path';
|
|
19
19
|
import { homedir } from 'node:os';
|
|
20
20
|
import { EncryptionError, EncryptionErrorCode } from '../../../types/index.js';
|
|
21
|
+
import { receivedContentKey, parseReceivedContent } from '../received-content.js';
|
|
21
22
|
import { resolveSignalProtocolLogger } from '../../../logger.js';
|
|
22
23
|
import { MAX_UNACKNOWLEDGED_SESSION_AGE_MS } from '../../../types/protocol-config.js';
|
|
23
|
-
import { getErrorMessage } from '../../../utils/errors.js';
|
|
24
24
|
import { encryptRecord, decryptRecord } from './database-encryption.js';
|
|
25
|
-
import { getNodeDatabaseKeyManager } from './database-key.js';
|
|
25
|
+
import { getNodeDatabaseKeyManager, NODE_DATABASE_RESET_FILE } from './database-key.js';
|
|
26
|
+
import { withNodeDatabaseLock } from './database-lock.js';
|
|
27
|
+
import { commitNodeDatabaseFile, isNodeDatabaseDataEntry, isNodeDatabaseRecord, syncNodeDatabaseDirectory, } from './database-file-commit.js';
|
|
28
|
+
import { createKyberPreKeyState, createKyberPreKeyInstanceId, getCurrentKyberPreKey, getRetainedKyberPreKey, retainKyberPreKey, recordKyberPreKeyUse, recordKyberPreKeyUseById, } from '../kyber-prekey-lifecycle.js';
|
|
26
29
|
const DEFAULT_DATA_DIR = join(homedir(), '.config', 'open-e2ee', 'signal-protocol');
|
|
27
|
-
/**
|
|
28
|
-
* File permissions for encrypted data (0600 = owner read/write only)
|
|
29
|
-
*/
|
|
30
|
-
const SECURE_FILE_MODE = 0o600;
|
|
31
30
|
function emptyDictionary() {
|
|
32
31
|
return Object.create(null);
|
|
33
32
|
}
|
|
@@ -45,7 +44,7 @@ function createEmptySecurityState() {
|
|
|
45
44
|
messageRecords: emptyDictionary(),
|
|
46
45
|
metadata: emptyDictionary(),
|
|
47
46
|
registrationIds: emptyDictionary(),
|
|
48
|
-
|
|
47
|
+
kyberPreKeyStates: emptyDictionary(),
|
|
49
48
|
};
|
|
50
49
|
}
|
|
51
50
|
/**
|
|
@@ -78,7 +77,6 @@ export class NodeEncryptedDatabase {
|
|
|
78
77
|
securityStatePath;
|
|
79
78
|
logger;
|
|
80
79
|
securityStateMutation = Promise.resolve();
|
|
81
|
-
atomicWriteCounter = 0;
|
|
82
80
|
/**
|
|
83
81
|
* Create a new NodeEncryptedDatabase instance
|
|
84
82
|
*
|
|
@@ -102,25 +100,23 @@ export class NodeEncryptedDatabase {
|
|
|
102
100
|
return this.initPromise;
|
|
103
101
|
}
|
|
104
102
|
// Create new initialization promise
|
|
105
|
-
this.initPromise = this._initialize()
|
|
103
|
+
this.initPromise = this._initialize().catch((error) => {
|
|
104
|
+
this.initPromise = null;
|
|
105
|
+
throw error;
|
|
106
|
+
});
|
|
106
107
|
return this.initPromise;
|
|
107
108
|
}
|
|
108
109
|
async _initialize() {
|
|
109
110
|
try {
|
|
110
|
-
// Create directory structure
|
|
111
|
-
await mkdir(this.dataDir, { recursive: true, mode: 0o700 });
|
|
112
|
-
await mkdir(this.sessionsDir, { recursive: true, mode: 0o700 });
|
|
113
|
-
// Get database encryption key
|
|
114
111
|
const dbKeyManager = getNodeDatabaseKeyManager(this.dataDir);
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
await
|
|
119
|
-
}
|
|
120
|
-
this.dbKey = await dbKeyManager.getKeyOrThrow();
|
|
121
|
-
await this.initializeAtomicSecurityState();
|
|
112
|
+
await dbKeyManager.withKey(async (key) => {
|
|
113
|
+
await mkdir(this.sessionsDir, { recursive: true, mode: 0o700 });
|
|
114
|
+
this.dbKey = key;
|
|
115
|
+
await this.initializeAtomicSecurityState();
|
|
116
|
+
}, true);
|
|
122
117
|
}
|
|
123
118
|
catch (error) {
|
|
119
|
+
this.dbKey = null;
|
|
124
120
|
throw new EncryptionError('Failed to initialize encrypted database', EncryptionErrorCode.INITIALIZATION_FAILED, { originalError: error });
|
|
125
121
|
}
|
|
126
122
|
}
|
|
@@ -128,9 +124,15 @@ export class NodeEncryptedDatabase {
|
|
|
128
124
|
* Initialize the database if it is not initialized yet
|
|
129
125
|
*/
|
|
130
126
|
async ensureInitialized() {
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
127
|
+
await this.initialize();
|
|
128
|
+
}
|
|
129
|
+
async withCurrentKey(operation) {
|
|
130
|
+
return getNodeDatabaseKeyManager(this.dataDir).withKey(async (key) => {
|
|
131
|
+
if (!this.dbKey || !Buffer.from(key).equals(Buffer.from(this.dbKey))) {
|
|
132
|
+
throw new Error('Node database authority changed. Close and reopen the store before retrying.');
|
|
133
|
+
}
|
|
134
|
+
return operation();
|
|
135
|
+
});
|
|
134
136
|
}
|
|
135
137
|
/**
|
|
136
138
|
* Direct pre-1.0 format reset. Contacts, one-time prekeys, and sessions now
|
|
@@ -205,56 +207,32 @@ export class NodeEncryptedDatabase {
|
|
|
205
207
|
messageRecords: toNullPrototype(decoded.messageRecords, 2),
|
|
206
208
|
metadata: toNullPrototype(decoded.metadata, 1),
|
|
207
209
|
registrationIds: toNullPrototype(decoded.registrationIds, 1),
|
|
208
|
-
|
|
210
|
+
kyberPreKeyStates: toNullPrototype(decoded.kyberPreKeyStates, 1),
|
|
209
211
|
};
|
|
210
212
|
}
|
|
211
213
|
async writeSecurityStateFile(state) {
|
|
212
214
|
const encrypted = encryptRecord(state, this.dbKey);
|
|
213
|
-
const tempPath = `${this.securityStatePath}.${process.pid}.${this.atomicWriteCounter++}.tmp`;
|
|
214
215
|
try {
|
|
215
|
-
await
|
|
216
|
-
mode: SECURE_FILE_MODE,
|
|
217
|
-
encoding: 'utf8',
|
|
218
|
-
});
|
|
219
|
-
const handle = await open(tempPath, 'r');
|
|
220
|
-
try {
|
|
221
|
-
await handle.sync();
|
|
222
|
-
}
|
|
223
|
-
finally {
|
|
224
|
-
await handle.close();
|
|
225
|
-
}
|
|
226
|
-
await rename(tempPath, this.securityStatePath);
|
|
227
|
-
// POSIX rename is atomic, but the containing directory must also be
|
|
228
|
-
// synchronized for the new directory entry to survive sudden power loss.
|
|
229
|
-
// Windows does not support opening directories this way.
|
|
230
|
-
if (process.platform !== 'win32') {
|
|
231
|
-
const directoryHandle = await open(this.dataDir, 'r');
|
|
232
|
-
try {
|
|
233
|
-
await directoryHandle.sync();
|
|
234
|
-
}
|
|
235
|
-
finally {
|
|
236
|
-
await directoryHandle.close();
|
|
237
|
-
}
|
|
238
|
-
}
|
|
216
|
+
await commitNodeDatabaseFile(this.securityStatePath, JSON.stringify(encrypted));
|
|
239
217
|
}
|
|
240
218
|
catch (error) {
|
|
241
|
-
await unlink(tempPath).catch(() => undefined);
|
|
242
219
|
throw new EncryptionError('Failed to atomically write Node protocol security state', EncryptionErrorCode.KEY_STORAGE_ERROR, { originalError: error });
|
|
243
220
|
}
|
|
244
221
|
}
|
|
245
222
|
async readSecurityState() {
|
|
246
223
|
await this.ensureInitialized();
|
|
247
224
|
await this.securityStateMutation;
|
|
248
|
-
return
|
|
225
|
+
return this.withCurrentKey(() => this.readSecurityStateFile());
|
|
249
226
|
}
|
|
250
|
-
async mutateSecurityState(mutation) {
|
|
227
|
+
async mutateSecurityState(mutation, commitWhen = () => true) {
|
|
251
228
|
await this.ensureInitialized();
|
|
252
|
-
const operation = this.securityStateMutation.then(async () => {
|
|
229
|
+
const operation = this.securityStateMutation.then(() => this.withCurrentKey(async () => {
|
|
253
230
|
const state = await this.readSecurityStateFile();
|
|
254
231
|
const result = mutation(state);
|
|
255
|
-
|
|
232
|
+
if (commitWhen(result))
|
|
233
|
+
await this.writeSecurityStateFile(state);
|
|
256
234
|
return result;
|
|
257
|
-
});
|
|
235
|
+
}));
|
|
258
236
|
this.securityStateMutation = operation.then(() => undefined, () => undefined);
|
|
259
237
|
return await operation;
|
|
260
238
|
}
|
|
@@ -262,7 +240,10 @@ export class NodeEncryptedDatabase {
|
|
|
262
240
|
* Get file path for a collection
|
|
263
241
|
*/
|
|
264
242
|
getCollectionPath(collection) {
|
|
265
|
-
|
|
243
|
+
const name = `${collection}.json`;
|
|
244
|
+
if (!isNodeDatabaseRecord(name))
|
|
245
|
+
throw new Error('Invalid Node database collection.');
|
|
246
|
+
return join(this.dataDir, name);
|
|
266
247
|
}
|
|
267
248
|
// ============================================================================
|
|
268
249
|
// Generic Collection Operations
|
|
@@ -272,49 +253,54 @@ export class NodeEncryptedDatabase {
|
|
|
272
253
|
*/
|
|
273
254
|
async readCollection(collection) {
|
|
274
255
|
await this.ensureInitialized();
|
|
275
|
-
|
|
276
|
-
|
|
277
|
-
|
|
278
|
-
|
|
279
|
-
|
|
280
|
-
|
|
281
|
-
catch (error) {
|
|
282
|
-
if (error.code === 'ENOENT') {
|
|
283
|
-
return [];
|
|
256
|
+
return this.withCurrentKey(async () => {
|
|
257
|
+
const filePath = this.getCollectionPath(collection);
|
|
258
|
+
try {
|
|
259
|
+
const fileData = await readFile(filePath, 'utf8');
|
|
260
|
+
const encrypted = JSON.parse(fileData);
|
|
261
|
+
return decryptRecord(encrypted, this.dbKey);
|
|
284
262
|
}
|
|
285
|
-
|
|
286
|
-
|
|
263
|
+
catch (error) {
|
|
264
|
+
if (error.code === 'ENOENT') {
|
|
265
|
+
return [];
|
|
266
|
+
}
|
|
267
|
+
throw new EncryptionError(`Failed to read collection: ${collection}`, EncryptionErrorCode.KEY_STORAGE_ERROR, { originalError: error });
|
|
268
|
+
}
|
|
269
|
+
});
|
|
287
270
|
}
|
|
288
271
|
/**
|
|
289
272
|
* Write a collection to disk
|
|
290
273
|
*/
|
|
291
274
|
async writeCollection(collection, data) {
|
|
292
275
|
await this.ensureInitialized();
|
|
293
|
-
|
|
294
|
-
|
|
295
|
-
|
|
296
|
-
|
|
297
|
-
|
|
298
|
-
|
|
299
|
-
|
|
300
|
-
|
|
301
|
-
|
|
302
|
-
|
|
303
|
-
}
|
|
276
|
+
return this.withCurrentKey(async () => {
|
|
277
|
+
const filePath = this.getCollectionPath(collection);
|
|
278
|
+
const encrypted = encryptRecord(data, this.dbKey);
|
|
279
|
+
try {
|
|
280
|
+
await commitNodeDatabaseFile(filePath, JSON.stringify(encrypted));
|
|
281
|
+
}
|
|
282
|
+
catch (error) {
|
|
283
|
+
throw new EncryptionError(`Failed to write collection: ${collection}`, EncryptionErrorCode.KEY_STORAGE_ERROR, { originalError: error });
|
|
284
|
+
}
|
|
285
|
+
});
|
|
304
286
|
}
|
|
305
287
|
/**
|
|
306
288
|
* Delete a collection from disk
|
|
307
289
|
*/
|
|
308
290
|
async deleteCollection(collection) {
|
|
309
|
-
|
|
310
|
-
|
|
311
|
-
|
|
312
|
-
|
|
313
|
-
|
|
314
|
-
|
|
315
|
-
throw new EncryptionError(`Failed to delete collection: ${collection}`, EncryptionErrorCode.KEY_STORAGE_ERROR, { originalError: error });
|
|
291
|
+
await this.ensureInitialized();
|
|
292
|
+
return this.withCurrentKey(async () => {
|
|
293
|
+
const filePath = this.getCollectionPath(collection);
|
|
294
|
+
try {
|
|
295
|
+
await unlink(filePath);
|
|
296
|
+
await syncNodeDatabaseDirectory(this.dataDir);
|
|
316
297
|
}
|
|
317
|
-
|
|
298
|
+
catch (error) {
|
|
299
|
+
if (error.code !== 'ENOENT') {
|
|
300
|
+
throw new EncryptionError(`Failed to delete collection: ${collection}`, EncryptionErrorCode.KEY_STORAGE_ERROR, { originalError: error });
|
|
301
|
+
}
|
|
302
|
+
}
|
|
303
|
+
});
|
|
318
304
|
}
|
|
319
305
|
// ============================================================================
|
|
320
306
|
// Identity Keys
|
|
@@ -470,34 +456,39 @@ export class NodeEncryptedDatabase {
|
|
|
470
456
|
// ============================================================================
|
|
471
457
|
// Kyber PreKeys
|
|
472
458
|
// ============================================================================
|
|
473
|
-
async storeKyberPreKey(
|
|
474
|
-
const
|
|
475
|
-
|
|
476
|
-
|
|
477
|
-
|
|
478
|
-
|
|
479
|
-
|
|
459
|
+
async storeKyberPreKey(key, identityType = 'aci') {
|
|
460
|
+
const instanceId = await createKyberPreKeyInstanceId();
|
|
461
|
+
await this.mutateSecurityState((state) => {
|
|
462
|
+
const kyberState = state.kyberPreKeyStates[identityType] ??
|
|
463
|
+
(state.kyberPreKeyStates[identityType] = createKyberPreKeyState());
|
|
464
|
+
retainKyberPreKey(kyberState, key, identityType, Date.now(), instanceId);
|
|
465
|
+
});
|
|
480
466
|
}
|
|
481
|
-
async
|
|
482
|
-
const
|
|
483
|
-
|
|
484
|
-
|
|
485
|
-
|
|
467
|
+
async getCurrentKyberPreKey(identityType = 'aci') {
|
|
468
|
+
const state = await this.readSecurityState();
|
|
469
|
+
return getCurrentKyberPreKey(state.kyberPreKeyStates[identityType]);
|
|
470
|
+
}
|
|
471
|
+
async getKyberPreKeyById(id, identityType = 'aci') {
|
|
472
|
+
const state = await this.readSecurityState();
|
|
473
|
+
return getRetainedKyberPreKey(state.kyberPreKeyStates[identityType], id);
|
|
486
474
|
}
|
|
487
475
|
async deleteKyberPreKey(id, identityType = 'aci') {
|
|
488
|
-
|
|
489
|
-
|
|
490
|
-
|
|
491
|
-
|
|
476
|
+
await this.mutateSecurityState((state) => {
|
|
477
|
+
const kyberState = state.kyberPreKeyStates[identityType];
|
|
478
|
+
if (!kyberState)
|
|
479
|
+
return;
|
|
480
|
+
delete kyberState.instances[String(id)];
|
|
481
|
+
if (kyberState.currentKeyId === id)
|
|
482
|
+
kyberState.currentKeyId = null;
|
|
483
|
+
});
|
|
492
484
|
}
|
|
493
485
|
async deleteAllKyberPreKeys(identityType) {
|
|
494
|
-
|
|
495
|
-
|
|
496
|
-
|
|
497
|
-
|
|
498
|
-
|
|
499
|
-
|
|
500
|
-
}
|
|
486
|
+
await this.mutateSecurityState((state) => {
|
|
487
|
+
if (identityType)
|
|
488
|
+
delete state.kyberPreKeyStates[identityType];
|
|
489
|
+
else
|
|
490
|
+
state.kyberPreKeyStates = emptyDictionary();
|
|
491
|
+
});
|
|
501
492
|
}
|
|
502
493
|
// ============================================================================
|
|
503
494
|
// Sessions
|
|
@@ -527,7 +518,7 @@ export class NodeEncryptedDatabase {
|
|
|
527
518
|
state.sessions = emptyDictionary();
|
|
528
519
|
});
|
|
529
520
|
}
|
|
530
|
-
async commitSessionTrust(sessionId, userId, deviceId, serializedRecord, localIdentityType, contactKey, contactMutation, oneTimePreKeyId, kemOneTimePreKeyId) {
|
|
521
|
+
async commitSessionTrust(sessionId, userId, deviceId, serializedRecord, localIdentityType, contactKey, contactMutation, oneTimePreKeyId, kemOneTimePreKeyId, receivedContent, kyberPreKeyUse) {
|
|
531
522
|
await this.mutateSecurityState((state) => {
|
|
532
523
|
if (oneTimePreKeyId !== undefined &&
|
|
533
524
|
!(state.ecOneTimePreKeys[localIdentityType] ?? []).some((key) => key.keyId === oneTimePreKeyId)) {
|
|
@@ -537,8 +528,13 @@ export class NodeEncryptedDatabase {
|
|
|
537
528
|
!(state.kemOneTimePreKeys[localIdentityType] ?? []).some((key) => key.keyId === kemOneTimePreKeyId)) {
|
|
538
529
|
throw new Error('Atomic session/trust commit cannot consume a missing KEM one-time prekey');
|
|
539
530
|
}
|
|
531
|
+
if (kyberPreKeyUse) {
|
|
532
|
+
recordKyberPreKeyUse(state.kyberPreKeyStates[localIdentityType], localIdentityType, kyberPreKeyUse);
|
|
533
|
+
}
|
|
540
534
|
state.contacts[contactKey] = contactMutation(state.contacts[contactKey] ?? null);
|
|
541
535
|
state.sessions[sessionId] = { userId, deviceId, serializedRecord };
|
|
536
|
+
if (receivedContent)
|
|
537
|
+
state.metadata[receivedContentKey(receivedContent.id)] = JSON.stringify(receivedContent);
|
|
542
538
|
if (oneTimePreKeyId !== undefined) {
|
|
543
539
|
state.ecOneTimePreKeys[localIdentityType] = (state.ecOneTimePreKeys[localIdentityType] ?? []).filter((key) => key.keyId !== oneTimePreKeyId);
|
|
544
540
|
}
|
|
@@ -556,10 +552,7 @@ export class NodeEncryptedDatabase {
|
|
|
556
552
|
// ============================================================================
|
|
557
553
|
async readSesameState() {
|
|
558
554
|
const state = await this.readSecurityState();
|
|
559
|
-
return {
|
|
560
|
-
users: state.sesameUsers,
|
|
561
|
-
sessions: state.sessions,
|
|
562
|
-
};
|
|
555
|
+
return { users: state.sesameUsers, sessions: state.sessions };
|
|
563
556
|
}
|
|
564
557
|
/** Drop every session and every SESAME device record in one commit. */
|
|
565
558
|
async clearSesameState() {
|
|
@@ -569,10 +562,7 @@ export class NodeEncryptedDatabase {
|
|
|
569
562
|
});
|
|
570
563
|
}
|
|
571
564
|
async mutateSesameState(mutation) {
|
|
572
|
-
return await this.mutateSecurityState((state) => mutation({
|
|
573
|
-
users: state.sesameUsers,
|
|
574
|
-
sessions: state.sessions,
|
|
575
|
-
}));
|
|
565
|
+
return await this.mutateSecurityState((state) => mutation({ users: state.sesameUsers, sessions: state.sessions }));
|
|
576
566
|
}
|
|
577
567
|
// ============================================================================
|
|
578
568
|
// Sender Keys (Group Messaging)
|
|
@@ -592,12 +582,17 @@ export class NodeEncryptedDatabase {
|
|
|
592
582
|
* together. A crash between them would leave a sender key whose in-flight
|
|
593
583
|
* messages can no longer be resolved.
|
|
594
584
|
*/
|
|
595
|
-
async mutateSenderKeyState(mutation) {
|
|
596
|
-
return await this.mutateSecurityState((state) =>
|
|
597
|
-
|
|
598
|
-
|
|
599
|
-
|
|
600
|
-
|
|
585
|
+
async mutateSenderKeyState(mutation, receivedContent) {
|
|
586
|
+
return await this.mutateSecurityState((state) => {
|
|
587
|
+
const result = mutation({
|
|
588
|
+
current: state.senderKeys,
|
|
589
|
+
records: state.senderKeyRecords,
|
|
590
|
+
skipped: state.skippedSenderKeys,
|
|
591
|
+
});
|
|
592
|
+
if (receivedContent)
|
|
593
|
+
state.metadata[receivedContentKey(receivedContent.id)] = JSON.stringify(receivedContent);
|
|
594
|
+
return result;
|
|
595
|
+
});
|
|
601
596
|
}
|
|
602
597
|
// ============================================================================
|
|
603
598
|
// Message Records (SESAME Retry Support)
|
|
@@ -626,6 +621,32 @@ export class NodeEncryptedDatabase {
|
|
|
626
621
|
delete state.metadata[key];
|
|
627
622
|
});
|
|
628
623
|
}
|
|
624
|
+
async deleteExpiredReceivedContent(before) {
|
|
625
|
+
return this.mutateSecurityState((state) => {
|
|
626
|
+
let count = 0;
|
|
627
|
+
const prefix = receivedContentKey('');
|
|
628
|
+
for (const [key, value] of Object.entries(state.metadata)) {
|
|
629
|
+
if (!key.startsWith(prefix))
|
|
630
|
+
continue;
|
|
631
|
+
if (parseReceivedContent(value, key.slice(prefix.length)).receivedAt < before) {
|
|
632
|
+
delete state.metadata[key];
|
|
633
|
+
count++;
|
|
634
|
+
}
|
|
635
|
+
}
|
|
636
|
+
return count;
|
|
637
|
+
});
|
|
638
|
+
}
|
|
639
|
+
async compareAndSetMetadataValue(key, expected, value) {
|
|
640
|
+
return this.mutateSecurityState((state) => {
|
|
641
|
+
if ((state.metadata[key] ?? null) !== expected)
|
|
642
|
+
return false;
|
|
643
|
+
if (value === null)
|
|
644
|
+
delete state.metadata[key];
|
|
645
|
+
else
|
|
646
|
+
state.metadata[key] = value;
|
|
647
|
+
return true;
|
|
648
|
+
}, (changed) => changed);
|
|
649
|
+
}
|
|
629
650
|
async getRegistrationId(identityType) {
|
|
630
651
|
const state = await this.readSecurityState();
|
|
631
652
|
return state.registrationIds[identityType] ?? 0;
|
|
@@ -635,9 +656,9 @@ export class NodeEncryptedDatabase {
|
|
|
635
656
|
state.registrationIds[identityType] = id;
|
|
636
657
|
});
|
|
637
658
|
}
|
|
638
|
-
async markKyberPreKeyUsed(
|
|
659
|
+
async markKyberPreKeyUsed(identityType, usage) {
|
|
639
660
|
await this.mutateSecurityState((state) => {
|
|
640
|
-
state.
|
|
661
|
+
recordKyberPreKeyUseById(state.kyberPreKeyStates[identityType], identityType, usage);
|
|
641
662
|
});
|
|
642
663
|
}
|
|
643
664
|
// ============================================================================
|
|
@@ -648,50 +669,41 @@ export class NodeEncryptedDatabase {
|
|
|
648
669
|
return keys.reduce((max, key) => (key.keyId > max ? key.keyId : max), 0);
|
|
649
670
|
}
|
|
650
671
|
async getKyberPreKeyMaxId(identityType = 'aci') {
|
|
651
|
-
const
|
|
652
|
-
|
|
672
|
+
const state = await this.readSecurityState();
|
|
673
|
+
const instances = state.kyberPreKeyStates[identityType]?.instances ?? {};
|
|
674
|
+
return Object.keys(instances).reduce((max, id) => Math.max(max, Number(id)), 0);
|
|
653
675
|
}
|
|
654
676
|
async deleteAllPreKeys(identityType = 'aci') {
|
|
655
|
-
const
|
|
656
|
-
this.readCollection(`signed_prekeys_${identityType}`),
|
|
657
|
-
this.readCollection(`kyber_prekeys_${identityType}`),
|
|
658
|
-
]);
|
|
677
|
+
const signedPreKeys = await this.readCollection(`signed_prekeys_${identityType}`);
|
|
659
678
|
const oneTimeCounts = await this.mutateSecurityState((state) => {
|
|
660
679
|
const ec = (state.ecOneTimePreKeys[identityType] ?? []).length;
|
|
661
680
|
const kem = (state.kemOneTimePreKeys[identityType] ?? []).length;
|
|
681
|
+
const kyber = Object.keys(state.kyberPreKeyStates[identityType]?.instances ?? {}).length;
|
|
662
682
|
delete state.ecOneTimePreKeys[identityType];
|
|
663
683
|
delete state.kemOneTimePreKeys[identityType];
|
|
664
|
-
|
|
665
|
-
|
|
666
|
-
delete state.kyberUsage[key];
|
|
667
|
-
}
|
|
668
|
-
return { ec, kem };
|
|
684
|
+
delete state.kyberPreKeyStates[identityType];
|
|
685
|
+
return { ec, kem, kyber };
|
|
669
686
|
});
|
|
670
|
-
await Promise.all([
|
|
671
|
-
this.deleteCollection(`signed_prekeys_${identityType}`),
|
|
672
|
-
this.deleteCollection(`kyber_prekeys_${identityType}`),
|
|
673
|
-
]);
|
|
687
|
+
await Promise.all([this.deleteCollection(`signed_prekeys_${identityType}`)]);
|
|
674
688
|
return {
|
|
675
689
|
ecSignedPreKeys: signedPreKeys.length,
|
|
676
690
|
ecOneTimePreKeys: oneTimeCounts.ec,
|
|
677
|
-
kyberPreKeys:
|
|
691
|
+
kyberPreKeys: oneTimeCounts.kyber,
|
|
678
692
|
kemOneTimePreKeys: oneTimeCounts.kem,
|
|
679
693
|
};
|
|
680
694
|
}
|
|
681
695
|
async getDetailedStats() {
|
|
682
696
|
const state = await this.readSecurityState();
|
|
683
|
-
const [signedAci, signedPni
|
|
697
|
+
const [signedAci, signedPni] = await Promise.all([
|
|
684
698
|
this.readCollection(`signed_prekeys_aci`).then((keys) => keys.length),
|
|
685
699
|
this.readCollection(`signed_prekeys_pni`).then((keys) => keys.length),
|
|
686
|
-
this.readCollection(`kyber_prekeys_aci`).then((keys) => keys.length),
|
|
687
|
-
this.readCollection(`kyber_prekeys_pni`).then((keys) => keys.length),
|
|
688
700
|
]);
|
|
689
701
|
const total = (collection) => Object.values(collection).reduce((count, keys) => count + keys.length, 0);
|
|
690
702
|
return {
|
|
691
703
|
sessions: Object.keys(state.sessions).length,
|
|
692
704
|
ecSignedPreKeys: signedAci + signedPni,
|
|
693
705
|
ecOneTimePreKeys: total(state.ecOneTimePreKeys),
|
|
694
|
-
kyberPreKeys:
|
|
706
|
+
kyberPreKeys: Object.values(state.kyberPreKeyStates).reduce((count, kyberState) => count + Object.keys(kyberState.instances).length, 0),
|
|
695
707
|
kemOneTimePreKeys: total(state.kemOneTimePreKeys),
|
|
696
708
|
users: Object.keys(state.sesameUsers).length,
|
|
697
709
|
};
|
|
@@ -702,7 +714,7 @@ export class NodeEncryptedDatabase {
|
|
|
702
714
|
async getStats() {
|
|
703
715
|
await this.ensureInitialized();
|
|
704
716
|
const securityState = await this.readSecurityState();
|
|
705
|
-
const [identityAci, identityPni, signedAci, signedPni
|
|
717
|
+
const [identityAci, identityPni, signedAci, signedPni] = await Promise.all([
|
|
706
718
|
this.readCollection('identity_keys_aci')
|
|
707
719
|
.then((keys) => keys.length)
|
|
708
720
|
.catch(() => 0),
|
|
@@ -715,18 +727,12 @@ export class NodeEncryptedDatabase {
|
|
|
715
727
|
this.readCollection('signed_prekeys_pni')
|
|
716
728
|
.then((keys) => keys.length)
|
|
717
729
|
.catch(() => 0),
|
|
718
|
-
this.readCollection('kyber_prekeys_aci')
|
|
719
|
-
.then((keys) => keys.length)
|
|
720
|
-
.catch(() => 0),
|
|
721
|
-
this.readCollection('kyber_prekeys_pni')
|
|
722
|
-
.then((keys) => keys.length)
|
|
723
|
-
.catch(() => 0),
|
|
724
730
|
]);
|
|
725
731
|
return {
|
|
726
732
|
identityKeys: identityAci + identityPni,
|
|
727
733
|
signedPreKeys: signedAci + signedPni,
|
|
728
734
|
oneTimePreKeys: Object.values(securityState.ecOneTimePreKeys).reduce((count, keys) => count + keys.length, 0),
|
|
729
|
-
kyberPreKeys:
|
|
735
|
+
kyberPreKeys: Object.values(securityState.kyberPreKeyStates).reduce((count, kyberState) => count + Object.keys(kyberState.instances).length, 0),
|
|
730
736
|
sessions: Object.keys(securityState.sessions).length,
|
|
731
737
|
};
|
|
732
738
|
}
|
|
@@ -737,6 +743,8 @@ export class NodeEncryptedDatabase {
|
|
|
737
743
|
* Close database (cleanup)
|
|
738
744
|
*/
|
|
739
745
|
async close() {
|
|
746
|
+
await this.initPromise?.catch(() => undefined);
|
|
747
|
+
await this.securityStateMutation;
|
|
740
748
|
this.dbKey = null;
|
|
741
749
|
this.initPromise = null;
|
|
742
750
|
}
|
|
@@ -749,70 +757,57 @@ export class NodeEncryptedDatabase {
|
|
|
749
757
|
* @returns true if database was deleted, false if it did not exist
|
|
750
758
|
*/
|
|
751
759
|
async deleteDatabase() {
|
|
752
|
-
|
|
753
|
-
|
|
754
|
-
|
|
755
|
-
|
|
756
|
-
|
|
757
|
-
if (!exists) {
|
|
758
|
-
this.logger.info('[NodeEncryptedDatabase] Database does not exist, skipping deletion', {
|
|
759
|
-
dataDir: this.dataDir,
|
|
760
|
-
});
|
|
760
|
+
await this.initPromise?.catch(() => undefined);
|
|
761
|
+
await this.securityStateMutation;
|
|
762
|
+
return withNodeDatabaseLock(this.dataDir, async () => {
|
|
763
|
+
const entries = (await readdir(this.dataDir)).filter(isNodeDatabaseDataEntry);
|
|
764
|
+
if (entries.length === 0)
|
|
761
765
|
return false;
|
|
766
|
+
if (this.dbKey && !entries.includes(NODE_DATABASE_RESET_FILE)) {
|
|
767
|
+
const key = await readFile(join(this.dataDir, 'db.key'));
|
|
768
|
+
if (!key.equals(Buffer.from(this.dbKey))) {
|
|
769
|
+
throw new Error('Node database authority changed. Refusing reset from a stale handle.');
|
|
770
|
+
}
|
|
762
771
|
}
|
|
763
|
-
|
|
764
|
-
await
|
|
765
|
-
|
|
766
|
-
|
|
767
|
-
|
|
768
|
-
|
|
769
|
-
|
|
770
|
-
|
|
771
|
-
|
|
772
|
-
this.
|
|
773
|
-
|
|
774
|
-
|
|
775
|
-
});
|
|
776
|
-
return false;
|
|
777
|
-
}
|
|
778
|
-
}
|
|
779
|
-
/**
|
|
780
|
-
* Check if database directory exists
|
|
781
|
-
*
|
|
782
|
-
* @returns true if database directory exists on filesystem
|
|
783
|
-
*/
|
|
784
|
-
async databaseExists() {
|
|
785
|
-
try {
|
|
786
|
-
await access(this.dataDir);
|
|
772
|
+
const marker = join(this.dataDir, NODE_DATABASE_RESET_FILE);
|
|
773
|
+
await commitNodeDatabaseFile(marker, 'reset');
|
|
774
|
+
for (const entry of entries) {
|
|
775
|
+
if (entry !== NODE_DATABASE_RESET_FILE)
|
|
776
|
+
await rm(join(this.dataDir, entry), { recursive: true, force: true });
|
|
777
|
+
}
|
|
778
|
+
await syncNodeDatabaseDirectory(this.dataDir);
|
|
779
|
+
await unlink(marker);
|
|
780
|
+
await syncNodeDatabaseDirectory(this.dataDir);
|
|
781
|
+
this.dbKey = null;
|
|
782
|
+
this.initPromise = null;
|
|
783
|
+
this.logger.info('[NodeEncryptedDatabase] Database reset complete');
|
|
787
784
|
return true;
|
|
788
|
-
}
|
|
789
|
-
catch {
|
|
790
|
-
return false;
|
|
791
|
-
}
|
|
785
|
+
});
|
|
792
786
|
}
|
|
793
787
|
}
|
|
794
788
|
/**
|
|
795
789
|
* Singleton instance
|
|
796
790
|
*/
|
|
797
|
-
|
|
791
|
+
const encryptedDatabaseInstances = new Map();
|
|
798
792
|
/**
|
|
799
793
|
* Get singleton NodeEncryptedDatabase instance
|
|
800
794
|
*
|
|
801
795
|
* @param dataDir Optional custom data directory
|
|
802
796
|
*/
|
|
803
797
|
export function getNodeEncryptedDatabase(dataDir) {
|
|
804
|
-
|
|
805
|
-
|
|
798
|
+
const path = resolve(dataDir ?? DEFAULT_DATA_DIR);
|
|
799
|
+
let instance = encryptedDatabaseInstances.get(path);
|
|
800
|
+
if (!instance) {
|
|
801
|
+
instance = new NodeEncryptedDatabase(path);
|
|
802
|
+
encryptedDatabaseInstances.set(path, instance);
|
|
806
803
|
}
|
|
807
|
-
return
|
|
804
|
+
return instance;
|
|
808
805
|
}
|
|
809
806
|
/**
|
|
810
807
|
* Reset the singleton for controlled local teardown.
|
|
811
808
|
*/
|
|
812
809
|
export async function resetNodeEncryptedDatabase() {
|
|
813
|
-
|
|
814
|
-
|
|
815
|
-
}
|
|
816
|
-
encryptedDatabaseInstance = null;
|
|
810
|
+
await Promise.all([...encryptedDatabaseInstances.values()].map((instance) => instance.close()));
|
|
811
|
+
encryptedDatabaseInstances.clear();
|
|
817
812
|
}
|
|
818
813
|
//# sourceMappingURL=database.js.map
|