@open-e2ee/signal-protocol-sdk 7.2.0 → 8.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 +54 -7
- package/ARCHITECTURE.md +1 -0
- package/CHANGELOG.md +503 -0
- package/README.md +9 -5
- package/SECURITY.md +2 -2
- package/THIRD_PARTY_NOTICES.md +429 -0
- package/client/README.md +1 -2
- package/device/README.md +50 -19
- package/dist/client/client.d.ts +31 -5
- package/dist/client/client.d.ts.map +1 -1
- package/dist/client/client.js +149 -90
- package/dist/client/client.js.map +1 -1
- package/dist/client/event-hooks.d.ts.map +1 -1
- package/dist/client/event-hooks.js +2 -0
- package/dist/client/event-hooks.js.map +1 -1
- package/dist/client/files.d.ts.map +1 -1
- package/dist/client/files.js +19 -2
- package/dist/client/files.js.map +1 -1
- package/dist/client/headless.d.ts +1 -1
- package/dist/client/headless.js +1 -1
- package/dist/client/hosted-anonymous-delivery.d.ts.map +1 -1
- package/dist/client/hosted-anonymous-delivery.js +2 -1
- package/dist/client/hosted-anonymous-delivery.js.map +1 -1
- 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 +8 -12
- package/dist/client/hosted-connection.js.map +1 -1
- package/dist/client/hosted-group-authority.d.ts.map +1 -1
- package/dist/client/hosted-group-authority.js +2 -1
- package/dist/client/hosted-group-authority.js.map +1 -1
- package/dist/client/hosted-groups.d.ts.map +1 -1
- package/dist/client/hosted-groups.js +2 -1
- package/dist/client/hosted-groups.js.map +1 -1
- package/dist/client/hosted-push.d.ts.map +1 -1
- package/dist/client/hosted-push.js +2 -1
- package/dist/client/hosted-push.js.map +1 -1
- package/dist/client/hosted-transport.d.ts.map +1 -1
- package/dist/client/hosted-transport.js +10 -11
- package/dist/client/hosted-transport.js.map +1 -1
- package/dist/client/hosted-trust.d.ts +11 -11
- package/dist/client/hosted-trust.d.ts.map +1 -1
- package/dist/client/hosted-trust.js +12 -12
- package/dist/client/hosted-trust.js.map +1 -1
- package/dist/client/messages.d.ts.map +1 -1
- package/dist/client/messages.js +6 -1
- package/dist/client/messages.js.map +1 -1
- package/dist/client/multi-device.d.ts.map +1 -1
- package/dist/client/multi-device.js +2 -1
- package/dist/client/multi-device.js.map +1 -1
- package/dist/client/relay-work.d.ts +30 -0
- package/dist/client/relay-work.d.ts.map +1 -0
- package/dist/client/relay-work.js +189 -0
- package/dist/client/relay-work.js.map +1 -0
- package/dist/client/retry.d.ts.map +1 -1
- package/dist/client/retry.js +2 -0
- package/dist/client/retry.js.map +1 -1
- package/dist/client/sessions.d.ts.map +1 -1
- package/dist/client/sessions.js +3 -0
- package/dist/client/sessions.js.map +1 -1
- package/dist/client/signal-service-cipher.d.ts +19 -11
- package/dist/client/signal-service-cipher.d.ts.map +1 -1
- package/dist/client/signal-service-cipher.js +48 -46
- package/dist/client/signal-service-cipher.js.map +1 -1
- package/dist/client/state.d.ts +8 -0
- package/dist/client/state.d.ts.map +1 -1
- package/dist/client/state.js +11 -0
- package/dist/client/state.js.map +1 -1
- package/dist/device/connection.d.ts +1 -1
- package/dist/device/connection.d.ts.map +1 -1
- package/dist/device/connection.js +4 -11
- package/dist/device/connection.js.map +1 -1
- package/dist/device/device-id.d.ts +10 -4
- package/dist/device/device-id.d.ts.map +1 -1
- package/dist/device/device-id.js +15 -9
- package/dist/device/device-id.js.map +1 -1
- package/dist/device/device-name-crypto.d.ts.map +1 -1
- package/dist/device/device-name-crypto.js +2 -2
- package/dist/device/device-name-crypto.js.map +1 -1
- package/dist/device/expo/index.d.ts +25 -8
- package/dist/device/expo/index.d.ts.map +1 -1
- package/dist/device/expo/index.js +58 -8
- package/dist/device/expo/index.js.map +1 -1
- package/dist/device/index.d.ts +2 -2
- package/dist/device/index.d.ts.map +1 -1
- package/dist/device/index.js +3 -2
- package/dist/device/index.js.map +1 -1
- package/dist/device/lifecycle/index.d.ts +4 -2
- package/dist/device/lifecycle/index.d.ts.map +1 -1
- package/dist/device/lifecycle/index.js.map +1 -1
- package/dist/device/lifecycle/manager.d.ts +12 -14
- package/dist/device/lifecycle/manager.d.ts.map +1 -1
- package/dist/device/lifecycle/manager.js +52 -97
- package/dist/device/lifecycle/manager.js.map +1 -1
- package/dist/device/lifecycle/types.d.ts +26 -16
- package/dist/device/lifecycle/types.d.ts.map +1 -1
- package/dist/device/lifecycle/utils.d.ts +8 -4
- package/dist/device/lifecycle/utils.d.ts.map +1 -1
- package/dist/device/lifecycle/utils.js +12 -16
- package/dist/device/lifecycle/utils.js.map +1 -1
- package/dist/device/provisioning.d.ts.map +1 -1
- package/dist/device/provisioning.js +6 -8
- package/dist/device/provisioning.js.map +1 -1
- package/dist/device/react-native/index.d.ts +40 -0
- package/dist/device/react-native/index.d.ts.map +1 -0
- package/dist/device/react-native/index.js +74 -0
- package/dist/device/react-native/index.js.map +1 -0
- package/dist/device/transfer.d.ts +15 -7
- package/dist/device/transfer.d.ts.map +1 -1
- package/dist/device/transfer.js +30 -22
- package/dist/device/transfer.js.map +1 -1
- package/dist/device/types.d.ts +15 -7
- package/dist/device/types.d.ts.map +1 -1
- package/dist/device/types.js.map +1 -1
- package/dist/device/vault-text.d.ts +13 -0
- package/dist/device/vault-text.d.ts.map +1 -0
- package/dist/device/vault-text.js +17 -0
- package/dist/device/vault-text.js.map +1 -0
- package/dist/index.d.ts +9 -5
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +9 -5
- package/dist/index.js.map +1 -1
- package/dist/internal/crypto/index.d.ts +3 -3
- package/dist/internal/crypto/index.d.ts.map +1 -1
- package/dist/internal/crypto/index.js +3 -3
- package/dist/internal/crypto/index.js.map +1 -1
- package/dist/internal/crypto/random-host.d.ts +1 -1
- package/dist/internal/crypto/random-host.d.ts.map +1 -1
- package/dist/internal/crypto/random-host.js +3 -2
- package/dist/internal/crypto/random-host.js.map +1 -1
- package/dist/internal/crypto/random-host.native.d.ts +6 -1
- package/dist/internal/crypto/random-host.native.d.ts.map +1 -1
- package/dist/internal/crypto/random-host.native.js +14 -10
- package/dist/internal/crypto/random-host.native.js.map +1 -1
- package/dist/internal/crypto/random-host.node.d.ts +1 -1
- package/dist/internal/crypto/random-host.node.d.ts.map +1 -1
- package/dist/internal/crypto/random-host.node.js +1 -1
- package/dist/internal/crypto/random-host.node.js.map +1 -1
- package/dist/internal/crypto/random.d.ts +12 -3
- package/dist/internal/crypto/random.d.ts.map +1 -1
- package/dist/internal/crypto/random.js +14 -3
- package/dist/internal/crypto/random.js.map +1 -1
- package/dist/internal/crypto/utils.d.ts.map +1 -1
- package/dist/internal/crypto/utils.js +10 -6
- package/dist/internal/crypto/utils.js.map +1 -1
- package/dist/internal/encoding/proto/primitives.d.ts +2 -0
- package/dist/internal/encoding/proto/primitives.d.ts.map +1 -1
- package/dist/internal/encoding/proto/primitives.js +2 -1
- package/dist/internal/encoding/proto/primitives.js.map +1 -1
- package/dist/internal/encoding/proto/signal-message.d.ts +1 -0
- package/dist/internal/encoding/proto/signal-message.d.ts.map +1 -1
- package/dist/internal/encoding/proto/signal-message.js +2 -1
- package/dist/internal/encoding/proto/signal-message.js.map +1 -1
- package/dist/internal/groups/authority-certificate.d.ts.map +1 -1
- package/dist/internal/groups/authority-certificate.js +2 -1
- package/dist/internal/groups/authority-certificate.js.map +1 -1
- package/dist/internal/groups/encrypted-state.d.ts.map +1 -1
- package/dist/internal/groups/encrypted-state.js +9 -7
- package/dist/internal/groups/encrypted-state.js.map +1 -1
- package/dist/internal/groups/invite-link.d.ts.map +1 -1
- package/dist/internal/groups/invite-link.js +2 -1
- package/dist/internal/groups/invite-link.js.map +1 -1
- package/dist/internal/groups/manager.d.ts.map +1 -1
- package/dist/internal/groups/manager.js +5 -5
- package/dist/internal/groups/manager.js.map +1 -1
- package/dist/internal/groups/sdk-store.d.ts.map +1 -1
- package/dist/internal/groups/sdk-store.js +4 -3
- package/dist/internal/groups/sdk-store.js.map +1 -1
- package/dist/internal/groups/server-engine.d.ts +6 -1
- package/dist/internal/groups/server-engine.d.ts.map +1 -1
- package/dist/internal/groups/server-engine.js +11 -15
- 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 +2 -1
- package/dist/internal/groups/wire.js.map +1 -1
- package/dist/internal/platform/blob.d.ts +10 -0
- package/dist/internal/platform/blob.d.ts.map +1 -0
- package/dist/internal/platform/blob.js +30 -0
- package/dist/internal/platform/blob.js.map +1 -0
- package/dist/internal/platform/env.d.ts +13 -0
- package/dist/internal/platform/env.d.ts.map +1 -0
- package/dist/internal/platform/env.js +17 -0
- package/dist/internal/platform/env.js.map +1 -0
- package/dist/internal/platform/index.d.ts +5 -0
- package/dist/internal/platform/index.d.ts.map +1 -0
- package/dist/internal/platform/index.js +5 -0
- package/dist/internal/platform/index.js.map +1 -0
- package/dist/internal/platform/url.d.ts +72 -0
- package/dist/internal/platform/url.d.ts.map +1 -0
- package/dist/internal/platform/url.js +275 -0
- package/dist/internal/platform/url.js.map +1 -0
- package/dist/internal/platform/utf8.d.ts +28 -0
- package/dist/internal/platform/utf8.d.ts.map +1 -0
- package/dist/internal/platform/utf8.js +167 -0
- package/dist/internal/platform/utf8.js.map +1 -0
- package/dist/internal/protocol/sealed-sender/delivery-token.d.ts +1 -1
- package/dist/internal/protocol/sealed-sender/delivery-token.d.ts.map +1 -1
- package/dist/internal/protocol/sealed-sender/delivery-token.js +5 -10
- package/dist/internal/protocol/sealed-sender/delivery-token.js.map +1 -1
- package/dist/internal/protocol/sealed-sender/proto/index.d.ts.map +1 -1
- package/dist/internal/protocol/sealed-sender/proto/index.js +2 -4
- package/dist/internal/protocol/sealed-sender/proto/index.js.map +1 -1
- package/dist/internal/protocol/sender-keys/manager.d.ts.map +1 -1
- package/dist/internal/protocol/sender-keys/manager.js +4 -3
- package/dist/internal/protocol/sender-keys/manager.js.map +1 -1
- package/dist/internal/protocol/spqr/ml-kem-braid/noble-pq/index.d.ts +4 -4
- package/dist/internal/protocol/spqr/ml-kem-braid/noble-pq/index.d.ts.map +1 -1
- package/dist/internal/protocol/spqr/ml-kem-braid/noble-pq/index.js +8 -10
- package/dist/internal/protocol/spqr/ml-kem-braid/noble-pq/index.js.map +1 -1
- package/dist/internal/protocol/username/hash.d.ts.map +1 -1
- package/dist/internal/protocol/username/hash.js +18 -3
- package/dist/internal/protocol/username/hash.js.map +1 -1
- package/dist/internal/protocol/username/link.d.ts.map +1 -1
- package/dist/internal/protocol/username/link.js +2 -1
- package/dist/internal/protocol/username/link.js.map +1 -1
- package/dist/internal/protocol/username/proof.d.ts.map +1 -1
- package/dist/internal/protocol/username/proof.js +2 -1
- package/dist/internal/protocol/username/proof.js.map +1 -1
- package/dist/internal/sesame/device-registry.d.ts +16 -3
- package/dist/internal/sesame/device-registry.d.ts.map +1 -1
- package/dist/internal/sesame/device-registry.js +10 -7
- package/dist/internal/sesame/device-registry.js.map +1 -1
- package/dist/internal/sesame/index.d.ts +1 -1
- package/dist/internal/sesame/index.d.ts.map +1 -1
- package/dist/internal/sesame/manager.d.ts.map +1 -1
- package/dist/internal/sesame/manager.js +3 -2
- package/dist/internal/sesame/manager.js.map +1 -1
- package/dist/internal/session/index.d.ts +1 -2
- package/dist/internal/session/index.d.ts.map +1 -1
- package/dist/internal/session/index.js +1 -1
- package/dist/internal/session/index.js.map +1 -1
- package/dist/internal/session/validation.d.ts +0 -80
- package/dist/internal/session/validation.d.ts.map +1 -1
- package/dist/internal/session/validation.js +0 -134
- package/dist/internal/session/validation.js.map +1 -1
- package/dist/local/store/device-record.d.ts +18 -0
- package/dist/local/store/device-record.d.ts.map +1 -0
- package/dist/local/store/device-record.js +34 -0
- package/dist/local/store/device-record.js.map +1 -0
- package/dist/local/store/expo/adapter.d.ts +59 -238
- package/dist/local/store/expo/adapter.d.ts.map +1 -1
- package/dist/local/store/expo/adapter.js +83 -640
- package/dist/local/store/expo/adapter.js.map +1 -1
- package/dist/local/store/expo/driver.d.ts +16 -0
- package/dist/local/store/expo/driver.d.ts.map +1 -0
- package/dist/local/store/expo/driver.js +141 -0
- package/dist/local/store/expo/driver.js.map +1 -0
- package/dist/local/store/expo/index.d.ts +3 -12
- package/dist/local/store/expo/index.d.ts.map +1 -1
- package/dist/local/store/expo/index.js +1 -8
- package/dist/local/store/expo/index.js.map +1 -1
- package/dist/local/store/expo/maintenance.d.ts +3 -2
- package/dist/local/store/expo/maintenance.d.ts.map +1 -1
- package/dist/local/store/expo/maintenance.js +5 -34
- package/dist/local/store/expo/maintenance.js.map +1 -1
- package/dist/local/store/index.d.ts +10 -5
- package/dist/local/store/index.d.ts.map +1 -1
- package/dist/local/store/index.js +10 -5
- package/dist/local/store/index.js.map +1 -1
- package/dist/local/store/key-value/adapter.d.ts +326 -0
- package/dist/local/store/key-value/adapter.d.ts.map +1 -0
- package/dist/local/store/key-value/adapter.js +1472 -0
- package/dist/local/store/key-value/adapter.js.map +1 -0
- package/dist/local/store/{react-native → key-value}/backend-conformance.d.ts +6 -6
- package/dist/local/store/key-value/backend-conformance.d.ts.map +1 -0
- package/dist/local/store/{react-native → key-value}/backend-conformance.js +3 -3
- package/dist/local/store/key-value/backend-conformance.js.map +1 -0
- package/dist/local/store/key-value/batch.d.ts +41 -0
- package/dist/local/store/key-value/batch.d.ts.map +1 -0
- package/dist/local/store/key-value/batch.js +77 -0
- package/dist/local/store/key-value/batch.js.map +1 -0
- package/dist/local/store/key-value/device-record.d.ts +23 -0
- package/dist/local/store/key-value/device-record.d.ts.map +1 -0
- package/dist/local/store/key-value/device-record.js +33 -0
- package/dist/local/store/key-value/device-record.js.map +1 -0
- package/dist/local/store/key-value/index.d.ts +24 -0
- package/dist/local/store/key-value/index.d.ts.map +1 -0
- package/dist/local/store/key-value/index.js +8 -0
- package/dist/local/store/key-value/index.js.map +1 -0
- package/dist/local/store/key-value/realm/index.d.ts +83 -0
- package/dist/local/store/key-value/realm/index.d.ts.map +1 -0
- package/dist/local/store/key-value/realm/index.js +102 -0
- package/dist/local/store/key-value/realm/index.js.map +1 -0
- package/dist/local/store/{react-native → key-value}/storage.d.ts +6 -6
- package/dist/local/store/key-value/storage.d.ts.map +1 -0
- package/dist/local/store/key-value/storage.js.map +1 -0
- package/dist/local/store/key-value/transactional-backend.d.ts +50 -0
- package/dist/local/store/key-value/transactional-backend.d.ts.map +1 -0
- package/dist/local/store/key-value/transactional-backend.js +90 -0
- package/dist/local/store/key-value/transactional-backend.js.map +1 -0
- package/dist/local/store/key-value/value-key.d.ts +34 -0
- package/dist/local/store/key-value/value-key.d.ts.map +1 -0
- package/dist/local/store/key-value/value-key.js +83 -0
- package/dist/local/store/key-value/value-key.js.map +1 -0
- package/dist/local/store/memory/adapter.d.ts +8 -0
- package/dist/local/store/memory/adapter.d.ts.map +1 -1
- package/dist/local/store/memory/adapter.js +60 -75
- package/dist/local/store/memory/adapter.js.map +1 -1
- package/dist/local/store/node/adapter.d.ts +74 -130
- package/dist/local/store/node/adapter.d.ts.map +1 -1
- package/dist/local/store/node/adapter.js +83 -727
- package/dist/local/store/node/adapter.js.map +1 -1
- package/dist/local/store/node/index.d.ts +8 -6
- package/dist/local/store/node/index.d.ts.map +1 -1
- package/dist/local/store/node/index.js +3 -7
- package/dist/local/store/node/index.js.map +1 -1
- package/dist/local/store/node/maintenance.d.ts +5 -0
- package/dist/local/store/node/maintenance.d.ts.map +1 -0
- package/dist/local/store/node/maintenance.js +7 -0
- package/dist/local/store/node/maintenance.js.map +1 -0
- package/dist/local/store/node/owner-lock.d.ts +26 -0
- package/dist/local/store/node/owner-lock.d.ts.map +1 -0
- package/dist/local/store/node/owner-lock.js +88 -0
- package/dist/local/store/node/owner-lock.js.map +1 -0
- package/dist/local/store/react-native/adapter.d.ts +63 -274
- package/dist/local/store/react-native/adapter.d.ts.map +1 -1
- package/dist/local/store/react-native/adapter.js +80 -1406
- package/dist/local/store/react-native/adapter.js.map +1 -1
- package/dist/local/store/react-native/index.d.ts +7 -19
- package/dist/local/store/react-native/index.d.ts.map +1 -1
- package/dist/local/store/react-native/index.js +2 -7
- package/dist/local/store/react-native/index.js.map +1 -1
- package/dist/local/store/react-native/maintenance.d.ts +5 -0
- package/dist/local/store/react-native/maintenance.d.ts.map +1 -0
- package/dist/local/store/react-native/maintenance.js +7 -0
- package/dist/local/store/react-native/maintenance.js.map +1 -0
- package/dist/local/store/sqlite/better-sqlite3-multiple-ciphers-driver.d.ts +38 -0
- package/dist/local/store/sqlite/better-sqlite3-multiple-ciphers-driver.d.ts.map +1 -0
- package/dist/local/store/sqlite/better-sqlite3-multiple-ciphers-driver.js +196 -0
- package/dist/local/store/sqlite/better-sqlite3-multiple-ciphers-driver.js.map +1 -0
- package/dist/local/store/sqlite/database.d.ts +20 -0
- package/dist/local/store/sqlite/database.d.ts.map +1 -0
- package/dist/local/store/sqlite/database.js +41 -0
- package/dist/local/store/sqlite/database.js.map +1 -0
- package/dist/local/store/sqlite/driver.d.ts +138 -0
- package/dist/local/store/sqlite/driver.d.ts.map +1 -0
- package/dist/local/store/sqlite/driver.js +10 -0
- package/dist/local/store/sqlite/driver.js.map +1 -0
- package/dist/local/store/sqlite/encryption.d.ts +61 -0
- package/dist/local/store/sqlite/encryption.d.ts.map +1 -0
- package/dist/local/store/sqlite/encryption.js +98 -0
- package/dist/local/store/sqlite/encryption.js.map +1 -0
- package/dist/local/store/sqlite/errors.d.ts +70 -0
- package/dist/local/store/sqlite/errors.d.ts.map +1 -0
- package/dist/local/store/sqlite/errors.js +101 -0
- package/dist/local/store/sqlite/errors.js.map +1 -0
- package/dist/local/store/sqlite/executor.d.ts +22 -0
- package/dist/local/store/sqlite/executor.d.ts.map +1 -0
- package/dist/local/store/sqlite/executor.js +129 -0
- package/dist/local/store/sqlite/executor.js.map +1 -0
- package/dist/local/store/sqlite/index.d.ts +20 -0
- package/dist/local/store/sqlite/index.d.ts.map +1 -0
- package/dist/local/store/sqlite/index.js +18 -0
- package/dist/local/store/sqlite/index.js.map +1 -0
- package/dist/local/store/sqlite/key-storage/account.d.ts +45 -0
- package/dist/local/store/sqlite/key-storage/account.d.ts.map +1 -0
- package/dist/local/store/sqlite/key-storage/account.js +125 -0
- package/dist/local/store/sqlite/key-storage/account.js.map +1 -0
- package/dist/local/store/sqlite/key-storage/contact-identities.d.ts +19 -0
- package/dist/local/store/sqlite/key-storage/contact-identities.d.ts.map +1 -0
- package/dist/local/store/sqlite/key-storage/contact-identities.js +85 -0
- package/dist/local/store/sqlite/key-storage/contact-identities.js.map +1 -0
- package/dist/local/store/sqlite/key-storage/context.d.ts +19 -0
- package/dist/local/store/sqlite/key-storage/context.d.ts.map +1 -0
- package/dist/local/store/sqlite/key-storage/context.js +18 -0
- package/dist/local/store/sqlite/key-storage/context.js.map +1 -0
- package/dist/local/store/sqlite/key-storage/identity-keys.d.ts +18 -0
- package/dist/local/store/sqlite/key-storage/identity-keys.d.ts.map +1 -0
- package/dist/local/store/sqlite/key-storage/identity-keys.js +88 -0
- package/dist/local/store/sqlite/key-storage/identity-keys.js.map +1 -0
- package/dist/local/store/sqlite/key-storage/index.d.ts +108 -0
- package/dist/local/store/sqlite/key-storage/index.d.ts.map +1 -0
- package/dist/local/store/sqlite/key-storage/index.js +241 -0
- package/dist/local/store/sqlite/key-storage/index.js.map +1 -0
- package/dist/local/store/sqlite/key-storage/message-records.d.ts +41 -0
- package/dist/local/store/sqlite/key-storage/message-records.d.ts.map +1 -0
- package/dist/local/store/sqlite/key-storage/message-records.js +133 -0
- package/dist/local/store/sqlite/key-storage/message-records.js.map +1 -0
- package/dist/local/store/sqlite/key-storage/metadata.d.ts +16 -0
- package/dist/local/store/sqlite/key-storage/metadata.d.ts.map +1 -0
- package/dist/local/store/sqlite/key-storage/metadata.js +53 -0
- package/dist/local/store/sqlite/key-storage/metadata.js.map +1 -0
- package/dist/local/store/sqlite/key-storage/one-time-prekeys.d.ts +36 -0
- package/dist/local/store/sqlite/key-storage/one-time-prekeys.d.ts.map +1 -0
- package/dist/local/store/sqlite/key-storage/one-time-prekeys.js +129 -0
- package/dist/local/store/sqlite/key-storage/one-time-prekeys.js.map +1 -0
- package/dist/local/store/sqlite/key-storage/session-trust.d.ts +10 -0
- package/dist/local/store/sqlite/key-storage/session-trust.d.ts.map +1 -0
- package/dist/local/store/sqlite/key-storage/session-trust.js +88 -0
- package/dist/local/store/sqlite/key-storage/session-trust.js.map +1 -0
- package/dist/local/store/sqlite/key-storage/sessions.d.ts +50 -0
- package/dist/local/store/sqlite/key-storage/sessions.d.ts.map +1 -0
- package/dist/local/store/sqlite/key-storage/sessions.js +209 -0
- package/dist/local/store/sqlite/key-storage/sessions.js.map +1 -0
- package/dist/local/store/sqlite/key-storage/signed-prekeys.d.ts +69 -0
- package/dist/local/store/sqlite/key-storage/signed-prekeys.d.ts.map +1 -0
- package/dist/local/store/sqlite/key-storage/signed-prekeys.js +219 -0
- package/dist/local/store/sqlite/key-storage/signed-prekeys.js.map +1 -0
- package/dist/local/store/sqlite/maintenance.d.ts +7 -0
- package/dist/local/store/sqlite/maintenance.d.ts.map +1 -0
- package/dist/local/store/sqlite/maintenance.js +32 -0
- package/dist/local/store/sqlite/maintenance.js.map +1 -0
- package/dist/local/store/sqlite/migrations.d.ts +31 -0
- package/dist/local/store/sqlite/migrations.d.ts.map +1 -0
- package/dist/local/store/sqlite/migrations.js +232 -0
- package/dist/local/store/sqlite/migrations.js.map +1 -0
- package/dist/local/store/{expo → sqlite}/models/ec-one-time-prekey.d.ts +17 -22
- package/dist/local/store/sqlite/models/ec-one-time-prekey.d.ts.map +1 -0
- package/dist/local/store/{expo → sqlite}/models/ec-one-time-prekey.js +61 -99
- package/dist/local/store/sqlite/models/ec-one-time-prekey.js.map +1 -0
- package/dist/local/store/{expo → sqlite}/models/ec-signed-prekey.d.ts +22 -25
- package/dist/local/store/sqlite/models/ec-signed-prekey.d.ts.map +1 -0
- package/dist/local/store/{expo → sqlite}/models/ec-signed-prekey.js +82 -128
- package/dist/local/store/sqlite/models/ec-signed-prekey.js.map +1 -0
- package/dist/local/store/sqlite/models/identity-key-id.d.ts.map +1 -0
- package/dist/local/store/sqlite/models/identity-key-id.js.map +1 -0
- package/dist/local/store/{expo → sqlite}/models/index.d.ts +5 -5
- package/dist/local/store/sqlite/models/index.d.ts.map +1 -0
- package/dist/local/store/{expo → sqlite}/models/index.js +12 -5
- package/dist/local/store/sqlite/models/index.js.map +1 -0
- package/dist/local/store/{expo → sqlite}/models/kyber-one-time-prekey.d.ts +17 -20
- package/dist/local/store/sqlite/models/kyber-one-time-prekey.d.ts.map +1 -0
- package/dist/local/store/{expo → sqlite}/models/kyber-one-time-prekey.js +65 -105
- package/dist/local/store/sqlite/models/kyber-one-time-prekey.js.map +1 -0
- package/dist/local/store/{expo → sqlite}/models/kyber-prekey-used.d.ts +3 -3
- package/dist/local/store/sqlite/models/kyber-prekey-used.d.ts.map +1 -0
- package/dist/local/store/{expo → sqlite}/models/kyber-prekey-used.js +13 -25
- package/dist/local/store/sqlite/models/kyber-prekey-used.js.map +1 -0
- package/dist/local/store/{expo → sqlite}/models/kyber-prekey.d.ts +16 -19
- package/dist/local/store/sqlite/models/kyber-prekey.d.ts.map +1 -0
- package/dist/local/store/{expo → sqlite}/models/kyber-prekey.js +67 -111
- package/dist/local/store/sqlite/models/kyber-prekey.js.map +1 -0
- package/dist/local/store/sqlite/models/local-identity.d.ts +51 -0
- package/dist/local/store/sqlite/models/local-identity.d.ts.map +1 -0
- package/dist/local/store/sqlite/models/local-identity.js +150 -0
- package/dist/local/store/sqlite/models/local-identity.js.map +1 -0
- package/dist/local/store/{expo → sqlite}/models/message-record.d.ts +15 -44
- package/dist/local/store/sqlite/models/message-record.d.ts.map +1 -0
- package/dist/local/store/{expo → sqlite}/models/message-record.js +43 -109
- package/dist/local/store/sqlite/models/message-record.js.map +1 -0
- package/dist/local/store/sqlite/models/recipient-identity.d.ts +21 -0
- package/dist/local/store/sqlite/models/recipient-identity.d.ts.map +1 -0
- package/dist/local/store/sqlite/models/recipient-identity.js +59 -0
- package/dist/local/store/sqlite/models/recipient-identity.js.map +1 -0
- package/dist/local/store/sqlite/models/replaced-prekeys.d.ts +23 -0
- package/dist/local/store/sqlite/models/replaced-prekeys.d.ts.map +1 -0
- package/dist/local/store/sqlite/models/replaced-prekeys.js +42 -0
- package/dist/local/store/sqlite/models/replaced-prekeys.js.map +1 -0
- package/dist/local/store/{expo → sqlite}/models/sender-key.d.ts +22 -23
- package/dist/local/store/sqlite/models/sender-key.d.ts.map +1 -0
- package/dist/local/store/{expo → sqlite}/models/sender-key.js +66 -94
- package/dist/local/store/sqlite/models/sender-key.js.map +1 -0
- package/dist/local/store/sqlite/models/sesame-user-record.d.ts +32 -0
- package/dist/local/store/sqlite/models/sesame-user-record.d.ts.map +1 -0
- package/dist/local/store/sqlite/models/sesame-user-record.js +78 -0
- package/dist/local/store/sqlite/models/sesame-user-record.js.map +1 -0
- package/dist/local/store/{expo → sqlite}/models/session.d.ts +24 -20
- package/dist/local/store/sqlite/models/session.d.ts.map +1 -0
- package/dist/local/store/{expo → sqlite}/models/session.js +54 -72
- package/dist/local/store/sqlite/models/session.js.map +1 -0
- package/dist/local/store/sqlite/models/skipped-sender-key.d.ts +24 -0
- package/dist/local/store/sqlite/models/skipped-sender-key.d.ts.map +1 -0
- package/dist/local/store/sqlite/models/skipped-sender-key.js +62 -0
- package/dist/local/store/sqlite/models/skipped-sender-key.js.map +1 -0
- package/dist/local/store/sqlite/op-sqlite-driver.d.ts +14 -0
- package/dist/local/store/sqlite/op-sqlite-driver.d.ts.map +1 -0
- package/dist/local/store/sqlite/op-sqlite-driver.js +180 -0
- package/dist/local/store/sqlite/op-sqlite-driver.js.map +1 -0
- package/dist/local/store/sqlite/open-store.d.ts +83 -0
- package/dist/local/store/sqlite/open-store.d.ts.map +1 -0
- package/dist/local/store/sqlite/open-store.js +177 -0
- package/dist/local/store/sqlite/open-store.js.map +1 -0
- package/dist/local/store/sqlite/schema.d.ts +102 -0
- package/dist/local/store/sqlite/schema.d.ts.map +1 -0
- package/dist/local/store/sqlite/schema.js +61 -0
- package/dist/local/store/sqlite/schema.js.map +1 -0
- package/dist/local/store/sqlite/store.d.ts +199 -0
- package/dist/local/store/sqlite/store.d.ts.map +1 -0
- package/dist/local/store/sqlite/store.js +494 -0
- package/dist/local/store/sqlite/store.js.map +1 -0
- package/dist/local/store/sqlite/web/driver.d.ts +50 -0
- package/dist/local/store/sqlite/web/driver.d.ts.map +1 -0
- package/dist/local/store/sqlite/web/driver.js +169 -0
- package/dist/local/store/sqlite/web/driver.js.map +1 -0
- package/dist/local/store/sqlite/web/protocol.d.ts +80 -0
- package/dist/local/store/sqlite/web/protocol.d.ts.map +1 -0
- package/dist/local/store/sqlite/web/protocol.js +13 -0
- package/dist/local/store/sqlite/web/protocol.js.map +1 -0
- package/dist/local/store/sqlite/web/sqlite3mc/sqlite3.mjs +14526 -0
- package/dist/local/store/sqlite/web/sqlite3mc/sqlite3.wasm +0 -0
- package/dist/local/store/sqlite/web/worker.d.ts +36 -0
- package/dist/local/store/sqlite/web/worker.d.ts.map +1 -0
- package/dist/local/store/sqlite/web/worker.js +616 -0
- package/dist/local/store/sqlite/web/worker.js.map +1 -0
- package/dist/local/store/web/adapter.d.ts +5 -14
- package/dist/local/store/web/adapter.d.ts.map +1 -1
- package/dist/local/store/web/adapter.js +119 -106
- package/dist/local/store/web/adapter.js.map +1 -1
- package/dist/local/store/web/device-record.d.ts +23 -0
- package/dist/local/store/web/device-record.d.ts.map +1 -0
- package/dist/local/store/web/device-record.js +31 -0
- package/dist/local/store/web/device-record.js.map +1 -0
- package/dist/local/store/web-sqlite/adapter.d.ts +98 -0
- package/dist/local/store/web-sqlite/adapter.d.ts.map +1 -0
- package/dist/local/store/web-sqlite/adapter.js +151 -0
- package/dist/local/store/web-sqlite/adapter.js.map +1 -0
- package/dist/local/store/web-sqlite/index.d.ts +14 -0
- package/dist/local/store/web-sqlite/index.d.ts.map +1 -0
- package/dist/local/store/web-sqlite/index.js +3 -0
- package/dist/local/store/web-sqlite/index.js.map +1 -0
- package/dist/local/store/web-sqlite/maintenance.d.ts +5 -0
- package/dist/local/store/web-sqlite/maintenance.d.ts.map +1 -0
- package/dist/local/store/web-sqlite/maintenance.js +7 -0
- package/dist/local/store/web-sqlite/maintenance.js.map +1 -0
- package/dist/local/store/web-sqlite/store-locks.d.ts +33 -0
- package/dist/local/store/web-sqlite/store-locks.d.ts.map +1 -0
- package/dist/local/store/web-sqlite/store-locks.js +60 -0
- package/dist/local/store/web-sqlite/store-locks.js.map +1 -0
- package/dist/local/vault/electron-safe-storage.d.ts +45 -0
- package/dist/local/vault/electron-safe-storage.d.ts.map +1 -0
- package/dist/local/vault/electron-safe-storage.js +212 -0
- package/dist/local/vault/electron-safe-storage.js.map +1 -0
- package/dist/local/vault/index.d.ts +4 -2
- package/dist/local/vault/index.d.ts.map +1 -1
- package/dist/local/vault/indexed-db.d.ts +37 -0
- package/dist/local/vault/indexed-db.d.ts.map +1 -0
- package/dist/local/vault/indexed-db.js +102 -0
- package/dist/local/vault/indexed-db.js.map +1 -0
- package/dist/local/vault/react-native-keychain.d.ts +12 -0
- package/dist/local/vault/react-native-keychain.d.ts.map +1 -0
- package/dist/local/vault/react-native-keychain.js +71 -0
- package/dist/local/vault/react-native-keychain.js.map +1 -0
- package/dist/local/vault/require.d.ts +10 -0
- package/dist/local/vault/require.d.ts.map +1 -0
- package/dist/local/vault/require.js +16 -0
- package/dist/local/vault/require.js.map +1 -0
- package/dist/logger.d.ts.map +1 -1
- package/dist/logger.js +2 -1
- package/dist/logger.js.map +1 -1
- package/dist/media/index.d.ts.map +1 -1
- package/dist/media/index.js +2 -1
- package/dist/media/index.js.map +1 -1
- package/dist/profile/contact-state.d.ts.map +1 -1
- package/dist/profile/contact-state.js +2 -4
- package/dist/profile/contact-state.js.map +1 -1
- package/dist/profile/index.d.ts +0 -1
- package/dist/profile/index.d.ts.map +1 -1
- package/dist/profile/index.js +0 -2
- package/dist/profile/index.js.map +1 -1
- package/dist/profile/profile-key.d.ts +16 -11
- package/dist/profile/profile-key.d.ts.map +1 -1
- package/dist/profile/profile-key.js +29 -29
- package/dist/profile/profile-key.js.map +1 -1
- package/dist/profile/update-service.d.ts +6 -0
- package/dist/profile/update-service.d.ts.map +1 -1
- package/dist/profile/update-service.js +3 -1
- package/dist/profile/update-service.js.map +1 -1
- package/dist/remote/object-store/validation.d.ts.map +1 -1
- package/dist/remote/object-store/validation.js +2 -1
- package/dist/remote/object-store/validation.js.map +1 -1
- package/dist/remote/relay/memory/adapter.d.ts +2 -3
- package/dist/remote/relay/memory/adapter.d.ts.map +1 -1
- package/dist/remote/relay/memory/adapter.js +22 -30
- package/dist/remote/relay/memory/adapter.js.map +1 -1
- package/dist/remote/relay/memory/failures.d.ts.map +1 -1
- package/dist/remote/relay/memory/failures.js +2 -1
- package/dist/remote/relay/memory/failures.js.map +1 -1
- package/dist/remote/relay/memory/group-server.d.ts +5 -1
- package/dist/remote/relay/memory/group-server.d.ts.map +1 -1
- package/dist/remote/relay/memory/group-server.js +11 -1
- package/dist/remote/relay/memory/group-server.js.map +1 -1
- package/dist/safety/url.d.ts.map +1 -1
- package/dist/safety/url.js +21 -26
- package/dist/safety/url.js.map +1 -1
- package/dist/types/api.d.ts +15 -2
- package/dist/types/api.d.ts.map +1 -1
- package/dist/types/errors.d.ts +97 -1
- package/dist/types/errors.d.ts.map +1 -1
- package/dist/types/errors.js +105 -1
- package/dist/types/errors.js.map +1 -1
- package/dist/types/session.d.ts.map +1 -1
- package/dist/types/session.js +2 -1
- package/dist/types/session.js.map +1 -1
- package/dist/utils/retry.d.ts +2 -0
- package/dist/utils/retry.d.ts.map +1 -1
- package/dist/utils/retry.js +4 -2
- package/dist/utils/retry.js.map +1 -1
- package/docs/ASSURANCE.md +80 -8
- package/docs/CLIENT_COMPOSITION.md +1 -2
- package/docs/DEVIATIONS.md +1 -1
- package/docs/ERROR_HANDLING.md +6 -0
- package/docs/GETTING_STARTED.md +1 -2
- package/docs/PACKAGE_SURFACE.md +29 -11
- package/docs/RECIPES.md +1 -2
- package/examples/browser/index.html +1 -1
- package/local/store/README.md +117 -37
- package/local/store/expo/README.md +67 -47
- package/local/store/key-value/README.md +278 -0
- package/local/store/node/README.md +206 -46
- package/local/store/react-native/README.md +120 -61
- package/local/store/web/README.md +9 -0
- package/local/store/web-sqlite/README.md +202 -0
- package/local/vault/README.md +115 -2
- package/package.json +42 -23
- package/profile/README.md +9 -11
- package/remote/README.md +1 -2
- package/dist/local/store/expo/database-key.d.ts +0 -142
- package/dist/local/store/expo/database-key.d.ts.map +0 -1
- package/dist/local/store/expo/database-key.js +0 -312
- package/dist/local/store/expo/database-key.js.map +0 -1
- package/dist/local/store/expo/db.d.ts +0 -95
- package/dist/local/store/expo/db.d.ts.map +0 -1
- package/dist/local/store/expo/db.js +0 -147
- package/dist/local/store/expo/db.js.map +0 -1
- package/dist/local/store/expo/key-storage.d.ts +0 -429
- package/dist/local/store/expo/key-storage.d.ts.map +0 -1
- package/dist/local/store/expo/key-storage.js +0 -1361
- package/dist/local/store/expo/key-storage.js.map +0 -1
- package/dist/local/store/expo/models/ec-one-time-prekey.d.ts.map +0 -1
- package/dist/local/store/expo/models/ec-one-time-prekey.js.map +0 -1
- package/dist/local/store/expo/models/ec-signed-prekey.d.ts.map +0 -1
- package/dist/local/store/expo/models/ec-signed-prekey.js.map +0 -1
- package/dist/local/store/expo/models/identity-key-id.d.ts.map +0 -1
- package/dist/local/store/expo/models/identity-key-id.js.map +0 -1
- package/dist/local/store/expo/models/index.d.ts.map +0 -1
- package/dist/local/store/expo/models/index.js.map +0 -1
- package/dist/local/store/expo/models/kyber-one-time-prekey.d.ts.map +0 -1
- package/dist/local/store/expo/models/kyber-one-time-prekey.js.map +0 -1
- package/dist/local/store/expo/models/kyber-prekey-used.d.ts.map +0 -1
- package/dist/local/store/expo/models/kyber-prekey-used.js.map +0 -1
- package/dist/local/store/expo/models/kyber-prekey.d.ts.map +0 -1
- package/dist/local/store/expo/models/kyber-prekey.js.map +0 -1
- package/dist/local/store/expo/models/local-identity.d.ts +0 -52
- package/dist/local/store/expo/models/local-identity.d.ts.map +0 -1
- package/dist/local/store/expo/models/local-identity.js +0 -166
- package/dist/local/store/expo/models/local-identity.js.map +0 -1
- package/dist/local/store/expo/models/message-record.d.ts.map +0 -1
- package/dist/local/store/expo/models/message-record.js.map +0 -1
- package/dist/local/store/expo/models/recipient-identity.d.ts +0 -21
- package/dist/local/store/expo/models/recipient-identity.d.ts.map +0 -1
- package/dist/local/store/expo/models/recipient-identity.js +0 -66
- package/dist/local/store/expo/models/recipient-identity.js.map +0 -1
- package/dist/local/store/expo/models/replaced-prekey-utils.d.ts +0 -33
- package/dist/local/store/expo/models/replaced-prekey-utils.d.ts.map +0 -1
- package/dist/local/store/expo/models/replaced-prekey-utils.js +0 -54
- package/dist/local/store/expo/models/replaced-prekey-utils.js.map +0 -1
- package/dist/local/store/expo/models/sender-key.d.ts.map +0 -1
- package/dist/local/store/expo/models/sender-key.js.map +0 -1
- package/dist/local/store/expo/models/session.d.ts.map +0 -1
- package/dist/local/store/expo/models/session.js.map +0 -1
- package/dist/local/store/expo/schema.d.ts +0 -1917
- package/dist/local/store/expo/schema.d.ts.map +0 -1
- package/dist/local/store/expo/schema.js +0 -197
- package/dist/local/store/expo/schema.js.map +0 -1
- package/dist/local/store/node/database-encryption.d.ts +0 -109
- package/dist/local/store/node/database-encryption.d.ts.map +0 -1
- package/dist/local/store/node/database-encryption.js +0 -202
- package/dist/local/store/node/database-encryption.js.map +0 -1
- package/dist/local/store/node/database-file-commit.d.ts +0 -8
- package/dist/local/store/node/database-file-commit.d.ts.map +0 -1
- package/dist/local/store/node/database-file-commit.js +0 -62
- package/dist/local/store/node/database-file-commit.js.map +0 -1
- package/dist/local/store/node/database-key.d.ts +0 -129
- package/dist/local/store/node/database-key.d.ts.map +0 -1
- package/dist/local/store/node/database-key.js +0 -293
- package/dist/local/store/node/database-key.js.map +0 -1
- package/dist/local/store/node/database-lock.d.ts +0 -8
- package/dist/local/store/node/database-lock.d.ts.map +0 -1
- package/dist/local/store/node/database-lock.js +0 -44
- package/dist/local/store/node/database-lock.js.map +0 -1
- package/dist/local/store/node/database.d.ts +0 -226
- package/dist/local/store/node/database.d.ts.map +0 -1
- package/dist/local/store/node/database.js +0 -813
- package/dist/local/store/node/database.js.map +0 -1
- package/dist/local/store/react-native/backend-conformance.d.ts.map +0 -1
- package/dist/local/store/react-native/backend-conformance.js.map +0 -1
- package/dist/local/store/react-native/reference-backend.d.ts +0 -43
- package/dist/local/store/react-native/reference-backend.d.ts.map +0 -1
- package/dist/local/store/react-native/reference-backend.js +0 -178
- package/dist/local/store/react-native/reference-backend.js.map +0 -1
- package/dist/local/store/react-native/storage.d.ts.map +0 -1
- package/dist/local/store/react-native/storage.js.map +0 -1
- package/dist/profile/storage.d.ts +0 -61
- package/dist/profile/storage.d.ts.map +0 -1
- package/dist/profile/storage.js +0 -145
- package/dist/profile/storage.js.map +0 -1
- /package/dist/local/store/{react-native → key-value}/storage.js +0 -0
- /package/dist/local/store/{expo → sqlite}/models/identity-key-id.d.ts +0 -0
- /package/dist/local/store/{expo → sqlite}/models/identity-key-id.js +0 -0
|
@@ -1,813 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Encrypted Filesystem Database for Node.js
|
|
3
|
-
*
|
|
4
|
-
* Provides encrypted JSON file storage with AES-256-GCM encryption.
|
|
5
|
-
*
|
|
6
|
-
* Layer 1: Single database encryption key in secure file (NodeDatabaseKeyManager)
|
|
7
|
-
* Layer 2: All Signal Protocol keys in encrypted JSON files (this file)
|
|
8
|
-
*
|
|
9
|
-
* Security-critical mutable state (contact trust, one-time prekeys, and
|
|
10
|
-
* sessions) is committed through one encrypted, versioned state file. A
|
|
11
|
-
* write-fsync/rename/directory-fsync sequence provides a crash-durable commit
|
|
12
|
-
* point. A kernel file lock serializes state transactions across processes.
|
|
13
|
-
* Other independent collections remain encrypted JSON records.
|
|
14
|
-
*
|
|
15
|
-
* All sensitive data encrypted before storage.
|
|
16
|
-
*/
|
|
17
|
-
import { access, mkdir, readFile, readdir, rm, unlink } from 'node:fs/promises';
|
|
18
|
-
import { join, resolve } from 'node:path';
|
|
19
|
-
import { homedir } from 'node:os';
|
|
20
|
-
import { EncryptionError, EncryptionErrorCode } from '../../../types/index.js';
|
|
21
|
-
import { receivedContentKey, parseReceivedContent } from '../received-content.js';
|
|
22
|
-
import { resolveSignalProtocolLogger } from '../../../logger.js';
|
|
23
|
-
import { MAX_UNACKNOWLEDGED_SESSION_AGE_MS } from '../../../types/protocol-config.js';
|
|
24
|
-
import { encryptRecord, decryptRecord } from './database-encryption.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';
|
|
29
|
-
const DEFAULT_DATA_DIR = join(homedir(), '.config', 'open-e2ee', 'signal-protocol');
|
|
30
|
-
function emptyDictionary() {
|
|
31
|
-
return Object.create(null);
|
|
32
|
-
}
|
|
33
|
-
function createEmptySecurityState() {
|
|
34
|
-
return {
|
|
35
|
-
version: 2,
|
|
36
|
-
contacts: emptyDictionary(),
|
|
37
|
-
ecOneTimePreKeys: emptyDictionary(),
|
|
38
|
-
kemOneTimePreKeys: emptyDictionary(),
|
|
39
|
-
sessions: emptyDictionary(),
|
|
40
|
-
sesameUsers: emptyDictionary(),
|
|
41
|
-
senderKeys: emptyDictionary(),
|
|
42
|
-
senderKeyRecords: emptyDictionary(),
|
|
43
|
-
skippedSenderKeys: emptyDictionary(),
|
|
44
|
-
messageRecords: emptyDictionary(),
|
|
45
|
-
metadata: emptyDictionary(),
|
|
46
|
-
registrationIds: emptyDictionary(),
|
|
47
|
-
kyberPreKeyStates: emptyDictionary(),
|
|
48
|
-
};
|
|
49
|
-
}
|
|
50
|
-
/**
|
|
51
|
-
* Rebuild a decoded dictionary with a null prototype, `depth` levels down.
|
|
52
|
-
*
|
|
53
|
-
* `JSON.parse` produces ordinary objects, on which `__proto__` and
|
|
54
|
-
* `constructor` are not plain data keys: assigning to them either invokes an
|
|
55
|
-
* inherited setter or is silently dropped. Every dictionary here is keyed by
|
|
56
|
-
* identifiers the application supplies: user, group, device, session, and
|
|
57
|
-
* metadata names. Each level is therefore rebuilt before it is indexed.
|
|
58
|
-
*/
|
|
59
|
-
function toNullPrototype(value, depth) {
|
|
60
|
-
const source = (value ?? {});
|
|
61
|
-
const result = emptyDictionary();
|
|
62
|
-
for (const key of Object.keys(source)) {
|
|
63
|
-
result[key] = depth > 1 ? toNullPrototype(source[key], depth - 1) : source[key];
|
|
64
|
-
}
|
|
65
|
-
return result;
|
|
66
|
-
}
|
|
67
|
-
/**
|
|
68
|
-
* Node.js Encrypted Filesystem Database
|
|
69
|
-
*
|
|
70
|
-
* Handles all storage operations with automatic encryption/decryption.
|
|
71
|
-
*/
|
|
72
|
-
export class NodeEncryptedDatabase {
|
|
73
|
-
dbKey = null;
|
|
74
|
-
initPromise = null;
|
|
75
|
-
dataDir;
|
|
76
|
-
sessionsDir;
|
|
77
|
-
securityStatePath;
|
|
78
|
-
logger;
|
|
79
|
-
securityStateMutation = Promise.resolve();
|
|
80
|
-
/**
|
|
81
|
-
* Create a new NodeEncryptedDatabase instance
|
|
82
|
-
*
|
|
83
|
-
* @param dataDir Optional data directory (defaults to ~/.config/signal)
|
|
84
|
-
*/
|
|
85
|
-
constructor(dataDir = DEFAULT_DATA_DIR, providedLogger) {
|
|
86
|
-
this.dataDir = dataDir;
|
|
87
|
-
this.sessionsDir = join(dataDir, 'sessions');
|
|
88
|
-
this.securityStatePath = join(dataDir, 'protocol_security_state_v1.json');
|
|
89
|
-
this.logger = resolveSignalProtocolLogger(providedLogger);
|
|
90
|
-
}
|
|
91
|
-
/**
|
|
92
|
-
* Initialize the database
|
|
93
|
-
*
|
|
94
|
-
* Creates directory structure and retrieves database encryption key.
|
|
95
|
-
* This is called automatically on first operation.
|
|
96
|
-
*/
|
|
97
|
-
async initialize() {
|
|
98
|
-
// Return existing initialization promise if already initializing
|
|
99
|
-
if (this.initPromise) {
|
|
100
|
-
return this.initPromise;
|
|
101
|
-
}
|
|
102
|
-
// Create new initialization promise
|
|
103
|
-
this.initPromise = this._initialize().catch((error) => {
|
|
104
|
-
this.initPromise = null;
|
|
105
|
-
throw error;
|
|
106
|
-
});
|
|
107
|
-
return this.initPromise;
|
|
108
|
-
}
|
|
109
|
-
async _initialize() {
|
|
110
|
-
try {
|
|
111
|
-
const dbKeyManager = getNodeDatabaseKeyManager(this.dataDir);
|
|
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);
|
|
117
|
-
}
|
|
118
|
-
catch (error) {
|
|
119
|
-
this.dbKey = null;
|
|
120
|
-
throw new EncryptionError('Failed to initialize encrypted database', EncryptionErrorCode.INITIALIZATION_FAILED, { originalError: error });
|
|
121
|
-
}
|
|
122
|
-
}
|
|
123
|
-
/**
|
|
124
|
-
* Initialize the database if it is not initialized yet
|
|
125
|
-
*/
|
|
126
|
-
async ensureInitialized() {
|
|
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
|
-
});
|
|
136
|
-
}
|
|
137
|
-
/**
|
|
138
|
-
* Direct pre-1.0 format reset. Contacts, one-time prekeys, and sessions now
|
|
139
|
-
* share one encrypted document so security-sensitive multi-record commits are
|
|
140
|
-
* one atomic filesystem replacement.
|
|
141
|
-
*/
|
|
142
|
-
async initializeAtomicSecurityState() {
|
|
143
|
-
try {
|
|
144
|
-
await access(this.securityStatePath);
|
|
145
|
-
await this.readSecurityStateFile();
|
|
146
|
-
return;
|
|
147
|
-
}
|
|
148
|
-
catch (error) {
|
|
149
|
-
if (error.code !== 'ENOENT')
|
|
150
|
-
throw error;
|
|
151
|
-
}
|
|
152
|
-
const legacyCollections = [
|
|
153
|
-
'contact_identities_v1.json',
|
|
154
|
-
'one_time_prekeys_aci.json',
|
|
155
|
-
'one_time_prekeys_pni.json',
|
|
156
|
-
'kem_one_time_prekeys_aci.json',
|
|
157
|
-
'kem_one_time_prekeys_pni.json',
|
|
158
|
-
];
|
|
159
|
-
await Promise.all(legacyCollections.map(async (filename) => {
|
|
160
|
-
try {
|
|
161
|
-
await unlink(join(this.dataDir, filename));
|
|
162
|
-
}
|
|
163
|
-
catch (error) {
|
|
164
|
-
if (error.code !== 'ENOENT')
|
|
165
|
-
throw error;
|
|
166
|
-
}
|
|
167
|
-
}));
|
|
168
|
-
await rm(this.sessionsDir, { recursive: true, force: true });
|
|
169
|
-
await mkdir(this.sessionsDir, { recursive: true, mode: 0o700 });
|
|
170
|
-
await this.writeSecurityStateFile(createEmptySecurityState());
|
|
171
|
-
}
|
|
172
|
-
assertSecurityState(value) {
|
|
173
|
-
if (!value || typeof value !== 'object')
|
|
174
|
-
throw new Error('Invalid Node security state');
|
|
175
|
-
const state = value;
|
|
176
|
-
if ((state.version !== 1 && state.version !== 2) ||
|
|
177
|
-
!state.contacts ||
|
|
178
|
-
typeof state.contacts !== 'object' ||
|
|
179
|
-
!state.ecOneTimePreKeys ||
|
|
180
|
-
typeof state.ecOneTimePreKeys !== 'object' ||
|
|
181
|
-
!state.kemOneTimePreKeys ||
|
|
182
|
-
typeof state.kemOneTimePreKeys !== 'object' ||
|
|
183
|
-
!state.sessions ||
|
|
184
|
-
typeof state.sessions !== 'object') {
|
|
185
|
-
throw new Error('Invalid Node security state structure');
|
|
186
|
-
}
|
|
187
|
-
}
|
|
188
|
-
async readSecurityStateFile() {
|
|
189
|
-
const fileData = await readFile(this.securityStatePath, 'utf8');
|
|
190
|
-
const encrypted = JSON.parse(fileData);
|
|
191
|
-
const decoded = decryptRecord(encrypted, this.dbKey);
|
|
192
|
-
this.assertSecurityState(decoded);
|
|
193
|
-
// A version 1 document predates the SESAME, group, message-record, and
|
|
194
|
-
// metadata namespaces. It is widened here rather than reset. Discarding it
|
|
195
|
-
// would drop pinned contact identities, and an unpinned contact is one
|
|
196
|
-
// whose next identity change goes undetected.
|
|
197
|
-
return {
|
|
198
|
-
version: 2,
|
|
199
|
-
contacts: toNullPrototype(decoded.contacts, 1),
|
|
200
|
-
ecOneTimePreKeys: toNullPrototype(decoded.ecOneTimePreKeys, 1),
|
|
201
|
-
kemOneTimePreKeys: toNullPrototype(decoded.kemOneTimePreKeys, 1),
|
|
202
|
-
sessions: toNullPrototype(decoded.sessions, 1),
|
|
203
|
-
sesameUsers: toNullPrototype(decoded.sesameUsers, 1),
|
|
204
|
-
senderKeys: toNullPrototype(decoded.senderKeys, 3),
|
|
205
|
-
senderKeyRecords: toNullPrototype(decoded.senderKeyRecords, 3),
|
|
206
|
-
skippedSenderKeys: toNullPrototype(decoded.skippedSenderKeys, 4),
|
|
207
|
-
messageRecords: toNullPrototype(decoded.messageRecords, 2),
|
|
208
|
-
metadata: toNullPrototype(decoded.metadata, 1),
|
|
209
|
-
registrationIds: toNullPrototype(decoded.registrationIds, 1),
|
|
210
|
-
kyberPreKeyStates: toNullPrototype(decoded.kyberPreKeyStates, 1),
|
|
211
|
-
};
|
|
212
|
-
}
|
|
213
|
-
async writeSecurityStateFile(state) {
|
|
214
|
-
const encrypted = encryptRecord(state, this.dbKey);
|
|
215
|
-
try {
|
|
216
|
-
await commitNodeDatabaseFile(this.securityStatePath, JSON.stringify(encrypted));
|
|
217
|
-
}
|
|
218
|
-
catch (error) {
|
|
219
|
-
throw new EncryptionError('Failed to atomically write Node protocol security state', EncryptionErrorCode.KEY_STORAGE_ERROR, { originalError: error });
|
|
220
|
-
}
|
|
221
|
-
}
|
|
222
|
-
async readSecurityState() {
|
|
223
|
-
await this.ensureInitialized();
|
|
224
|
-
await this.securityStateMutation;
|
|
225
|
-
return this.withCurrentKey(() => this.readSecurityStateFile());
|
|
226
|
-
}
|
|
227
|
-
async mutateSecurityState(mutation, commitWhen = () => true) {
|
|
228
|
-
await this.ensureInitialized();
|
|
229
|
-
const operation = this.securityStateMutation.then(() => this.withCurrentKey(async () => {
|
|
230
|
-
const state = await this.readSecurityStateFile();
|
|
231
|
-
const result = mutation(state);
|
|
232
|
-
if (commitWhen(result))
|
|
233
|
-
await this.writeSecurityStateFile(state);
|
|
234
|
-
return result;
|
|
235
|
-
}));
|
|
236
|
-
this.securityStateMutation = operation.then(() => undefined, () => undefined);
|
|
237
|
-
return await operation;
|
|
238
|
-
}
|
|
239
|
-
/**
|
|
240
|
-
* Get file path for a collection
|
|
241
|
-
*/
|
|
242
|
-
getCollectionPath(collection) {
|
|
243
|
-
const name = `${collection}.json`;
|
|
244
|
-
if (!isNodeDatabaseRecord(name))
|
|
245
|
-
throw new Error('Invalid Node database collection.');
|
|
246
|
-
return join(this.dataDir, name);
|
|
247
|
-
}
|
|
248
|
-
// ============================================================================
|
|
249
|
-
// Generic Collection Operations
|
|
250
|
-
// ============================================================================
|
|
251
|
-
/**
|
|
252
|
-
* Read a collection from disk
|
|
253
|
-
*/
|
|
254
|
-
async readCollection(collection) {
|
|
255
|
-
await this.ensureInitialized();
|
|
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);
|
|
262
|
-
}
|
|
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
|
-
});
|
|
270
|
-
}
|
|
271
|
-
/**
|
|
272
|
-
* Write a collection to disk
|
|
273
|
-
*/
|
|
274
|
-
async writeCollection(collection, data) {
|
|
275
|
-
await this.ensureInitialized();
|
|
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
|
-
});
|
|
286
|
-
}
|
|
287
|
-
/**
|
|
288
|
-
* Delete a collection from disk
|
|
289
|
-
*/
|
|
290
|
-
async deleteCollection(collection) {
|
|
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);
|
|
297
|
-
}
|
|
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
|
-
});
|
|
304
|
-
}
|
|
305
|
-
// ============================================================================
|
|
306
|
-
// Identity Keys
|
|
307
|
-
// ============================================================================
|
|
308
|
-
async storeIdentityKey(key, identityType = 'aci') {
|
|
309
|
-
const collection = `identity_keys_${identityType}`;
|
|
310
|
-
await this.writeCollection(collection, [key]);
|
|
311
|
-
}
|
|
312
|
-
async getIdentityKey(identityType = 'aci') {
|
|
313
|
-
const collection = `identity_keys_${identityType}`;
|
|
314
|
-
const keys = await this.readCollection(collection);
|
|
315
|
-
return keys.length > 0 ? keys[0] : null;
|
|
316
|
-
}
|
|
317
|
-
async deleteIdentityKey(identityType) {
|
|
318
|
-
if (identityType) {
|
|
319
|
-
await this.deleteCollection(`identity_keys_${identityType}`);
|
|
320
|
-
}
|
|
321
|
-
else {
|
|
322
|
-
await this.deleteCollection('identity_keys_aci');
|
|
323
|
-
await this.deleteCollection('identity_keys_pni');
|
|
324
|
-
}
|
|
325
|
-
}
|
|
326
|
-
async getContactIdentity(key) {
|
|
327
|
-
const state = await this.readSecurityState();
|
|
328
|
-
return state.contacts[key] ?? null;
|
|
329
|
-
}
|
|
330
|
-
async storeContactIdentity(key, record) {
|
|
331
|
-
await this.mutateSecurityState((state) => {
|
|
332
|
-
state.contacts[key] = record;
|
|
333
|
-
});
|
|
334
|
-
}
|
|
335
|
-
async mutateContactIdentity(key, mutation) {
|
|
336
|
-
return await this.mutateSecurityState((state) => {
|
|
337
|
-
const replacement = mutation(state.contacts[key] ?? null);
|
|
338
|
-
state.contacts[key] = replacement;
|
|
339
|
-
return replacement;
|
|
340
|
-
});
|
|
341
|
-
}
|
|
342
|
-
async mutateContactIdentityAndDeleteSessions(key, userId, mutation) {
|
|
343
|
-
return await this.mutateSecurityState((state) => {
|
|
344
|
-
const replacement = mutation(state.contacts[key] ?? null);
|
|
345
|
-
state.contacts[key] = replacement;
|
|
346
|
-
for (const [sessionId, stored] of Object.entries(state.sessions)) {
|
|
347
|
-
if (stored.userId === userId)
|
|
348
|
-
delete state.sessions[sessionId];
|
|
349
|
-
}
|
|
350
|
-
return replacement;
|
|
351
|
-
});
|
|
352
|
-
}
|
|
353
|
-
// ============================================================================
|
|
354
|
-
// Signed PreKeys
|
|
355
|
-
// Per X3DH Spec Section 4.4: Keep old signed prekeys for ~30 days
|
|
356
|
-
// ============================================================================
|
|
357
|
-
async storeEcSignedPreKey(key, identityType = 'aci') {
|
|
358
|
-
const collection = `signed_prekeys_${identityType}`;
|
|
359
|
-
const keys = await this.readCollection(collection);
|
|
360
|
-
// Update existing or add new (keep old prekeys for grace period)
|
|
361
|
-
const existingIndex = keys.findIndex((k) => k.keyId === key.keyId);
|
|
362
|
-
if (existingIndex >= 0) {
|
|
363
|
-
keys[existingIndex] = key;
|
|
364
|
-
}
|
|
365
|
-
else {
|
|
366
|
-
keys.push(key);
|
|
367
|
-
}
|
|
368
|
-
await this.writeCollection(collection, keys);
|
|
369
|
-
await this.cleanupExpiredEcSignedPreKeys(identityType);
|
|
370
|
-
}
|
|
371
|
-
async getEcSignedPreKey(keyId, identityType = 'aci') {
|
|
372
|
-
const collection = `signed_prekeys_${identityType}`;
|
|
373
|
-
const keys = await this.readCollection(collection);
|
|
374
|
-
if (keys.length === 0)
|
|
375
|
-
return null;
|
|
376
|
-
if (keyId !== undefined) {
|
|
377
|
-
// Look up by specific keyId
|
|
378
|
-
return keys.find((k) => k.keyId === keyId) ?? null;
|
|
379
|
-
}
|
|
380
|
-
// Return the most recent (highest keyId)
|
|
381
|
-
return keys.reduce((latest, current) => (current.keyId > latest.keyId ? current : latest));
|
|
382
|
-
}
|
|
383
|
-
async getAllEcSignedPreKeys(identityType = 'aci') {
|
|
384
|
-
const collection = `signed_prekeys_${identityType}`;
|
|
385
|
-
return await this.readCollection(collection);
|
|
386
|
-
}
|
|
387
|
-
async removeEcSignedPreKey(keyId, identityType = 'aci') {
|
|
388
|
-
const collection = `signed_prekeys_${identityType}`;
|
|
389
|
-
const keys = await this.readCollection(collection);
|
|
390
|
-
await this.writeCollection(collection, keys.filter((k) => k.keyId !== keyId));
|
|
391
|
-
}
|
|
392
|
-
async deleteSignedPreKey(identityType) {
|
|
393
|
-
if (identityType) {
|
|
394
|
-
await this.deleteCollection(`signed_prekeys_${identityType}`);
|
|
395
|
-
}
|
|
396
|
-
else {
|
|
397
|
-
await this.deleteCollection('signed_prekeys_aci');
|
|
398
|
-
await this.deleteCollection('signed_prekeys_pni');
|
|
399
|
-
}
|
|
400
|
-
}
|
|
401
|
-
async cleanupExpiredEcSignedPreKeys(identityType = 'aci') {
|
|
402
|
-
const collection = `signed_prekeys_${identityType}`;
|
|
403
|
-
const keys = await this.readCollection(collection);
|
|
404
|
-
if (keys.length <= 1)
|
|
405
|
-
return; // Keep at least one
|
|
406
|
-
const cutoff = Date.now() - MAX_UNACKNOWLEDGED_SESSION_AGE_MS;
|
|
407
|
-
const newest = keys.reduce((a, b) => (a.keyId > b.keyId ? a : b));
|
|
408
|
-
const filtered = keys.filter((k) => k.keyId === newest.keyId || (k.timestamp && k.timestamp > cutoff));
|
|
409
|
-
if (filtered.length < keys.length) {
|
|
410
|
-
await this.writeCollection(collection, filtered);
|
|
411
|
-
}
|
|
412
|
-
}
|
|
413
|
-
// ============================================================================
|
|
414
|
-
// One-Time PreKeys
|
|
415
|
-
// ============================================================================
|
|
416
|
-
async storeEcOneTimePreKeys(prekeys, identityType = 'aci') {
|
|
417
|
-
await this.mutateSecurityState((state) => {
|
|
418
|
-
const existing = (state.ecOneTimePreKeys[identityType] ?? []);
|
|
419
|
-
state.ecOneTimePreKeys[identityType] = [...existing, ...prekeys];
|
|
420
|
-
});
|
|
421
|
-
}
|
|
422
|
-
async getEcOneTimePreKeys(identityType = 'aci') {
|
|
423
|
-
const state = await this.readSecurityState();
|
|
424
|
-
return (state.ecOneTimePreKeys[identityType] ?? []);
|
|
425
|
-
}
|
|
426
|
-
async removeEcOneTimePreKey(predicate, identityType = 'aci') {
|
|
427
|
-
await this.mutateSecurityState((state) => {
|
|
428
|
-
const keys = (state.ecOneTimePreKeys[identityType] ?? []);
|
|
429
|
-
state.ecOneTimePreKeys[identityType] = keys.filter((key) => !predicate(key));
|
|
430
|
-
});
|
|
431
|
-
}
|
|
432
|
-
async deleteOneTimePreKeys(identityType) {
|
|
433
|
-
await this.mutateSecurityState((state) => {
|
|
434
|
-
if (identityType)
|
|
435
|
-
delete state.ecOneTimePreKeys[identityType];
|
|
436
|
-
else
|
|
437
|
-
state.ecOneTimePreKeys = emptyDictionary();
|
|
438
|
-
});
|
|
439
|
-
}
|
|
440
|
-
async storeKemOneTimePreKeys(prekeys, identityType = 'aci') {
|
|
441
|
-
await this.mutateSecurityState((state) => {
|
|
442
|
-
const existing = (state.kemOneTimePreKeys[identityType] ?? []);
|
|
443
|
-
state.kemOneTimePreKeys[identityType] = [...existing, ...prekeys];
|
|
444
|
-
});
|
|
445
|
-
}
|
|
446
|
-
async getKemOneTimePreKeys(identityType = 'aci') {
|
|
447
|
-
const state = await this.readSecurityState();
|
|
448
|
-
return (state.kemOneTimePreKeys[identityType] ?? []);
|
|
449
|
-
}
|
|
450
|
-
async removeKemOneTimePreKey(keyId, identityType = 'aci') {
|
|
451
|
-
await this.mutateSecurityState((state) => {
|
|
452
|
-
const keys = (state.kemOneTimePreKeys[identityType] ?? []);
|
|
453
|
-
state.kemOneTimePreKeys[identityType] = keys.filter((key) => key.keyId !== keyId);
|
|
454
|
-
});
|
|
455
|
-
}
|
|
456
|
-
// ============================================================================
|
|
457
|
-
// Kyber PreKeys
|
|
458
|
-
// ============================================================================
|
|
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
|
-
});
|
|
466
|
-
}
|
|
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);
|
|
474
|
-
}
|
|
475
|
-
async deleteKyberPreKey(id, identityType = 'aci') {
|
|
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
|
-
});
|
|
484
|
-
}
|
|
485
|
-
async deleteAllKyberPreKeys(identityType) {
|
|
486
|
-
await this.mutateSecurityState((state) => {
|
|
487
|
-
if (identityType)
|
|
488
|
-
delete state.kyberPreKeyStates[identityType];
|
|
489
|
-
else
|
|
490
|
-
state.kyberPreKeyStates = emptyDictionary();
|
|
491
|
-
});
|
|
492
|
-
}
|
|
493
|
-
// ============================================================================
|
|
494
|
-
// Sessions
|
|
495
|
-
// ============================================================================
|
|
496
|
-
async storeSession(sessionId, userId, deviceId, serializedRecord) {
|
|
497
|
-
await this.mutateSecurityState((state) => {
|
|
498
|
-
state.sessions[sessionId] = { userId, deviceId, serializedRecord };
|
|
499
|
-
});
|
|
500
|
-
}
|
|
501
|
-
async getSession(sessionId) {
|
|
502
|
-
const state = await this.readSecurityState();
|
|
503
|
-
return state.sessions[sessionId]?.serializedRecord ?? null;
|
|
504
|
-
}
|
|
505
|
-
async getSessionsForUser(userId) {
|
|
506
|
-
const state = await this.readSecurityState();
|
|
507
|
-
return Object.values(state.sessions)
|
|
508
|
-
.filter((session) => session.userId === userId)
|
|
509
|
-
.map((session) => session.serializedRecord);
|
|
510
|
-
}
|
|
511
|
-
async deleteSession(sessionId) {
|
|
512
|
-
await this.mutateSecurityState((state) => {
|
|
513
|
-
delete state.sessions[sessionId];
|
|
514
|
-
});
|
|
515
|
-
}
|
|
516
|
-
async deleteAllSessions() {
|
|
517
|
-
await this.mutateSecurityState((state) => {
|
|
518
|
-
state.sessions = emptyDictionary();
|
|
519
|
-
});
|
|
520
|
-
}
|
|
521
|
-
async commitSessionTrust(sessionId, userId, deviceId, serializedRecord, localIdentityType, contactKey, contactMutation, oneTimePreKeyId, kemOneTimePreKeyId, receivedContent, kyberPreKeyUse) {
|
|
522
|
-
await this.mutateSecurityState((state) => {
|
|
523
|
-
if (oneTimePreKeyId !== undefined &&
|
|
524
|
-
!(state.ecOneTimePreKeys[localIdentityType] ?? []).some((key) => key.keyId === oneTimePreKeyId)) {
|
|
525
|
-
throw new Error('Atomic session/trust commit cannot consume a missing EC one-time prekey');
|
|
526
|
-
}
|
|
527
|
-
if (kemOneTimePreKeyId !== undefined &&
|
|
528
|
-
!(state.kemOneTimePreKeys[localIdentityType] ?? []).some((key) => key.keyId === kemOneTimePreKeyId)) {
|
|
529
|
-
throw new Error('Atomic session/trust commit cannot consume a missing KEM one-time prekey');
|
|
530
|
-
}
|
|
531
|
-
if (kyberPreKeyUse) {
|
|
532
|
-
recordKyberPreKeyUse(state.kyberPreKeyStates[localIdentityType], localIdentityType, kyberPreKeyUse);
|
|
533
|
-
}
|
|
534
|
-
state.contacts[contactKey] = contactMutation(state.contacts[contactKey] ?? null);
|
|
535
|
-
state.sessions[sessionId] = { userId, deviceId, serializedRecord };
|
|
536
|
-
if (receivedContent)
|
|
537
|
-
state.metadata[receivedContentKey(receivedContent.id)] = JSON.stringify(receivedContent);
|
|
538
|
-
if (oneTimePreKeyId !== undefined) {
|
|
539
|
-
state.ecOneTimePreKeys[localIdentityType] = (state.ecOneTimePreKeys[localIdentityType] ?? []).filter((key) => key.keyId !== oneTimePreKeyId);
|
|
540
|
-
}
|
|
541
|
-
if (kemOneTimePreKeyId !== undefined) {
|
|
542
|
-
state.kemOneTimePreKeys[localIdentityType] = (state.kemOneTimePreKeys[localIdentityType] ?? []).filter((key) => key.keyId !== kemOneTimePreKeyId);
|
|
543
|
-
}
|
|
544
|
-
});
|
|
545
|
-
}
|
|
546
|
-
// ============================================================================
|
|
547
|
-
// SESAME Device State
|
|
548
|
-
//
|
|
549
|
-
// Device records and the sessions they own are one mutation domain. A device
|
|
550
|
-
// record naming a session that is not in `sessions`, or the reverse, is a
|
|
551
|
-
// divergence no later read can repair. Both therefore move under one commit.
|
|
552
|
-
// ============================================================================
|
|
553
|
-
async readSesameState() {
|
|
554
|
-
const state = await this.readSecurityState();
|
|
555
|
-
return { users: state.sesameUsers, sessions: state.sessions };
|
|
556
|
-
}
|
|
557
|
-
/** Drop every session and every SESAME device record in one commit. */
|
|
558
|
-
async clearSesameState() {
|
|
559
|
-
await this.mutateSecurityState((state) => {
|
|
560
|
-
state.sessions = emptyDictionary();
|
|
561
|
-
state.sesameUsers = emptyDictionary();
|
|
562
|
-
});
|
|
563
|
-
}
|
|
564
|
-
async mutateSesameState(mutation) {
|
|
565
|
-
return await this.mutateSecurityState((state) => mutation({ users: state.sesameUsers, sessions: state.sessions }));
|
|
566
|
-
}
|
|
567
|
-
// ============================================================================
|
|
568
|
-
// Sender Keys (Group Messaging)
|
|
569
|
-
// ============================================================================
|
|
570
|
-
async readSenderKeyState() {
|
|
571
|
-
const state = await this.readSecurityState();
|
|
572
|
-
return {
|
|
573
|
-
current: state.senderKeys,
|
|
574
|
-
records: state.senderKeyRecords,
|
|
575
|
-
skipped: state.skippedSenderKeys,
|
|
576
|
-
};
|
|
577
|
-
}
|
|
578
|
-
/**
|
|
579
|
-
* Atomically update the group-messaging namespaces.
|
|
580
|
-
*
|
|
581
|
-
* A rotation writes the new current state and the retained previous states
|
|
582
|
-
* together. A crash between them would leave a sender key whose in-flight
|
|
583
|
-
* messages can no longer be resolved.
|
|
584
|
-
*/
|
|
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
|
-
});
|
|
596
|
-
}
|
|
597
|
-
// ============================================================================
|
|
598
|
-
// Message Records (SESAME Retry Support)
|
|
599
|
-
// ============================================================================
|
|
600
|
-
async readMessageRecords() {
|
|
601
|
-
const state = await this.readSecurityState();
|
|
602
|
-
return state.messageRecords;
|
|
603
|
-
}
|
|
604
|
-
async mutateMessageRecords(mutation) {
|
|
605
|
-
return await this.mutateSecurityState((state) => mutation(state.messageRecords));
|
|
606
|
-
}
|
|
607
|
-
// ============================================================================
|
|
608
|
-
// Metadata, Registration IDs, and Kyber Usage
|
|
609
|
-
// ============================================================================
|
|
610
|
-
async getMetadataValue(key) {
|
|
611
|
-
const state = await this.readSecurityState();
|
|
612
|
-
return state.metadata[key] ?? null;
|
|
613
|
-
}
|
|
614
|
-
async setMetadataValue(key, value) {
|
|
615
|
-
await this.mutateSecurityState((state) => {
|
|
616
|
-
state.metadata[key] = value;
|
|
617
|
-
});
|
|
618
|
-
}
|
|
619
|
-
async deleteMetadataValue(key) {
|
|
620
|
-
await this.mutateSecurityState((state) => {
|
|
621
|
-
delete state.metadata[key];
|
|
622
|
-
});
|
|
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
|
-
}
|
|
650
|
-
async getRegistrationId(identityType) {
|
|
651
|
-
const state = await this.readSecurityState();
|
|
652
|
-
return state.registrationIds[identityType] ?? 0;
|
|
653
|
-
}
|
|
654
|
-
async setRegistrationId(identityType, id) {
|
|
655
|
-
await this.mutateSecurityState((state) => {
|
|
656
|
-
state.registrationIds[identityType] = id;
|
|
657
|
-
});
|
|
658
|
-
}
|
|
659
|
-
async markKyberPreKeyUsed(identityType, usage) {
|
|
660
|
-
await this.mutateSecurityState((state) => {
|
|
661
|
-
recordKyberPreKeyUseById(state.kyberPreKeyStates[identityType], identityType, usage);
|
|
662
|
-
});
|
|
663
|
-
}
|
|
664
|
-
// ============================================================================
|
|
665
|
-
// Key Recovery (PQXDH §4.13 identifier-collision recovery)
|
|
666
|
-
// ============================================================================
|
|
667
|
-
async getEcSignedPreKeyMaxId(identityType = 'aci') {
|
|
668
|
-
const keys = await this.readCollection(`signed_prekeys_${identityType}`);
|
|
669
|
-
return keys.reduce((max, key) => (key.keyId > max ? key.keyId : max), 0);
|
|
670
|
-
}
|
|
671
|
-
async getKyberPreKeyMaxId(identityType = 'aci') {
|
|
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);
|
|
675
|
-
}
|
|
676
|
-
async deleteAllPreKeys(identityType = 'aci') {
|
|
677
|
-
const signedPreKeys = await this.readCollection(`signed_prekeys_${identityType}`);
|
|
678
|
-
const oneTimeCounts = await this.mutateSecurityState((state) => {
|
|
679
|
-
const ec = (state.ecOneTimePreKeys[identityType] ?? []).length;
|
|
680
|
-
const kem = (state.kemOneTimePreKeys[identityType] ?? []).length;
|
|
681
|
-
const kyber = Object.keys(state.kyberPreKeyStates[identityType]?.instances ?? {}).length;
|
|
682
|
-
delete state.ecOneTimePreKeys[identityType];
|
|
683
|
-
delete state.kemOneTimePreKeys[identityType];
|
|
684
|
-
delete state.kyberPreKeyStates[identityType];
|
|
685
|
-
return { ec, kem, kyber };
|
|
686
|
-
});
|
|
687
|
-
await Promise.all([this.deleteCollection(`signed_prekeys_${identityType}`)]);
|
|
688
|
-
return {
|
|
689
|
-
ecSignedPreKeys: signedPreKeys.length,
|
|
690
|
-
ecOneTimePreKeys: oneTimeCounts.ec,
|
|
691
|
-
kyberPreKeys: oneTimeCounts.kyber,
|
|
692
|
-
kemOneTimePreKeys: oneTimeCounts.kem,
|
|
693
|
-
};
|
|
694
|
-
}
|
|
695
|
-
async getDetailedStats() {
|
|
696
|
-
const state = await this.readSecurityState();
|
|
697
|
-
const [signedAci, signedPni] = await Promise.all([
|
|
698
|
-
this.readCollection(`signed_prekeys_aci`).then((keys) => keys.length),
|
|
699
|
-
this.readCollection(`signed_prekeys_pni`).then((keys) => keys.length),
|
|
700
|
-
]);
|
|
701
|
-
const total = (collection) => Object.values(collection).reduce((count, keys) => count + keys.length, 0);
|
|
702
|
-
return {
|
|
703
|
-
sessions: Object.keys(state.sessions).length,
|
|
704
|
-
ecSignedPreKeys: signedAci + signedPni,
|
|
705
|
-
ecOneTimePreKeys: total(state.ecOneTimePreKeys),
|
|
706
|
-
kyberPreKeys: Object.values(state.kyberPreKeyStates).reduce((count, kyberState) => count + Object.keys(kyberState.instances).length, 0),
|
|
707
|
-
kemOneTimePreKeys: total(state.kemOneTimePreKeys),
|
|
708
|
-
users: Object.keys(state.sesameUsers).length,
|
|
709
|
-
};
|
|
710
|
-
}
|
|
711
|
-
// ============================================================================
|
|
712
|
-
// Statistics
|
|
713
|
-
// ============================================================================
|
|
714
|
-
async getStats() {
|
|
715
|
-
await this.ensureInitialized();
|
|
716
|
-
const securityState = await this.readSecurityState();
|
|
717
|
-
const [identityAci, identityPni, signedAci, signedPni] = await Promise.all([
|
|
718
|
-
this.readCollection('identity_keys_aci')
|
|
719
|
-
.then((keys) => keys.length)
|
|
720
|
-
.catch(() => 0),
|
|
721
|
-
this.readCollection('identity_keys_pni')
|
|
722
|
-
.then((keys) => keys.length)
|
|
723
|
-
.catch(() => 0),
|
|
724
|
-
this.readCollection('signed_prekeys_aci')
|
|
725
|
-
.then((keys) => keys.length)
|
|
726
|
-
.catch(() => 0),
|
|
727
|
-
this.readCollection('signed_prekeys_pni')
|
|
728
|
-
.then((keys) => keys.length)
|
|
729
|
-
.catch(() => 0),
|
|
730
|
-
]);
|
|
731
|
-
return {
|
|
732
|
-
identityKeys: identityAci + identityPni,
|
|
733
|
-
signedPreKeys: signedAci + signedPni,
|
|
734
|
-
oneTimePreKeys: Object.values(securityState.ecOneTimePreKeys).reduce((count, keys) => count + keys.length, 0),
|
|
735
|
-
kyberPreKeys: Object.values(securityState.kyberPreKeyStates).reduce((count, kyberState) => count + Object.keys(kyberState.instances).length, 0),
|
|
736
|
-
sessions: Object.keys(securityState.sessions).length,
|
|
737
|
-
};
|
|
738
|
-
}
|
|
739
|
-
// ============================================================================
|
|
740
|
-
// Maintenance
|
|
741
|
-
// ============================================================================
|
|
742
|
-
/**
|
|
743
|
-
* Close database (cleanup)
|
|
744
|
-
*/
|
|
745
|
-
async close() {
|
|
746
|
-
await this.initPromise?.catch(() => undefined);
|
|
747
|
-
await this.securityStateMutation;
|
|
748
|
-
this.dbKey = null;
|
|
749
|
-
this.initPromise = null;
|
|
750
|
-
}
|
|
751
|
-
/**
|
|
752
|
-
* Delete entire database (⚠️ DANGEROUS)
|
|
753
|
-
*
|
|
754
|
-
* Only for controlled local reset or factory reset.
|
|
755
|
-
* This method is safe to call even if database does not exist.
|
|
756
|
-
*
|
|
757
|
-
* @returns true if database was deleted, false if it did not exist
|
|
758
|
-
*/
|
|
759
|
-
async deleteDatabase() {
|
|
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)
|
|
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
|
-
}
|
|
771
|
-
}
|
|
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');
|
|
784
|
-
return true;
|
|
785
|
-
});
|
|
786
|
-
}
|
|
787
|
-
}
|
|
788
|
-
/**
|
|
789
|
-
* Singleton instance
|
|
790
|
-
*/
|
|
791
|
-
const encryptedDatabaseInstances = new Map();
|
|
792
|
-
/**
|
|
793
|
-
* Get singleton NodeEncryptedDatabase instance
|
|
794
|
-
*
|
|
795
|
-
* @param dataDir Optional custom data directory
|
|
796
|
-
*/
|
|
797
|
-
export function getNodeEncryptedDatabase(dataDir) {
|
|
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);
|
|
803
|
-
}
|
|
804
|
-
return instance;
|
|
805
|
-
}
|
|
806
|
-
/**
|
|
807
|
-
* Reset the singleton for controlled local teardown.
|
|
808
|
-
*/
|
|
809
|
-
export async function resetNodeEncryptedDatabase() {
|
|
810
|
-
await Promise.all([...encryptedDatabaseInstances.values()].map((instance) => instance.close()));
|
|
811
|
-
encryptedDatabaseInstances.clear();
|
|
812
|
-
}
|
|
813
|
-
//# sourceMappingURL=database.js.map
|