@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
|
@@ -59,7 +59,7 @@ export interface DecryptedEnvelope {
|
|
|
59
59
|
timestamp: number;
|
|
60
60
|
/** Relay server timestamp when available */
|
|
61
61
|
serverTimestamp?: number;
|
|
62
|
-
/** When the
|
|
62
|
+
/** When the device received the message locally */
|
|
63
63
|
receivedAt: number;
|
|
64
64
|
/** Whether this is a group message */
|
|
65
65
|
isGroup: boolean;
|
|
@@ -67,7 +67,7 @@ export interface DecryptedEnvelope {
|
|
|
67
67
|
messageType?: string;
|
|
68
68
|
}
|
|
69
69
|
/**
|
|
70
|
-
* Event hooks that
|
|
70
|
+
* Event hooks that SignalProtocolClient accepts
|
|
71
71
|
*
|
|
72
72
|
* All hooks are optional and support both sync and async implementations.
|
|
73
73
|
*/
|
|
@@ -90,9 +90,9 @@ export interface SignalProtocolClientHooks {
|
|
|
90
90
|
*/
|
|
91
91
|
onSessionEstablished?: (sessionId: string, remoteAddress: string) => void | Promise<void>;
|
|
92
92
|
/**
|
|
93
|
-
*
|
|
93
|
+
* Runs after the client deletes a session
|
|
94
94
|
*
|
|
95
|
-
* @param sessionId - The
|
|
95
|
+
* @param sessionId - The identifier of the deleted session
|
|
96
96
|
*
|
|
97
97
|
* @example
|
|
98
98
|
* ```typescript
|
|
@@ -106,13 +106,13 @@ export interface SignalProtocolClientHooks {
|
|
|
106
106
|
*/
|
|
107
107
|
onSessionDeleted?: (sessionId: string) => void | Promise<void>;
|
|
108
108
|
/**
|
|
109
|
-
*
|
|
109
|
+
* Runs after the client archives a session (moved to inactive list)
|
|
110
110
|
*
|
|
111
111
|
* Stale-device recovery archives the session so delayed messages can still
|
|
112
112
|
* attempt decryption.
|
|
113
113
|
* Per SESAME §3.2: "previously active session is moved to the head of the inactive sessions list"
|
|
114
114
|
*
|
|
115
|
-
* @param sessionId - The
|
|
115
|
+
* @param sessionId - The identifier of the archived session
|
|
116
116
|
*
|
|
117
117
|
* @example
|
|
118
118
|
* ```typescript
|
|
@@ -125,7 +125,7 @@ export interface SignalProtocolClientHooks {
|
|
|
125
125
|
/**
|
|
126
126
|
* Called after a key rotation completes successfully
|
|
127
127
|
*
|
|
128
|
-
* @param keyType - Type of
|
|
128
|
+
* @param keyType - Type of the rotated key
|
|
129
129
|
*
|
|
130
130
|
* @example
|
|
131
131
|
* ```typescript
|
|
@@ -244,13 +244,13 @@ export interface SignalProtocolClientHooks {
|
|
|
244
244
|
*/
|
|
245
245
|
onKeysCleanedUp?: (sessionId: string, removedCount: number) => void | Promise<void>;
|
|
246
246
|
/**
|
|
247
|
-
*
|
|
247
|
+
* Runs when the client receives a delivery receipt
|
|
248
248
|
*
|
|
249
249
|
* Allows the app to update message status from 'sent' to 'delivered'.
|
|
250
250
|
* The timestamps array contains server timestamps of delivered messages.
|
|
251
251
|
*
|
|
252
252
|
* @param senderId - The user who sent the delivery receipt (message recipient)
|
|
253
|
-
* @param timestamps - Array of message timestamps
|
|
253
|
+
* @param timestamps - Array of message timestamps for the delivered messages
|
|
254
254
|
*
|
|
255
255
|
* @example
|
|
256
256
|
* ```typescript
|
|
@@ -263,13 +263,13 @@ export interface SignalProtocolClientHooks {
|
|
|
263
263
|
*/
|
|
264
264
|
onDeliveryReceiptReceived?: (senderId: string, timestamps: number[]) => void | Promise<void>;
|
|
265
265
|
/**
|
|
266
|
-
*
|
|
266
|
+
* Runs when the client receives a read receipt
|
|
267
267
|
*
|
|
268
268
|
* Allows the app to update message status from 'delivered' to 'read'.
|
|
269
269
|
* The timestamps array contains server timestamps of read messages.
|
|
270
270
|
*
|
|
271
271
|
* @param senderId - The user who sent the read receipt (message recipient who viewed messages)
|
|
272
|
-
* @param timestamps - Array of message timestamps
|
|
272
|
+
* @param timestamps - Array of message timestamps for the read messages
|
|
273
273
|
*
|
|
274
274
|
* @example
|
|
275
275
|
* ```typescript
|
|
@@ -282,13 +282,13 @@ export interface SignalProtocolClientHooks {
|
|
|
282
282
|
*/
|
|
283
283
|
onReadReceiptReceived?: (senderId: string, timestamps: number[]) => void | Promise<void>;
|
|
284
284
|
/**
|
|
285
|
-
*
|
|
285
|
+
* Runs when the client receives a viewed receipt (e.g., view-once media)
|
|
286
286
|
*
|
|
287
287
|
* Allows the app to update message status to 'viewed'.
|
|
288
288
|
* The timestamps array contains server timestamps of viewed messages.
|
|
289
289
|
*
|
|
290
290
|
* @param senderId - The user who sent the viewed receipt (message recipient who viewed media)
|
|
291
|
-
* @param timestamps - Array of message timestamps
|
|
291
|
+
* @param timestamps - Array of message timestamps for the viewed messages
|
|
292
292
|
*
|
|
293
293
|
* @example
|
|
294
294
|
* ```typescript
|
|
@@ -301,13 +301,13 @@ export interface SignalProtocolClientHooks {
|
|
|
301
301
|
*/
|
|
302
302
|
onViewedReceiptReceived?: (senderId: string, timestamps: number[]) => void | Promise<void>;
|
|
303
303
|
/**
|
|
304
|
-
*
|
|
304
|
+
* Runs when the client receives a typing indicator
|
|
305
305
|
*
|
|
306
|
-
* Allows the app to update UI
|
|
306
|
+
* Allows the app to update UI with the users who type.
|
|
307
307
|
* Typing indicators are transient - they auto-expire after 15 seconds.
|
|
308
308
|
*
|
|
309
309
|
* @param senderId - The user who sent the typing indicator
|
|
310
|
-
* @param conversationId - The conversation
|
|
310
|
+
* @param conversationId - The conversation the typing indicator belongs to
|
|
311
311
|
* @param action - Whether user STARTED or STOPPED typing
|
|
312
312
|
*
|
|
313
313
|
* @example
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"event-hooks.d.ts","sourceRoot":"","sources":["../../client/event-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH;;;;;GAKG;AACH,OAAO,EAAE,CAAC;AACV,MAAM,WAAW,iBAAiB;IAChC,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,SAAS,EAAE,MAAM,CAAC;IAClB,uBAAuB;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,gEAAgE;IAChE,cAAc,EAAE,MAAM,CAAC;IACvB,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,
|
|
1
|
+
{"version":3,"file":"event-hooks.d.ts","sourceRoot":"","sources":["../../client/event-hooks.ts"],"names":[],"mappings":"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"}
|
|
@@ -52,7 +52,7 @@ export async function callHook(hooks, hookName, ...args) {
|
|
|
52
52
|
await Promise.resolve(Reflect.apply(hook, undefined, args));
|
|
53
53
|
}
|
|
54
54
|
catch (error) {
|
|
55
|
-
// Log hook error but
|
|
55
|
+
// Log hook error but do not let it break core functionality
|
|
56
56
|
console.error(`Hook ${hookName} failed:`, error);
|
|
57
57
|
}
|
|
58
58
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"event-hooks.js","sourceRoot":"","sources":["../../client/event-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAyTH;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,KAA4C,EAC5C,QAAW,EACX,GAAG,IAA2D;IAE9D,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC/B,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAA8C,CAAC;QAC1E,MAAM,OAAO,CAAC,OAAO,CACnB,OAAO,CAAC,KAAK,CAAC,IAA2C,EAAE,SAAS,EAAE,IAAiB,CAAC,CACzF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,
|
|
1
|
+
{"version":3,"file":"event-hooks.js","sourceRoot":"","sources":["../../client/event-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAyTH;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,KAA4C,EAC5C,QAAW,EACX,GAAG,IAA2D;IAE9D,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC/B,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAA8C,CAAC;QAC1E,MAAM,OAAO,CAAC,OAAO,CACnB,OAAO,CAAC,KAAK,CAAC,IAA2C,EAAE,SAAS,EAAE,IAAiB,CAAC,CACzF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,4DAA4D;QAC5D,OAAO,CAAC,KAAK,CAAC,QAAQ,QAAQ,UAAU,EAAE,KAAK,CAAC,CAAC;IACnD,CAAC;AACH,CAAC"}
|
package/dist/client/files.js
CHANGED
|
@@ -96,10 +96,10 @@ export async function decryptFile(ctx, remoteAddress, encryptedBlob, encryptedKe
|
|
|
96
96
|
}
|
|
97
97
|
// Decrypt file with AES-GCM
|
|
98
98
|
const fileBytes = await CryptoUtils.aesGcmDecrypt(fileKey, asBase64(encrypted.ciphertext), asBase64(encrypted.iv), asBase64(encrypted.authTag));
|
|
99
|
-
// Convert Uint8Array to Blob with correct MIME type from encrypted metadata
|
|
100
|
-
// Use ArrayBuffer slice to satisfy TypeScript's strict BlobPart types
|
|
101
|
-
// (Uint8Array.buffer may be larger than the view, so we slice to exact bounds)
|
|
102
|
-
// Cast needed because .slice() returns ArrayBufferLike which includes SharedArrayBuffer
|
|
99
|
+
// Convert Uint8Array to Blob with correct MIME type from encrypted metadata.
|
|
100
|
+
// Use ArrayBuffer slice to satisfy TypeScript's strict BlobPart types.
|
|
101
|
+
// (Uint8Array.buffer may be larger than the view, so we slice to exact bounds).
|
|
102
|
+
// Cast needed because .slice() returns ArrayBufferLike, which includes SharedArrayBuffer.
|
|
103
103
|
const finalMimeType = keyMetadata.mimeType || 'application/octet-stream';
|
|
104
104
|
const arrayBuffer = fileBytes.buffer.slice(fileBytes.byteOffset, fileBytes.byteOffset + fileBytes.byteLength);
|
|
105
105
|
return new Blob([arrayBuffer], { type: finalMimeType });
|
package/dist/client/files.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"files.js","sourceRoot":"","sources":["../../client/files.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"files.js","sourceRoot":"","sources":["../../client/files.ts"],"names":[],"mappings":"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"}
|
|
@@ -33,11 +33,11 @@ import { type PreKeyMaintenanceStore } from './config.js';
|
|
|
33
33
|
*/
|
|
34
34
|
export {};
|
|
35
35
|
export interface HeadlessRotationResult {
|
|
36
|
-
/** Whether signed prekey
|
|
36
|
+
/** Whether the call rotated the signed prekey */
|
|
37
37
|
signedRotated: boolean;
|
|
38
|
-
/** Whether Kyber prekey
|
|
38
|
+
/** Whether the call rotated the Kyber prekey */
|
|
39
39
|
kyberRotated: boolean;
|
|
40
|
-
/** Whether one-time prekeys
|
|
40
|
+
/** Whether the call replenished the one-time prekeys */
|
|
41
41
|
oneTimeReplenished: boolean;
|
|
42
42
|
/** Any errors that occurred (non-fatal) */
|
|
43
43
|
errors: string[];
|
|
@@ -61,13 +61,13 @@ export interface HeadlessRotationOptions {
|
|
|
61
61
|
* Per PQXDH spec Section 3.2, rotates BOTH signed and Kyber prekeys
|
|
62
62
|
* together to maintain synchronized post-quantum forward secrecy.
|
|
63
63
|
*
|
|
64
|
-
* This function
|
|
65
|
-
* context
|
|
64
|
+
* This function suits background tasks that have no React
|
|
65
|
+
* context. It uses the same core rotation logic
|
|
66
66
|
* as SignalProtocolClient but works with any ISignalProtocolRelayServer implementation.
|
|
67
67
|
*
|
|
68
68
|
* Features:
|
|
69
69
|
* - Works with ConvexSignalProtocolRelayServer or any ISignalProtocolRelayServer implementation
|
|
70
|
-
* - Checks
|
|
70
|
+
* - Checks whether the keys need rotation before it rotates them
|
|
71
71
|
* - Handles errors gracefully (returns partial success)
|
|
72
72
|
* - Logs all operations for debugging
|
|
73
73
|
*
|
|
@@ -83,7 +83,7 @@ export declare function rotateKeysHeadless(relay: ISignalProtocolRelayServer, us
|
|
|
83
83
|
/**
|
|
84
84
|
* Check if any keys need rotation
|
|
85
85
|
*
|
|
86
|
-
* Lightweight check that
|
|
86
|
+
* Lightweight check that does not rotate anything.
|
|
87
87
|
* Useful for deciding whether to run the full rotation.
|
|
88
88
|
*
|
|
89
89
|
* @param relay - Signal Protocol relay server interface
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"headless.d.ts","sourceRoot":"","sources":["../../client/headless.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAA+B,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AAEtE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAC1D,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AACxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAqC,KAAK,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAQ1F;;GAEG;AACH,OAAO,EAAE,CAAC;AACV,MAAM,WAAW,sBAAsB;IACrC,
|
|
1
|
+
{"version":3,"file":"headless.d.ts","sourceRoot":"","sources":["../../client/headless.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAA+B,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AAEtE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAC1D,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AACxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAqC,KAAK,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAQ1F;;GAEG;AACH,OAAO,EAAE,CAAC;AACV,MAAM,WAAW,sBAAsB;IACrC,iDAAiD;IACjD,aAAa,EAAE,OAAO,CAAC;IACvB,gDAAgD;IAChD,YAAY,EAAE,OAAO,CAAC;IACtB,wDAAwD;IACxD,kBAAkB,EAAE,OAAO,CAAC;IAC5B,2CAA2C;IAC3C,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,0DAA0D;IAC1D,OAAO,CAAC,EAAE,yBAAyB,CAAC;IACpC,4DAA4D;IAC5D,aAAa,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;IACxC,sDAAsD;IACtD,iBAAiB,CAAC,EAAE,sBAAsB,CAAC;IAC3C,yDAAyD;IACzD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,0BAA0B,EACjC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,uBAAuB,GAChC,OAAO,CAAC,sBAAsB,CAAC,CAiHjC;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,0BAA0B,EACjC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IACT,kBAAkB,EAAE,OAAO,CAAC;IAC5B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,oBAAoB,EAAE,OAAO,CAAC;CAC/B,CAAC,CAgBD"}
|
package/dist/client/headless.js
CHANGED
|
@@ -33,13 +33,13 @@ import { rotateEcSignedPreKeyCore, rotateKyberPreKeyCore, replenishOneTimePreKey
|
|
|
33
33
|
* Per PQXDH spec Section 3.2, rotates BOTH signed and Kyber prekeys
|
|
34
34
|
* together to maintain synchronized post-quantum forward secrecy.
|
|
35
35
|
*
|
|
36
|
-
* This function
|
|
37
|
-
* context
|
|
36
|
+
* This function suits background tasks that have no React
|
|
37
|
+
* context. It uses the same core rotation logic
|
|
38
38
|
* as SignalProtocolClient but works with any ISignalProtocolRelayServer implementation.
|
|
39
39
|
*
|
|
40
40
|
* Features:
|
|
41
41
|
* - Works with ConvexSignalProtocolRelayServer or any ISignalProtocolRelayServer implementation
|
|
42
|
-
* - Checks
|
|
42
|
+
* - Checks whether the keys need rotation before it rotates them
|
|
43
43
|
* - Handles errors gracefully (returns partial success)
|
|
44
44
|
* - Logs all operations for debugging
|
|
45
45
|
*
|
|
@@ -137,7 +137,7 @@ export async function rotateKeysHeadless(relay, userId, deviceId, options) {
|
|
|
137
137
|
/**
|
|
138
138
|
* Check if any keys need rotation
|
|
139
139
|
*
|
|
140
|
-
* Lightweight check that
|
|
140
|
+
* Lightweight check that does not rotate anything.
|
|
141
141
|
* Useful for deciding whether to run the full rotation.
|
|
142
142
|
*
|
|
143
143
|
* @param relay - Signal Protocol relay server interface
|
|
@@ -18,7 +18,7 @@
|
|
|
18
18
|
* - Network requests completing out of order
|
|
19
19
|
*
|
|
20
20
|
* The lock wraps the entire check → generate → upload → store sequence
|
|
21
|
-
* to
|
|
21
|
+
* to make key rotation atomic.
|
|
22
22
|
*
|
|
23
23
|
* ## Transactional Pattern
|
|
24
24
|
*
|
|
@@ -28,8 +28,8 @@
|
|
|
28
28
|
* 3. Upload to server (may fail - local state unchanged)
|
|
29
29
|
* 4. Store locally only after successful upload
|
|
30
30
|
*
|
|
31
|
-
* This
|
|
32
|
-
*
|
|
31
|
+
* This keeps client and server in sync. If upload fails, local state does not
|
|
32
|
+
* change, and the caller can safely retry rotation.
|
|
33
33
|
*/
|
|
34
34
|
import { type ILogger } from '../logger.js';
|
|
35
35
|
import type { ISignalProtocolLocalStore } from '../types/index.js';
|
|
@@ -42,34 +42,35 @@ import { type PreKeyMaintenanceStore } from './config.js';
|
|
|
42
42
|
* Prevents concurrent callers from both generating and uploading different keys,
|
|
43
43
|
* which would result in one upload overwriting the other.
|
|
44
44
|
*
|
|
45
|
-
* Uses per-key-type locks so signed and Kyber rotations
|
|
45
|
+
* Uses per-key-type locks so signed and Kyber rotations do not block each other.
|
|
46
46
|
*/
|
|
47
47
|
export {};
|
|
48
48
|
/**
|
|
49
|
-
* Minimum one-time prekeys before replenishment
|
|
50
|
-
* When count drops below this threshold,
|
|
49
|
+
* Minimum one-time prekeys before replenishment starts.
|
|
50
|
+
* When the count drops below this threshold, the client generates and uploads
|
|
51
|
+
* new prekeys.
|
|
51
52
|
*/
|
|
52
53
|
export declare const MIN_PREKEY_REPLENISHMENT_THRESHOLD = 10;
|
|
53
54
|
/**
|
|
54
55
|
* Check if a key needs rotation based on age
|
|
55
56
|
*
|
|
56
57
|
* Used for BOTH signed and Kyber prekeys. Per PQXDH spec Section 3.2,
|
|
57
|
-
* both key types use identical rotation thresholds
|
|
58
|
+
* both key types use identical rotation thresholds, which synchronizes
|
|
58
59
|
* post-quantum security maintenance.
|
|
59
60
|
*
|
|
60
61
|
* @param createdAt - Key creation timestamp (milliseconds)
|
|
61
62
|
* @param expiresAt - Key expiration timestamp (milliseconds)
|
|
62
63
|
* @param refreshIntervalMs - Custom refresh interval (defaults to 2 days)
|
|
63
|
-
* @returns true if key
|
|
64
|
+
* @returns true if the key needs rotation
|
|
64
65
|
*
|
|
65
66
|
* @see https://signal.org/docs/specifications/pqxdh/#publishing-keys
|
|
66
67
|
*/
|
|
67
68
|
export declare function shouldRotateKey(createdAt: number, expiresAt: number, refreshIntervalMs?: number): boolean;
|
|
68
69
|
/**
|
|
69
|
-
* Check
|
|
70
|
+
* Check whether prekeys exceed the maximum allowed age.
|
|
70
71
|
*
|
|
71
|
-
* If prekeys are older than MAX_PREKEY_AGE_MS (14 days),
|
|
72
|
-
*
|
|
72
|
+
* If prekeys are older than MAX_PREKEY_AGE_MS (14 days), the caller must block
|
|
73
|
+
* message sending until rotation succeeds.
|
|
73
74
|
*
|
|
74
75
|
* This provides a 12-day safety buffer above the 2-day refresh interval.
|
|
75
76
|
*
|
|
@@ -91,7 +92,7 @@ export declare function isPreKeyExpired(createdAt: number, maxAgeMs?: number): b
|
|
|
91
92
|
* @param deviceId - Device identifier
|
|
92
93
|
* @param providedStorage - Local store instance for the current runtime
|
|
93
94
|
* @param refreshIntervalMs - Custom refresh interval (defaults to 2 days)
|
|
94
|
-
* @returns true if
|
|
95
|
+
* @returns true if the function rotated the key
|
|
95
96
|
*/
|
|
96
97
|
export declare function rotateEcSignedPreKeyCore(relay: ISignalProtocolRelayServer, userId: string, deviceId: number, providedStorage?: ISignalProtocolLocalStore, refreshIntervalMs?: number, identityTypes?: readonly IdentityType[], logger?: Required<ILogger>): Promise<boolean>;
|
|
97
98
|
/**
|
|
@@ -106,7 +107,7 @@ export declare function rotateEcSignedPreKeyCore(relay: ISignalProtocolRelayServ
|
|
|
106
107
|
* @param deviceId - Device identifier
|
|
107
108
|
* @param providedStorage - Local store instance for the current runtime
|
|
108
109
|
* @param refreshIntervalMs - Custom refresh interval (defaults to 2 days)
|
|
109
|
-
* @returns true if
|
|
110
|
+
* @returns true if the function rotated the key
|
|
110
111
|
*/
|
|
111
112
|
export declare function rotateKyberPreKeyCore(relay: ISignalProtocolRelayServer, userId: string, deviceId: number, providedStorage?: ISignalProtocolLocalStore, refreshIntervalMs?: number, identityTypes?: readonly IdentityType[], logger?: Required<ILogger>): Promise<boolean>;
|
|
112
113
|
/**
|
|
@@ -120,7 +121,7 @@ export declare function rotateKyberPreKeyCore(relay: ISignalProtocolRelayServer,
|
|
|
120
121
|
* @param deviceId - Device identifier
|
|
121
122
|
* @param storage - Key storage for local persistence
|
|
122
123
|
* @param threshold - Minimum number of prekeys before replenishment (default: 10)
|
|
123
|
-
* @returns true if
|
|
124
|
+
* @returns true if the function replenished both identity types
|
|
124
125
|
*/
|
|
125
126
|
export declare function replenishOneTimePreKeysCore(relay: ISignalProtocolRelayServer, userId: string, deviceId: number, storage: ISignalProtocolLocalStore, threshold?: number, identityTypes?: readonly IdentityType[], preKeyMaintenance?: PreKeyMaintenanceStore, logger?: Required<ILogger>): Promise<boolean>;
|
|
126
127
|
/**
|
|
@@ -129,7 +130,7 @@ export declare function replenishOneTimePreKeysCore(relay: ISignalProtocolRelayS
|
|
|
129
130
|
export interface PreKeySendCheckResult {
|
|
130
131
|
/** Whether sending should proceed */
|
|
131
132
|
canSend: boolean;
|
|
132
|
-
/** Whether
|
|
133
|
+
/** Whether the check attempted a rotation */
|
|
133
134
|
rotationAttempted: boolean;
|
|
134
135
|
/** Whether rotation succeeded (if attempted) */
|
|
135
136
|
rotationSucceeded: boolean;
|
|
@@ -139,8 +140,9 @@ export interface PreKeySendCheckResult {
|
|
|
139
140
|
/**
|
|
140
141
|
* Check prekey age and rotate if needed before sending a message.
|
|
141
142
|
*
|
|
142
|
-
* If prekeys exceed MAX_PREKEY_AGE_MS (14 days),
|
|
143
|
-
* If rotation fails,
|
|
143
|
+
* If prekeys exceed MAX_PREKEY_AGE_MS (14 days), this function attempts a
|
|
144
|
+
* rotation. If rotation fails, the caller must block sending to maintain
|
|
145
|
+
* security.
|
|
144
146
|
*
|
|
145
147
|
* @param relay - Signal Protocol relay server interface
|
|
146
148
|
* @param userId - User identifier
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"key-rotation-core.d.ts","sourceRoot":"","sources":["../../client/key-rotation-core.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAGH,OAAO,EAA+B,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AACtE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAE1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAGlD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AACxE,OAAO,EAGL,KAAK,sBAAsB,EAC5B,MAAM,UAAU,CAAC;AAElB;;;;;;;GAOG;AACH,OAAO,EAAE,CAAC;AA+GV
|
|
1
|
+
{"version":3,"file":"key-rotation-core.d.ts","sourceRoot":"","sources":["../../client/key-rotation-core.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAGH,OAAO,EAA+B,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AACtE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAE1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAGlD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AACxE,OAAO,EAGL,KAAK,sBAAsB,EAC5B,MAAM,UAAU,CAAC;AAElB;;;;;;;GAOG;AACH,OAAO,EAAE,CAAC;AA+GV;;;;GAIG;AACH,eAAO,MAAM,kCAAkC,KAAK,CAAC;AAErD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,iBAAiB,GAAE,MAAwC,GAC1D,OAAO,CAMT;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,QAAQ,GAAE,MAAkC,GAC3C,OAAO,CAGT;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,0BAA0B,EACjC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,eAAe,CAAC,EAAE,yBAAyB,EAC3C,iBAAiB,GAAE,MAAwC,EAC3D,aAAa,GAAE,SAAS,YAAY,EAAmB,EACvD,MAAM,GAAE,QAAQ,CAAC,OAAO,CAA+B,GACtD,OAAO,CAAC,OAAO,CAAC,CAoBlB;AAgFD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,0BAA0B,EACjC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,eAAe,CAAC,EAAE,yBAAyB,EAC3C,iBAAiB,GAAE,MAAwC,EAC3D,aAAa,GAAE,SAAS,YAAY,EAAmB,EACvD,MAAM,GAAE,QAAQ,CAAC,OAAO,CAA+B,GACtD,OAAO,CAAC,OAAO,CAAC,CAoBlB;AAqFD;;;;;;;;;;;;GAYG;AACH,wBAAsB,2BAA2B,CAC/C,KAAK,EAAE,0BAA0B,EACjC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,yBAAyB,EAClC,SAAS,GAAE,MAA2C,EACtD,aAAa,GAAE,SAAS,YAAY,EAAmB,EACvD,iBAAiB,CAAC,EAAE,sBAAsB,EAC1C,MAAM,GAAE,QAAQ,CAAC,OAAO,CAA+B,GACtD,OAAO,CAAC,OAAO,CAAC,CAiBlB;AAkFD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,qCAAqC;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,6CAA6C;IAC7C,iBAAiB,EAAE,OAAO,CAAC;IAC3B,gDAAgD;IAChD,iBAAiB,EAAE,OAAO,CAAC;IAC3B,uCAAuC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,0BAA0B,EACjC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,yBAAyB,EACnC,QAAQ,GAAE,MAAkC,EAC5C,YAAY,GAAE,YAAoB,EAClC,MAAM,GAAE,QAAQ,CAAC,OAAO,CAA+B,GACtD,OAAO,CAAC,qBAAqB,CAAC,CAkGhC"}
|
|
@@ -18,7 +18,7 @@
|
|
|
18
18
|
* - Network requests completing out of order
|
|
19
19
|
*
|
|
20
20
|
* The lock wraps the entire check → generate → upload → store sequence
|
|
21
|
-
* to
|
|
21
|
+
* to make key rotation atomic.
|
|
22
22
|
*
|
|
23
23
|
* ## Transactional Pattern
|
|
24
24
|
*
|
|
@@ -28,8 +28,8 @@
|
|
|
28
28
|
* 3. Upload to server (may fail - local state unchanged)
|
|
29
29
|
* 4. Store locally only after successful upload
|
|
30
30
|
*
|
|
31
|
-
* This
|
|
32
|
-
*
|
|
31
|
+
* This keeps client and server in sync. If upload fails, local state does not
|
|
32
|
+
* change, and the caller can safely retry rotation.
|
|
33
33
|
*/
|
|
34
34
|
import AsyncLock from 'async-lock';
|
|
35
35
|
import { defaultSignalProtocolLogger } from '../logger.js';
|
|
@@ -103,21 +103,22 @@ function checkRotationNeeded(metadata, refreshIntervalMs, keyTypeName, logger) {
|
|
|
103
103
|
// EXPORTS
|
|
104
104
|
// ============================================================================
|
|
105
105
|
/**
|
|
106
|
-
* Minimum one-time prekeys before replenishment
|
|
107
|
-
* When count drops below this threshold,
|
|
106
|
+
* Minimum one-time prekeys before replenishment starts.
|
|
107
|
+
* When the count drops below this threshold, the client generates and uploads
|
|
108
|
+
* new prekeys.
|
|
108
109
|
*/
|
|
109
110
|
export const MIN_PREKEY_REPLENISHMENT_THRESHOLD = 10;
|
|
110
111
|
/**
|
|
111
112
|
* Check if a key needs rotation based on age
|
|
112
113
|
*
|
|
113
114
|
* Used for BOTH signed and Kyber prekeys. Per PQXDH spec Section 3.2,
|
|
114
|
-
* both key types use identical rotation thresholds
|
|
115
|
+
* both key types use identical rotation thresholds, which synchronizes
|
|
115
116
|
* post-quantum security maintenance.
|
|
116
117
|
*
|
|
117
118
|
* @param createdAt - Key creation timestamp (milliseconds)
|
|
118
119
|
* @param expiresAt - Key expiration timestamp (milliseconds)
|
|
119
120
|
* @param refreshIntervalMs - Custom refresh interval (defaults to 2 days)
|
|
120
|
-
* @returns true if key
|
|
121
|
+
* @returns true if the key needs rotation
|
|
121
122
|
*
|
|
122
123
|
* @see https://signal.org/docs/specifications/pqxdh/#publishing-keys
|
|
123
124
|
*/
|
|
@@ -128,10 +129,10 @@ export function shouldRotateKey(createdAt, expiresAt, refreshIntervalMs = KEY_RE
|
|
|
128
129
|
return age >= refreshIntervalMs || now >= expiresAt;
|
|
129
130
|
}
|
|
130
131
|
/**
|
|
131
|
-
* Check
|
|
132
|
+
* Check whether prekeys exceed the maximum allowed age.
|
|
132
133
|
*
|
|
133
|
-
* If prekeys are older than MAX_PREKEY_AGE_MS (14 days),
|
|
134
|
-
*
|
|
134
|
+
* If prekeys are older than MAX_PREKEY_AGE_MS (14 days), the caller must block
|
|
135
|
+
* message sending until rotation succeeds.
|
|
135
136
|
*
|
|
136
137
|
* This provides a 12-day safety buffer above the 2-day refresh interval.
|
|
137
138
|
*
|
|
@@ -156,13 +157,14 @@ export function isPreKeyExpired(createdAt, maxAgeMs = MAX_PREKEY_AGE_MS_DEFAULT)
|
|
|
156
157
|
* @param deviceId - Device identifier
|
|
157
158
|
* @param providedStorage - Local store instance for the current runtime
|
|
158
159
|
* @param refreshIntervalMs - Custom refresh interval (defaults to 2 days)
|
|
159
|
-
* @returns true if
|
|
160
|
+
* @returns true if the function rotated the key
|
|
160
161
|
*/
|
|
161
162
|
export async function rotateEcSignedPreKeyCore(relay, userId, deviceId, providedStorage, refreshIntervalMs = KEY_REFRESH_INTERVAL_MS_DEFAULT, identityTypes = ['aci', 'pni'], logger = defaultSignalProtocolLogger) {
|
|
162
|
-
// Rotate for active identity types
|
|
163
|
+
// Rotate for active identity types. The reference implementation rotates PNI
|
|
164
|
+
// on the same schedule as ACI.
|
|
163
165
|
// Use && so the function only returns true when ALL identities succeed.
|
|
164
|
-
// The reference implementation uses exception propagation
|
|
165
|
-
// fails and
|
|
166
|
+
// The reference implementation uses exception propagation. If any identity fails, the entire job
|
|
167
|
+
// fails, and the next rotation cycle retries it.
|
|
166
168
|
let allRotated = true;
|
|
167
169
|
for (const type of identityTypes) {
|
|
168
170
|
const rotated = await rotateEcSignedPreKeyForIdentity(relay, userId, deviceId, type, providedStorage, refreshIntervalMs, logger);
|
|
@@ -179,11 +181,11 @@ export async function rotateEcSignedPreKeyCore(relay, userId, deviceId, provided
|
|
|
179
181
|
* @param identityType - 'aci' or 'pni'
|
|
180
182
|
* @param providedStorage - Optional storage instance
|
|
181
183
|
* @param refreshIntervalMs - Custom refresh interval
|
|
182
|
-
* @returns true if
|
|
184
|
+
* @returns true if the function rotated the key
|
|
183
185
|
*/
|
|
184
186
|
async function rotateEcSignedPreKeyForIdentity(relay, userId, deviceId, identityType, providedStorage, refreshIntervalMs = KEY_REFRESH_INTERVAL_MS_DEFAULT, logger = defaultSignalProtocolLogger) {
|
|
185
187
|
return withRotationLock(userId, deviceId, `signed:${identityType}`, async () => {
|
|
186
|
-
// Check
|
|
188
|
+
// Check whether this identity type needs rotation
|
|
187
189
|
const metadata = await relay.getEcSignedPreKeyMetadata(userId, deviceId, identityType);
|
|
188
190
|
if (!checkRotationNeeded(metadata, refreshIntervalMs, `EC signed prekey (${identityType})`, logger)) {
|
|
189
191
|
return false;
|
|
@@ -195,10 +197,10 @@ async function rotateEcSignedPreKeyForIdentity(relay, userId, deviceId, identity
|
|
|
195
197
|
const { generateEcSignedPreKey } = await import('../keys/index.js');
|
|
196
198
|
const storage = await resolveStorage(providedStorage, logger);
|
|
197
199
|
const identityKey = await getRequiredIdentityKey(storage, identityType);
|
|
198
|
-
// Generate new EC signed prekey (but
|
|
200
|
+
// Generate new EC signed prekey (but do not store yet)
|
|
199
201
|
const newSignedPreKey = await generateEcSignedPreKey(identityKey);
|
|
200
202
|
// TRANSACTIONAL PATTERN: Upload first, then commit locally
|
|
201
|
-
// If upload fails, local state
|
|
203
|
+
// If upload fails, local state does not change, so a retry is safe.
|
|
202
204
|
await relay.uploadEcSignedPreKey(userId, {
|
|
203
205
|
keyId: newSignedPreKey.keyId,
|
|
204
206
|
deviceId,
|
|
@@ -226,13 +228,14 @@ async function rotateEcSignedPreKeyForIdentity(relay, userId, deviceId, identity
|
|
|
226
228
|
* @param deviceId - Device identifier
|
|
227
229
|
* @param providedStorage - Local store instance for the current runtime
|
|
228
230
|
* @param refreshIntervalMs - Custom refresh interval (defaults to 2 days)
|
|
229
|
-
* @returns true if
|
|
231
|
+
* @returns true if the function rotated the key
|
|
230
232
|
*/
|
|
231
233
|
export async function rotateKyberPreKeyCore(relay, userId, deviceId, providedStorage, refreshIntervalMs = KEY_REFRESH_INTERVAL_MS_DEFAULT, identityTypes = ['aci', 'pni'], logger = defaultSignalProtocolLogger) {
|
|
232
|
-
// Rotate for active identity types
|
|
234
|
+
// Rotate for active identity types. The reference implementation rotates PNI
|
|
235
|
+
// on the same schedule as ACI.
|
|
233
236
|
// Use && so the function only returns true when ALL identities succeed.
|
|
234
|
-
// The reference implementation uses exception propagation
|
|
235
|
-
// fails and
|
|
237
|
+
// The reference implementation uses exception propagation. If any identity fails, the entire job
|
|
238
|
+
// fails, and the next rotation cycle retries it.
|
|
236
239
|
let allRotated = true;
|
|
237
240
|
for (const type of identityTypes) {
|
|
238
241
|
const rotated = await rotateKyberPreKeyForIdentity(relay, userId, deviceId, type, providedStorage, refreshIntervalMs, logger);
|
|
@@ -249,11 +252,11 @@ export async function rotateKyberPreKeyCore(relay, userId, deviceId, providedSto
|
|
|
249
252
|
* @param identityType - 'aci' or 'pni'
|
|
250
253
|
* @param providedStorage - Optional storage instance
|
|
251
254
|
* @param refreshIntervalMs - Custom refresh interval
|
|
252
|
-
* @returns true if
|
|
255
|
+
* @returns true if the function rotated the key
|
|
253
256
|
*/
|
|
254
257
|
async function rotateKyberPreKeyForIdentity(relay, userId, deviceId, identityType, providedStorage, refreshIntervalMs = KEY_REFRESH_INTERVAL_MS_DEFAULT, logger = defaultSignalProtocolLogger) {
|
|
255
258
|
return withRotationLock(userId, deviceId, `kyber:${identityType}`, async () => {
|
|
256
|
-
// Check
|
|
259
|
+
// Check whether this identity type needs rotation
|
|
257
260
|
const metadata = await relay.getKemLastResortPreKeyMetadata(userId, deviceId, identityType);
|
|
258
261
|
if (!checkRotationNeeded(metadata, refreshIntervalMs, `Kyber prekey (${identityType})`, logger)) {
|
|
259
262
|
return false;
|
|
@@ -267,7 +270,7 @@ async function rotateKyberPreKeyForIdentity(relay, userId, deviceId, identityTyp
|
|
|
267
270
|
const { generateKyberLastResortPreKey } = await import('../keys/generation.js');
|
|
268
271
|
const kyberPreKey = await generateKyberLastResortPreKey(identityKey, 1);
|
|
269
272
|
// TRANSACTIONAL PATTERN: Upload first, then commit locally
|
|
270
|
-
// If upload fails, local state
|
|
273
|
+
// If upload fails, local state does not change, so a retry is safe.
|
|
271
274
|
const publicKyberPreKey = {
|
|
272
275
|
keyId: kyberPreKey.keyId,
|
|
273
276
|
publicKey: kyberPreKey.publicKey,
|
|
@@ -299,7 +302,7 @@ async function rotateKyberPreKeyForIdentity(relay, userId, deviceId, identityTyp
|
|
|
299
302
|
* @param deviceId - Device identifier
|
|
300
303
|
* @param storage - Key storage for local persistence
|
|
301
304
|
* @param threshold - Minimum number of prekeys before replenishment (default: 10)
|
|
302
|
-
* @returns true if
|
|
305
|
+
* @returns true if the function replenished both identity types
|
|
303
306
|
*/
|
|
304
307
|
export async function replenishOneTimePreKeysCore(relay, userId, deviceId, storage, threshold = MIN_PREKEY_REPLENISHMENT_THRESHOLD, identityTypes = ['aci', 'pni'], preKeyMaintenance, logger = defaultSignalProtocolLogger) {
|
|
305
308
|
// Replenish for active identity types (consistent with rotateEcSignedPreKeyCore/rotateKyberPreKeyCore)
|
|
@@ -319,7 +322,7 @@ export async function replenishOneTimePreKeysCore(relay, userId, deviceId, stora
|
|
|
319
322
|
* @param storage - Key storage for local persistence
|
|
320
323
|
* @param threshold - Minimum number of prekeys before replenishment
|
|
321
324
|
* @param identityType - 'aci' or 'pni'
|
|
322
|
-
* @returns true if
|
|
325
|
+
* @returns true if the function replenished the prekeys
|
|
323
326
|
*/
|
|
324
327
|
async function replenishOneTimePreKeysForIdentity(relay, userId, deviceId, storage, threshold, identityType, preKeyMaintenance, logger = defaultSignalProtocolLogger) {
|
|
325
328
|
return withRotationLock(userId, deviceId, `prekeys:${identityType}`, async () => {
|
|
@@ -359,8 +362,9 @@ async function replenishOneTimePreKeysForIdentity(relay, userId, deviceId, stora
|
|
|
359
362
|
/**
|
|
360
363
|
* Check prekey age and rotate if needed before sending a message.
|
|
361
364
|
*
|
|
362
|
-
* If prekeys exceed MAX_PREKEY_AGE_MS (14 days),
|
|
363
|
-
* If rotation fails,
|
|
365
|
+
* If prekeys exceed MAX_PREKEY_AGE_MS (14 days), this function attempts a
|
|
366
|
+
* rotation. If rotation fails, the caller must block sending to maintain
|
|
367
|
+
* security.
|
|
364
368
|
*
|
|
365
369
|
* @param relay - Signal Protocol relay server interface
|
|
366
370
|
* @param userId - User identifier
|
|
@@ -390,7 +394,7 @@ export async function ensurePreKeysValid(relay, userId, deviceId, storage, maxAg
|
|
|
390
394
|
// Check Kyber prekey metadata for the specified identity type
|
|
391
395
|
const kyberMetadata = await relay.getKemLastResortPreKeyMetadata(userId, deviceId, identityType);
|
|
392
396
|
const kyberExpired = kyberMetadata ? isPreKeyExpired(kyberMetadata.createdAt, maxAgeMs) : true;
|
|
393
|
-
// If neither
|
|
397
|
+
// If neither key expired, sending can proceed
|
|
394
398
|
if (!signedExpired && !kyberExpired) {
|
|
395
399
|
return {
|
|
396
400
|
canSend: true,
|
|
@@ -398,7 +402,7 @@ export async function ensurePreKeysValid(relay, userId, deviceId, storage, maxAg
|
|
|
398
402
|
rotationSucceeded: false,
|
|
399
403
|
};
|
|
400
404
|
}
|
|
401
|
-
//
|
|
405
|
+
// The prekeys expired - attempt rotation (rotate before blocking)
|
|
402
406
|
logger.warn('Prekeys expired, attempting rotation before send', {
|
|
403
407
|
category: 'E2EE',
|
|
404
408
|
data: {
|