@open-e2ee/signal-protocol-sdk 0.2.2 → 0.3.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 +4 -4
- package/ARCHITECTURE.md +17 -16
- package/CHANGELOG.md +49 -0
- package/COMMERCIAL.md +6 -6
- package/NOTICE +1 -1
- package/README.md +44 -34
- package/SECURITY.md +16 -13
- package/TROUBLESHOOTING.md +5 -5
- package/blocking/README.md +6 -5
- package/client/README.md +5 -5
- package/device/README.md +8 -8
- package/dist/blocking/types.d.ts +2 -2
- package/dist/blocking/types.js +2 -2
- package/dist/client/client.d.ts +46 -45
- package/dist/client/client.d.ts.map +1 -1
- package/dist/client/client.js +61 -60
- package/dist/client/client.js.map +1 -1
- package/dist/client/config.d.ts +32 -32
- package/dist/client/constants.d.ts +7 -6
- package/dist/client/constants.d.ts.map +1 -1
- package/dist/client/constants.js +5 -4
- package/dist/client/constants.js.map +1 -1
- package/dist/client/dual-store.d.ts +2 -2
- package/dist/client/dual-store.js +2 -2
- package/dist/client/endorsement-manager.d.ts +14 -14
- package/dist/client/endorsement-manager.d.ts.map +1 -1
- package/dist/client/endorsement-manager.js +15 -15
- package/dist/client/endorsement-manager.js.map +1 -1
- package/dist/client/event-hooks.d.ts +16 -16
- package/dist/client/event-hooks.d.ts.map +1 -1
- package/dist/client/event-hooks.js +1 -1
- package/dist/client/event-hooks.js.map +1 -1
- package/dist/client/files.js +4 -4
- package/dist/client/files.js.map +1 -1
- package/dist/client/headless.d.ts +7 -7
- package/dist/client/headless.d.ts.map +1 -1
- package/dist/client/headless.js +4 -4
- package/dist/client/key-rotation-core.d.ts +19 -17
- package/dist/client/key-rotation-core.d.ts.map +1 -1
- package/dist/client/key-rotation-core.js +35 -31
- package/dist/client/key-rotation-core.js.map +1 -1
- package/dist/client/key-rotation.d.ts +8 -8
- package/dist/client/key-rotation.js +8 -8
- package/dist/client/media.d.ts +1 -1
- package/dist/client/messages.d.ts.map +1 -1
- package/dist/client/messages.js +13 -11
- package/dist/client/messages.js.map +1 -1
- package/dist/client/multi-device.d.ts +5 -4
- package/dist/client/multi-device.d.ts.map +1 -1
- package/dist/client/multi-device.js.map +1 -1
- package/dist/client/prekeys.d.ts +7 -7
- package/dist/client/prekeys.js +10 -10
- package/dist/client/prekeys.js.map +1 -1
- package/dist/client/relay-subscription.d.ts +3 -0
- package/dist/client/relay-subscription.d.ts.map +1 -1
- package/dist/client/relay-subscription.js +7 -4
- package/dist/client/relay-subscription.js.map +1 -1
- package/dist/client/retry-utils.d.ts +5 -6
- package/dist/client/retry-utils.d.ts.map +1 -1
- package/dist/client/retry-utils.js +5 -12
- package/dist/client/retry-utils.js.map +1 -1
- package/dist/client/retry.js +7 -7
- package/dist/client/retry.js.map +1 -1
- package/dist/client/sealed-sender-ops.d.ts +3 -3
- package/dist/client/sealed-sender-ops.js +5 -5
- package/dist/client/sealed-sender-ops.js.map +1 -1
- package/dist/client/sessions.d.ts +2 -2
- package/dist/client/sessions.js +2 -2
- package/dist/client/signal-service-cipher.d.ts +9 -9
- package/dist/client/signal-service-cipher.d.ts.map +1 -1
- package/dist/client/signal-service-cipher.js +41 -40
- 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 +19 -19
- package/dist/client/types.d.ts.map +1 -1
- package/dist/device/connection.d.ts +1 -1
- package/dist/device/connection.js +2 -2
- package/dist/device/connection.js.map +1 -1
- package/dist/device/constants.d.ts +4 -4
- package/dist/device/constants.js +3 -3
- package/dist/device/device-id.d.ts +4 -4
- package/dist/device/device-id.js +4 -4
- package/dist/device/expo-metadata.d.ts +13 -11
- package/dist/device/expo-metadata.d.ts.map +1 -1
- package/dist/device/expo-metadata.js +13 -11
- package/dist/device/expo-metadata.js.map +1 -1
- package/dist/device/lifecycle/manager.d.ts +6 -6
- package/dist/device/lifecycle/manager.js +7 -7
- package/dist/device/lifecycle/types.d.ts +13 -13
- package/dist/device/lifecycle/types.d.ts.map +1 -1
- package/dist/device/lifecycle/utils.d.ts +2 -2
- package/dist/device/lifecycle/utils.js +5 -5
- package/dist/device/lifecycle/utils.js.map +1 -1
- package/dist/device/provisioning.d.ts +5 -4
- package/dist/device/provisioning.d.ts.map +1 -1
- package/dist/device/provisioning.js +5 -4
- package/dist/device/provisioning.js.map +1 -1
- package/dist/device/transfer.d.ts +2 -2
- package/dist/device/transfer.js +3 -3
- package/dist/device/transfer.js.map +1 -1
- package/dist/encoding/index.d.ts +3 -4
- package/dist/encoding/index.d.ts.map +1 -1
- package/dist/encoding/index.js.map +1 -1
- package/dist/files/index.d.ts +1 -1
- package/dist/files/index.js +1 -1
- package/dist/hooks/use-connection-presence.d.ts +1 -1
- package/dist/hooks/use-connection-presence.js +7 -7
- 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 +6 -6
- package/dist/hooks/use-group-membership.js.map +1 -1
- package/dist/hooks/use-key-rotation.js +3 -3
- package/dist/hooks/use-key-rotation.js.map +1 -1
- package/dist/hooks/use-single-flight.d.ts +2 -2
- package/dist/hooks/use-single-flight.js +1 -1
- package/dist/index.d.ts +4 -3
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +22 -4
- package/dist/index.js.map +1 -1
- package/dist/internal/crypto/ec/ed25519.d.ts +6 -6
- package/dist/internal/crypto/ec/ed25519.js +6 -6
- package/dist/internal/crypto/ec/x25519-validation.d.ts.map +1 -1
- package/dist/internal/crypto/ec/x25519-validation.js +4 -2
- package/dist/internal/crypto/ec/x25519-validation.js.map +1 -1
- package/dist/internal/crypto/index.d.ts +2 -0
- package/dist/internal/crypto/index.d.ts.map +1 -1
- package/dist/internal/crypto/index.js +2 -0
- package/dist/internal/crypto/index.js.map +1 -1
- package/dist/internal/crypto/kdf/hkdf.d.ts +9 -8
- package/dist/internal/crypto/kdf/hkdf.d.ts.map +1 -1
- package/dist/internal/crypto/kdf/hkdf.js +11 -10
- package/dist/internal/crypto/kdf/hkdf.js.map +1 -1
- package/dist/internal/crypto/key-prefix.d.ts +3 -3
- package/dist/internal/crypto/key-prefix.js +3 -3
- package/dist/internal/crypto/pq/kyber.d.ts +7 -7
- package/dist/internal/crypto/pq/kyber.js +10 -10
- package/dist/internal/crypto/pq/kyber.js.map +1 -1
- package/dist/internal/crypto/random.d.ts +1 -1
- package/dist/internal/crypto/random.js +1 -1
- package/dist/internal/crypto/symmetric/aes-gcm-siv.js +1 -1
- package/dist/internal/crypto/symmetric/aes.js +4 -4
- package/dist/internal/crypto/symmetric/aes.js.map +1 -1
- package/dist/internal/crypto/symmetric/mac.d.ts +1 -1
- package/dist/internal/crypto/symmetric/mac.js +3 -3
- package/dist/internal/crypto/symmetric/padding.js +1 -1
- package/dist/internal/crypto/symmetric/padding.js.map +1 -1
- package/dist/internal/crypto/symmetric/streaming-aead.d.ts +7 -1
- package/dist/internal/crypto/symmetric/streaming-aead.d.ts.map +1 -1
- package/dist/internal/crypto/symmetric/streaming-aead.js +10 -4
- package/dist/internal/crypto/symmetric/streaming-aead.js.map +1 -1
- package/dist/internal/crypto/utils.d.ts +2 -2
- package/dist/internal/crypto/utils.d.ts.map +1 -1
- package/dist/internal/crypto/utils.js +16 -14
- package/dist/internal/crypto/utils.js.map +1 -1
- package/dist/internal/crypto/validation.d.ts +4 -4
- package/dist/internal/crypto/validation.js +2 -2
- package/dist/internal/encoding/proto/envelope.d.ts +1 -1
- package/dist/internal/encoding/proto/envelope.js +1 -1
- package/dist/internal/encoding/proto/index.d.ts +4 -4
- package/dist/internal/encoding/proto/index.js +4 -4
- package/dist/internal/encoding/proto/pq-ratchet-serialize.d.ts +28 -16
- package/dist/internal/encoding/proto/pq-ratchet-serialize.d.ts.map +1 -1
- package/dist/internal/encoding/proto/pq-ratchet-serialize.js +30 -18
- package/dist/internal/encoding/proto/pq-ratchet-serialize.js.map +1 -1
- package/dist/internal/encoding/proto/primitives.d.ts +45 -35
- package/dist/internal/encoding/proto/primitives.d.ts.map +1 -1
- package/dist/internal/encoding/proto/primitives.js +54 -43
- package/dist/internal/encoding/proto/primitives.js.map +1 -1
- package/dist/internal/encoding/proto/sender-key-message.d.ts +2 -2
- package/dist/internal/encoding/proto/sender-key-message.js +2 -2
- package/dist/internal/encoding/proto/signal-message.d.ts +13 -13
- package/dist/internal/encoding/proto/signal-message.d.ts.map +1 -1
- package/dist/internal/encoding/proto/signal-message.js +13 -13
- package/dist/internal/encoding/proto/signal-message.js.map +1 -1
- package/dist/internal/groups/access-control.d.ts +5 -5
- package/dist/internal/groups/access-control.js +6 -6
- package/dist/internal/groups/access-control.js.map +1 -1
- package/dist/internal/groups/change-actions.d.ts +4 -4
- package/dist/internal/groups/change-actions.js +3 -3
- package/dist/internal/groups/encrypted-state.js +1 -1
- package/dist/internal/groups/encrypted-state.js.map +1 -1
- package/dist/internal/groups/group-id.d.ts +1 -1
- package/dist/internal/groups/manager.d.ts +24 -23
- package/dist/internal/groups/manager.d.ts.map +1 -1
- package/dist/internal/groups/manager.js +40 -36
- package/dist/internal/groups/manager.js.map +1 -1
- package/dist/internal/groups/server-engine.d.ts +29 -21
- package/dist/internal/groups/server-engine.d.ts.map +1 -1
- package/dist/internal/groups/server-engine.js +55 -50
- package/dist/internal/groups/server-engine.js.map +1 -1
- package/dist/internal/groups/trust-root.d.ts +2 -2
- package/dist/internal/groups/trust-root.js +2 -2
- package/dist/internal/groups/types.d.ts +4 -4
- package/dist/internal/groups/types.d.ts.map +1 -1
- package/dist/internal/groups/wire.d.ts +6 -7
- package/dist/internal/groups/wire.d.ts.map +1 -1
- package/dist/internal/groups/wire.js +6 -7
- package/dist/internal/groups/wire.js.map +1 -1
- package/dist/internal/manager/manager.d.ts +14 -12
- package/dist/internal/manager/manager.d.ts.map +1 -1
- package/dist/internal/manager/manager.js +47 -41
- package/dist/internal/manager/manager.js.map +1 -1
- package/dist/internal/protocol/double-ratchet/chains.d.ts +8 -6
- package/dist/internal/protocol/double-ratchet/chains.d.ts.map +1 -1
- package/dist/internal/protocol/double-ratchet/chains.js +10 -8
- package/dist/internal/protocol/double-ratchet/chains.js.map +1 -1
- package/dist/internal/protocol/double-ratchet/index.d.ts +2 -2
- package/dist/internal/protocol/double-ratchet/index.js +2 -2
- package/dist/internal/protocol/double-ratchet/ratchet.d.ts +4 -4
- package/dist/internal/protocol/double-ratchet/ratchet.js +6 -6
- package/dist/internal/protocol/pqxdh/pqxdh.d.ts +21 -18
- package/dist/internal/protocol/pqxdh/pqxdh.d.ts.map +1 -1
- package/dist/internal/protocol/pqxdh/pqxdh.js +48 -42
- package/dist/internal/protocol/pqxdh/pqxdh.js.map +1 -1
- package/dist/internal/protocol/sealed-sender/decryption-v2.js +5 -5
- package/dist/internal/protocol/sealed-sender/decryption-v2.js.map +1 -1
- package/dist/internal/protocol/sealed-sender/decryption.d.ts.map +1 -1
- package/dist/internal/protocol/sealed-sender/decryption.js +11 -8
- package/dist/internal/protocol/sealed-sender/decryption.js.map +1 -1
- package/dist/internal/protocol/sealed-sender/delivery-token.d.ts +2 -2
- package/dist/internal/protocol/sealed-sender/delivery-token.js +2 -2
- package/dist/internal/protocol/sealed-sender/encryption-v2.js +1 -1
- package/dist/internal/protocol/sealed-sender/encryption-v2.js.map +1 -1
- package/dist/internal/protocol/sealed-sender/encryption.d.ts +2 -2
- package/dist/internal/protocol/sealed-sender/encryption.js +2 -2
- package/dist/internal/protocol/sealed-sender/proto/index.d.ts +25 -23
- package/dist/internal/protocol/sealed-sender/proto/index.d.ts.map +1 -1
- package/dist/internal/protocol/sealed-sender/proto/index.js +32 -30
- package/dist/internal/protocol/sealed-sender/proto/index.js.map +1 -1
- package/dist/internal/protocol/sealed-sender/trust-root.d.ts +10 -9
- package/dist/internal/protocol/sealed-sender/trust-root.d.ts.map +1 -1
- package/dist/internal/protocol/sealed-sender/trust-root.js +10 -9
- package/dist/internal/protocol/sealed-sender/trust-root.js.map +1 -1
- package/dist/internal/protocol/sealed-sender/types.d.ts +13 -14
- package/dist/internal/protocol/sealed-sender/types.d.ts.map +1 -1
- package/dist/internal/protocol/sealed-sender/types.js +7 -8
- package/dist/internal/protocol/sealed-sender/types.js.map +1 -1
- package/dist/internal/protocol/sealed-sender/v2-binary.d.ts +1 -1
- package/dist/internal/protocol/sealed-sender/v2-binary.js +2 -2
- package/dist/internal/protocol/sealed-sender/v2-binary.js.map +1 -1
- package/dist/internal/protocol/sender-keys/manager.d.ts +16 -14
- package/dist/internal/protocol/sender-keys/manager.d.ts.map +1 -1
- package/dist/internal/protocol/sender-keys/manager.js +37 -34
- package/dist/internal/protocol/sender-keys/manager.js.map +1 -1
- package/dist/internal/protocol/spqr/braid-serialize.d.ts +6 -6
- package/dist/internal/protocol/spqr/braid-serialize.js +5 -5
- package/dist/internal/protocol/spqr/braid-serialize.js.map +1 -1
- package/dist/internal/protocol/spqr/braid.d.ts +3 -3
- package/dist/internal/protocol/spqr/braid.js +7 -7
- package/dist/internal/protocol/spqr/braid.js.map +1 -1
- package/dist/internal/protocol/spqr/index.js +1 -1
- package/dist/internal/protocol/spqr/index.js.map +1 -1
- package/dist/internal/protocol/spqr/ml-kem-braid/chunk-domain.d.ts +3 -3
- package/dist/internal/protocol/spqr/ml-kem-braid/chunk-domain.js +3 -3
- package/dist/internal/protocol/spqr/ml-kem-braid/incremental-kem.js +1 -1
- package/dist/internal/protocol/spqr/ml-kem-braid/incremental-kem.js.map +1 -1
- package/dist/internal/protocol/spqr/ml-kem-braid/kdf.d.ts +1 -1
- package/dist/internal/protocol/spqr/ml-kem-braid/kdf.js +1 -1
- package/dist/internal/protocol/spqr/ml-kem-braid/kdf.js.map +1 -1
- package/dist/internal/protocol/spqr/ml-kem-braid/noble-pq/arithmetic.d.ts +4 -3
- package/dist/internal/protocol/spqr/ml-kem-braid/noble-pq/arithmetic.d.ts.map +1 -1
- package/dist/internal/protocol/spqr/ml-kem-braid/noble-pq/arithmetic.js +4 -3
- package/dist/internal/protocol/spqr/ml-kem-braid/noble-pq/arithmetic.js.map +1 -1
- package/dist/internal/protocol/spqr/ml-kem-braid/noble-pq/index.js +2 -2
- package/dist/internal/protocol/spqr/ml-kem-braid/progress.d.ts +1 -1
- package/dist/internal/protocol/spqr/ml-kem-braid/progress.js +1 -1
- package/dist/internal/protocol/spqr/ml-kem-braid/rs/codec.d.ts +15 -7
- package/dist/internal/protocol/spqr/ml-kem-braid/rs/codec.d.ts.map +1 -1
- package/dist/internal/protocol/spqr/ml-kem-braid/rs/codec.js +15 -7
- package/dist/internal/protocol/spqr/ml-kem-braid/rs/codec.js.map +1 -1
- package/dist/internal/protocol/spqr/ml-kem-braid/rs/galois/field.js +1 -1
- package/dist/internal/protocol/spqr/ml-kem-braid/rs/polynomial.d.ts +3 -3
- package/dist/internal/protocol/spqr/ml-kem-braid/rs/polynomial.js +1 -1
- package/dist/internal/protocol/spqr/ml-kem-braid/serialize.d.ts +7 -7
- package/dist/internal/protocol/spqr/ml-kem-braid/serialize.js +11 -11
- package/dist/internal/protocol/spqr/ml-kem-braid/serialize.js.map +1 -1
- package/dist/internal/protocol/spqr/ml-kem-braid/state-machine.d.ts +1 -1
- package/dist/internal/protocol/spqr/ml-kem-braid/state-machine.js +6 -6
- 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 +2 -2
- package/dist/internal/protocol/spqr/ml-kem-braid/types.d.ts.map +1 -1
- package/dist/internal/protocol/spqr/ml-kem-braid/types.js.map +1 -1
- package/dist/internal/protocol/spqr/serialize.d.ts +12 -12
- package/dist/internal/protocol/spqr/serialize.js +5 -5
- package/dist/internal/protocol/spqr/spqr.d.ts +6 -6
- package/dist/internal/protocol/spqr/spqr.d.ts.map +1 -1
- package/dist/internal/protocol/spqr/spqr.js +47 -42
- package/dist/internal/protocol/spqr/spqr.js.map +1 -1
- package/dist/internal/protocol/spqr/validate.d.ts +1 -1
- package/dist/internal/protocol/triple-ratchet/ratchet.d.ts +12 -12
- package/dist/internal/protocol/triple-ratchet/ratchet.d.ts.map +1 -1
- package/dist/internal/protocol/triple-ratchet/ratchet.js +11 -11
- package/dist/internal/protocol/triple-ratchet/ratchet.js.map +1 -1
- package/dist/internal/protocol/username/hash.d.ts.map +1 -1
- package/dist/internal/protocol/username/hash.js +6 -4
- package/dist/internal/protocol/username/hash.js.map +1 -1
- package/dist/internal/protocol/version.d.ts +3 -3
- package/dist/internal/protocol/version.js +1 -1
- package/dist/internal/protocol/x3dh/x3dh.d.ts +16 -16
- package/dist/internal/protocol/x3dh/x3dh.d.ts.map +1 -1
- package/dist/internal/protocol/x3dh/x3dh.js +15 -15
- package/dist/internal/protocol/x3dh/x3dh.js.map +1 -1
- package/dist/internal/protocol/zk/credentials/attributes.d.ts +7 -7
- package/dist/internal/protocol/zk/credentials/attributes.js +7 -7
- package/dist/internal/protocol/zk/credentials/credentials.d.ts +1 -1
- package/dist/internal/protocol/zk/credentials/credentials.js +1 -1
- package/dist/internal/protocol/zk/credentials/endorsements.d.ts +11 -11
- package/dist/internal/protocol/zk/credentials/endorsements.js +14 -14
- package/dist/internal/protocol/zk/credentials/issuance.d.ts +5 -1
- package/dist/internal/protocol/zk/credentials/issuance.d.ts.map +1 -1
- package/dist/internal/protocol/zk/credentials/issuance.js +5 -1
- package/dist/internal/protocol/zk/credentials/issuance.js.map +1 -1
- package/dist/internal/protocol/zk/credentials/presentation.d.ts +16 -16
- package/dist/internal/protocol/zk/credentials/presentation.d.ts.map +1 -1
- package/dist/internal/protocol/zk/credentials/presentation.js +18 -18
- package/dist/internal/protocol/zk/credentials/presentation.js.map +1 -1
- package/dist/internal/protocol/zk/groups/auth-credential.d.ts +22 -16
- package/dist/internal/protocol/zk/groups/auth-credential.d.ts.map +1 -1
- package/dist/internal/protocol/zk/groups/auth-credential.js +19 -14
- package/dist/internal/protocol/zk/groups/auth-credential.js.map +1 -1
- package/dist/internal/protocol/zk/groups/client-zk-group-cipher.d.ts +4 -4
- package/dist/internal/protocol/zk/groups/client-zk-group-cipher.js +4 -4
- package/dist/internal/protocol/zk/groups/group-params.d.ts +2 -2
- package/dist/internal/protocol/zk/groups/group-params.js +2 -2
- package/dist/internal/protocol/zk/groups/group-send-endorsement.d.ts +10 -9
- package/dist/internal/protocol/zk/groups/group-send-endorsement.d.ts.map +1 -1
- package/dist/internal/protocol/zk/groups/group-send-endorsement.js +9 -8
- package/dist/internal/protocol/zk/groups/group-send-endorsement.js.map +1 -1
- package/dist/internal/protocol/zk/groups/lizard.d.ts +1 -1
- package/dist/internal/protocol/zk/groups/lizard.js +4 -4
- package/dist/internal/protocol/zk/groups/lizard.js.map +1 -1
- package/dist/internal/protocol/zk/groups/profile-key-commitment.d.ts +3 -3
- package/dist/internal/protocol/zk/groups/profile-key-commitment.js +3 -3
- package/dist/internal/protocol/zk/groups/profile-key-credential.d.ts +11 -11
- package/dist/internal/protocol/zk/groups/profile-key-credential.js +7 -7
- package/dist/internal/protocol/zk/groups/profile-key-encryption.d.ts +2 -2
- package/dist/internal/protocol/zk/groups/profile-key-encryption.js +2 -2
- package/dist/internal/protocol/zk/groups/profile-key-struct.d.ts +2 -2
- package/dist/internal/protocol/zk/groups/profile-key-struct.js +2 -2
- package/dist/internal/protocol/zk/groups/profile-key-version.d.ts +2 -2
- package/dist/internal/protocol/zk/groups/profile-key-version.js +2 -2
- package/dist/internal/protocol/zk/groups/server-params.d.ts +1 -1
- package/dist/internal/protocol/zk/groups/server-params.js +1 -1
- package/dist/internal/protocol/zk/groups/uid-encryption.d.ts +4 -4
- package/dist/internal/protocol/zk/groups/uid-encryption.js +4 -4
- package/dist/internal/protocol/zk/groups/uid-struct.d.ts +2 -2
- package/dist/internal/protocol/zk/groups/uid-struct.js +3 -3
- package/dist/internal/protocol/zk/groups/uid-struct.js.map +1 -1
- package/dist/internal/protocol/zk/proofs/args.d.ts +3 -3
- package/dist/internal/protocol/zk/proofs/args.js +3 -3
- package/dist/internal/protocol/zk/proofs/sho-sha256.d.ts +3 -3
- package/dist/internal/protocol/zk/proofs/sho-sha256.js +3 -3
- package/dist/internal/protocol/zk/proofs/sho.d.ts +8 -7
- package/dist/internal/protocol/zk/proofs/sho.d.ts.map +1 -1
- package/dist/internal/protocol/zk/proofs/sho.js +8 -7
- package/dist/internal/protocol/zk/proofs/sho.js.map +1 -1
- package/dist/internal/protocol/zk/proofs/statement.d.ts +8 -6
- package/dist/internal/protocol/zk/proofs/statement.d.ts.map +1 -1
- package/dist/internal/protocol/zk/proofs/statement.js +8 -6
- package/dist/internal/protocol/zk/proofs/statement.js.map +1 -1
- package/dist/internal/sesame/manager.d.ts +23 -19
- package/dist/internal/sesame/manager.d.ts.map +1 -1
- package/dist/internal/sesame/manager.js +64 -54
- package/dist/internal/sesame/manager.js.map +1 -1
- package/dist/internal/sesame/types.d.ts +28 -25
- package/dist/internal/sesame/types.d.ts.map +1 -1
- package/dist/internal/sesame/types.js +2 -2
- package/dist/internal/sesame/types.js.map +1 -1
- package/dist/internal/sesame/validation.d.ts +2 -2
- package/dist/internal/sesame/validation.js +3 -3
- package/dist/internal/sesame/validation.js.map +1 -1
- package/dist/internal/session/builder.d.ts +8 -8
- package/dist/internal/session/builder.js +22 -22
- package/dist/internal/session/builder.js.map +1 -1
- package/dist/internal/session/cipher.d.ts +3 -3
- package/dist/internal/session/cipher.d.ts.map +1 -1
- package/dist/internal/session/cipher.js +51 -40
- package/dist/internal/session/cipher.js.map +1 -1
- package/dist/internal/session/decryption.js +11 -9
- package/dist/internal/session/decryption.js.map +1 -1
- package/dist/internal/session/factory.js +1 -1
- package/dist/internal/session/factory.js.map +1 -1
- package/dist/internal/session/handshake.d.ts +4 -4
- package/dist/internal/session/handshake.js +4 -4
- package/dist/internal/session/keys.d.ts +3 -4
- package/dist/internal/session/keys.d.ts.map +1 -1
- package/dist/internal/session/keys.js.map +1 -1
- package/dist/internal/session/ratchet.d.ts +8 -8
- package/dist/internal/session/ratchet.js +10 -10
- package/dist/internal/session/ratchet.js.map +1 -1
- package/dist/internal/session/session-resolver.d.ts +6 -6
- package/dist/internal/session/session-resolver.js +6 -6
- package/dist/internal/session/state.d.ts +12 -12
- package/dist/internal/session/state.d.ts.map +1 -1
- package/dist/internal/session/state.js +7 -7
- package/dist/internal/session/types.d.ts +20 -20
- package/dist/internal/session/types.d.ts.map +1 -1
- package/dist/internal/session/types.js +3 -3
- package/dist/internal/session/validation.d.ts +1 -1
- package/dist/internal/session/validation.js +4 -4
- package/dist/internal/session/validation.js.map +1 -1
- package/dist/keys/branded.d.ts +12 -12
- package/dist/keys/branded.js +3 -3
- package/dist/keys/generation.d.ts +4 -4
- package/dist/keys/generation.js +4 -4
- package/dist/keys/identity.d.ts +7 -7
- package/dist/keys/identity.d.ts.map +1 -1
- package/dist/keys/identity.js +7 -7
- package/dist/keys/identity.js.map +1 -1
- package/dist/keys/types.d.ts +16 -16
- package/dist/keys/types.d.ts.map +1 -1
- package/dist/layers.d.ts +1 -1
- package/dist/layers.js +1 -1
- package/dist/local/store/expo/adapter.d.ts +8 -8
- package/dist/local/store/expo/adapter.js +10 -10
- package/dist/local/store/expo/adapter.js.map +1 -1
- package/dist/local/store/expo/database-key.d.ts +7 -7
- package/dist/local/store/expo/database-key.js +7 -7
- package/dist/local/store/expo/key-storage.d.ts +1 -1
- package/dist/local/store/expo/key-storage.js +4 -4
- package/dist/local/store/expo/key-storage.js.map +1 -1
- package/dist/local/store/expo/models/kyber-prekey-used.d.ts +6 -6
- package/dist/local/store/expo/models/kyber-prekey-used.js +3 -3
- package/dist/local/store/expo/models/kyber-prekey.d.ts +1 -1
- package/dist/local/store/expo/models/kyber-prekey.js +1 -1
- package/dist/local/store/expo/models/message-record.d.ts +2 -2
- package/dist/local/store/expo/models/message-record.d.ts.map +1 -1
- package/dist/local/store/expo/models/message-record.js +1 -1
- package/dist/local/store/expo/models/message-record.js.map +1 -1
- package/dist/local/store/expo/models/sender-key.d.ts +11 -10
- package/dist/local/store/expo/models/sender-key.d.ts.map +1 -1
- package/dist/local/store/expo/models/sender-key.js +11 -10
- package/dist/local/store/expo/models/sender-key.js.map +1 -1
- package/dist/local/store/expo/schema.d.ts +2 -2
- package/dist/local/store/expo/schema.js +2 -2
- package/dist/local/store/expo/secure-store-options.d.ts +1 -1
- package/dist/local/store/memory/adapter.d.ts +2 -2
- package/dist/local/store/memory/adapter.js +12 -12
- package/dist/local/store/memory/adapter.js.map +1 -1
- package/dist/local/store/node/adapter.d.ts.map +1 -1
- package/dist/local/store/node/adapter.js +5 -4
- package/dist/local/store/node/adapter.js.map +1 -1
- package/dist/local/store/node/database-key.d.ts +8 -8
- package/dist/local/store/node/database-key.js +10 -10
- package/dist/local/store/node/database-key.js.map +1 -1
- package/dist/local/store/node/database.d.ts +5 -5
- package/dist/local/store/node/database.js +11 -11
- package/dist/local/store/node/database.js.map +1 -1
- package/dist/local/store/react-native/adapter.d.ts +6 -6
- package/dist/local/store/react-native/adapter.d.ts.map +1 -1
- package/dist/local/store/react-native/adapter.js +35 -32
- package/dist/local/store/react-native/adapter.js.map +1 -1
- package/dist/local/store/react-native/backend-conformance.d.ts +11 -10
- package/dist/local/store/react-native/backend-conformance.d.ts.map +1 -1
- package/dist/local/store/react-native/backend-conformance.js +13 -12
- package/dist/local/store/react-native/backend-conformance.js.map +1 -1
- package/dist/local/store/react-native/index.d.ts +1 -1
- package/dist/local/store/react-native/reference-backend.d.ts +14 -13
- package/dist/local/store/react-native/reference-backend.d.ts.map +1 -1
- package/dist/local/store/react-native/reference-backend.js +15 -14
- package/dist/local/store/react-native/reference-backend.js.map +1 -1
- package/dist/local/store/react-native/storage.d.ts +3 -3
- package/dist/local/store/web/adapter.d.ts +3 -3
- package/dist/local/store/web/adapter.d.ts.map +1 -1
- package/dist/local/store/web/adapter.js +30 -31
- package/dist/local/store/web/adapter.js.map +1 -1
- package/dist/local/store/web/index.d.ts +1 -1
- package/dist/local/vault/index.d.ts +2 -2
- package/dist/media/index.d.ts +11 -11
- package/dist/media/index.js +9 -9
- package/dist/profile/contact-state.d.ts +1 -1
- package/dist/profile/contact-state.js +1 -1
- package/dist/profile/profile-key.d.ts +2 -2
- package/dist/profile/profile-key.js +7 -6
- package/dist/profile/profile-key.js.map +1 -1
- package/dist/remote/object-store/index.d.ts +1 -1
- package/dist/remote/object-store/s3/storage.d.ts +1 -1
- package/dist/remote/object-store/types.d.ts +4 -4
- package/dist/remote/object-store/types.d.ts.map +1 -1
- package/dist/remote/relay/convex/backend.d.ts +4 -4
- package/dist/remote/relay/convex/backend.js +3 -3
- package/dist/remote/relay/convex/backend.js.map +1 -1
- package/dist/remote/relay/convex/component/accounts.d.ts +15 -13
- package/dist/remote/relay/convex/component/accounts.d.ts.map +1 -1
- package/dist/remote/relay/convex/component/accounts.js +31 -28
- package/dist/remote/relay/convex/component/accounts.js.map +1 -1
- package/dist/remote/relay/convex/component/certificates.js +1 -1
- package/dist/remote/relay/convex/component/cleanup.js +7 -7
- package/dist/remote/relay/convex/component/cleanup.js.map +1 -1
- package/dist/remote/relay/convex/component/convex.config.d.ts.map +1 -1
- package/dist/remote/relay/convex/component/convex.config.js +10 -8
- package/dist/remote/relay/convex/component/convex.config.js.map +1 -1
- package/dist/remote/relay/convex/component/devices.d.ts +21 -20
- package/dist/remote/relay/convex/component/devices.d.ts.map +1 -1
- package/dist/remote/relay/convex/component/devices.js +24 -23
- package/dist/remote/relay/convex/component/devices.js.map +1 -1
- package/dist/remote/relay/convex/component/groups.js +6 -6
- package/dist/remote/relay/convex/component/groups.js.map +1 -1
- package/dist/remote/relay/convex/component/messages.d.ts.map +1 -1
- package/dist/remote/relay/convex/component/messages.js +89 -82
- package/dist/remote/relay/convex/component/messages.js.map +1 -1
- package/dist/remote/relay/convex/component/provisioning.d.ts +3 -3
- package/dist/remote/relay/convex/component/provisioning.d.ts.map +1 -1
- package/dist/remote/relay/convex/component/provisioning.js +17 -16
- package/dist/remote/relay/convex/component/provisioning.js.map +1 -1
- package/dist/remote/relay/convex/component/runtime.d.ts.map +1 -1
- package/dist/remote/relay/convex/component/runtime.js +4 -2
- package/dist/remote/relay/convex/component/runtime.js.map +1 -1
- package/dist/remote/relay/convex/component/schema.js +25 -24
- package/dist/remote/relay/convex/component/schema.js.map +1 -1
- package/dist/remote/relay/convex/group-server.d.ts +3 -3
- package/dist/remote/relay/convex/group-server.js +3 -3
- package/dist/remote/relay/convex/relay.d.ts +3 -3
- package/dist/remote/relay/convex/relay.d.ts.map +1 -1
- package/dist/remote/relay/convex/relay.js +18 -17
- package/dist/remote/relay/convex/relay.js.map +1 -1
- package/dist/remote/relay/convex/types.d.ts +7 -7
- package/dist/remote/relay/convex/types.js +4 -4
- package/dist/remote/relay/memory/adapter.js +9 -9
- package/dist/remote/relay/memory/adapter.js.map +1 -1
- package/dist/remote/relay/types.d.ts +27 -27
- package/dist/remote/relay/types.d.ts.map +1 -1
- package/dist/safety/fingerprint.d.ts +7 -6
- package/dist/safety/fingerprint.d.ts.map +1 -1
- package/dist/safety/fingerprint.js +5 -4
- package/dist/safety/fingerprint.js.map +1 -1
- package/dist/safety/index.d.ts +6 -5
- package/dist/safety/index.d.ts.map +1 -1
- package/dist/safety/index.js +7 -6
- package/dist/safety/index.js.map +1 -1
- package/dist/safety/protobuf.js +2 -2
- package/dist/safety/protobuf.js.map +1 -1
- package/dist/safety/url.d.ts +5 -5
- package/dist/safety/url.js +6 -6
- package/dist/types/address.d.ts +2 -2
- package/dist/types/address.js +2 -2
- package/dist/types/api.d.ts +78 -73
- package/dist/types/api.d.ts.map +1 -1
- package/dist/types/errors.d.ts +63 -403
- package/dist/types/errors.d.ts.map +1 -1
- package/dist/types/errors.js +62 -537
- package/dist/types/errors.js.map +1 -1
- package/dist/types/messages.d.ts +16 -16
- package/dist/types/messages.d.ts.map +1 -1
- package/dist/types/messages.js +7 -7
- package/dist/types/messages.js.map +1 -1
- package/dist/types/protocol-config.d.ts +52 -49
- package/dist/types/protocol-config.d.ts.map +1 -1
- package/dist/types/protocol-config.js +36 -34
- package/dist/types/protocol-config.js.map +1 -1
- package/dist/types/protocol-constants.d.ts +2 -2
- package/dist/types/protocol-constants.js +2 -2
- package/dist/types/session.d.ts +62 -61
- package/dist/types/session.d.ts.map +1 -1
- package/dist/types/session.js +13 -14
- package/dist/types/session.js.map +1 -1
- package/dist/types/trust.d.ts +8 -8
- package/dist/types/trust.js +3 -3
- package/dist/utils/retry.d.ts.map +1 -1
- package/dist/utils/retry.js +2 -4
- package/dist/utils/retry.js.map +1 -1
- package/docs/ASSURANCE.md +82 -74
- package/docs/CLIENT_COMPOSITION.md +19 -15
- package/docs/DEVIATIONS.md +507 -425
- package/docs/DOCUMENTATION_STANDARDS.md +24 -24
- package/docs/E2EE.md +45 -42
- package/docs/ERROR_HANDLING.md +29 -105
- package/docs/GETTING_STARTED.md +24 -25
- package/docs/INTERFACES.md +27 -18
- package/docs/PACKAGE_SURFACE.md +23 -21
- package/docs/PROTOCOL_POLICY.md +19 -13
- package/docs/RECIPES.md +4 -4
- package/docs/SECURITY.md +72 -60
- package/encoding/README.md +2 -2
- package/files/README.md +1 -1
- package/groups/README.md +4 -3
- package/hooks/README.md +2 -2
- package/keys/README.md +15 -14
- package/local/store/README.md +82 -67
- package/local/store/expo/README.md +17 -12
- package/local/store/memory/README.md +4 -3
- package/local/store/node/README.md +8 -6
- package/local/store/react-native/README.md +14 -12
- package/local/store/web/README.md +31 -26
- package/local/vault/README.md +4 -4
- package/media/README.md +6 -5
- package/package.json +2 -2
- package/profile/README.md +7 -7
- package/remote/README.md +20 -18
- package/remote/object-store/README.md +8 -4
- package/remote/object-store/convex-r2/README.md +3 -3
- package/remote/object-store/s3/README.md +10 -5
- package/remote/relay/convex/README.md +5 -5
- package/remote/relay/convex/component/README.md +145 -124
- package/remote/relay/memory/README.md +6 -5
- package/safety/README.md +1 -1
- package/sealed-sender/README.md +3 -2
- package/types/README.md +1 -1
- package/utils/README.md +4 -4
package/dist/types/session.d.ts
CHANGED
|
@@ -11,9 +11,9 @@ import type { ResolvedSPQRLimits, SCKAMode } from './protocol-config.js';
|
|
|
11
11
|
/**
|
|
12
12
|
* Persisted record version for the composite-identity session profile.
|
|
13
13
|
*
|
|
14
|
-
* Version 4 is a deliberate pre-1.0 format break
|
|
15
|
-
* the ACI/PNI namespaces of both endpoint identity tuples
|
|
16
|
-
* never migrated or interpreted as version 4.
|
|
14
|
+
* Version 4 is a deliberate pre-1.0 format break. Version 3 records did not
|
|
15
|
+
* bind the ACI/PNI namespaces of both endpoint identity tuples. Such records
|
|
16
|
+
* must be reset, never migrated or interpreted as version 4.
|
|
17
17
|
*/
|
|
18
18
|
export declare const CURRENT_SESSION_RECORD_VERSION = 4;
|
|
19
19
|
/**
|
|
@@ -30,7 +30,7 @@ export interface StoredMessageKey {
|
|
|
30
30
|
/**
|
|
31
31
|
* 32-byte seed for key derivation (proto: seed, field 2).
|
|
32
32
|
*
|
|
33
|
-
*
|
|
33
|
+
* Callers derive the full message key (cipher_key, mac_key, iv) from the seed
|
|
34
34
|
* on demand. This is 3x more storage efficient than storing pre-computed keys.
|
|
35
35
|
*/
|
|
36
36
|
seed: Base64;
|
|
@@ -65,8 +65,8 @@ export interface ReceiverChain {
|
|
|
65
65
|
/**
|
|
66
66
|
* Skipped message keys (proto: message_keys, field 3).
|
|
67
67
|
*
|
|
68
|
-
*
|
|
69
|
-
* message arrives,
|
|
68
|
+
* This array holds keys for messages that arrive out of order. When the
|
|
69
|
+
* skipped message arrives, decryption consumes (removes) its key.
|
|
70
70
|
*/
|
|
71
71
|
messageKeys: StoredMessageKey[];
|
|
72
72
|
}
|
|
@@ -94,7 +94,7 @@ export interface SessionState {
|
|
|
94
94
|
* Session state identifier - initiator's ephemeral public key (EKA).
|
|
95
95
|
*
|
|
96
96
|
* The initiator's ephemeral public key is the unique identifier for this
|
|
97
|
-
* session state.
|
|
97
|
+
* session state. This field takes the name "baseKey" because:
|
|
98
98
|
* - "ephemeral" describes the key's LIFECYCLE (temporary, single-use)
|
|
99
99
|
* - "base" describes the key's ROLE (foundation for SK derivation in X3DH/PQXDH)
|
|
100
100
|
*
|
|
@@ -102,8 +102,8 @@ export interface SessionState {
|
|
|
102
102
|
* For responder (Bob): Set to senderEphemeralKey from PreKeyMessage
|
|
103
103
|
*
|
|
104
104
|
* CRITICAL: This is different from sessionId/ProtocolAddress lookup.
|
|
105
|
-
*
|
|
106
|
-
*
|
|
105
|
+
* A ProtocolAddress (userId:deviceId) LOOKS UP a session, but a baseKey
|
|
106
|
+
* (ephemeral public key) IDENTIFIES a session STATE.
|
|
107
107
|
*
|
|
108
108
|
*/
|
|
109
109
|
baseKey: Base64;
|
|
@@ -114,13 +114,13 @@ export interface SessionState {
|
|
|
114
114
|
/**
|
|
115
115
|
* Our registration ID (from our IdentityKeyPair).
|
|
116
116
|
*
|
|
117
|
-
* Generated once per app install.
|
|
117
|
+
* Generated once per app install. Detects a reinstall on our side.
|
|
118
118
|
*/
|
|
119
119
|
localRegistrationId: number;
|
|
120
120
|
/**
|
|
121
121
|
* Remote party's registration ID (from their PreKeyBundle).
|
|
122
122
|
*
|
|
123
|
-
* If this changes, they
|
|
123
|
+
* If this changes, they reinstalled their app and we should
|
|
124
124
|
* archive the old session and establish a new one.
|
|
125
125
|
*/
|
|
126
126
|
remoteRegistrationId: number;
|
|
@@ -161,7 +161,7 @@ export interface SessionState {
|
|
|
161
161
|
* to detect replay attacks. If a message arrives with an old DHr:
|
|
162
162
|
* - If in receiverChains: decrypt (out-of-order message)
|
|
163
163
|
* - If in processedChains but not receiverChains: replay attack (already processed)
|
|
164
|
-
* - If not in either: new chain (
|
|
164
|
+
* - If not in either: new chain (run the DH ratchet)
|
|
165
165
|
*
|
|
166
166
|
* Key: DHr (Base64 DH public key)
|
|
167
167
|
* Value: { lastNr: number, timestamp: number }
|
|
@@ -179,9 +179,9 @@ export interface SessionState {
|
|
|
179
179
|
/**
|
|
180
180
|
* Prekey IDs pending deletion after first successful decryption.
|
|
181
181
|
*
|
|
182
|
-
*
|
|
182
|
+
* The client deletes one-time prekeys after decryption succeeds, not after session
|
|
183
183
|
* establishment. This prevents
|
|
184
|
-
* irrecoverable failure if the inner message
|
|
184
|
+
* irrecoverable failure if the inner message arrives corrupted (the sender can
|
|
185
185
|
* retry with the same prekey).
|
|
186
186
|
*
|
|
187
187
|
* Set during performX3DHResponder() and cleared after the first successful
|
|
@@ -199,18 +199,18 @@ export interface SessionState {
|
|
|
199
199
|
/**
|
|
200
200
|
* Whether this session still needs to send PreKeyMessages.
|
|
201
201
|
*
|
|
202
|
-
* Set to true when the
|
|
203
|
-
* the first message
|
|
202
|
+
* Set to true when the client creates the session as initiator. Remains true
|
|
203
|
+
* until the first message arrives from the responder, which proves the
|
|
204
204
|
* responder successfully processed the PreKeyMessage.
|
|
205
205
|
*
|
|
206
|
-
*
|
|
206
|
+
* If the first PreKeyMessage is lost, subsequent messages
|
|
207
207
|
* are still sent as PreKeyMessages so the responder can establish the session.
|
|
208
208
|
*
|
|
209
209
|
* @default undefined (treated as false for responder sessions)
|
|
210
210
|
*/
|
|
211
211
|
unacknowledgedPreKeyMessage?: boolean;
|
|
212
212
|
/**
|
|
213
|
-
* Whether we
|
|
213
|
+
* Whether we received at least one message in this session.
|
|
214
214
|
*
|
|
215
215
|
* Unacknowledged PreKey sessions (where the initiator has not received a
|
|
216
216
|
* reply) expire after 30 days (MAX_UNACKNOWLEDGED_SESSION_AGE).
|
|
@@ -284,7 +284,7 @@ export interface KDFChain {
|
|
|
284
284
|
export interface SCKAState {
|
|
285
285
|
/** Current epoch number (increments with each DH ratchet) */
|
|
286
286
|
epoch: number;
|
|
287
|
-
/**
|
|
287
|
+
/** Which way messages flow ('A2B' = Alice to Bob, 'B2A' = Bob to Alice) */
|
|
288
288
|
direction: 'A2B' | 'B2A';
|
|
289
289
|
/** Our current Kyber private key (for receiving) */
|
|
290
290
|
ourKyberPrivateKey: Base64 | null;
|
|
@@ -353,13 +353,13 @@ export interface SPQRState {
|
|
|
353
353
|
* Signal Protocol Section 8.4:
|
|
354
354
|
* "A recommended policy is to delete message keys more than one week old"
|
|
355
355
|
*
|
|
356
|
-
* Note: Using Record for JSON serialization.
|
|
356
|
+
* Note: Using Record for JSON serialization. The map holds keys as strings
|
|
357
357
|
* in format "epoch:index" -> { key: Base64, timestamp: number }
|
|
358
358
|
*/
|
|
359
359
|
MKSKIPPED: Record<string, {
|
|
360
360
|
/** Message key */
|
|
361
361
|
key: Base64;
|
|
362
|
-
/** Timestamp when key
|
|
362
|
+
/** Timestamp of when this key entered the store (for expiration) */
|
|
363
363
|
timestamp: number;
|
|
364
364
|
}>;
|
|
365
365
|
/** Communication direction */
|
|
@@ -372,8 +372,8 @@ export interface SPQRState {
|
|
|
372
372
|
* - `'braid'` (default): specification-defined ML-KEM Braid profile
|
|
373
373
|
* - `'direct'`: Explicit direct ML-KEM-768 encapsulation mode
|
|
374
374
|
*
|
|
375
|
-
* Once set during session establishment, the mode
|
|
376
|
-
* lifetime of the session
|
|
375
|
+
* Once set during session establishment, the mode stays fixed for the
|
|
376
|
+
* lifetime of the session, which keeps the protocol consistent.
|
|
377
377
|
*
|
|
378
378
|
* @default 'braid'
|
|
379
379
|
*/
|
|
@@ -387,7 +387,7 @@ export interface SPQRState {
|
|
|
387
387
|
/**
|
|
388
388
|
* Pending outgoing Braid chunks.
|
|
389
389
|
*
|
|
390
|
-
* Only present when mode is `braid` and the state machine
|
|
390
|
+
* Only present when mode is `braid` and the state machine holds queued chunks
|
|
391
391
|
* for future message headers.
|
|
392
392
|
*/
|
|
393
393
|
pendingOutgoingChunks?: MLKEMBraidMessage[];
|
|
@@ -395,7 +395,7 @@ export interface SPQRState {
|
|
|
395
395
|
* Version negotiation state for this session.
|
|
396
396
|
*
|
|
397
397
|
* Tracks the negotiation process with the peer to agree on a protocol version.
|
|
398
|
-
* Once negotiation completes, the version
|
|
398
|
+
* Once negotiation completes, the version stays locked for the session lifetime.
|
|
399
399
|
*
|
|
400
400
|
* @see VersionNegotiationState
|
|
401
401
|
*/
|
|
@@ -415,7 +415,7 @@ export interface SPQRState {
|
|
|
415
415
|
* and during bootstrap. Cleared by spqrSend() after performing the
|
|
416
416
|
* encapsulation/keypair generation.
|
|
417
417
|
*
|
|
418
|
-
* `send()` decides whether to
|
|
418
|
+
* `send()` decides whether to run a KEM exchange from this state. Callers
|
|
419
419
|
* do not trigger the exchange separately.
|
|
420
420
|
*/
|
|
421
421
|
needsSendRatchet?: boolean;
|
|
@@ -424,14 +424,15 @@ export interface SPQRState {
|
|
|
424
424
|
* Triple Ratchet state (Signal Protocol Section 6).
|
|
425
425
|
*
|
|
426
426
|
* Signal Protocol Section 6:
|
|
427
|
-
* "The Triple Ratchet provides hybrid security by running two ratchets in parallel:
|
|
428
|
-
* 1. Elliptic Curve Double Ratchet (Section 3) - Classical security
|
|
429
|
-
* 2. Sparse Post-Quantum Ratchet (Section 5) - Post-quantum security
|
|
430
427
|
*
|
|
431
|
-
*
|
|
432
|
-
*
|
|
428
|
+
* > "The Triple Ratchet provides hybrid security by running two ratchets in parallel:
|
|
429
|
+
* > 1. Elliptic Curve Double Ratchet (Section 3) - Classical security
|
|
430
|
+
* > 2. Sparse Post-Quantum Ratchet (Section 5) - Post-quantum security
|
|
431
|
+
* >
|
|
432
|
+
* > Message keys are derived by combining both ratchets using KDF_HYBRID(),
|
|
433
|
+
* > ensuring security if EITHER ratchet remains secure."
|
|
433
434
|
*
|
|
434
|
-
* Security boundary: hybrid confidentiality
|
|
435
|
+
* Security boundary: hybrid confidentiality aims to survive failure of
|
|
435
436
|
* one contribution only if the other contribution and the surrounding
|
|
436
437
|
* authenticated protocol assumptions remain secure. Percentages and absolute
|
|
437
438
|
* "quantum safe" guarantees are deliberately not assigned here.
|
|
@@ -446,7 +447,7 @@ export interface TripleRatchetState {
|
|
|
446
447
|
/**
|
|
447
448
|
* SPQR state for post-quantum security.
|
|
448
449
|
*
|
|
449
|
-
* Note:
|
|
450
|
+
* Note: the main SessionState fields hold EC Double Ratchet state
|
|
450
451
|
* (DHs, DHr, RK, CKs, CKr, Ns, Nr, PN, receiverChains, etc.)
|
|
451
452
|
*
|
|
452
453
|
* This separation keeps the module boundary explicit:
|
|
@@ -457,12 +458,12 @@ export interface TripleRatchetState {
|
|
|
457
458
|
/**
|
|
458
459
|
* Flag indicating if Triple Ratchet is active.
|
|
459
460
|
*
|
|
460
|
-
* Set to true once PQXDH
|
|
461
|
-
* manager
|
|
461
|
+
* Set to true once PQXDH produced the SPQR root material and the
|
|
462
|
+
* manager initialized SPQR v1 state for the session.
|
|
462
463
|
*/
|
|
463
464
|
enabled: boolean;
|
|
464
465
|
/**
|
|
465
|
-
* Timestamp
|
|
466
|
+
* Timestamp of the moment Triple Ratchet became active.
|
|
466
467
|
*
|
|
467
468
|
* Used for metrics, debugging, and gradual rollout tracking.
|
|
468
469
|
*/
|
|
@@ -483,12 +484,13 @@ export interface SessionConfig {
|
|
|
483
484
|
* sessions for handling race conditions and out-of-order establishment.
|
|
484
485
|
*
|
|
485
486
|
* From Signal Protocol:
|
|
486
|
-
*
|
|
487
|
-
*
|
|
487
|
+
*
|
|
488
|
+
* > "A device might have multiple sessions for the same remote device.
|
|
489
|
+
* > The Sesame algorithm ensures convergence to a single active session."
|
|
488
490
|
*
|
|
489
491
|
* Session Lookup Architecture:
|
|
490
|
-
* 1.
|
|
491
|
-
* 2. Within a SessionRecord,
|
|
492
|
+
* 1. A ProtocolAddress (userId:deviceId) LOOKS UP a session
|
|
493
|
+
* 2. Within a SessionRecord, a baseKey IDENTIFIES a session state
|
|
492
494
|
* 3. The baseKey is the initiator's ephemeral public key from X3DH/PQXDH
|
|
493
495
|
*
|
|
494
496
|
* @see https://signal.org/docs/specifications/sesame/
|
|
@@ -498,14 +500,14 @@ export interface SessionRecord {
|
|
|
498
500
|
* Current active session state.
|
|
499
501
|
*
|
|
500
502
|
* This is the session used for encrypting new messages.
|
|
501
|
-
* May be null
|
|
503
|
+
* May be null when no session remains outside the archive (rare edge case).
|
|
502
504
|
*/
|
|
503
505
|
currentSession: SessionState | null;
|
|
504
506
|
/**
|
|
505
507
|
* Archived sessions indexed by baseKey for O(1) lookup.
|
|
506
508
|
*
|
|
507
|
-
*
|
|
508
|
-
*
|
|
509
|
+
* The initiator's ephemeral public key (`baseKey`) identifies a session
|
|
510
|
+
* state.
|
|
509
511
|
*
|
|
510
512
|
* Used for:
|
|
511
513
|
* - Handling race conditions during session establishment
|
|
@@ -515,14 +517,14 @@ export interface SessionRecord {
|
|
|
515
517
|
* Key: Base64-encoded baseKey (initiator's ephemeral public key)
|
|
516
518
|
* Value: SessionState
|
|
517
519
|
*
|
|
518
|
-
*
|
|
520
|
+
* baseKey keys session records for fast lookup and spec-aligned
|
|
519
521
|
* session recovery behavior.
|
|
520
522
|
*/
|
|
521
523
|
archivedSessions: Record<Base64, SessionState>;
|
|
522
524
|
/**
|
|
523
525
|
* Protocol version for this persisted session record shape.
|
|
524
526
|
*
|
|
525
|
-
* The current format is version 4.
|
|
527
|
+
* The current format is version 4. The store rejects older versions and forces
|
|
526
528
|
* session re-establishment instead of compatibility migration.
|
|
527
529
|
*/
|
|
528
530
|
version: typeof CURRENT_SESSION_RECORD_VERSION;
|
|
@@ -537,8 +539,8 @@ export interface SessionRecord {
|
|
|
537
539
|
* Metadata for a session record.
|
|
538
540
|
*
|
|
539
541
|
* Combines UI/management metadata with SESAME session lifecycle tracking.
|
|
540
|
-
* This
|
|
541
|
-
*
|
|
542
|
+
* This lets the SESAME layer use SessionRecord directly, without a separate
|
|
543
|
+
* SesameSessionRecord wrapper.
|
|
542
544
|
*
|
|
543
545
|
* @see https://signal.org/docs/specifications/sesame/
|
|
544
546
|
*/
|
|
@@ -549,12 +551,12 @@ export interface SessionRecordMetadata {
|
|
|
549
551
|
messagesSent?: number;
|
|
550
552
|
/** Total number of messages received in current session */
|
|
551
553
|
messagesReceived?: number;
|
|
552
|
-
/** Whether this session
|
|
554
|
+
/** Whether this session counts as active */
|
|
553
555
|
isActive?: boolean;
|
|
554
556
|
/** Human-readable label for debugging */
|
|
555
557
|
label?: string;
|
|
556
558
|
/**
|
|
557
|
-
* Timestamp
|
|
559
|
+
* Timestamp of the moment this session began (milliseconds since epoch).
|
|
558
560
|
* Used for session expiration calculations (MAXSEND, MAXRECV thresholds).
|
|
559
561
|
*
|
|
560
562
|
* @see SESAME spec Section 4.2 (Session expiration)
|
|
@@ -575,7 +577,7 @@ export interface SessionRecordMetadata {
|
|
|
575
577
|
*/
|
|
576
578
|
lastReceivedAt?: number | null;
|
|
577
579
|
/**
|
|
578
|
-
* Whether
|
|
580
|
+
* Whether we created this session (initiating) or they did (responding).
|
|
579
581
|
* Initiator sends PreKeyMessages until first response received.
|
|
580
582
|
*
|
|
581
583
|
* @see SESAME spec Section 2.2 (Session creation for senders/recipients)
|
|
@@ -593,8 +595,7 @@ export declare function assertCurrentSessionRecord(record: unknown): asserts rec
|
|
|
593
595
|
/**
|
|
594
596
|
* Helper functions for working with SessionRecords.
|
|
595
597
|
*
|
|
596
|
-
*
|
|
597
|
-
* key.
|
|
598
|
+
* `baseKey`, the initiator's ephemeral public key, identifies a session state.
|
|
598
599
|
*/
|
|
599
600
|
export declare namespace SessionRecord {
|
|
600
601
|
/**
|
|
@@ -614,8 +615,8 @@ export declare namespace SessionRecord {
|
|
|
614
615
|
/**
|
|
615
616
|
* Archive the current session and optionally set a new one.
|
|
616
617
|
*
|
|
617
|
-
* The current session
|
|
618
|
-
*
|
|
618
|
+
* The function moves the current session to archivedSessions, keyed by its
|
|
619
|
+
* baseKey. It trims old archived sessions if we exceed maxArchived.
|
|
619
620
|
*
|
|
620
621
|
* @param record - SessionRecord to modify
|
|
621
622
|
* @param newSession - Optional new session to set as current
|
|
@@ -633,8 +634,8 @@ export declare namespace SessionRecord {
|
|
|
633
634
|
/**
|
|
634
635
|
* Find a session by baseKey.
|
|
635
636
|
*
|
|
636
|
-
*
|
|
637
|
-
*
|
|
637
|
+
* The initiator's ephemeral public key (`baseKey`) identifies a session
|
|
638
|
+
* state.
|
|
638
639
|
*
|
|
639
640
|
* @param record - SessionRecord
|
|
640
641
|
* @param baseKey - Base64-encoded baseKey to find
|
|
@@ -656,7 +657,7 @@ export declare namespace SessionRecord {
|
|
|
656
657
|
*
|
|
657
658
|
* @param record - SessionRecord
|
|
658
659
|
* @param baseKey - Base64-encoded baseKey of session to promote
|
|
659
|
-
* @returns true if
|
|
660
|
+
* @returns true if the function found and promoted the session
|
|
660
661
|
*/
|
|
661
662
|
function promoteSession(record: SessionRecord, baseKey: Base64): boolean;
|
|
662
663
|
/**
|
|
@@ -672,11 +673,11 @@ export declare namespace SessionRecord {
|
|
|
672
673
|
* A session is usable for sending if:
|
|
673
674
|
* 1. It has a current session
|
|
674
675
|
* 2. The current session has sending chain keys (CKs)
|
|
675
|
-
* 3. The session
|
|
676
|
+
* 3. The session has not expired for sending (per SESAME MAXSEND threshold)
|
|
676
677
|
*
|
|
677
678
|
* @param record - SessionRecord to check
|
|
678
679
|
* @param now - Current time (default: Date.now())
|
|
679
|
-
* @returns true if
|
|
680
|
+
* @returns true if the record can send with this session
|
|
680
681
|
*
|
|
681
682
|
*/
|
|
682
683
|
function hasUsableSenderChain(record: SessionRecord, now?: number): boolean;
|
|
@@ -685,7 +686,7 @@ export declare namespace SessionRecord {
|
|
|
685
686
|
*
|
|
686
687
|
* - Move the current session to archived (if it exists)
|
|
687
688
|
* - Clear the current session slot
|
|
688
|
-
* -
|
|
689
|
+
* - A separate step sets the new session from PreKeyMessage
|
|
689
690
|
*
|
|
690
691
|
* Called when:
|
|
691
692
|
* - Receiving a PreKeyMessage from a device we already have a session with
|
|
@@ -713,7 +714,7 @@ export declare namespace SessionRecord {
|
|
|
713
714
|
*
|
|
714
715
|
* @param buffer - Serialized bytes
|
|
715
716
|
* @returns Deserialized SessionRecord
|
|
716
|
-
* @throws Error if buffer
|
|
717
|
+
* @throws Error if the buffer does not parse
|
|
717
718
|
*
|
|
718
719
|
*/
|
|
719
720
|
function deserialize(buffer: Uint8Array): SessionRecord;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../types/session.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EACV,mBAAmB,EACnB,eAAe,EACf,YAAY,EACZ,SAAS,EACT,UAAU,EACX,MAAM,SAAS,CAAC;AAMjB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAGtC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAC5E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,KAAK,EACV,oBAAoB,EACpB,iBAAiB,EAClB,MAAM,8CAA8C,CAAC;AACtD,OAAO,KAAK,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAMtE;;;;;;GAMG;AACH,eAAO,MAAM,8BAA8B,IAAI,CAAC;AAMhD;;;;;;GAMG;AACH,OAAO,EAAE,CAAC;AACV,MAAM,WAAW,gBAAgB;IAC/B,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IAEd;;;;;OAKG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;;;OAKG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,gBAAgB,EAAE,MAAM,CAAC;IAEzB;;;;OAIG;IACH,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB;;;;;OAKG;IACH,WAAW,EAAE,gBAAgB,EAAE,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;;;;;;;;;;;OAeG;IACH,OAAO,EAAE,MAAM,CAAC;IAGhB,YAAY,EAAE,eAAe,CAAC;IAC9B,aAAa,EAAE,eAAe,CAAC;IAG/B,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IAGvB;;;;OAIG;IACH,mBAAmB,EAAE,MAAM,CAAC;IAE5B;;;;;OAKG;IACH,oBAAoB,EAAE,MAAM,CAAC;IAG7B,GAAG,EAAE;QAAE,SAAS,EAAE,SAAS,CAAC;QAAC,UAAU,EAAE,UAAU,CAAA;KAAE,GAAG,IAAI,CAAC;IAC7D,GAAG,EAAE,SAAS,GAAG,SAAS,CAAC;IAG3B,EAAE,EAAE,MAAM,CAAC;
|
|
1
|
+
{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../types/session.ts"],"names":[],"mappings":"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"}
|
package/dist/types/session.js
CHANGED
|
@@ -11,9 +11,9 @@ import { DEFAULT_SESAME_CONFIG } from '../internal/sesame/types.js';
|
|
|
11
11
|
/**
|
|
12
12
|
* Persisted record version for the composite-identity session profile.
|
|
13
13
|
*
|
|
14
|
-
* Version 4 is a deliberate pre-1.0 format break
|
|
15
|
-
* the ACI/PNI namespaces of both endpoint identity tuples
|
|
16
|
-
* never migrated or interpreted as version 4.
|
|
14
|
+
* Version 4 is a deliberate pre-1.0 format break. Version 3 records did not
|
|
15
|
+
* bind the ACI/PNI namespaces of both endpoint identity tuples. Such records
|
|
16
|
+
* must be reset, never migrated or interpreted as version 4.
|
|
17
17
|
*/
|
|
18
18
|
export const CURRENT_SESSION_RECORD_VERSION = 4;
|
|
19
19
|
// ============================================================================
|
|
@@ -102,8 +102,7 @@ export function assertCurrentSessionRecord(record) {
|
|
|
102
102
|
/**
|
|
103
103
|
* Helper functions for working with SessionRecords.
|
|
104
104
|
*
|
|
105
|
-
*
|
|
106
|
-
* key.
|
|
105
|
+
* `baseKey`, the initiator's ephemeral public key, identifies a session state.
|
|
107
106
|
*/
|
|
108
107
|
export var SessionRecord;
|
|
109
108
|
(function (SessionRecord) {
|
|
@@ -131,8 +130,8 @@ export var SessionRecord;
|
|
|
131
130
|
/**
|
|
132
131
|
* Archive the current session and optionally set a new one.
|
|
133
132
|
*
|
|
134
|
-
* The current session
|
|
135
|
-
*
|
|
133
|
+
* The function moves the current session to archivedSessions, keyed by its
|
|
134
|
+
* baseKey. It trims old archived sessions if we exceed maxArchived.
|
|
136
135
|
*
|
|
137
136
|
* @param record - SessionRecord to modify
|
|
138
137
|
* @param newSession - Optional new session to set as current
|
|
@@ -183,8 +182,8 @@ export var SessionRecord;
|
|
|
183
182
|
/**
|
|
184
183
|
* Find a session by baseKey.
|
|
185
184
|
*
|
|
186
|
-
*
|
|
187
|
-
*
|
|
185
|
+
* The initiator's ephemeral public key (`baseKey`) identifies a session
|
|
186
|
+
* state.
|
|
188
187
|
*
|
|
189
188
|
* @param record - SessionRecord
|
|
190
189
|
* @param baseKey - Base64-encoded baseKey to find
|
|
@@ -217,7 +216,7 @@ export var SessionRecord;
|
|
|
217
216
|
*
|
|
218
217
|
* @param record - SessionRecord
|
|
219
218
|
* @param baseKey - Base64-encoded baseKey of session to promote
|
|
220
|
-
* @returns true if
|
|
219
|
+
* @returns true if the function found and promoted the session
|
|
221
220
|
*/
|
|
222
221
|
function promoteSession(record, baseKey) {
|
|
223
222
|
const sessionToPromote = record.archivedSessions[baseKey];
|
|
@@ -254,11 +253,11 @@ export var SessionRecord;
|
|
|
254
253
|
* A session is usable for sending if:
|
|
255
254
|
* 1. It has a current session
|
|
256
255
|
* 2. The current session has sending chain keys (CKs)
|
|
257
|
-
* 3. The session
|
|
256
|
+
* 3. The session has not expired for sending (per SESAME MAXSEND threshold)
|
|
258
257
|
*
|
|
259
258
|
* @param record - SessionRecord to check
|
|
260
259
|
* @param now - Current time (default: Date.now())
|
|
261
|
-
* @returns true if
|
|
260
|
+
* @returns true if the record can send with this session
|
|
262
261
|
*
|
|
263
262
|
*/
|
|
264
263
|
function hasUsableSenderChain(record, now = Date.now()) {
|
|
@@ -285,7 +284,7 @@ export var SessionRecord;
|
|
|
285
284
|
*
|
|
286
285
|
* - Move the current session to archived (if it exists)
|
|
287
286
|
* - Clear the current session slot
|
|
288
|
-
* -
|
|
287
|
+
* - A separate step sets the new session from PreKeyMessage
|
|
289
288
|
*
|
|
290
289
|
* Called when:
|
|
291
290
|
* - Receiving a PreKeyMessage from a device we already have a session with
|
|
@@ -320,7 +319,7 @@ export var SessionRecord;
|
|
|
320
319
|
*
|
|
321
320
|
* @param buffer - Serialized bytes
|
|
322
321
|
* @returns Deserialized SessionRecord
|
|
323
|
-
* @throws Error if buffer
|
|
322
|
+
* @throws Error if the buffer does not parse
|
|
324
323
|
*
|
|
325
324
|
*/
|
|
326
325
|
function deserialize(buffer) {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"session.js","sourceRoot":"","sources":["../../types/session.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAQ5C,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AASjE,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAE/E;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC;
|
|
1
|
+
{"version":3,"file":"session.js","sourceRoot":"","sources":["../../types/session.ts"],"names":[],"mappings":"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"}
|
package/dist/types/trust.d.ts
CHANGED
|
@@ -11,18 +11,18 @@
|
|
|
11
11
|
* @see Signal Protocol Specification - Section 3.3: Identity Key Management
|
|
12
12
|
*/
|
|
13
13
|
/**
|
|
14
|
-
*
|
|
14
|
+
* Which way a message flows, for trust verification context.
|
|
15
15
|
*
|
|
16
|
-
* Trust verification behavior differs
|
|
17
|
-
*
|
|
16
|
+
* Trust verification behavior differs when you send a message and when you
|
|
17
|
+
* receive one:
|
|
18
18
|
*
|
|
19
|
-
* - SENDING: Stricter verification.
|
|
19
|
+
* - SENDING: Stricter verification. Do not send to untrusted identities.
|
|
20
20
|
* Prevent accidentally leaking information to attackers.
|
|
21
21
|
*
|
|
22
22
|
* - RECEIVING: More permissive. Allow receiving from changed identities
|
|
23
23
|
* but warn the user. Maintains communication while alerting to risks.
|
|
24
24
|
*
|
|
25
|
-
* Receiving and sending can use different product policies
|
|
25
|
+
* Receiving and sending can use different product policies. Sending to an
|
|
26
26
|
* untrusted identity risks disclosure, while receiving can surface the change
|
|
27
27
|
* without releasing new plaintext to that identity.
|
|
28
28
|
*
|
|
@@ -53,16 +53,16 @@
|
|
|
53
53
|
export {};
|
|
54
54
|
export declare enum TrustDirection {
|
|
55
55
|
/**
|
|
56
|
-
*
|
|
56
|
+
* The client sends the message to the remote party.
|
|
57
57
|
*
|
|
58
58
|
* Use stricter verification:
|
|
59
59
|
* - Require explicit user trust for new identities
|
|
60
|
-
* - Block sending if identity key
|
|
60
|
+
* - Block sending if the identity key changed without user confirmation
|
|
61
61
|
* - Prevent information leakage to potential attackers
|
|
62
62
|
*/
|
|
63
63
|
SENDING = "sending",
|
|
64
64
|
/**
|
|
65
|
-
*
|
|
65
|
+
* The client receives the message from the remote party.
|
|
66
66
|
*
|
|
67
67
|
* Use more permissive verification:
|
|
68
68
|
* - Allow receiving from new identities (TOFU)
|
package/dist/types/trust.js
CHANGED
|
@@ -13,16 +13,16 @@
|
|
|
13
13
|
export var TrustDirection;
|
|
14
14
|
(function (TrustDirection) {
|
|
15
15
|
/**
|
|
16
|
-
*
|
|
16
|
+
* The client sends the message to the remote party.
|
|
17
17
|
*
|
|
18
18
|
* Use stricter verification:
|
|
19
19
|
* - Require explicit user trust for new identities
|
|
20
|
-
* - Block sending if identity key
|
|
20
|
+
* - Block sending if the identity key changed without user confirmation
|
|
21
21
|
* - Prevent information leakage to potential attackers
|
|
22
22
|
*/
|
|
23
23
|
TrustDirection["SENDING"] = "sending";
|
|
24
24
|
/**
|
|
25
|
-
*
|
|
25
|
+
* The client receives the message from the remote party.
|
|
26
26
|
*
|
|
27
27
|
* Use more permissive verification:
|
|
28
28
|
* - Allow receiving from new identities (TOFU)
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../utils/retry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;;GAIG;AACH,OAAO,EAAE,CAAC;AACV,MAAM,WAAW,yBAAyB;IACxC,qFAAqF;IACrF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;
|
|
1
|
+
{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../utils/retry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;;GAIG;AACH,OAAO,EAAE,CAAC;AACV,MAAM,WAAW,yBAAyB;IACxC,qFAAqF;IACrF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAsFD;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAyBtD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,MAAM,GAAE,yBAA8B,GACrC,OAAO,CAAC,CAAC,CAAC,CAoCZ"}
|
package/dist/utils/retry.js
CHANGED
|
@@ -20,8 +20,8 @@ const SIGNAL_RETRY_CONFIG = {
|
|
|
20
20
|
*
|
|
21
21
|
* The second group are session-establishment failures. They reach this
|
|
22
22
|
* classifier because a failed device now surfaces its error from inside the
|
|
23
|
-
* retry callback
|
|
24
|
-
*
|
|
23
|
+
* retry callback. A code that is permanent for the life of the request must be
|
|
24
|
+
* listed here, or it is attempted three times for no benefit:
|
|
25
25
|
*
|
|
26
26
|
* - UNTRUSTED_IDENTITY and SIGNATURE_VERIFICATION_FAILED are security events.
|
|
27
27
|
* They want a safety-number check, not another attempt, and retrying only
|
|
@@ -33,10 +33,8 @@ const SIGNAL_RETRY_CONFIG = {
|
|
|
33
33
|
*/
|
|
34
34
|
const NON_RETRYABLE_ERROR_CODES = new Set([
|
|
35
35
|
EncryptionErrorCode.INVALID_PREKEY_BUNDLE,
|
|
36
|
-
EncryptionErrorCode.SESSION_CONFLICT,
|
|
37
36
|
EncryptionErrorCode.ENCRYPTION_FAILED,
|
|
38
37
|
EncryptionErrorCode.TOO_MANY_SKIPPED_MESSAGES,
|
|
39
|
-
EncryptionErrorCode.IDENTITY_KEY_CHANGED,
|
|
40
38
|
EncryptionErrorCode.KEY_STORAGE_ERROR,
|
|
41
39
|
EncryptionErrorCode.UNTRUSTED_IDENTITY,
|
|
42
40
|
EncryptionErrorCode.SIGNATURE_VERIFICATION_FAILED,
|
package/dist/utils/retry.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../utils/retry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAqB/C,MAAM,mBAAmB,GAAG;IAC1B,UAAU,EAAE,CAAC;IACb,SAAS,EAAE,IAAI;IACf,QAAQ,EAAE,KAAK;IACf,iBAAiB,EAAE,CAAC;IACpB,YAAY,EAAE,IAAI;CACnB,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,yBAAyB,GAAG,IAAI,GAAG,CAAC;IACxC,mBAAmB,CAAC,qBAAqB;IACzC,mBAAmB,CAAC,
|
|
1
|
+
{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../utils/retry.ts"],"names":[],"mappings":"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"}
|