@open-e2ee/signal-protocol-sdk 0.1.0-alpha.6 → 0.1.0-alpha.8
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 +1 -1
- package/ARCHITECTURE.md +1 -1
- package/CHANGELOG.md +876 -3
- package/COMMERCIAL.md +56 -0
- package/README.md +13 -8
- package/SECURITY.md +15 -1
- package/client/README.md +1 -1
- package/dist/client/client.d.ts +32 -28
- package/dist/client/client.d.ts.map +1 -1
- package/dist/client/client.js +136 -80
- package/dist/client/client.js.map +1 -1
- package/dist/client/compose.d.ts +6 -1
- package/dist/client/compose.d.ts.map +1 -1
- package/dist/client/compose.js +2 -0
- package/dist/client/compose.js.map +1 -1
- package/dist/client/config.d.ts +53 -19
- package/dist/client/config.d.ts.map +1 -1
- package/dist/client/config.js.map +1 -1
- package/dist/client/endorsement-manager.d.ts +23 -2
- package/dist/client/endorsement-manager.d.ts.map +1 -1
- package/dist/client/endorsement-manager.js +35 -10
- package/dist/client/endorsement-manager.js.map +1 -1
- package/dist/client/groups.d.ts +29 -29
- package/dist/client/groups.d.ts.map +1 -1
- package/dist/client/groups.js +54 -37
- package/dist/client/groups.js.map +1 -1
- package/dist/client/headless.d.ts +1 -1
- package/dist/client/headless.js +1 -1
- package/dist/client/sealed-sender-ops.d.ts +27 -1
- package/dist/client/sealed-sender-ops.d.ts.map +1 -1
- package/dist/client/sealed-sender-ops.js +36 -6
- package/dist/client/sealed-sender-ops.js.map +1 -1
- package/dist/client/signal-service-cipher.d.ts +21 -2
- package/dist/client/signal-service-cipher.d.ts.map +1 -1
- package/dist/client/signal-service-cipher.js +119 -53
- package/dist/client/signal-service-cipher.js.map +1 -1
- package/dist/client/types.d.ts +20 -7
- package/dist/client/types.d.ts.map +1 -1
- package/dist/client/types.js.map +1 -1
- package/dist/groups/index.d.ts +4 -4
- package/dist/groups/index.d.ts.map +1 -1
- package/dist/groups/index.js +3 -3
- package/dist/groups/index.js.map +1 -1
- package/dist/index.d.ts +12 -5
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +10 -3
- package/dist/index.js.map +1 -1
- package/dist/internal/crypto/index.d.ts +1 -1
- package/dist/internal/crypto/index.d.ts.map +1 -1
- package/dist/internal/crypto/index.js +1 -1
- package/dist/internal/crypto/index.js.map +1 -1
- package/dist/internal/crypto/random.d.ts +9 -0
- package/dist/internal/crypto/random.d.ts.map +1 -1
- package/dist/internal/crypto/random.js +16 -0
- package/dist/internal/crypto/random.js.map +1 -1
- package/dist/internal/groups/access-control.d.ts +170 -0
- package/dist/internal/groups/access-control.d.ts.map +1 -0
- package/dist/internal/groups/access-control.js +284 -0
- package/dist/internal/groups/access-control.js.map +1 -0
- package/dist/internal/groups/change-actions.d.ts +57 -0
- package/dist/internal/groups/change-actions.d.ts.map +1 -0
- package/dist/internal/groups/change-actions.js +827 -0
- package/dist/internal/groups/change-actions.js.map +1 -0
- package/dist/internal/groups/change-authorization.d.ts +16 -0
- package/dist/internal/groups/change-authorization.d.ts.map +1 -0
- package/dist/internal/groups/change-authorization.js +120 -0
- package/dist/internal/groups/change-authorization.js.map +1 -0
- package/dist/internal/{groups-v2 → groups}/encrypted-state.d.ts +12 -2
- package/dist/internal/groups/encrypted-state.d.ts.map +1 -0
- package/dist/internal/{groups-v2 → groups}/encrypted-state.js +122 -22
- package/dist/internal/groups/encrypted-state.js.map +1 -0
- package/dist/internal/groups/group-id.d.ts +9 -9
- package/dist/internal/groups/group-id.d.ts.map +1 -1
- package/dist/internal/groups/group-id.js +11 -12
- package/dist/internal/groups/group-id.js.map +1 -1
- package/dist/internal/groups/index.d.ts +16 -6
- package/dist/internal/groups/index.d.ts.map +1 -1
- package/dist/internal/groups/index.js +9 -1
- package/dist/internal/groups/index.js.map +1 -1
- package/dist/internal/groups/invite-link.d.ts.map +1 -0
- package/dist/internal/groups/invite-link.js.map +1 -0
- package/dist/internal/{groups-v2 → groups}/manager.d.ts +188 -40
- package/dist/internal/groups/manager.d.ts.map +1 -0
- package/dist/internal/groups/manager.js +1923 -0
- package/dist/internal/groups/manager.js.map +1 -0
- package/dist/internal/groups/sdk-store.d.ts +32 -0
- package/dist/internal/groups/sdk-store.d.ts.map +1 -0
- package/dist/internal/groups/sdk-store.js +111 -0
- package/dist/internal/groups/sdk-store.js.map +1 -0
- package/dist/internal/groups/server-engine.d.ts +83 -0
- package/dist/internal/groups/server-engine.d.ts.map +1 -0
- package/dist/internal/groups/server-engine.js +1186 -0
- package/dist/internal/groups/server-engine.js.map +1 -0
- package/dist/internal/groups/trust-root.d.ts +32 -0
- package/dist/internal/groups/trust-root.d.ts.map +1 -0
- package/dist/internal/groups/trust-root.js +91 -0
- package/dist/internal/groups/trust-root.js.map +1 -0
- package/dist/internal/{groups-v2 → groups}/types.d.ts +188 -46
- package/dist/internal/groups/types.d.ts.map +1 -0
- package/dist/internal/{groups-v2 → groups}/types.js +3 -2
- package/dist/internal/groups/types.js.map +1 -0
- package/dist/internal/groups/wire.d.ts +68 -0
- package/dist/internal/groups/wire.d.ts.map +1 -0
- package/dist/internal/groups/wire.js +708 -0
- package/dist/internal/groups/wire.js.map +1 -0
- package/dist/internal/protocol/sealed-sender/decryption-v2.d.ts.map +1 -1
- package/dist/internal/protocol/sealed-sender/decryption-v2.js +32 -18
- 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 +33 -19
- package/dist/internal/protocol/sealed-sender/decryption.js.map +1 -1
- package/dist/internal/protocol/sealed-sender/encryption-v2.d.ts.map +1 -1
- package/dist/internal/protocol/sealed-sender/encryption-v2.js +8 -14
- package/dist/internal/protocol/sealed-sender/encryption-v2.js.map +1 -1
- package/dist/internal/protocol/sealed-sender/encryption.d.ts +9 -4
- package/dist/internal/protocol/sealed-sender/encryption.d.ts.map +1 -1
- package/dist/internal/protocol/sealed-sender/encryption.js +7 -15
- package/dist/internal/protocol/sealed-sender/encryption.js.map +1 -1
- package/dist/internal/protocol/sealed-sender/proto/index.d.ts +6 -7
- package/dist/internal/protocol/sealed-sender/proto/index.d.ts.map +1 -1
- package/dist/internal/protocol/sealed-sender/proto/index.js +5 -7
- package/dist/internal/protocol/sealed-sender/proto/index.js.map +1 -1
- package/dist/internal/protocol/sealed-sender/trust-root.d.ts +45 -0
- package/dist/internal/protocol/sealed-sender/trust-root.d.ts.map +1 -0
- package/dist/internal/protocol/sealed-sender/trust-root.js +77 -0
- package/dist/internal/protocol/sealed-sender/trust-root.js.map +1 -0
- package/dist/internal/protocol/sealed-sender/types.d.ts +64 -9
- package/dist/internal/protocol/sealed-sender/types.d.ts.map +1 -1
- package/dist/internal/protocol/sealed-sender/types.js +43 -0
- package/dist/internal/protocol/sealed-sender/types.js.map +1 -1
- package/dist/internal/protocol/sender-keys/index.d.ts +1 -1
- package/dist/internal/protocol/sender-keys/manager.d.ts +38 -1
- package/dist/internal/protocol/sender-keys/manager.d.ts.map +1 -1
- package/dist/internal/protocol/sender-keys/manager.js +109 -8
- package/dist/internal/protocol/sender-keys/manager.js.map +1 -1
- package/dist/internal/protocol/zk/groups/auth-credential.d.ts +9 -7
- package/dist/internal/protocol/zk/groups/auth-credential.d.ts.map +1 -1
- package/dist/internal/protocol/zk/groups/auth-credential.js +68 -29
- package/dist/internal/protocol/zk/groups/auth-credential.js.map +1 -1
- package/dist/internal/protocol/zk/groups/server-params.d.ts +1 -1
- package/dist/internal/protocol/zk/groups/server-params.d.ts.map +1 -1
- package/dist/internal/protocol/zk/groups/server-params.js.map +1 -1
- package/dist/internal/protocol/zk/groups/uid-struct.d.ts +2 -0
- package/dist/internal/protocol/zk/groups/uid-struct.d.ts.map +1 -1
- package/dist/internal/protocol/zk/groups/uid-struct.js +4 -0
- package/dist/internal/protocol/zk/groups/uid-struct.js.map +1 -1
- package/dist/layers.d.ts +1 -1
- package/dist/layers.js +3 -3
- package/dist/layers.js.map +1 -1
- package/dist/local/store/expo/adapter.d.ts +14 -15
- package/dist/local/store/expo/adapter.d.ts.map +1 -1
- package/dist/local/store/expo/adapter.js +109 -102
- package/dist/local/store/expo/adapter.js.map +1 -1
- package/dist/local/store/expo/db.d.ts +4 -1
- package/dist/local/store/expo/db.d.ts.map +1 -1
- package/dist/local/store/expo/db.js +5 -0
- package/dist/local/store/expo/db.js.map +1 -1
- package/dist/local/store/expo/index.d.ts +0 -2
- package/dist/local/store/expo/index.d.ts.map +1 -1
- package/dist/local/store/expo/index.js +1 -1
- package/dist/local/store/expo/index.js.map +1 -1
- package/dist/local/store/expo/models/index.d.ts +1 -1
- package/dist/local/store/expo/models/index.d.ts.map +1 -1
- package/dist/local/store/expo/models/index.js +2 -2
- package/dist/local/store/expo/models/index.js.map +1 -1
- package/dist/local/store/expo/models/sender-key.d.ts +101 -77
- package/dist/local/store/expo/models/sender-key.d.ts.map +1 -1
- package/dist/local/store/expo/models/sender-key.js +154 -124
- package/dist/local/store/expo/models/sender-key.js.map +1 -1
- package/dist/local/store/expo/schema.d.ts +134 -32
- package/dist/local/store/expo/schema.d.ts.map +1 -1
- package/dist/local/store/expo/schema.js +36 -7
- package/dist/local/store/expo/schema.js.map +1 -1
- package/dist/local/store/mock/adapter.d.ts +1 -0
- package/dist/local/store/mock/adapter.d.ts.map +1 -1
- package/dist/local/store/mock/adapter.js +18 -0
- package/dist/local/store/mock/adapter.js.map +1 -1
- package/dist/local/store/react-native/adapter.d.ts +39 -0
- package/dist/local/store/react-native/adapter.d.ts.map +1 -1
- package/dist/local/store/react-native/adapter.js +163 -8
- package/dist/local/store/react-native/adapter.js.map +1 -1
- package/dist/local/store/web/adapter.d.ts +1 -0
- package/dist/local/store/web/adapter.d.ts.map +1 -1
- package/dist/local/store/web/adapter.js +33 -1
- package/dist/local/store/web/adapter.js.map +1 -1
- package/dist/remote/relay/convex/backend.d.ts +402 -0
- package/dist/remote/relay/convex/backend.d.ts.map +1 -0
- package/dist/remote/relay/convex/backend.js +684 -0
- package/dist/remote/relay/convex/backend.js.map +1 -0
- package/dist/remote/relay/convex/component/_generated/api.d.ts +58 -0
- package/dist/remote/relay/convex/component/_generated/api.d.ts.map +1 -0
- package/dist/remote/relay/convex/component/_generated/api.js +31 -0
- package/dist/remote/relay/convex/component/_generated/api.js.map +1 -0
- package/dist/remote/relay/convex/component/_generated/component.d.ts +480 -0
- package/dist/remote/relay/convex/component/_generated/component.d.ts.map +1 -0
- package/dist/remote/relay/convex/component/_generated/component.js +11 -0
- package/dist/remote/relay/convex/component/_generated/component.js.map +1 -0
- package/dist/remote/relay/convex/component/_generated/dataModel.d.ts +46 -0
- package/dist/remote/relay/convex/component/_generated/dataModel.d.ts.map +1 -0
- package/dist/remote/relay/convex/component/_generated/dataModel.js +11 -0
- package/dist/remote/relay/convex/component/_generated/dataModel.js.map +1 -0
- package/dist/remote/relay/convex/component/_generated/server.d.ts +129 -0
- package/dist/remote/relay/convex/component/_generated/server.d.ts.map +1 -0
- package/dist/remote/relay/convex/component/_generated/server.js +79 -0
- package/dist/remote/relay/convex/component/_generated/server.js.map +1 -0
- package/dist/remote/relay/convex/component/accounts.d.ts +43 -0
- package/dist/remote/relay/convex/component/accounts.d.ts.map +1 -0
- package/dist/remote/relay/convex/component/accounts.js +181 -0
- package/dist/remote/relay/convex/component/accounts.js.map +1 -0
- package/dist/remote/relay/convex/component/certificates.d.ts +10 -0
- package/dist/remote/relay/convex/component/certificates.d.ts.map +1 -0
- package/dist/remote/relay/convex/component/certificates.js +122 -0
- package/dist/remote/relay/convex/component/certificates.js.map +1 -0
- package/dist/remote/relay/convex/component/cleanup.d.ts +26 -0
- package/dist/remote/relay/convex/component/cleanup.d.ts.map +1 -0
- package/dist/remote/relay/convex/component/cleanup.js +127 -0
- package/dist/remote/relay/convex/component/cleanup.js.map +1 -0
- package/dist/remote/relay/convex/component/convex.config.d.ts +5 -0
- package/dist/remote/relay/convex/component/convex.config.d.ts.map +1 -0
- package/dist/remote/relay/convex/component/convex.config.js +33 -0
- package/dist/remote/relay/convex/component/convex.config.js.map +1 -0
- package/dist/remote/relay/convex/component/crons.d.ts +3 -0
- package/dist/remote/relay/convex/component/crons.d.ts.map +1 -0
- package/dist/remote/relay/convex/component/crons.js +9 -0
- package/dist/remote/relay/convex/component/crons.js.map +1 -0
- package/dist/remote/relay/convex/component/devices.d.ts +101 -0
- package/dist/remote/relay/convex/component/devices.d.ts.map +1 -0
- package/dist/remote/relay/convex/component/devices.js +299 -0
- package/dist/remote/relay/convex/component/devices.js.map +1 -0
- package/dist/remote/relay/convex/component/errors.d.ts +22 -0
- package/dist/remote/relay/convex/component/errors.d.ts.map +1 -0
- package/dist/remote/relay/convex/component/errors.js +17 -0
- package/dist/remote/relay/convex/component/errors.js.map +1 -0
- package/dist/remote/relay/convex/component/groups.d.ts +60 -0
- package/dist/remote/relay/convex/component/groups.d.ts.map +1 -0
- package/dist/remote/relay/convex/component/groups.js +331 -0
- package/dist/remote/relay/convex/component/groups.js.map +1 -0
- package/dist/remote/relay/convex/component/keys.d.ts +130 -0
- package/dist/remote/relay/convex/component/keys.d.ts.map +1 -0
- package/dist/remote/relay/convex/component/keys.js +578 -0
- package/dist/remote/relay/convex/component/keys.js.map +1 -0
- package/dist/remote/relay/convex/component/messages.d.ts +119 -0
- package/dist/remote/relay/convex/component/messages.d.ts.map +1 -0
- package/dist/remote/relay/convex/component/messages.js +649 -0
- package/dist/remote/relay/convex/component/messages.js.map +1 -0
- package/dist/remote/relay/convex/component/provisioning.d.ts +92 -0
- package/dist/remote/relay/convex/component/provisioning.d.ts.map +1 -0
- package/dist/remote/relay/convex/component/provisioning.js +359 -0
- package/dist/remote/relay/convex/component/provisioning.js.map +1 -0
- package/dist/remote/relay/convex/component/runtime.d.ts +18 -0
- package/dist/remote/relay/convex/component/runtime.d.ts.map +1 -0
- package/dist/remote/relay/convex/component/runtime.js +142 -0
- package/dist/remote/relay/convex/component/runtime.js.map +1 -0
- package/dist/remote/relay/convex/component/schema.d.ts +344 -0
- package/dist/remote/relay/convex/component/schema.d.ts.map +1 -0
- package/dist/remote/relay/convex/component/schema.js +266 -0
- package/dist/remote/relay/convex/component/schema.js.map +1 -0
- package/dist/remote/relay/convex/component/zkAuth.d.ts +12 -0
- package/dist/remote/relay/convex/component/zkAuth.d.ts.map +1 -0
- package/dist/remote/relay/convex/component/zkAuth.js +71 -0
- package/dist/remote/relay/convex/component/zkAuth.js.map +1 -0
- package/dist/remote/relay/convex/constants.d.ts +3 -0
- package/dist/remote/relay/convex/constants.d.ts.map +1 -0
- package/dist/remote/relay/convex/constants.js +3 -0
- package/dist/remote/relay/convex/constants.js.map +1 -0
- package/dist/remote/relay/convex/group-server.d.ts +25 -21
- package/dist/remote/relay/convex/group-server.d.ts.map +1 -1
- package/dist/remote/relay/convex/group-server.js +51 -21
- package/dist/remote/relay/convex/group-server.js.map +1 -1
- package/dist/remote/relay/convex/index.d.ts +4 -1
- package/dist/remote/relay/convex/index.d.ts.map +1 -1
- package/dist/remote/relay/convex/index.js +3 -1
- package/dist/remote/relay/convex/index.js.map +1 -1
- package/dist/remote/relay/convex/relay.d.ts +54 -67
- package/dist/remote/relay/convex/relay.d.ts.map +1 -1
- package/dist/remote/relay/convex/relay.js +123 -42
- package/dist/remote/relay/convex/relay.js.map +1 -1
- package/dist/remote/relay/convex/types.d.ts +16 -103
- package/dist/remote/relay/convex/types.d.ts.map +1 -1
- package/dist/remote/relay/convex/types.js +8 -13
- package/dist/remote/relay/convex/types.js.map +1 -1
- package/dist/remote/relay/index.d.ts +1 -1
- package/dist/remote/relay/index.d.ts.map +1 -1
- package/dist/remote/relay/mock/adapter.d.ts +33 -20
- package/dist/remote/relay/mock/adapter.d.ts.map +1 -1
- package/dist/remote/relay/mock/adapter.js +98 -81
- package/dist/remote/relay/mock/adapter.js.map +1 -1
- package/dist/remote/relay/mock/group-server.d.ts +9 -0
- package/dist/remote/relay/mock/group-server.d.ts.map +1 -0
- package/dist/remote/relay/mock/group-server.js +9 -0
- package/dist/remote/relay/mock/group-server.js.map +1 -0
- package/dist/remote/relay/types.d.ts +73 -79
- package/dist/remote/relay/types.d.ts.map +1 -1
- package/dist/remote/relay/types.js +0 -1
- package/dist/remote/relay/types.js.map +1 -1
- package/dist/types/api.d.ts +23 -2
- package/dist/types/api.d.ts.map +1 -1
- package/dist/types/protocol-config.d.ts +51 -0
- package/dist/types/protocol-config.d.ts.map +1 -1
- package/dist/types/protocol-config.js +46 -0
- package/dist/types/protocol-config.js.map +1 -1
- package/docs/ASSURANCE.md +10 -6
- package/docs/CLIENT_COMPOSITION.md +23 -69
- package/docs/DEVIATIONS.md +77 -41
- package/docs/E2EE.md +71 -6
- package/docs/GETTING_STARTED.md +1 -1
- package/docs/PACKAGE_SURFACE.md +6 -0
- package/docs/RECIPES.md +1 -1
- package/docs/SECURITY.md +8 -0
- package/groups/README.md +16 -5
- package/local/store/expo/README.md +10 -1
- package/local/store/node/README.md +10 -1
- package/package.json +20 -4
- package/remote/relay/convex/README.md +6 -0
- package/remote/relay/convex/component/README.md +428 -0
- package/scripts/oe-groups.mjs +162 -0
- package/dist/internal/groups-v2/access-control.d.ts +0 -108
- package/dist/internal/groups-v2/access-control.d.ts.map +0 -1
- package/dist/internal/groups-v2/access-control.js +0 -191
- package/dist/internal/groups-v2/access-control.js.map +0 -1
- package/dist/internal/groups-v2/change-actions.d.ts +0 -40
- package/dist/internal/groups-v2/change-actions.d.ts.map +0 -1
- package/dist/internal/groups-v2/change-actions.js +0 -363
- package/dist/internal/groups-v2/change-actions.js.map +0 -1
- package/dist/internal/groups-v2/encrypted-state.d.ts.map +0 -1
- package/dist/internal/groups-v2/encrypted-state.js.map +0 -1
- package/dist/internal/groups-v2/index.d.ts +0 -19
- package/dist/internal/groups-v2/index.d.ts.map +0 -1
- package/dist/internal/groups-v2/index.js +0 -11
- package/dist/internal/groups-v2/index.js.map +0 -1
- package/dist/internal/groups-v2/invite-link.d.ts.map +0 -1
- package/dist/internal/groups-v2/invite-link.js.map +0 -1
- package/dist/internal/groups-v2/manager.d.ts.map +0 -1
- package/dist/internal/groups-v2/manager.js +0 -1095
- package/dist/internal/groups-v2/manager.js.map +0 -1
- package/dist/internal/groups-v2/types.d.ts.map +0 -1
- package/dist/internal/groups-v2/types.js.map +0 -1
- package/docs/api/README.md +0 -471
- package/docs/api/classes/EncryptionError.md +0 -112
- package/docs/api/classes/EndorsementManager.md +0 -307
- package/docs/api/classes/SealedSenderAuthError.md +0 -127
- package/docs/api/classes/ServerDerivedKeyPair.md +0 -68
- package/docs/api/classes/ServerDerivedPublicKey.md +0 -33
- package/docs/api/classes/ServerRootKeyPair.md +0 -94
- package/docs/api/classes/ServerRootPublicKey.md +0 -72
- package/docs/api/classes/SignalProtocolBlockingManager.md +0 -106
- package/docs/api/classes/SignalProtocolClient.md +0 -2654
- package/docs/api/classes/VerificationFailure.md +0 -25
- package/docs/api/enumerations/ContentHint.md +0 -63
- package/docs/api/enumerations/EncryptionErrorCode.md +0 -488
- package/docs/api/enumerations/IdentityKeyChange.md +0 -65
- package/docs/api/enumerations/MessageType.md +0 -29
- package/docs/api/enumerations/TrustDirection.md +0 -33
- package/docs/api/enumerations/TypingAction.md +0 -31
- package/docs/api/functions/createDefaultSignalProtocolContentAdapter.md +0 -13
- package/docs/api/functions/createDefaultSignalProtocolLogger.md +0 -36
- package/docs/api/functions/createGroupId.md +0 -32
- package/docs/api/functions/createSignalProtocolClient.md +0 -36
- package/docs/api/functions/createSignalProtocolClientConfig.md +0 -24
- package/docs/api/functions/extractGroupId.md +0 -32
- package/docs/api/functions/formatVersion.md +0 -25
- package/docs/api/functions/isCompatible.md +0 -31
- package/docs/api/functions/isGroupId.md +0 -37
- package/docs/api/functions/isSealedSenderAuthError.md +0 -25
- package/docs/api/functions/parseVersion.md +0 -29
- package/docs/api/functions/resolveSPQRLimits.md +0 -21
- package/docs/api/functions/resolveSignalProtocolLogger.md +0 -42
- package/docs/api/interfaces/AccountIdentityProvisioning.md +0 -43
- package/docs/api/interfaces/AccountIdentityRotation.md +0 -69
- package/docs/api/interfaces/AttachmentTransferOptions.md +0 -49
- package/docs/api/interfaces/BlockedRecipientEntry.md +0 -25
- package/docs/api/interfaces/BlockedRecipientsSyncInput.md +0 -27
- package/docs/api/interfaces/ConfigurationSyncInput.md +0 -19
- package/docs/api/interfaces/CredentialPublicKey.md +0 -25
- package/docs/api/interfaces/DataMessageInput.md +0 -21
- package/docs/api/interfaces/DecryptedEnvelope.md +0 -95
- package/docs/api/interfaces/DecryptedGroup.md +0 -86
- package/docs/api/interfaces/DeviceInfo.md +0 -79
- package/docs/api/interfaces/DeviceRecord.md +0 -87
- package/docs/api/interfaces/DeviceRegistration.md +0 -27
- package/docs/api/interfaces/DoubleRatchetConfig.md +0 -36
- package/docs/api/interfaces/EcOneTimePreKey.md +0 -27
- package/docs/api/interfaces/EcSignedPreKey.md +0 -39
- package/docs/api/interfaces/EcSignedPreKeyUpload.md +0 -50
- package/docs/api/interfaces/EncryptionErrorContext.md +0 -51
- package/docs/api/interfaces/Envelope.md +0 -154
- package/docs/api/interfaces/ForceKeyResetResult.md +0 -37
- package/docs/api/interfaces/GroupAuthorization.md +0 -23
- package/docs/api/interfaces/GroupChangeEntry.md +0 -42
- package/docs/api/interfaces/GroupMemberDevice.md +0 -26
- package/docs/api/interfaces/IEcOneTimePreKeyStore.md +0 -86
- package/docs/api/interfaces/IEcSignedPreKeyStore.md +0 -133
- package/docs/api/interfaces/IGroupServer.md +0 -120
- package/docs/api/interfaces/IGroupStateStore.md +0 -128
- package/docs/api/interfaces/IIdentityKeyStore.md +0 -312
- package/docs/api/interfaces/IKemPreKeyStore.md +0 -144
- package/docs/api/interfaces/IKyberLastResortPreKeyStore.md +0 -112
- package/docs/api/interfaces/ILogger.md +0 -117
- package/docs/api/interfaces/IProtocolStore.md +0 -1033
- package/docs/api/interfaces/ISenderKeyStore.md +0 -417
- package/docs/api/interfaces/ISesameStore.md +0 -249
- package/docs/api/interfaces/ISessionStore.md +0 -178
- package/docs/api/interfaces/ISignalProtocolClient.md +0 -1185
- package/docs/api/interfaces/ISignalProtocolLocalSecretVault.md +0 -71
- package/docs/api/interfaces/ISignalProtocolLocalStore.md +0 -2053
- package/docs/api/interfaces/ISignalProtocolManager.md +0 -272
- package/docs/api/interfaces/ISignalProtocolRelayServer.md +0 -1329
- package/docs/api/interfaces/IdentityKeyPair.md +0 -49
- package/docs/api/interfaces/IncomingEnvelope.md +0 -91
- package/docs/api/interfaces/InspectedSignalProtocolContent.md +0 -43
- package/docs/api/interfaces/KDFChain.md +0 -31
- package/docs/api/interfaces/KemLastResortPreKeyUpload.md +0 -50
- package/docs/api/interfaces/KeyPair.md +0 -23
- package/docs/api/interfaces/KyberPreKey.md +0 -42
- package/docs/api/interfaces/MLKEMBraidAgentState.md +0 -191
- package/docs/api/interfaces/MLKEMBraidMessage.md +0 -49
- package/docs/api/interfaces/MediaAttachmentDeleteSyncInput.md +0 -31
- package/docs/api/interfaces/MessageHeader.md +0 -49
- package/docs/api/interfaces/MessageRecord.md +0 -86
- package/docs/api/interfaces/ParsedReceiptContent.md +0 -19
- package/docs/api/interfaces/ParsedTypingContent.md +0 -19
- package/docs/api/interfaces/PreKeyMaintenanceStore.md +0 -88
- package/docs/api/interfaces/PreKeyMessage.md +0 -159
- package/docs/api/interfaces/PreKeyStatusResult.md +0 -21
- package/docs/api/interfaces/PreKeyUpload.md +0 -42
- package/docs/api/interfaces/ProcessEnvelopeOptions.md +0 -72
- package/docs/api/interfaces/ProtocolAddress.md +0 -38
- package/docs/api/interfaces/ProtocolStrategyConfig.md +0 -91
- package/docs/api/interfaces/RatchetMessage.md +0 -96
- package/docs/api/interfaces/ReadSyncEntryInput.md +0 -19
- package/docs/api/interfaces/ReceiverChain.md +0 -43
- package/docs/api/interfaces/RecipientUsernameSyncInput.md +0 -31
- package/docs/api/interfaces/RelayPreKeyBundle.md +0 -254
- package/docs/api/interfaces/RemoteObjectDownload.md +0 -33
- package/docs/api/interfaces/RemoteObjectUpload.md +0 -49
- package/docs/api/interfaces/ResolvedSPQRInfoStrings.md +0 -27
- package/docs/api/interfaces/ResolvedSPQRLimits.md +0 -37
- package/docs/api/interfaces/RetryRequest.md +0 -80
- package/docs/api/interfaces/SCKAState.md +0 -65
- package/docs/api/interfaces/SPQRLimits.md +0 -40
- package/docs/api/interfaces/SPQRState.md +0 -191
- package/docs/api/interfaces/SafetyNumber.md +0 -60
- package/docs/api/interfaces/SafetyNumberConfirmation.md +0 -46
- package/docs/api/interfaces/SealedSenderConfig.md +0 -70
- package/docs/api/interfaces/SendOptions.md +0 -191
- package/docs/api/interfaces/SendResult.md +0 -93
- package/docs/api/interfaces/SenderKeyDistributionMessage.md +0 -43
- package/docs/api/interfaces/SenderKeyState.md +0 -76
- package/docs/api/interfaces/SenderKeysConfig.md +0 -65
- package/docs/api/interfaces/SentSyncTranscriptInput.md +0 -31
- package/docs/api/interfaces/ServiceId.md +0 -19
- package/docs/api/interfaces/SesameMessage.md +0 -84
- package/docs/api/interfaces/SesameStats.md +0 -57
- package/docs/api/interfaces/SessionHealthResult.md +0 -120
- package/docs/api/interfaces/SessionRecord.md +0 -80
- package/docs/api/interfaces/SessionRecordMetadata.md +0 -109
- package/docs/api/interfaces/SessionState.md +0 -368
- package/docs/api/interfaces/SessionTrustCommit.md +0 -58
- package/docs/api/interfaces/SignalProtocolBlockingHooks.md +0 -44
- package/docs/api/interfaces/SignalProtocolBlockingManagerOptions.md +0 -31
- package/docs/api/interfaces/SignalProtocolBlockingMirror.md +0 -30
- package/docs/api/interfaces/SignalProtocolBlockingStore.md +0 -83
- package/docs/api/interfaces/SignalProtocolClientAdapterConfig.md +0 -44
- package/docs/api/interfaces/SignalProtocolClientCompositionOptions.md +0 -693
- package/docs/api/interfaces/SignalProtocolClientConfig.md +0 -839
- package/docs/api/interfaces/SignalProtocolClientDeleteLocalAttachmentInput.md +0 -25
- package/docs/api/interfaces/SignalProtocolClientHooks.md +0 -506
- package/docs/api/interfaces/SignalProtocolClientIdentityConfig.md +0 -35
- package/docs/api/interfaces/SignalProtocolClientLoadLocalAttachmentInput.md +0 -187
- package/docs/api/interfaces/SignalProtocolClientLoadedLocalAttachment.md +0 -19
- package/docs/api/interfaces/SignalProtocolClientMedia.md +0 -83
- package/docs/api/interfaces/SignalProtocolClientMediaCompletedResult.md +0 -25
- package/docs/api/interfaces/SignalProtocolClientMediaConfig.md +0 -157
- package/docs/api/interfaces/SignalProtocolClientMediaDownloadCompletedResult.md +0 -37
- package/docs/api/interfaces/SignalProtocolClientMediaDownloadNotNeededResult.md +0 -25
- package/docs/api/interfaces/SignalProtocolClientMediaFailedResult.md +0 -19
- package/docs/api/interfaces/SignalProtocolClientMediaOperationOptions.md +0 -53
- package/docs/api/interfaces/SignalProtocolClientMediaPendingResult.md +0 -19
- package/docs/api/interfaces/SignalProtocolClientMediaProcessResult.md +0 -43
- package/docs/api/interfaces/SignalProtocolClientMediaSkippedResult.md +0 -25
- package/docs/api/interfaces/SignalProtocolClientMediaUploadCompletedResult.md +0 -31
- package/docs/api/interfaces/SignalProtocolClientProcessPendingMediaOptions.md +0 -87
- package/docs/api/interfaces/SignalProtocolClientSaveDownloadedAttachmentInput.md +0 -25
- package/docs/api/interfaces/SignalProtocolClientSaveUploadedAttachmentInput.md +0 -25
- package/docs/api/interfaces/SignalProtocolClientSyncDeleteInput.md +0 -19
- package/docs/api/interfaces/SignalProtocolConfig.md +0 -50
- package/docs/api/interfaces/SignalProtocolContentAdapter.md +0 -325
- package/docs/api/interfaces/SignalProtocolRemoteObjectStore.md +0 -88
- package/docs/api/interfaces/SkippedSenderMessageKey.md +0 -26
- package/docs/api/interfaces/TaskNotificationAckSyncInput.md +0 -31
- package/docs/api/interfaces/TripleRatchetState.md +0 -64
- package/docs/api/interfaces/UserRecord.md +0 -71
- package/docs/api/interfaces/UsernameStateSyncInput.md +0 -19
- package/docs/api/interfaces/VerificationStateSyncInput.md +0 -31
- package/docs/api/interfaces/VersionNegotiationState.md +0 -84
- package/docs/api/interfaces/ViewOnceOpenSyncInput.md +0 -19
- package/docs/api/namespaces/ProtocolAddress/README.md +0 -33
- package/docs/api/namespaces/ProtocolAddress/functions/create.md +0 -41
- package/docs/api/namespaces/ProtocolAddress/functions/equals.md +0 -39
- package/docs/api/namespaces/ProtocolAddress/functions/fromStorageKey.md +0 -36
- package/docs/api/namespaces/ProtocolAddress/functions/isUser.md +0 -39
- package/docs/api/namespaces/ProtocolAddress/functions/isValid.md +0 -34
- package/docs/api/namespaces/ProtocolAddress/functions/parse.md +0 -41
- package/docs/api/namespaces/ProtocolAddress/functions/toStorageKey.md +0 -38
- package/docs/api/namespaces/ProtocolAddress/functions/toString.md +0 -34
- package/docs/api/namespaces/SessionRecord/README.md +0 -30
- package/docs/api/namespaces/SessionRecord/functions/archiveCurrent.md +0 -40
- package/docs/api/namespaces/SessionRecord/functions/archiveCurrentState.md +0 -34
- package/docs/api/namespaces/SessionRecord/functions/create.md +0 -25
- package/docs/api/namespaces/SessionRecord/functions/deserialize.md +0 -29
- package/docs/api/namespaces/SessionRecord/functions/findSession.md +0 -34
- package/docs/api/namespaces/SessionRecord/functions/getAllSessions.md +0 -25
- package/docs/api/namespaces/SessionRecord/functions/getArchivedCount.md +0 -25
- package/docs/api/namespaces/SessionRecord/functions/hasCurrentSession.md +0 -25
- package/docs/api/namespaces/SessionRecord/functions/hasUsableSenderChain.md +0 -36
- package/docs/api/namespaces/SessionRecord/functions/promoteSession.md +0 -34
- package/docs/api/namespaces/SessionRecord/functions/serialize.md +0 -28
- package/docs/api/namespaces/SessionRecord/variables/MAX_ARCHIVED_SESSIONS.md +0 -14
- package/docs/api/namespaces/SessionState/README.md +0 -15
- package/docs/api/namespaces/SessionState/functions/getSessionId.md +0 -32
- package/docs/api/namespaces/blocking/README.md +0 -43
- package/docs/api/namespaces/encoding/README.md +0 -33
- package/docs/api/namespaces/encoding/functions/base64ToUrlSafe.md +0 -28
- package/docs/api/namespaces/encoding/functions/bytesToBase64.md +0 -21
- package/docs/api/namespaces/encoding/functions/bytesToString.md +0 -21
- package/docs/api/namespaces/encoding/functions/bytesToUrlSafeBase64.md +0 -33
- package/docs/api/namespaces/encoding/functions/concatBytes.md +0 -21
- package/docs/api/namespaces/encoding/functions/stringToBytes.md +0 -21
- package/docs/api/namespaces/encoding/functions/urlSafeToBase64.md +0 -27
- package/docs/api/namespaces/keys/README.md +0 -130
- package/docs/api/namespaces/keys/functions/acceptContactIdentityRotation.md +0 -33
- package/docs/api/namespaces/keys/functions/assertIdentityCommitment.md +0 -25
- package/docs/api/namespaces/keys/functions/canonicalizeDeviceIdentityKey.md +0 -30
- package/docs/api/namespaces/keys/functions/compareDeviceIdentityKeys.md +0 -28
- package/docs/api/namespaces/keys/functions/compositeIdentitiesEqual.md +0 -23
- package/docs/api/namespaces/keys/functions/createCompositeIdentityV1.md +0 -19
- package/docs/api/namespaces/keys/functions/createPreKeySignatureContext.md +0 -31
- package/docs/api/namespaces/keys/functions/createUnverifiedContactIdentityRecord.md +0 -23
- package/docs/api/namespaces/keys/functions/decodeCompositeIdentityV1.md +0 -19
- package/docs/api/namespaces/keys/functions/deriveIdentityCommitment.md +0 -19
- package/docs/api/namespaces/keys/functions/encodeCompositeIdentityV1.md +0 -19
- package/docs/api/namespaces/keys/functions/evaluateContactIdentityCandidate.md +0 -27
- package/docs/api/namespaces/keys/functions/generateEcOneTimePreKeys.md +0 -37
- package/docs/api/namespaces/keys/functions/generateEcSignedPreKey.md +0 -39
- package/docs/api/namespaces/keys/functions/generateEcSignedPreKeyId.md +0 -21
- package/docs/api/namespaces/keys/functions/generateIdentityKeyPair.md +0 -24
- package/docs/api/namespaces/keys/functions/generateKemOneTimePreKeys.md +0 -47
- package/docs/api/namespaces/keys/functions/generateKyberLastResortPreKey.md +0 -37
- package/docs/api/namespaces/keys/functions/generateRegistrationId.md +0 -13
- package/docs/api/namespaces/keys/functions/isValidDeviceIdentityKey.md +0 -22
- package/docs/api/namespaces/keys/functions/signMlKem1024PreKey.md +0 -29
- package/docs/api/namespaces/keys/functions/signPreKey.md +0 -31
- package/docs/api/namespaces/keys/functions/validateContactIdentityRecord.md +0 -19
- package/docs/api/namespaces/keys/functions/verifyContactIdentityRecord.md +0 -31
- package/docs/api/namespaces/keys/functions/verifyMlKem1024PreKey.md +0 -33
- package/docs/api/namespaces/keys/functions/verifyPreKeySignature.md +0 -35
- package/docs/api/namespaces/keys/interfaces/CompositeIdentityV1.md +0 -33
- package/docs/api/namespaces/keys/interfaces/ContactIdentityRecord.md +0 -53
- package/docs/api/namespaces/keys/interfaces/KemOneTimePreKey.md +0 -43
- package/docs/api/namespaces/keys/type-aliases/IdentityCandidateStatus.md +0 -9
- package/docs/api/namespaces/keys/type-aliases/IdentityTrustState.md +0 -9
- package/docs/api/namespaces/keys/type-aliases/IdentityType.md +0 -9
- package/docs/api/namespaces/keys/variables/COMPOSITE_IDENTITY_V1_ED25519_TAG.md +0 -9
- package/docs/api/namespaces/keys/variables/COMPOSITE_IDENTITY_V1_LENGTH.md +0 -9
- package/docs/api/namespaces/keys/variables/COMPOSITE_IDENTITY_V1_VERSION.md +0 -9
- package/docs/api/namespaces/keys/variables/COMPOSITE_IDENTITY_V1_X25519_TAG.md +0 -9
- package/docs/api/namespaces/keys/variables/IDENTITY_COMMITMENT_V1_DOMAIN.md +0 -9
- package/docs/api/namespaces/keys/variables/PREKEY_ALGORITHM_ML_KEM_1024.md +0 -9
- package/docs/api/namespaces/keys/variables/PREKEY_ALGORITHM_X25519.md +0 -9
- package/docs/api/namespaces/keys/variables/PREKEY_SIGNATURE_V1_DOMAIN.md +0 -9
- package/docs/api/namespaces/keys/variables/UNPINNED_DEVICE_IDENTITY_KEY.md +0 -18
- package/docs/api/namespaces/media/README.md +0 -105
- package/docs/api/namespaces/media/classes/MediaAttachmentError.md +0 -57
- package/docs/api/namespaces/media/functions/createByteRangeMediaAttachmentTransfer.md +0 -19
- package/docs/api/namespaces/media/functions/createMediaAttachmentDeliveryId.md +0 -29
- package/docs/api/namespaces/media/functions/createMediaAttachmentId.md +0 -19
- package/docs/api/namespaces/media/functions/createMediaAttachmentMessage.md +0 -25
- package/docs/api/namespaces/media/functions/createMediaAttachmentPointer.md +0 -19
- package/docs/api/namespaces/media/functions/createTusMediaAttachmentTransfer.md +0 -19
- package/docs/api/namespaces/media/functions/deleteMediaAttachment.md +0 -23
- package/docs/api/namespaces/media/functions/executeMediaAttachmentJob.md +0 -23
- package/docs/api/namespaces/media/functions/isMediaAttachmentFlagSet.md +0 -19
- package/docs/api/namespaces/media/functions/parseMediaAttachmentMessage.md +0 -19
- package/docs/api/namespaces/media/functions/planMediaAttachmentCleanup.md +0 -23
- package/docs/api/namespaces/media/functions/planMediaAttachmentCleanupJobs.md +0 -19
- package/docs/api/namespaces/media/functions/planMediaAttachmentDeleteSync.md +0 -19
- package/docs/api/namespaces/media/functions/planMediaAttachmentDownloadJob.md +0 -19
- package/docs/api/namespaces/media/functions/planMediaAttachmentOpen.md +0 -19
- package/docs/api/namespaces/media/functions/planMediaAttachmentProcessing.md +0 -19
- package/docs/api/namespaces/media/functions/planMediaAttachmentUploadJob.md +0 -19
- package/docs/api/namespaces/media/functions/prepareMediaAttachmentUpload.md +0 -30
- package/docs/api/namespaces/media/functions/resolveMediaAttachment.md +0 -30
- package/docs/api/namespaces/media/functions/serializeMediaAttachmentMessage.md +0 -25
- package/docs/api/namespaces/media/functions/validateMediaAttachmentPolicy.md +0 -23
- package/docs/api/namespaces/media/interfaces/ByteRangeMediaAttachmentPartialStore.md +0 -68
- package/docs/api/namespaces/media/interfaces/ByteRangeMediaAttachmentTransferOptions.md +0 -91
- package/docs/api/namespaces/media/interfaces/DeleteMediaAttachmentOptions.md +0 -25
- package/docs/api/namespaces/media/interfaces/DeleteMediaAttachmentResult.md +0 -19
- package/docs/api/namespaces/media/interfaces/ExecuteMediaAttachmentJobOptions.md +0 -157
- package/docs/api/namespaces/media/interfaces/MediaAttachmentBackgroundJob.md +0 -85
- package/docs/api/namespaces/media/interfaces/MediaAttachmentCleanupPlan.md +0 -37
- package/docs/api/namespaces/media/interfaces/MediaAttachmentJobExecutionResult.md +0 -55
- package/docs/api/namespaces/media/interfaces/MediaAttachmentMessage.md +0 -31
- package/docs/api/namespaces/media/interfaces/MediaAttachmentOpenDecision.md +0 -31
- package/docs/api/namespaces/media/interfaces/MediaAttachmentPointer.md +0 -133
- package/docs/api/namespaces/media/interfaces/MediaAttachmentPolicy.md +0 -67
- package/docs/api/namespaces/media/interfaces/MediaAttachmentProcessingPlan.md +0 -73
- package/docs/api/namespaces/media/interfaces/MediaAttachmentProgress.md +0 -69
- package/docs/api/namespaces/media/interfaces/MediaAttachmentResumeState.md +0 -37
- package/docs/api/namespaces/media/interfaces/MediaAttachmentRetryOptions.md +0 -31
- package/docs/api/namespaces/media/interfaces/MediaAttachmentTransfer.md +0 -51
- package/docs/api/namespaces/media/interfaces/MediaAttachmentTransferCheckpoint.md +0 -69
- package/docs/api/namespaces/media/interfaces/MediaAttachmentTransferOptions.md +0 -67
- package/docs/api/namespaces/media/interfaces/MediaAttachmentUploadJobData.md +0 -19
- package/docs/api/namespaces/media/interfaces/MediaAttachmentUploadResponse.md +0 -25
- package/docs/api/namespaces/media/interfaces/PlanMediaAttachmentCleanupJobsInput.md +0 -61
- package/docs/api/namespaces/media/interfaces/PlanMediaAttachmentDeleteSyncInput.md +0 -25
- package/docs/api/namespaces/media/interfaces/PlanMediaAttachmentDownloadJobInput.md +0 -161
- package/docs/api/namespaces/media/interfaces/PlanMediaAttachmentOpenInput.md +0 -25
- package/docs/api/namespaces/media/interfaces/PlanMediaAttachmentProcessingInput.md +0 -83
- package/docs/api/namespaces/media/interfaces/PlanMediaAttachmentUploadJobInput.md +0 -147
- package/docs/api/namespaces/media/interfaces/PrepareMediaAttachmentUploadOptions.md +0 -144
- package/docs/api/namespaces/media/interfaces/ResolveMediaAttachmentOptions.md +0 -55
- package/docs/api/namespaces/media/interfaces/ResolvedMediaAttachment.md +0 -109
- package/docs/api/namespaces/media/interfaces/TusMediaAttachmentTransferOptions.md +0 -85
- package/docs/api/namespaces/media/type-aliases/CreateMediaAttachmentPointerInput.md +0 -15
- package/docs/api/namespaces/media/type-aliases/MediaAttachmentCheckpointCallback.md +0 -19
- package/docs/api/namespaces/media/type-aliases/MediaAttachmentCleanupReason.md +0 -9
- package/docs/api/namespaces/media/type-aliases/MediaAttachmentErrorCode.md +0 -9
- package/docs/api/namespaces/media/type-aliases/MediaAttachmentFlag.md +0 -9
- package/docs/api/namespaces/media/type-aliases/MediaAttachmentJobExecutionStatus.md +0 -9
- package/docs/api/namespaces/media/type-aliases/MediaAttachmentJobOperation.md +0 -9
- package/docs/api/namespaces/media/type-aliases/MediaAttachmentJobPriority.md +0 -9
- package/docs/api/namespaces/media/type-aliases/MediaAttachmentJobSkipReason.md +0 -9
- package/docs/api/namespaces/media/type-aliases/MediaAttachmentJobSource.md +0 -9
- package/docs/api/namespaces/media/type-aliases/MediaAttachmentKnownIds.md +0 -9
- package/docs/api/namespaces/media/type-aliases/MediaAttachmentMessageType.md +0 -9
- package/docs/api/namespaces/media/type-aliases/MediaAttachmentProgressCallback.md +0 -19
- package/docs/api/namespaces/media/variables/MEDIA_ATTACHMENT_POLICY_DEFAULTS.md +0 -47
- package/docs/api/namespaces/media/variables/MEDIA_ATTACHMENT_POLICY_PRESETS.md +0 -95
- package/docs/api/namespaces/media/variables/MediaAttachmentCleanupReason.md +0 -27
- package/docs/api/namespaces/media/variables/MediaAttachmentErrorCode.md +0 -75
- package/docs/api/namespaces/media/variables/MediaAttachmentFlag.md +0 -23
- package/docs/api/namespaces/media/variables/MediaAttachmentJobExecutionStatus.md +0 -19
- package/docs/api/namespaces/media/variables/MediaAttachmentJobOperation.md +0 -31
- package/docs/api/namespaces/media/variables/MediaAttachmentJobPriority.md +0 -23
- package/docs/api/namespaces/media/variables/MediaAttachmentJobSource.md +0 -51
- package/docs/api/namespaces/media/variables/MediaAttachmentMessageType.md +0 -15
- package/docs/api/namespaces/media/variables/downloadMediaAttachment.md +0 -30
- package/docs/api/namespaces/safety/README.md +0 -61
- package/docs/api/namespaces/safety/classes/DisplayableFingerprint.md +0 -108
- package/docs/api/namespaces/safety/classes/Fingerprint.md +0 -104
- package/docs/api/namespaces/safety/classes/ScannableFingerprint.md +0 -209
- package/docs/api/namespaces/safety/functions/base64ToBytes.md +0 -21
- package/docs/api/namespaces/safety/functions/clearFingerprintCache.md +0 -15
- package/docs/api/namespaces/safety/functions/compareSafetyNumbers.md +0 -25
- package/docs/api/namespaces/safety/functions/createFingerprintData.md +0 -60
- package/docs/api/namespaces/safety/functions/extractQrData.md +0 -34
- package/docs/api/namespaces/safety/functions/generateCompositeSafetyNumber.md +0 -39
- package/docs/api/namespaces/safety/functions/generateEmojiFingerprint.md +0 -24
- package/docs/api/namespaces/safety/functions/generateSingleKeyReferenceSafetyNumber.md +0 -51
- package/docs/api/namespaces/safety/functions/generateVerifySchemeUrl.md +0 -32
- package/docs/api/namespaces/safety/functions/generateVerifyUrl.md +0 -49
- package/docs/api/namespaces/safety/functions/isValidSafetyNumber.md +0 -21
- package/docs/api/namespaces/safety/functions/isVerifyUrl.md +0 -45
- package/docs/api/namespaces/safety/functions/parseVerifyUrl.md +0 -31
- package/docs/api/namespaces/safety/interfaces/FingerprintData.md +0 -52
- package/docs/api/namespaces/safety/interfaces/SafetyNumber.md +0 -49
- package/docs/api/namespaces/safety/interfaces/VerifyLinkConfig.md +0 -28
- package/docs/api/namespaces/safety/interfaces/VerifyUrlParams.md +0 -49
- package/docs/api/namespaces/safety/type-aliases/CompareResult.md +0 -21
- package/docs/api/namespaces/safety/variables/DEFAULT_VERIFY_LINK_CONFIG.md +0 -12
- package/docs/api/namespaces/safety/variables/FINGERPRINT_ITERATIONS.md +0 -12
- package/docs/api/namespaces/safety/variables/FINGERPRINT_VERSION.md +0 -12
- package/docs/api/namespaces/safety/variables/VERIFY_BASE_URL.md +0 -11
- package/docs/api/namespaces/safety/variables/VERIFY_SCHEME_URL.md +0 -11
- package/docs/api/type-aliases/Base64.md +0 -20
- package/docs/api/type-aliases/BraidPolicy.md +0 -11
- package/docs/api/type-aliases/Bytes.md +0 -20
- package/docs/api/type-aliases/Ciphertext.md +0 -21
- package/docs/api/type-aliases/DeviceType.md +0 -11
- package/docs/api/type-aliases/DownloadedAttachment.md +0 -11
- package/docs/api/type-aliases/GroupId.md +0 -27
- package/docs/api/type-aliases/Hex.md +0 -20
- package/docs/api/type-aliases/HookName.md +0 -11
- package/docs/api/type-aliases/PostQuantumPolicy.md +0 -11
- package/docs/api/type-aliases/PreparedAttachmentUpload.md +0 -14
- package/docs/api/type-aliases/PrivateKey.md +0 -22
- package/docs/api/type-aliases/ProgressCallback.md +0 -45
- package/docs/api/type-aliases/PublicKey.md +0 -22
- package/docs/api/type-aliases/RemoteObjectCompleteUploadRequest.md +0 -19
- package/docs/api/type-aliases/RemoteObjectDeleteRequest.md +0 -19
- package/docs/api/type-aliases/RemoteObjectDownloadRequest.md +0 -19
- package/docs/api/type-aliases/RemoteObjectUploadRequest.md +0 -42
- package/docs/api/type-aliases/SCKAMode.md +0 -11
- package/docs/api/type-aliases/SealedSenderAuth.md +0 -15
- package/docs/api/type-aliases/SignalProtocolClientMediaCleanupInput.md +0 -9
- package/docs/api/type-aliases/SignalProtocolClientMediaCleanupResult.md +0 -9
- package/docs/api/type-aliases/SignalProtocolClientMediaDownloadInput.md +0 -9
- package/docs/api/type-aliases/SignalProtocolClientMediaDownloadResult.md +0 -9
- package/docs/api/type-aliases/SignalProtocolClientMediaOperationResult.md +0 -9
- package/docs/api/type-aliases/SignalProtocolClientMediaUploadInput.md +0 -9
- package/docs/api/type-aliases/SignalProtocolClientMediaUploadResult.md +0 -9
- package/docs/api/type-aliases/Signature.md +0 -21
- package/docs/api/type-aliases/Unsubscribe.md +0 -15
- package/docs/api/variables/BraidPolicy.md +0 -21
- package/docs/api/variables/DEFAULT_DEVICE_ID.md +0 -12
- package/docs/api/variables/DOUBLE_RATCHET_SPEC.md +0 -11
- package/docs/api/variables/GROUP_V2_PREFIX.md +0 -11
- package/docs/api/variables/KEY_REFRESH_INTERVAL_MS_DEFAULT.md +0 -11
- package/docs/api/variables/MAX_MESSAGE_KEYS.md +0 -14
- package/docs/api/variables/MAX_PREKEY_AGE_MS_DEFAULT.md +0 -11
- package/docs/api/variables/MAX_RECEIVER_CHAINS.md +0 -14
- package/docs/api/variables/MAX_REGISTRATION_ID.md +0 -16
- package/docs/api/variables/MAX_SKIP.md +0 -11
- package/docs/api/variables/MESSAGE_FORMAT.md +0 -11
- package/docs/api/variables/MIN_REGISTRATION_ID.md +0 -16
- package/docs/api/variables/ML_KEM_BRAID_SPEC.md +0 -11
- package/docs/api/variables/ONE_TIME_PREKEY_BATCH_SIZE.md +0 -21
- package/docs/api/variables/PQXDH_SPEC.md +0 -11
- package/docs/api/variables/PostQuantumPolicy.md +0 -21
- package/docs/api/variables/SENDER_KEY_FORMAT.md +0 -11
- package/docs/api/variables/SENDER_KEY_SPEC.md +0 -11
- package/docs/api/variables/SESAME_SPEC.md +0 -11
- package/docs/api/variables/SESSION_FORMAT.md +0 -11
- package/docs/api/variables/SPQR_LIMITS_DEFAULTS.md +0 -11
- package/docs/api/variables/X3DH_SPEC.md +0 -9
- package/docs/api/variables/defaultSignalProtocolLogger.md +0 -32
- /package/dist/internal/{groups-v2 → groups}/invite-link.d.ts +0 -0
- /package/dist/internal/{groups-v2 → groups}/invite-link.js +0 -0
|
@@ -0,0 +1,1186 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Shared enforcing engine for the group-server contract.
|
|
3
|
+
*
|
|
4
|
+
* The engine operates only on encrypted group state. Storage adapters hydrate
|
|
5
|
+
* one group into the engine, execute an operation, and persist the resulting
|
|
6
|
+
* canonical state, signed log, and versioned snapshots atomically.
|
|
7
|
+
*/
|
|
8
|
+
import { AccessRequired, EnabledState, MemberRole, } from './types.js';
|
|
9
|
+
import { assertEncryptedGroupChangeForm, assertRecognizedEncryptedGroupChange, assertValidEncryptedGroupChangeWire, assertValidEncryptedGroupCreationSubmissionWire, assertValidEncryptedGroupWire, deserializeEncryptedGroupCreationSubmission, deserializeEncryptedGroup, deserializeEncryptedGroupChange, serializeEncryptedGroup, serializeEncryptedGroupChange, serializeEncryptedGroupJoinInfo, serializeGroupBaseline, serializeGroupChangeCommitment, requiredGroupChangeEpoch, } from './wire.js';
|
|
10
|
+
import { GroupAction, canRolePerformAction, isInviteLinkAccessRequirement, isRoleAccessRequirement, isStoredMemberRole, } from './access-control.js';
|
|
11
|
+
import { constantTimeEqual } from '../crypto/utils.js';
|
|
12
|
+
import { deserializeAuthCredentialPresentation, deserializeGroupPublicParams, serializeGroupPublicParams, verifyAuthCredentialPresentation, } from '../protocol/zk/groups/auth-credential.js';
|
|
13
|
+
import { SERVICE_ID_ACI, SERVICE_ID_PNI, } from '../protocol/zk/groups/uid-struct.js';
|
|
14
|
+
import { SECONDS_PER_DAY } from '../protocol/zk/groups/group-params.js';
|
|
15
|
+
import { getServerPublicParams, serverSign, } from '../protocol/zk/groups/server-params.js';
|
|
16
|
+
import { deserializeProfileKeyCredentialPresentation, verifyProfileKeyCredentialPresentation, } from '../protocol/zk/groups/profile-key-credential.js';
|
|
17
|
+
import { RistrettoPoint } from '../protocol/zk/proofs/sho.js';
|
|
18
|
+
const MAX_GROUP_SIZE = 1000;
|
|
19
|
+
const INVITE_LINK_PASSWORD_LENGTH = 16;
|
|
20
|
+
const defaultRuntime = {
|
|
21
|
+
now: () => Date.now(),
|
|
22
|
+
randomBytes: (length) => crypto.getRandomValues(new Uint8Array(length)),
|
|
23
|
+
};
|
|
24
|
+
class GroupServerError extends Error {
|
|
25
|
+
data;
|
|
26
|
+
constructor(code, status, message, reason) {
|
|
27
|
+
super(`${code}: ${message}`);
|
|
28
|
+
this.name = 'GroupServerError';
|
|
29
|
+
this.data = reason === undefined ? { code, status } : { code, status, reason };
|
|
30
|
+
}
|
|
31
|
+
}
|
|
32
|
+
function rejectBadRequest(message) {
|
|
33
|
+
throw new GroupServerError('INVALID_REQUEST', 400, message);
|
|
34
|
+
}
|
|
35
|
+
function rejectUnauthorized(message) {
|
|
36
|
+
throw new GroupServerError('UNAUTHORIZED', 403, message);
|
|
37
|
+
}
|
|
38
|
+
function rejectForbidden(message, reason) {
|
|
39
|
+
throw new GroupServerError('FORBIDDEN', 403, message, reason);
|
|
40
|
+
}
|
|
41
|
+
function rejectConflict(message) {
|
|
42
|
+
throw new GroupServerError('VERSION_CONFLICT', 409, message);
|
|
43
|
+
}
|
|
44
|
+
function equal(a, b) {
|
|
45
|
+
return constantTimeEqual(a, b);
|
|
46
|
+
}
|
|
47
|
+
function requireCiphertextEncoding(value, label, kind) {
|
|
48
|
+
if (!(value instanceof Uint8Array) || value.length !== 65) {
|
|
49
|
+
rejectBadRequest(`${label} must be a 65-byte ciphertext`);
|
|
50
|
+
}
|
|
51
|
+
if (kind === 'aci' && value[0] !== SERVICE_ID_ACI) {
|
|
52
|
+
rejectBadRequest(`${label} must carry an ACI ciphertext`);
|
|
53
|
+
}
|
|
54
|
+
if (kind === 'service-id' &&
|
|
55
|
+
value[0] !== SERVICE_ID_ACI &&
|
|
56
|
+
value[0] !== SERVICE_ID_PNI) {
|
|
57
|
+
rejectBadRequest(`${label} must carry an ACI or PNI ciphertext`);
|
|
58
|
+
}
|
|
59
|
+
if (kind === 'profile-key' && value[0] !== 0) {
|
|
60
|
+
rejectBadRequest(`${label} has an invalid reserved byte`);
|
|
61
|
+
}
|
|
62
|
+
try {
|
|
63
|
+
RistrettoPoint.fromBytes(value.slice(1, 33));
|
|
64
|
+
RistrettoPoint.fromBytes(value.slice(33, 65));
|
|
65
|
+
}
|
|
66
|
+
catch {
|
|
67
|
+
rejectBadRequest(`${label} contains an invalid Ristretto ciphertext point`);
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
function requireBlobEncoding(value, label, allowEmpty = true) {
|
|
71
|
+
if (!(value instanceof Uint8Array)) {
|
|
72
|
+
rejectBadRequest(`${label} must be ciphertext bytes`);
|
|
73
|
+
}
|
|
74
|
+
if (allowEmpty && value.length === 0)
|
|
75
|
+
return;
|
|
76
|
+
if (value.length < 65 ||
|
|
77
|
+
(value.length - 65) % 32 !== 0 ||
|
|
78
|
+
value[value.length - 1] !== 0) {
|
|
79
|
+
rejectBadRequest(`${label} has an invalid encrypted-blob envelope`);
|
|
80
|
+
}
|
|
81
|
+
}
|
|
82
|
+
function serializePresentationCiphertext(kind, ciphertext) {
|
|
83
|
+
const result = new Uint8Array(65);
|
|
84
|
+
result[0] = kind;
|
|
85
|
+
result.set(ciphertext.E_A1.toBytes(), 1);
|
|
86
|
+
result.set(ciphertext.E_A2.toBytes(), 33);
|
|
87
|
+
return result;
|
|
88
|
+
}
|
|
89
|
+
function serializeProfileKeyPresentationCiphertext(ciphertext) {
|
|
90
|
+
const result = new Uint8Array(65);
|
|
91
|
+
result[0] = 0;
|
|
92
|
+
result.set(ciphertext.E_A1.toBytes(), 1);
|
|
93
|
+
result.set(ciphertext.E_A2.toBytes(), 33);
|
|
94
|
+
return result;
|
|
95
|
+
}
|
|
96
|
+
function verifyProfileKeyPresentation(serverSecretParams, groupPublicParams, aciCiphertext, profileKeyCiphertext, presentationBytes, nowSeconds) {
|
|
97
|
+
if (presentationBytes.length === 0) {
|
|
98
|
+
rejectForbidden('Profile-key credential presentation is required');
|
|
99
|
+
}
|
|
100
|
+
try {
|
|
101
|
+
const presentation = deserializeProfileKeyCredentialPresentation(presentationBytes);
|
|
102
|
+
verifyProfileKeyCredentialPresentation(serverSecretParams.profileKeyCredentialKeyPair, groupPublicParams, presentation, nowSeconds);
|
|
103
|
+
if (!equal(aciCiphertext, serializePresentationCiphertext(SERVICE_ID_ACI, presentation.uidEncCiphertext)) ||
|
|
104
|
+
!equal(profileKeyCiphertext, serializeProfileKeyPresentationCiphertext(presentation.profileKeyEncCiphertext))) {
|
|
105
|
+
rejectForbidden('Profile-key presentation does not bind the submitted member');
|
|
106
|
+
}
|
|
107
|
+
}
|
|
108
|
+
catch (error) {
|
|
109
|
+
if (error instanceof GroupServerError)
|
|
110
|
+
throw error;
|
|
111
|
+
rejectForbidden('Profile-key credential presentation verification failed');
|
|
112
|
+
}
|
|
113
|
+
}
|
|
114
|
+
function stripStateProfileKeyPresentations(state) {
|
|
115
|
+
const stripped = structuredClone(state);
|
|
116
|
+
for (const member of stripped.members) {
|
|
117
|
+
member.presentation = new Uint8Array(0);
|
|
118
|
+
}
|
|
119
|
+
for (const member of stripped.membersPendingAdminApproval) {
|
|
120
|
+
member.presentation = new Uint8Array(0);
|
|
121
|
+
}
|
|
122
|
+
return stripped;
|
|
123
|
+
}
|
|
124
|
+
function stripChangeProfileKeyPresentations(change) {
|
|
125
|
+
const stripped = structuredClone(change);
|
|
126
|
+
for (const members of [
|
|
127
|
+
stripped.newMembers,
|
|
128
|
+
stripped.modifiedProfileKeys,
|
|
129
|
+
stripped.promotePendingMembers,
|
|
130
|
+
stripped.promotePendingPniAciMembers,
|
|
131
|
+
]) {
|
|
132
|
+
for (const member of members) {
|
|
133
|
+
member.presentation = new Uint8Array(0);
|
|
134
|
+
}
|
|
135
|
+
}
|
|
136
|
+
for (const member of stripped.newRequestingMembers) {
|
|
137
|
+
member.presentation = new Uint8Array(0);
|
|
138
|
+
}
|
|
139
|
+
return stripped;
|
|
140
|
+
}
|
|
141
|
+
function verifyStateProfileKeyPresentations(state, serverSecretParams, nowSeconds) {
|
|
142
|
+
const groupPublicParams = deserializeGroupPublicParams(state.publicKey);
|
|
143
|
+
for (const member of state.members) {
|
|
144
|
+
verifyProfileKeyPresentation(serverSecretParams, groupPublicParams, member.userId, member.profileKey, member.presentation, nowSeconds);
|
|
145
|
+
}
|
|
146
|
+
for (const member of state.membersPendingAdminApproval) {
|
|
147
|
+
verifyProfileKeyPresentation(serverSecretParams, groupPublicParams, member.userId, member.profileKey, member.presentation, nowSeconds);
|
|
148
|
+
}
|
|
149
|
+
}
|
|
150
|
+
function verifyChangeProfileKeyPresentations(state, change, serverSecretParams, nowSeconds) {
|
|
151
|
+
const groupPublicParams = deserializeGroupPublicParams(state.publicKey);
|
|
152
|
+
const members = [
|
|
153
|
+
...change.newMembers,
|
|
154
|
+
...change.modifiedProfileKeys,
|
|
155
|
+
...change.promotePendingMembers,
|
|
156
|
+
...change.promotePendingPniAciMembers,
|
|
157
|
+
];
|
|
158
|
+
for (const member of members) {
|
|
159
|
+
verifyProfileKeyPresentation(serverSecretParams, groupPublicParams, member.aciCiphertext, member.profileKeyCiphertext, member.presentation, nowSeconds);
|
|
160
|
+
}
|
|
161
|
+
for (const member of change.newRequestingMembers) {
|
|
162
|
+
verifyProfileKeyPresentation(serverSecretParams, groupPublicParams, member.aciCiphertext, member.profileKeyCiphertext, member.presentation, nowSeconds);
|
|
163
|
+
}
|
|
164
|
+
}
|
|
165
|
+
function memberFromAction(action, role, joinedAtVersion) {
|
|
166
|
+
return {
|
|
167
|
+
userId: action.aciCiphertext,
|
|
168
|
+
role,
|
|
169
|
+
profileKey: action.profileKeyCiphertext,
|
|
170
|
+
presentation: action.presentation,
|
|
171
|
+
joinedAtVersion,
|
|
172
|
+
labelEmoji: new Uint8Array(0),
|
|
173
|
+
labelString: new Uint8Array(0),
|
|
174
|
+
};
|
|
175
|
+
}
|
|
176
|
+
function validTimestamp(value) {
|
|
177
|
+
return Number.isSafeInteger(value) && value >= 0;
|
|
178
|
+
}
|
|
179
|
+
function assertRecognizedActionShape(change, form) {
|
|
180
|
+
try {
|
|
181
|
+
assertValidEncryptedGroupChangeWire(change, form);
|
|
182
|
+
assertRecognizedEncryptedGroupChange(change);
|
|
183
|
+
assertEncryptedGroupChangeForm(change, form);
|
|
184
|
+
}
|
|
185
|
+
catch (error) {
|
|
186
|
+
rejectBadRequest(error instanceof Error ? error.message : 'Actions are malformed');
|
|
187
|
+
}
|
|
188
|
+
if (!Number.isSafeInteger(change.revision) || change.revision < 1) {
|
|
189
|
+
rejectBadRequest('Actions revision must be a positive safe integer');
|
|
190
|
+
}
|
|
191
|
+
if (change.terminate !== undefined && change.terminate !== true) {
|
|
192
|
+
rejectBadRequest('Termination action must be true');
|
|
193
|
+
}
|
|
194
|
+
const requireProfileKeyAction = (member, label) => {
|
|
195
|
+
requireCiphertextEncoding(member.aciCiphertext, `${label}.aciCiphertext`, 'aci');
|
|
196
|
+
requireCiphertextEncoding(member.profileKeyCiphertext, `${label}.profileKeyCiphertext`, 'profile-key');
|
|
197
|
+
if (!(member.presentation instanceof Uint8Array)) {
|
|
198
|
+
rejectBadRequest(`${label}.presentation must be bytes`);
|
|
199
|
+
}
|
|
200
|
+
};
|
|
201
|
+
for (const [index, member] of change.newMembers.entries()) {
|
|
202
|
+
requireProfileKeyAction(member, `Actions.newMembers[${index}]`);
|
|
203
|
+
if (!isStoredMemberRole(member.role)) {
|
|
204
|
+
rejectBadRequest(`Actions.newMembers[${index}].role is invalid`);
|
|
205
|
+
}
|
|
206
|
+
if (form === 'canonical' && member.joinedAtRevision !== change.revision) {
|
|
207
|
+
rejectBadRequest(`Actions.newMembers[${index}].joinedAtRevision must equal the change revision`);
|
|
208
|
+
}
|
|
209
|
+
}
|
|
210
|
+
for (const [index, member] of change.modifiedProfileKeys.entries()) {
|
|
211
|
+
requireProfileKeyAction(member, `Actions.modifiedProfileKeys[${index}]`);
|
|
212
|
+
}
|
|
213
|
+
for (const [index, member] of change.promotePendingMembers.entries()) {
|
|
214
|
+
requireProfileKeyAction(member, `Actions.promotePendingMembers[${index}]`);
|
|
215
|
+
if (form === 'canonical' &&
|
|
216
|
+
(!isStoredMemberRole(member.role) ||
|
|
217
|
+
member.joinedAtRevision !== change.revision)) {
|
|
218
|
+
rejectBadRequest(`Actions.promotePendingMembers[${index}] has invalid derived role or joinedAtRevision`);
|
|
219
|
+
}
|
|
220
|
+
}
|
|
221
|
+
for (const [index, member] of change.promotePendingPniAciMembers.entries()) {
|
|
222
|
+
requireProfileKeyAction(member, `Actions.promotePendingPniAciMembers[${index}]`);
|
|
223
|
+
if (form === 'canonical' &&
|
|
224
|
+
(!isStoredMemberRole(member.role) ||
|
|
225
|
+
member.joinedAtRevision !== change.revision)) {
|
|
226
|
+
rejectBadRequest(`Actions.promotePendingPniAciMembers[${index}] has invalid derived role or joinedAtRevision`);
|
|
227
|
+
}
|
|
228
|
+
if (member.pniCiphertext.length !== 65) {
|
|
229
|
+
rejectBadRequest(`Actions.promotePendingPniAciMembers[${index}].pniCiphertext is required`);
|
|
230
|
+
}
|
|
231
|
+
}
|
|
232
|
+
for (const [index, ciphertext] of change.deleteMembers.entries()) {
|
|
233
|
+
requireCiphertextEncoding(ciphertext, `Actions.deleteMembers[${index}]`, 'aci');
|
|
234
|
+
}
|
|
235
|
+
for (const [index, member] of change.modifyMemberRoles.entries()) {
|
|
236
|
+
requireCiphertextEncoding(member.aciCiphertext, `Actions.modifyMemberRoles[${index}].aciCiphertext`, 'aci');
|
|
237
|
+
if (!isStoredMemberRole(member.role)) {
|
|
238
|
+
rejectBadRequest(`Actions.modifyMemberRoles[${index}].role is invalid`);
|
|
239
|
+
}
|
|
240
|
+
}
|
|
241
|
+
for (const [index, member] of change.modifyMemberLabels.entries()) {
|
|
242
|
+
requireCiphertextEncoding(member.aciCiphertext, `Actions.modifyMemberLabels[${index}].aciCiphertext`, 'aci');
|
|
243
|
+
requireBlobEncoding(member.labelEmojiCiphertext, `Actions.modifyMemberLabels[${index}].labelEmojiCiphertext`);
|
|
244
|
+
requireBlobEncoding(member.labelStringCiphertext, `Actions.modifyMemberLabels[${index}].labelStringCiphertext`);
|
|
245
|
+
}
|
|
246
|
+
for (const [index, member] of change.newPendingMembers.entries()) {
|
|
247
|
+
requireCiphertextEncoding(member.serviceIdCiphertext, `Actions.newPendingMembers[${index}].serviceIdCiphertext`, 'service-id');
|
|
248
|
+
if (!isStoredMemberRole(member.role)) {
|
|
249
|
+
rejectBadRequest(`Actions.newPendingMembers[${index}].role is invalid`);
|
|
250
|
+
}
|
|
251
|
+
if (form === 'canonical') {
|
|
252
|
+
requireCiphertextEncoding(member.addedByAciCiphertext, `Actions.newPendingMembers[${index}].addedByAciCiphertext`, 'aci');
|
|
253
|
+
if (!validTimestamp(member.timestamp)) {
|
|
254
|
+
rejectBadRequest(`Actions.newPendingMembers[${index}].timestamp is invalid`);
|
|
255
|
+
}
|
|
256
|
+
}
|
|
257
|
+
}
|
|
258
|
+
for (const [index, member] of change.deletePendingMembers.entries()) {
|
|
259
|
+
requireCiphertextEncoding(member.serviceIdCiphertext, `Actions.deletePendingMembers[${index}].serviceIdCiphertext`, 'service-id');
|
|
260
|
+
}
|
|
261
|
+
for (const [index, member] of change.newRequestingMembers.entries()) {
|
|
262
|
+
requireCiphertextEncoding(member.aciCiphertext, `Actions.newRequestingMembers[${index}].aciCiphertext`, 'aci');
|
|
263
|
+
requireCiphertextEncoding(member.profileKeyCiphertext, `Actions.newRequestingMembers[${index}].profileKeyCiphertext`, 'profile-key');
|
|
264
|
+
if (!(member.presentation instanceof Uint8Array)) {
|
|
265
|
+
rejectBadRequest(`Actions.newRequestingMembers[${index}].presentation must be bytes`);
|
|
266
|
+
}
|
|
267
|
+
if (form === 'canonical' && !validTimestamp(member.timestamp)) {
|
|
268
|
+
rejectBadRequest(`Actions.newRequestingMembers[${index}].timestamp is invalid`);
|
|
269
|
+
}
|
|
270
|
+
}
|
|
271
|
+
for (const [index, ciphertext] of change.deleteRequestingMembers.entries()) {
|
|
272
|
+
requireCiphertextEncoding(ciphertext, `Actions.deleteRequestingMembers[${index}]`, 'aci');
|
|
273
|
+
}
|
|
274
|
+
for (const [index, member] of change.promoteRequestingMembers.entries()) {
|
|
275
|
+
requireCiphertextEncoding(member.aciCiphertext, `Actions.promoteRequestingMembers[${index}].aciCiphertext`, 'aci');
|
|
276
|
+
if (!isStoredMemberRole(member.role)) {
|
|
277
|
+
rejectBadRequest(`Actions.promoteRequestingMembers[${index}].role is invalid`);
|
|
278
|
+
}
|
|
279
|
+
}
|
|
280
|
+
for (const [index, member] of change.newBannedMembers.entries()) {
|
|
281
|
+
requireCiphertextEncoding(member.serviceIdCiphertext, `Actions.newBannedMembers[${index}].serviceIdCiphertext`, 'service-id');
|
|
282
|
+
if (form === 'canonical' && !validTimestamp(member.timestamp)) {
|
|
283
|
+
rejectBadRequest(`Actions.newBannedMembers[${index}].timestamp is invalid`);
|
|
284
|
+
}
|
|
285
|
+
}
|
|
286
|
+
for (const [index, member] of change.deleteBannedMembers.entries()) {
|
|
287
|
+
requireCiphertextEncoding(member.serviceIdCiphertext, `Actions.deleteBannedMembers[${index}].serviceIdCiphertext`, 'service-id');
|
|
288
|
+
}
|
|
289
|
+
for (const [value, label] of [
|
|
290
|
+
[change.newTitle, 'Actions.newTitle'],
|
|
291
|
+
[change.newTimer, 'Actions.newTimer'],
|
|
292
|
+
[change.newDescription, 'Actions.newDescription'],
|
|
293
|
+
]) {
|
|
294
|
+
if (value !== undefined) {
|
|
295
|
+
requireBlobEncoding(value, label, false);
|
|
296
|
+
}
|
|
297
|
+
}
|
|
298
|
+
if (change.newAvatar !== undefined &&
|
|
299
|
+
(typeof change.newAvatar !== 'object' ||
|
|
300
|
+
change.newAvatar === null ||
|
|
301
|
+
typeof change.newAvatar.value !== 'string')) {
|
|
302
|
+
rejectBadRequest('Actions.newAvatar must carry a string value');
|
|
303
|
+
}
|
|
304
|
+
for (const [value, label] of [
|
|
305
|
+
[change.newAttributeAccess, 'Actions.newAttributeAccess'],
|
|
306
|
+
[change.newMemberAccess, 'Actions.newMemberAccess'],
|
|
307
|
+
[change.newMemberLabelAccess, 'Actions.newMemberLabelAccess'],
|
|
308
|
+
]) {
|
|
309
|
+
if (value !== undefined && !isRoleAccessRequirement(value)) {
|
|
310
|
+
rejectBadRequest(`${label} is outside its §6.7 domain`);
|
|
311
|
+
}
|
|
312
|
+
}
|
|
313
|
+
if (change.newInviteLinkAccess !== undefined &&
|
|
314
|
+
!isInviteLinkAccessRequirement(change.newInviteLinkAccess)) {
|
|
315
|
+
rejectBadRequest('Actions.newInviteLinkAccess is outside its §6.7 domain');
|
|
316
|
+
}
|
|
317
|
+
if (change.newIsAnnouncementGroup !== undefined &&
|
|
318
|
+
change.newIsAnnouncementGroup !== EnabledState.ENABLED &&
|
|
319
|
+
change.newIsAnnouncementGroup !== EnabledState.DISABLED) {
|
|
320
|
+
rejectBadRequest('Actions.newIsAnnouncementGroup is invalid');
|
|
321
|
+
}
|
|
322
|
+
const { newInviteLinkPassword } = change;
|
|
323
|
+
if (newInviteLinkPassword !== undefined &&
|
|
324
|
+
(!(newInviteLinkPassword instanceof Uint8Array) ||
|
|
325
|
+
newInviteLinkPassword.length !== 16)) {
|
|
326
|
+
rejectBadRequest('Actions.newInviteLinkPassword must be 16 bytes');
|
|
327
|
+
}
|
|
328
|
+
}
|
|
329
|
+
function assertEncryptedStateStructure(state) {
|
|
330
|
+
try {
|
|
331
|
+
assertValidEncryptedGroupWire(state);
|
|
332
|
+
}
|
|
333
|
+
catch (error) {
|
|
334
|
+
rejectBadRequest(error instanceof Error ? error.message : 'Encrypted group state is malformed');
|
|
335
|
+
}
|
|
336
|
+
if (!Number.isSafeInteger(state.version) || state.version < 0) {
|
|
337
|
+
rejectBadRequest('Group version must be a non-negative safe integer');
|
|
338
|
+
}
|
|
339
|
+
if (!Array.isArray(state.members) ||
|
|
340
|
+
!Array.isArray(state.membersPendingProfileKey) ||
|
|
341
|
+
!Array.isArray(state.membersPendingAdminApproval) ||
|
|
342
|
+
!Array.isArray(state.membersBanned)) {
|
|
343
|
+
rejectBadRequest('Group membership fields must be arrays');
|
|
344
|
+
}
|
|
345
|
+
if (state.members.length > MAX_GROUP_SIZE) {
|
|
346
|
+
rejectBadRequest(`Group exceeds the ${MAX_GROUP_SIZE}-member limit`);
|
|
347
|
+
}
|
|
348
|
+
if (state.membersPendingProfileKey.length > MAX_GROUP_SIZE) {
|
|
349
|
+
rejectBadRequest(`Group exceeds the ${MAX_GROUP_SIZE}-pending-member limit`);
|
|
350
|
+
}
|
|
351
|
+
if (state.membersPendingAdminApproval.length > MAX_GROUP_SIZE) {
|
|
352
|
+
rejectBadRequest(`Group exceeds the ${MAX_GROUP_SIZE}-requesting-member limit`);
|
|
353
|
+
}
|
|
354
|
+
if (state.membersBanned.length > MAX_GROUP_SIZE) {
|
|
355
|
+
rejectBadRequest(`Group exceeds the ${MAX_GROUP_SIZE}-banned-member limit`);
|
|
356
|
+
}
|
|
357
|
+
if (!(state.publicKey instanceof Uint8Array) ||
|
|
358
|
+
!(state.title instanceof Uint8Array) ||
|
|
359
|
+
!(state.description instanceof Uint8Array) ||
|
|
360
|
+
!(state.disappearingMessagesTimer instanceof Uint8Array) ||
|
|
361
|
+
!(state.inviteLinkPassword instanceof Uint8Array) ||
|
|
362
|
+
(state.inviteLinkPassword.length !== 0 &&
|
|
363
|
+
state.inviteLinkPassword.length !== 16) ||
|
|
364
|
+
typeof state.avatarUrl !== 'string' ||
|
|
365
|
+
typeof state.announcementsOnly !== 'boolean' ||
|
|
366
|
+
typeof state.terminated !== 'boolean') {
|
|
367
|
+
rejectBadRequest('Group scalar or encrypted attribute fields are malformed');
|
|
368
|
+
}
|
|
369
|
+
if (!isRoleAccessRequirement(state.accessControl?.attributes) ||
|
|
370
|
+
!isRoleAccessRequirement(state.accessControl?.members) ||
|
|
371
|
+
!isRoleAccessRequirement(state.accessControl?.memberLabel) ||
|
|
372
|
+
!isInviteLinkAccessRequirement(state.accessControl?.addFromInviteLink)) {
|
|
373
|
+
rejectBadRequest('Group access control is invalid');
|
|
374
|
+
}
|
|
375
|
+
const occupied = new Set();
|
|
376
|
+
const occupy = (ciphertext, label) => {
|
|
377
|
+
const key = Array.from(ciphertext, (byte) => byte.toString(16).padStart(2, '0')).join('');
|
|
378
|
+
if (occupied.has(key)) {
|
|
379
|
+
rejectBadRequest(`Principal appears in multiple group-state entries (${label})`);
|
|
380
|
+
}
|
|
381
|
+
occupied.add(key);
|
|
382
|
+
};
|
|
383
|
+
requireBlobEncoding(state.title, 'Group.title');
|
|
384
|
+
requireBlobEncoding(state.description, 'Group.description');
|
|
385
|
+
requireBlobEncoding(state.disappearingMessagesTimer, 'Group.disappearingMessagesTimer');
|
|
386
|
+
for (const member of state.members) {
|
|
387
|
+
requireCiphertextEncoding(member.userId, 'members.userId', 'aci');
|
|
388
|
+
requireCiphertextEncoding(member.profileKey, 'members.profileKey', 'profile-key');
|
|
389
|
+
if (!isStoredMemberRole(member.role) ||
|
|
390
|
+
!(member.presentation instanceof Uint8Array) ||
|
|
391
|
+
!Number.isSafeInteger(member.joinedAtVersion) ||
|
|
392
|
+
member.joinedAtVersion < 0 ||
|
|
393
|
+
member.joinedAtVersion > state.version ||
|
|
394
|
+
!(member.labelEmoji instanceof Uint8Array) ||
|
|
395
|
+
!(member.labelString instanceof Uint8Array)) {
|
|
396
|
+
rejectBadRequest('Stored member fields are malformed');
|
|
397
|
+
}
|
|
398
|
+
requireBlobEncoding(member.labelEmoji, 'members.labelEmoji');
|
|
399
|
+
requireBlobEncoding(member.labelString, 'members.labelString');
|
|
400
|
+
occupy(member.userId, 'members');
|
|
401
|
+
}
|
|
402
|
+
for (const pending of state.membersPendingProfileKey) {
|
|
403
|
+
requireCiphertextEncoding(pending.member.userId, 'membersPendingProfileKey.userId', 'service-id');
|
|
404
|
+
requireCiphertextEncoding(pending.addedByUserId, 'membersPendingProfileKey.addedByUserId', 'aci');
|
|
405
|
+
if (!isStoredMemberRole(pending.member.role) ||
|
|
406
|
+
!validTimestamp(pending.timestamp) ||
|
|
407
|
+
pending.member.profileKey.length !== 0 ||
|
|
408
|
+
pending.member.presentation.length !== 0) {
|
|
409
|
+
rejectBadRequest('Stored pending-member fields are malformed');
|
|
410
|
+
}
|
|
411
|
+
occupy(pending.member.userId, 'membersPendingProfileKey');
|
|
412
|
+
}
|
|
413
|
+
for (const requesting of state.membersPendingAdminApproval) {
|
|
414
|
+
requireCiphertextEncoding(requesting.userId, 'membersPendingAdminApproval.userId', 'aci');
|
|
415
|
+
requireCiphertextEncoding(requesting.profileKey, 'membersPendingAdminApproval.profileKey', 'profile-key');
|
|
416
|
+
if (!(requesting.presentation instanceof Uint8Array) ||
|
|
417
|
+
!validTimestamp(requesting.timestamp)) {
|
|
418
|
+
rejectBadRequest('Stored requesting-member fields are malformed');
|
|
419
|
+
}
|
|
420
|
+
occupy(requesting.userId, 'membersPendingAdminApproval');
|
|
421
|
+
}
|
|
422
|
+
for (const banned of state.membersBanned) {
|
|
423
|
+
requireCiphertextEncoding(banned.userId, 'membersBanned.userId', 'service-id');
|
|
424
|
+
if (!validTimestamp(banned.timestamp)) {
|
|
425
|
+
rejectBadRequest('Stored banned-member timestamp is invalid');
|
|
426
|
+
}
|
|
427
|
+
occupy(banned.userId, 'membersBanned');
|
|
428
|
+
}
|
|
429
|
+
}
|
|
430
|
+
function assertEncryptedCreationStateStructure(state) {
|
|
431
|
+
try {
|
|
432
|
+
assertValidEncryptedGroupCreationSubmissionWire(state);
|
|
433
|
+
}
|
|
434
|
+
catch (error) {
|
|
435
|
+
rejectBadRequest(error instanceof Error
|
|
436
|
+
? error.message
|
|
437
|
+
: 'Encrypted group creation submission is malformed');
|
|
438
|
+
}
|
|
439
|
+
}
|
|
440
|
+
function requesterMatches(requester, userId) {
|
|
441
|
+
return (equal(userId, requester.aciCiphertext) ||
|
|
442
|
+
(requester.pniCiphertext !== undefined &&
|
|
443
|
+
equal(userId, requester.pniCiphertext)));
|
|
444
|
+
}
|
|
445
|
+
function roleForSource(state, sourceUserId) {
|
|
446
|
+
return (state.members.find((member) => equal(member.userId, sourceUserId))?.role ??
|
|
447
|
+
MemberRole.UNKNOWN);
|
|
448
|
+
}
|
|
449
|
+
function roleForRequesterAliases(state, requester) {
|
|
450
|
+
return (state.members.find((member) => requesterMatches(requester, member.userId))?.role ??
|
|
451
|
+
MemberRole.UNKNOWN);
|
|
452
|
+
}
|
|
453
|
+
function requesterIsBanned(state, requester) {
|
|
454
|
+
return state.membersBanned.some((member) => requesterMatches(requester, member.userId));
|
|
455
|
+
}
|
|
456
|
+
function matchingRequesterIds(state, requester) {
|
|
457
|
+
return [
|
|
458
|
+
...state.members.map((member) => member.userId),
|
|
459
|
+
...state.membersPendingProfileKey.map((pending) => pending.member.userId),
|
|
460
|
+
...state.membersPendingAdminApproval.map((pending) => pending.userId),
|
|
461
|
+
].filter((userId) => requesterMatches(requester, userId));
|
|
462
|
+
}
|
|
463
|
+
function sourceUserIdForChange(state, change, requester) {
|
|
464
|
+
const actionNamedRequesterIds = [
|
|
465
|
+
...change.promotePendingPniAciMembers.map((promotion) => promotion.pniCiphertext),
|
|
466
|
+
...change.deletePendingMembers
|
|
467
|
+
.map((removal) => removal.serviceIdCiphertext)
|
|
468
|
+
.filter((target) => requesterMatches(requester, target)),
|
|
469
|
+
...change.deleteRequestingMembers.filter((target) => requesterMatches(requester, target)),
|
|
470
|
+
].filter((candidate, index, candidates) => candidates.findIndex((other) => equal(candidate, other)) === index);
|
|
471
|
+
if (actionNamedRequesterIds.length > 1) {
|
|
472
|
+
rejectForbidden('A change cannot exercise self-rights under multiple requester aliases');
|
|
473
|
+
}
|
|
474
|
+
if (actionNamedRequesterIds.length === 1) {
|
|
475
|
+
return actionNamedRequesterIds[0];
|
|
476
|
+
}
|
|
477
|
+
const preChangeMatches = matchingRequesterIds(state, requester);
|
|
478
|
+
const matches = preChangeMatches.length > 0
|
|
479
|
+
? preChangeMatches
|
|
480
|
+
: [
|
|
481
|
+
...change.newMembers.map((member) => member.aciCiphertext),
|
|
482
|
+
...change.newRequestingMembers.map((member) => member.aciCiphertext),
|
|
483
|
+
].filter((userId) => requesterMatches(requester, userId));
|
|
484
|
+
const aciMatch = matches.find((userId) => equal(userId, requester.aciCiphertext));
|
|
485
|
+
const sourceUserId = aciMatch ?? matches[0];
|
|
486
|
+
if (!sourceUserId) {
|
|
487
|
+
rejectForbidden('Requester does not match the pre- or post-change group state');
|
|
488
|
+
}
|
|
489
|
+
return sourceUserId;
|
|
490
|
+
}
|
|
491
|
+
function pendingRole(state, userId, label) {
|
|
492
|
+
const pending = state.membersPendingProfileKey.find((member) => equal(member.member.userId, userId));
|
|
493
|
+
if (!pending) {
|
|
494
|
+
rejectBadRequest(`Cannot derive role for missing ${label}`);
|
|
495
|
+
}
|
|
496
|
+
return pending.member.role;
|
|
497
|
+
}
|
|
498
|
+
function canonicalizeAcceptedChange(state, submitted, sourceUserId, groupId, timestamp) {
|
|
499
|
+
const stripped = stripChangeProfileKeyPresentations(submitted);
|
|
500
|
+
return {
|
|
501
|
+
...stripped,
|
|
502
|
+
sourceUserId,
|
|
503
|
+
groupId: new Uint8Array(groupId),
|
|
504
|
+
newMembers: stripped.newMembers.map((member) => ({
|
|
505
|
+
...member,
|
|
506
|
+
joinedAtRevision: stripped.revision,
|
|
507
|
+
})),
|
|
508
|
+
newPendingMembers: stripped.newPendingMembers.map((member) => ({
|
|
509
|
+
...member,
|
|
510
|
+
addedByAciCiphertext: new Uint8Array(sourceUserId),
|
|
511
|
+
timestamp,
|
|
512
|
+
})),
|
|
513
|
+
promotePendingMembers: stripped.promotePendingMembers.map((member) => ({
|
|
514
|
+
...member,
|
|
515
|
+
role: pendingRole(state, member.aciCiphertext, 'pending ACI member'),
|
|
516
|
+
joinedAtRevision: stripped.revision,
|
|
517
|
+
})),
|
|
518
|
+
promotePendingPniAciMembers: stripped.promotePendingPniAciMembers.map((member) => ({
|
|
519
|
+
...member,
|
|
520
|
+
role: pendingRole(state, member.pniCiphertext, 'pending PNI member'),
|
|
521
|
+
joinedAtRevision: stripped.revision,
|
|
522
|
+
})),
|
|
523
|
+
newRequestingMembers: stripped.newRequestingMembers.map((member) => ({
|
|
524
|
+
...member,
|
|
525
|
+
timestamp,
|
|
526
|
+
})),
|
|
527
|
+
newBannedMembers: stripped.newBannedMembers.map((member) => ({
|
|
528
|
+
...member,
|
|
529
|
+
timestamp,
|
|
530
|
+
})),
|
|
531
|
+
};
|
|
532
|
+
}
|
|
533
|
+
function targetIsRequester(target, sourceUserId) {
|
|
534
|
+
return equal(target, sourceUserId);
|
|
535
|
+
}
|
|
536
|
+
function authorizeEncryptedChange(state, change, sourceUserId, requester) {
|
|
537
|
+
const role = roleForSource(state, sourceUserId);
|
|
538
|
+
const banned = requesterIsBanned(state, requester);
|
|
539
|
+
const policyState = {
|
|
540
|
+
accessControl: state.accessControl,
|
|
541
|
+
isAnnouncementGroup: state.announcementsOnly
|
|
542
|
+
? EnabledState.ENABLED
|
|
543
|
+
: EnabledState.DISABLED,
|
|
544
|
+
};
|
|
545
|
+
const check = (action, target, assignedRole) => {
|
|
546
|
+
if (!canRolePerformAction(policyState, role, action, {
|
|
547
|
+
requesterIsBanned: banned,
|
|
548
|
+
targetIsRequester: target
|
|
549
|
+
? targetIsRequester(target, sourceUserId)
|
|
550
|
+
: false,
|
|
551
|
+
assignedRole,
|
|
552
|
+
})) {
|
|
553
|
+
rejectForbidden(`Requester cannot perform ${action}`);
|
|
554
|
+
}
|
|
555
|
+
};
|
|
556
|
+
for (const member of change.newMembers) {
|
|
557
|
+
check(GroupAction.ADD_MEMBER, member.aciCiphertext, member.role);
|
|
558
|
+
}
|
|
559
|
+
for (const member of change.deleteMembers)
|
|
560
|
+
check(GroupAction.REMOVE_MEMBER, member);
|
|
561
|
+
for (const member of change.modifyMemberRoles) {
|
|
562
|
+
check(GroupAction.MODIFY_MEMBER_ROLE, member.aciCiphertext);
|
|
563
|
+
}
|
|
564
|
+
for (const member of change.modifiedProfileKeys) {
|
|
565
|
+
check(GroupAction.MODIFY_MEMBER_PROFILE_KEY, member.aciCiphertext);
|
|
566
|
+
}
|
|
567
|
+
for (const member of change.newPendingMembers) {
|
|
568
|
+
check(GroupAction.ADD_MEMBER_PENDING_PROFILE_KEY, member.serviceIdCiphertext, member.role);
|
|
569
|
+
}
|
|
570
|
+
for (const member of change.deletePendingMembers) {
|
|
571
|
+
check(GroupAction.DELETE_MEMBER_PENDING_PROFILE_KEY, member.serviceIdCiphertext);
|
|
572
|
+
}
|
|
573
|
+
for (const member of change.promotePendingMembers) {
|
|
574
|
+
check(GroupAction.PROMOTE_MEMBER_PENDING_PROFILE_KEY, member.aciCiphertext);
|
|
575
|
+
}
|
|
576
|
+
for (const member of change.promotePendingPniAciMembers) {
|
|
577
|
+
const pniPending = state.membersPendingProfileKey.find((pending) => equal(pending.member.userId, member.pniCiphertext));
|
|
578
|
+
const aciPending = state.membersPendingProfileKey.find((pending) => equal(pending.member.userId, member.aciCiphertext));
|
|
579
|
+
if (pniPending &&
|
|
580
|
+
aciPending &&
|
|
581
|
+
pniPending.member.role !== aciPending.member.role) {
|
|
582
|
+
rejectForbidden('PNI-to-ACI promotion cannot consume pending aliases with different roles');
|
|
583
|
+
}
|
|
584
|
+
check(GroupAction.PROMOTE_MEMBER_PENDING_PNI_ACI_PROFILE_KEY, member.pniCiphertext);
|
|
585
|
+
}
|
|
586
|
+
if (change.newTitle !== undefined)
|
|
587
|
+
check(GroupAction.MODIFY_TITLE);
|
|
588
|
+
if (change.newAvatar !== undefined)
|
|
589
|
+
check(GroupAction.MODIFY_AVATAR);
|
|
590
|
+
if (change.newTimer !== undefined)
|
|
591
|
+
check(GroupAction.MODIFY_DISAPPEARING_MESSAGES);
|
|
592
|
+
if (change.newDescription !== undefined)
|
|
593
|
+
check(GroupAction.MODIFY_DESCRIPTION);
|
|
594
|
+
if (change.newAttributeAccess !== undefined)
|
|
595
|
+
check(GroupAction.MODIFY_ATTRIBUTES_ACCESS);
|
|
596
|
+
if (change.newMemberAccess !== undefined)
|
|
597
|
+
check(GroupAction.MODIFY_MEMBERS_ACCESS);
|
|
598
|
+
if (change.newInviteLinkAccess !== undefined) {
|
|
599
|
+
check(GroupAction.MODIFY_INVITE_LINK_ACCESS);
|
|
600
|
+
}
|
|
601
|
+
if (change.newMemberLabelAccess !== undefined) {
|
|
602
|
+
check(GroupAction.MODIFY_MEMBER_LABEL_ACCESS);
|
|
603
|
+
}
|
|
604
|
+
if (change['newInviteLinkPassword'] !== undefined) {
|
|
605
|
+
check(GroupAction.MODIFY_INVITE_LINK_PASSWORD);
|
|
606
|
+
}
|
|
607
|
+
if (change.newIsAnnouncementGroup !== undefined) {
|
|
608
|
+
check(GroupAction.MODIFY_ANNOUNCEMENTS);
|
|
609
|
+
}
|
|
610
|
+
for (const member of change.newRequestingMembers) {
|
|
611
|
+
check(GroupAction.ADD_MEMBER_PENDING_ADMIN_APPROVAL, member.aciCiphertext);
|
|
612
|
+
}
|
|
613
|
+
for (const member of change.deleteRequestingMembers) {
|
|
614
|
+
check(GroupAction.DELETE_MEMBER_PENDING_ADMIN_APPROVAL, member);
|
|
615
|
+
}
|
|
616
|
+
for (const member of change.promoteRequestingMembers) {
|
|
617
|
+
check(GroupAction.PROMOTE_MEMBER_PENDING_ADMIN_APPROVAL, member.aciCiphertext);
|
|
618
|
+
}
|
|
619
|
+
for (const member of change.newBannedMembers) {
|
|
620
|
+
check(GroupAction.BAN_MEMBER, member.serviceIdCiphertext);
|
|
621
|
+
}
|
|
622
|
+
for (const member of change.deleteBannedMembers) {
|
|
623
|
+
check(GroupAction.UNBAN_MEMBER, member.serviceIdCiphertext);
|
|
624
|
+
}
|
|
625
|
+
for (const member of change.modifyMemberLabels) {
|
|
626
|
+
check(GroupAction.MODIFY_MEMBER_LABEL, member.aciCiphertext);
|
|
627
|
+
}
|
|
628
|
+
if (change.terminate === true)
|
|
629
|
+
check(GroupAction.TERMINATE_GROUP);
|
|
630
|
+
}
|
|
631
|
+
function requirePniAciBinding(change, requester) {
|
|
632
|
+
for (const promotion of change.promotePendingPniAciMembers) {
|
|
633
|
+
if (!equal(promotion.aciCiphertext, requester.aciCiphertext) ||
|
|
634
|
+
requester.pniCiphertext === undefined ||
|
|
635
|
+
promotion.pniCiphertext.length === 0 ||
|
|
636
|
+
!equal(promotion.pniCiphertext, requester.pniCiphertext)) {
|
|
637
|
+
rejectForbidden('PNI-to-ACI promotion is not bound to the requester presentation');
|
|
638
|
+
}
|
|
639
|
+
}
|
|
640
|
+
}
|
|
641
|
+
function isLinkJoin(state, change, requester) {
|
|
642
|
+
if (roleForRequesterAliases(state, requester) !== MemberRole.UNKNOWN) {
|
|
643
|
+
return false;
|
|
644
|
+
}
|
|
645
|
+
return (change.newMembers.some((member) => equal(member.aciCiphertext, requester.aciCiphertext)) ||
|
|
646
|
+
change.newRequestingMembers.some((member) => equal(member.aciCiphertext, requester.aciCiphertext)));
|
|
647
|
+
}
|
|
648
|
+
function requireInviteLinkPassword(state, change, requester, password) {
|
|
649
|
+
if (isLinkJoin(state, change, requester) &&
|
|
650
|
+
(state.inviteLinkPassword.length !== INVITE_LINK_PASSWORD_LENGTH ||
|
|
651
|
+
password.length !== INVITE_LINK_PASSWORD_LENGTH ||
|
|
652
|
+
!constantTimeEqual(state.inviteLinkPassword, password))) {
|
|
653
|
+
rejectForbidden('Invite-link password is absent or invalid');
|
|
654
|
+
}
|
|
655
|
+
}
|
|
656
|
+
function applyEncryptedChange(state, change) {
|
|
657
|
+
if (state.terminated)
|
|
658
|
+
rejectBadRequest('Group is terminated');
|
|
659
|
+
const next = structuredClone(state);
|
|
660
|
+
const { newInviteLinkPassword } = change;
|
|
661
|
+
const missing = (description) => rejectBadRequest(`Action targets a missing ${description}`);
|
|
662
|
+
const duplicate = (description) => rejectBadRequest(`Action creates a duplicate ${description}`);
|
|
663
|
+
for (const removal of change.deletePendingMembers) {
|
|
664
|
+
const index = next.membersPendingProfileKey.findIndex((member) => equal(member.member.userId, removal.serviceIdCiphertext));
|
|
665
|
+
if (index < 0)
|
|
666
|
+
missing('pending member');
|
|
667
|
+
next.membersPendingProfileKey.splice(index, 1);
|
|
668
|
+
}
|
|
669
|
+
for (const userId of change.deleteRequestingMembers) {
|
|
670
|
+
const index = next.membersPendingAdminApproval.findIndex((member) => equal(member.userId, userId));
|
|
671
|
+
if (index < 0)
|
|
672
|
+
missing('requesting member');
|
|
673
|
+
next.membersPendingAdminApproval.splice(index, 1);
|
|
674
|
+
}
|
|
675
|
+
for (const removal of change.deleteBannedMembers) {
|
|
676
|
+
const index = next.membersBanned.findIndex((member) => equal(member.userId, removal.serviceIdCiphertext));
|
|
677
|
+
if (index < 0)
|
|
678
|
+
missing('banned member');
|
|
679
|
+
next.membersBanned.splice(index, 1);
|
|
680
|
+
}
|
|
681
|
+
for (const userId of change.deleteMembers) {
|
|
682
|
+
const index = next.members.findIndex((member) => equal(member.userId, userId));
|
|
683
|
+
if (index < 0)
|
|
684
|
+
missing('member');
|
|
685
|
+
next.members.splice(index, 1);
|
|
686
|
+
}
|
|
687
|
+
for (const addition of change.newBannedMembers) {
|
|
688
|
+
if (next.membersBanned.some((member) => equal(member.userId, addition.serviceIdCiphertext))) {
|
|
689
|
+
duplicate('banned member');
|
|
690
|
+
}
|
|
691
|
+
if (next.membersBanned.length >= MAX_GROUP_SIZE) {
|
|
692
|
+
rejectBadRequest('Group banned-member list is full');
|
|
693
|
+
}
|
|
694
|
+
next.membersBanned.push({
|
|
695
|
+
userId: addition.serviceIdCiphertext,
|
|
696
|
+
timestamp: addition.timestamp,
|
|
697
|
+
});
|
|
698
|
+
}
|
|
699
|
+
for (const promotion of change.promotePendingMembers) {
|
|
700
|
+
if (next.members.some((member) => equal(member.userId, promotion.aciCiphertext))) {
|
|
701
|
+
duplicate('member');
|
|
702
|
+
}
|
|
703
|
+
const index = next.membersPendingProfileKey.findIndex((member) => equal(member.member.userId, promotion.aciCiphertext));
|
|
704
|
+
if (index < 0)
|
|
705
|
+
missing('pending ACI member');
|
|
706
|
+
const [pending] = next.membersPendingProfileKey.splice(index, 1);
|
|
707
|
+
next.members.push(memberFromAction(promotion, pending.member.role, change.revision));
|
|
708
|
+
}
|
|
709
|
+
for (const promotion of change.promotePendingPniAciMembers) {
|
|
710
|
+
if (next.members.some((member) => equal(member.userId, promotion.aciCiphertext))) {
|
|
711
|
+
duplicate('member');
|
|
712
|
+
}
|
|
713
|
+
const index = next.membersPendingProfileKey.findIndex((member) => equal(member.member.userId, promotion.pniCiphertext));
|
|
714
|
+
if (index < 0)
|
|
715
|
+
missing('pending PNI member');
|
|
716
|
+
const [pending] = next.membersPendingProfileKey.splice(index, 1);
|
|
717
|
+
const aciAliasIndex = next.membersPendingProfileKey.findIndex((member) => equal(member.member.userId, promotion.aciCiphertext));
|
|
718
|
+
if (aciAliasIndex >= 0) {
|
|
719
|
+
const [aciPending] = next.membersPendingProfileKey.splice(aciAliasIndex, 1);
|
|
720
|
+
if (aciPending.member.role !== pending.member.role) {
|
|
721
|
+
rejectForbidden('PNI-to-ACI promotion cannot consume pending aliases with different roles');
|
|
722
|
+
}
|
|
723
|
+
}
|
|
724
|
+
next.members.push(memberFromAction(promotion, pending.member.role, change.revision));
|
|
725
|
+
}
|
|
726
|
+
for (const promotion of change.promoteRequestingMembers) {
|
|
727
|
+
if (next.members.some((member) => equal(member.userId, promotion.aciCiphertext))) {
|
|
728
|
+
duplicate('member');
|
|
729
|
+
}
|
|
730
|
+
const index = next.membersPendingAdminApproval.findIndex((member) => equal(member.userId, promotion.aciCiphertext));
|
|
731
|
+
if (index < 0)
|
|
732
|
+
missing('requesting member');
|
|
733
|
+
const [requesting] = next.membersPendingAdminApproval.splice(index, 1);
|
|
734
|
+
next.members.push({
|
|
735
|
+
userId: requesting.userId,
|
|
736
|
+
role: promotion.role,
|
|
737
|
+
profileKey: requesting.profileKey,
|
|
738
|
+
presentation: requesting.presentation,
|
|
739
|
+
joinedAtVersion: change.revision,
|
|
740
|
+
labelEmoji: new Uint8Array(0),
|
|
741
|
+
labelString: new Uint8Array(0),
|
|
742
|
+
});
|
|
743
|
+
}
|
|
744
|
+
for (const addition of change.newMembers) {
|
|
745
|
+
if (next.members.some((member) => equal(member.userId, addition.aciCiphertext))) {
|
|
746
|
+
duplicate('member');
|
|
747
|
+
}
|
|
748
|
+
if (next.members.length >= MAX_GROUP_SIZE)
|
|
749
|
+
rejectBadRequest('Group is full');
|
|
750
|
+
next.members.push(memberFromAction(addition, addition.role, addition.joinedAtRevision));
|
|
751
|
+
}
|
|
752
|
+
for (const addition of change.newPendingMembers) {
|
|
753
|
+
if (next.membersPendingProfileKey.some((member) => equal(member.member.userId, addition.serviceIdCiphertext))) {
|
|
754
|
+
duplicate('pending member');
|
|
755
|
+
}
|
|
756
|
+
if (next.membersPendingProfileKey.length >= MAX_GROUP_SIZE) {
|
|
757
|
+
rejectBadRequest('Group pending-member list is full');
|
|
758
|
+
}
|
|
759
|
+
next.membersPendingProfileKey.push({
|
|
760
|
+
member: {
|
|
761
|
+
userId: addition.serviceIdCiphertext,
|
|
762
|
+
role: addition.role,
|
|
763
|
+
profileKey: new Uint8Array(0),
|
|
764
|
+
presentation: new Uint8Array(0),
|
|
765
|
+
joinedAtVersion: 0,
|
|
766
|
+
labelEmoji: new Uint8Array(0),
|
|
767
|
+
labelString: new Uint8Array(0),
|
|
768
|
+
},
|
|
769
|
+
addedByUserId: addition.addedByAciCiphertext,
|
|
770
|
+
timestamp: addition.timestamp,
|
|
771
|
+
});
|
|
772
|
+
}
|
|
773
|
+
for (const addition of change.newRequestingMembers) {
|
|
774
|
+
if (next.membersPendingAdminApproval.some((member) => equal(member.userId, addition.aciCiphertext))) {
|
|
775
|
+
duplicate('requesting member');
|
|
776
|
+
}
|
|
777
|
+
if (next.membersPendingAdminApproval.length >= MAX_GROUP_SIZE) {
|
|
778
|
+
rejectBadRequest('Group requesting-member list is full');
|
|
779
|
+
}
|
|
780
|
+
next.membersPendingAdminApproval.push({
|
|
781
|
+
userId: addition.aciCiphertext,
|
|
782
|
+
profileKey: addition.profileKeyCiphertext,
|
|
783
|
+
presentation: addition.presentation,
|
|
784
|
+
timestamp: addition.timestamp,
|
|
785
|
+
});
|
|
786
|
+
}
|
|
787
|
+
for (const modification of change.modifyMemberRoles) {
|
|
788
|
+
const member = next.members.find((candidate) => equal(candidate.userId, modification.aciCiphertext));
|
|
789
|
+
if (!member)
|
|
790
|
+
return missing('member role target');
|
|
791
|
+
member.role = modification.role;
|
|
792
|
+
}
|
|
793
|
+
for (const modification of change.modifyMemberLabels) {
|
|
794
|
+
const member = next.members.find((candidate) => equal(candidate.userId, modification.aciCiphertext));
|
|
795
|
+
if (!member)
|
|
796
|
+
return missing('member label target');
|
|
797
|
+
member.labelEmoji = modification.labelEmojiCiphertext;
|
|
798
|
+
member.labelString = modification.labelStringCiphertext;
|
|
799
|
+
}
|
|
800
|
+
for (const modification of change.modifiedProfileKeys) {
|
|
801
|
+
const member = next.members.find((candidate) => equal(candidate.userId, modification.aciCiphertext));
|
|
802
|
+
if (!member)
|
|
803
|
+
return missing('member profile-key target');
|
|
804
|
+
member.profileKey = modification.profileKeyCiphertext;
|
|
805
|
+
member.presentation = modification.presentation;
|
|
806
|
+
}
|
|
807
|
+
if (change.newTitle !== undefined)
|
|
808
|
+
next.title = change.newTitle;
|
|
809
|
+
if (change.newAvatar !== undefined)
|
|
810
|
+
next.avatarUrl = change.newAvatar.value;
|
|
811
|
+
if (change.newTimer !== undefined)
|
|
812
|
+
next.disappearingMessagesTimer = change.newTimer;
|
|
813
|
+
if (change.newDescription !== undefined)
|
|
814
|
+
next.description = change.newDescription;
|
|
815
|
+
if (newInviteLinkPassword !== undefined) {
|
|
816
|
+
next.inviteLinkPassword = newInviteLinkPassword.slice();
|
|
817
|
+
}
|
|
818
|
+
if (change.newAttributeAccess !== undefined) {
|
|
819
|
+
next.accessControl.attributes = change.newAttributeAccess;
|
|
820
|
+
}
|
|
821
|
+
if (change.newMemberAccess !== undefined) {
|
|
822
|
+
next.accessControl.members = change.newMemberAccess;
|
|
823
|
+
}
|
|
824
|
+
if (change.newInviteLinkAccess !== undefined) {
|
|
825
|
+
next.accessControl.addFromInviteLink = change.newInviteLinkAccess;
|
|
826
|
+
}
|
|
827
|
+
if (change.newMemberLabelAccess !== undefined) {
|
|
828
|
+
next.accessControl.memberLabel = change.newMemberLabelAccess;
|
|
829
|
+
}
|
|
830
|
+
if (change.newIsAnnouncementGroup !== undefined) {
|
|
831
|
+
next.announcementsOnly = change.newIsAnnouncementGroup === EnabledState.ENABLED;
|
|
832
|
+
}
|
|
833
|
+
if (change.terminate === true)
|
|
834
|
+
next.terminated = true;
|
|
835
|
+
next.version = change.revision;
|
|
836
|
+
return next;
|
|
837
|
+
}
|
|
838
|
+
export class GroupAuthorizationServerEngine {
|
|
839
|
+
serverSecretParams;
|
|
840
|
+
runtime;
|
|
841
|
+
groups = new Map();
|
|
842
|
+
constructor(serverSecretParams, runtime = defaultRuntime) {
|
|
843
|
+
this.serverSecretParams = serverSecretParams;
|
|
844
|
+
this.runtime = runtime;
|
|
845
|
+
}
|
|
846
|
+
get publicParams() {
|
|
847
|
+
return getServerPublicParams(this.serverSecretParams);
|
|
848
|
+
}
|
|
849
|
+
clear() {
|
|
850
|
+
this.groups.clear();
|
|
851
|
+
}
|
|
852
|
+
inspectEncryptedState(groupId) {
|
|
853
|
+
const stored = this.groups.get(this.key(groupId));
|
|
854
|
+
return stored ? serializeEncryptedGroup(stored.state) : null;
|
|
855
|
+
}
|
|
856
|
+
restoreGroup(groupId, persisted) {
|
|
857
|
+
const state = deserializeEncryptedGroup(persisted.encryptedState);
|
|
858
|
+
const snapshots = new Map(persisted.snapshots.map((snapshot) => [
|
|
859
|
+
snapshot.version,
|
|
860
|
+
{
|
|
861
|
+
state: deserializeEncryptedGroup(snapshot.encryptedState),
|
|
862
|
+
baselineSignature: new Uint8Array(snapshot.baselineSignature),
|
|
863
|
+
},
|
|
864
|
+
]));
|
|
865
|
+
this.groups.set(this.key(groupId), {
|
|
866
|
+
state,
|
|
867
|
+
changes: structuredClone(persisted.changes),
|
|
868
|
+
snapshots,
|
|
869
|
+
});
|
|
870
|
+
}
|
|
871
|
+
exportGroup(groupId) {
|
|
872
|
+
const stored = this.groups.get(this.key(groupId));
|
|
873
|
+
if (!stored)
|
|
874
|
+
return null;
|
|
875
|
+
return {
|
|
876
|
+
encryptedState: serializeEncryptedGroup(stored.state),
|
|
877
|
+
changes: structuredClone(stored.changes),
|
|
878
|
+
snapshots: [...stored.snapshots.entries()]
|
|
879
|
+
.sort(([left], [right]) => left - right)
|
|
880
|
+
.map(([version, snapshot]) => ({
|
|
881
|
+
version,
|
|
882
|
+
encryptedState: serializeEncryptedGroup(snapshot.state),
|
|
883
|
+
baselineSignature: new Uint8Array(snapshot.baselineSignature),
|
|
884
|
+
})),
|
|
885
|
+
};
|
|
886
|
+
}
|
|
887
|
+
key(groupId) {
|
|
888
|
+
return Array.from(groupId, (byte) => byte.toString(16).padStart(2, '0')).join('');
|
|
889
|
+
}
|
|
890
|
+
createStoredSnapshot(groupId, state) {
|
|
891
|
+
const encryptedState = serializeEncryptedGroup(state);
|
|
892
|
+
return {
|
|
893
|
+
state: structuredClone(state),
|
|
894
|
+
baselineSignature: serverSign(this.serverSecretParams, this.runtime.randomBytes(32), serializeGroupBaseline(groupId, state.version, encryptedState)),
|
|
895
|
+
};
|
|
896
|
+
}
|
|
897
|
+
authenticate(groupId, authorization, state) {
|
|
898
|
+
try {
|
|
899
|
+
const groupPublicParams = deserializeGroupPublicParams(new Uint8Array(authorization.groupPublicParams));
|
|
900
|
+
if (!equal(groupPublicParams.groupId, groupId)) {
|
|
901
|
+
rejectUnauthorized('Presentation is bound to a different group');
|
|
902
|
+
}
|
|
903
|
+
if (state &&
|
|
904
|
+
!equal(state.publicKey, serializeGroupPublicParams(groupPublicParams))) {
|
|
905
|
+
rejectUnauthorized('Presentation parameters do not match stored group parameters');
|
|
906
|
+
}
|
|
907
|
+
const presentation = deserializeAuthCredentialPresentation(new Uint8Array(authorization.presentation));
|
|
908
|
+
const nowSeconds = Math.floor(this.runtime.now() / 1000);
|
|
909
|
+
const today = Math.floor(nowSeconds / SECONDS_PER_DAY) * SECONDS_PER_DAY;
|
|
910
|
+
if (presentation.redemptionTime % SECONDS_PER_DAY !== 0 ||
|
|
911
|
+
Math.abs(presentation.redemptionTime - today) > SECONDS_PER_DAY) {
|
|
912
|
+
rejectUnauthorized('Credential redemption time is outside current day ± one day');
|
|
913
|
+
}
|
|
914
|
+
verifyAuthCredentialPresentation(this.serverSecretParams.credentialKeyPair, groupPublicParams, presentation, nowSeconds);
|
|
915
|
+
return {
|
|
916
|
+
aciCiphertext: serializePresentationCiphertext(SERVICE_ID_ACI, presentation.aciCiphertext),
|
|
917
|
+
pniCiphertext: presentation.pniCiphertext === undefined
|
|
918
|
+
? undefined
|
|
919
|
+
: serializePresentationCiphertext(SERVICE_ID_PNI, presentation.pniCiphertext),
|
|
920
|
+
};
|
|
921
|
+
}
|
|
922
|
+
catch (error) {
|
|
923
|
+
if (error instanceof GroupServerError)
|
|
924
|
+
throw error;
|
|
925
|
+
rejectUnauthorized(error instanceof Error ? error.message : 'Credential presentation verification failed');
|
|
926
|
+
}
|
|
927
|
+
}
|
|
928
|
+
isReadable(state, requester) {
|
|
929
|
+
if (requesterIsBanned(state, requester))
|
|
930
|
+
return false;
|
|
931
|
+
return (state.members.some((member) => requesterMatches(requester, member.userId)) ||
|
|
932
|
+
state.membersPendingProfileKey.some((pending) => requesterMatches(requester, pending.member.userId)));
|
|
933
|
+
}
|
|
934
|
+
requireReadable(state, requester) {
|
|
935
|
+
if (!this.isReadable(state, requester)) {
|
|
936
|
+
rejectForbidden('Requester may not read full group state', 'not_readable');
|
|
937
|
+
}
|
|
938
|
+
}
|
|
939
|
+
/**
|
|
940
|
+
* The version at which the requester's current tenure began, or undefined
|
|
941
|
+
* when the requester has no tenure to read.
|
|
942
|
+
*
|
|
943
|
+
* Deliberately consults `members` only. A pending-profile-key entry is an
|
|
944
|
+
* invitation, not a tenure: its wire format pins `joinedAtVersion` to
|
|
945
|
+
* zero, so reading it here would hand every invitee a floor of "the
|
|
946
|
+
* beginning of time" — an invitee who never accepts could page through the
|
|
947
|
+
* group's entire pre-invitation history, which is more than acceptance
|
|
948
|
+
* itself would grant. An invitee reads the *current* state (that is what
|
|
949
|
+
* an invitation entitles, and what acceptance needs); versioned history
|
|
950
|
+
* starts existing for them when they join and their member entry records
|
|
951
|
+
* where.
|
|
952
|
+
*/
|
|
953
|
+
requesterJoinedAtVersion(state, requester) {
|
|
954
|
+
return state.members.find((candidate) => requesterMatches(requester, candidate.userId))?.joinedAtVersion;
|
|
955
|
+
}
|
|
956
|
+
async createGroup(groupId, encryptedState, authorization) {
|
|
957
|
+
const key = this.key(groupId);
|
|
958
|
+
if (this.groups.has(key))
|
|
959
|
+
rejectConflict('Group already exists');
|
|
960
|
+
let submission;
|
|
961
|
+
try {
|
|
962
|
+
submission = deserializeEncryptedGroupCreationSubmission(encryptedState);
|
|
963
|
+
}
|
|
964
|
+
catch {
|
|
965
|
+
return rejectBadRequest('Encrypted group state is malformed');
|
|
966
|
+
}
|
|
967
|
+
const requester = this.authenticate(groupId, authorization);
|
|
968
|
+
if (!equal(submission.publicKey, authorization.groupPublicParams)) {
|
|
969
|
+
rejectBadRequest('Stored publicKey must be serialized GroupPublicParams');
|
|
970
|
+
}
|
|
971
|
+
assertEncryptedCreationStateStructure(submission);
|
|
972
|
+
const now = this.runtime.now();
|
|
973
|
+
const state = {
|
|
974
|
+
...submission,
|
|
975
|
+
membersPendingProfileKey: submission.membersPendingProfileKey.map(({ userId, role }) => ({
|
|
976
|
+
member: {
|
|
977
|
+
userId,
|
|
978
|
+
role,
|
|
979
|
+
profileKey: new Uint8Array(0),
|
|
980
|
+
presentation: new Uint8Array(0),
|
|
981
|
+
joinedAtVersion: 0,
|
|
982
|
+
labelEmoji: new Uint8Array(0),
|
|
983
|
+
labelString: new Uint8Array(0),
|
|
984
|
+
},
|
|
985
|
+
addedByUserId: new Uint8Array(requester.aciCiphertext),
|
|
986
|
+
timestamp: now,
|
|
987
|
+
})),
|
|
988
|
+
membersPendingAdminApproval: [],
|
|
989
|
+
membersBanned: [],
|
|
990
|
+
};
|
|
991
|
+
assertEncryptedStateStructure(state);
|
|
992
|
+
verifyStateProfileKeyPresentations(state, this.serverSecretParams, Math.floor(now / 1000));
|
|
993
|
+
const creator = state.members.find((member) => equal(member.userId, requester.aciCiphertext));
|
|
994
|
+
if (!creator) {
|
|
995
|
+
rejectForbidden('Creator presentation is not an initial member');
|
|
996
|
+
}
|
|
997
|
+
if (creator.role !== MemberRole.ADMINISTRATOR) {
|
|
998
|
+
rejectForbidden('Creator must be an initial administrator');
|
|
999
|
+
}
|
|
1000
|
+
const storedState = stripStateProfileKeyPresentations(state);
|
|
1001
|
+
const initialSnapshot = this.createStoredSnapshot(groupId, storedState);
|
|
1002
|
+
this.groups.set(key, {
|
|
1003
|
+
state: storedState,
|
|
1004
|
+
changes: [],
|
|
1005
|
+
snapshots: new Map([[0, initialSnapshot]]),
|
|
1006
|
+
});
|
|
1007
|
+
}
|
|
1008
|
+
async getGroup(groupId, authorization, version) {
|
|
1009
|
+
const stored = this.groups.get(this.key(groupId));
|
|
1010
|
+
if (!stored)
|
|
1011
|
+
return null;
|
|
1012
|
+
// Authorization is evaluated against the group as it is *now*, never
|
|
1013
|
+
// against the requested snapshot. Historical snapshots each contain a
|
|
1014
|
+
// roster, and authorizing against the requested one let anyone removed or
|
|
1015
|
+
// banned at version N keep reading every version of their tenure forever
|
|
1016
|
+
// — a removal that does not revoke read access is not a removal. Current
|
|
1017
|
+
// membership answers "may you read this group"; the join-version floor
|
|
1018
|
+
// below answers "may you read this version of it".
|
|
1019
|
+
const requester = this.authenticate(groupId, authorization, stored.state);
|
|
1020
|
+
this.requireReadable(stored.state, requester);
|
|
1021
|
+
const snapshot = version === undefined
|
|
1022
|
+
? stored.snapshots.get(stored.state.version)
|
|
1023
|
+
: stored.snapshots.get(version);
|
|
1024
|
+
if (!snapshot)
|
|
1025
|
+
return null;
|
|
1026
|
+
if (version !== undefined) {
|
|
1027
|
+
// Under snapshot-based authorization this floor was implicit — a
|
|
1028
|
+
// pre-join snapshot simply did not list the requester. Authorizing
|
|
1029
|
+
// against the current state removes that accident, so the floor has to
|
|
1030
|
+
// be stated: membership grants the group from when you joined, not its
|
|
1031
|
+
// history.
|
|
1032
|
+
const joinedAtVersion = this.requesterJoinedAtVersion(stored.state, requester);
|
|
1033
|
+
if (joinedAtVersion === undefined || version < joinedAtVersion) {
|
|
1034
|
+
rejectForbidden('Requester may not read state from before they joined', 'before_join');
|
|
1035
|
+
}
|
|
1036
|
+
}
|
|
1037
|
+
const { state } = snapshot;
|
|
1038
|
+
const encryptedState = serializeEncryptedGroup(state);
|
|
1039
|
+
return {
|
|
1040
|
+
encryptedState,
|
|
1041
|
+
version: state.version,
|
|
1042
|
+
baselineSignature: new Uint8Array(snapshot.baselineSignature),
|
|
1043
|
+
};
|
|
1044
|
+
}
|
|
1045
|
+
async getGroupJoinInfo(groupId, inviteLinkPassword, authorization) {
|
|
1046
|
+
const stored = this.groups.get(this.key(groupId));
|
|
1047
|
+
if (!stored)
|
|
1048
|
+
return null;
|
|
1049
|
+
const requester = this.authenticate(groupId, authorization, stored.state);
|
|
1050
|
+
if (requesterIsBanned(stored.state, requester)) {
|
|
1051
|
+
rejectForbidden('Banned requester may not read group join info');
|
|
1052
|
+
}
|
|
1053
|
+
if (stored.state.terminated) {
|
|
1054
|
+
rejectForbidden('Terminated group has no join info');
|
|
1055
|
+
}
|
|
1056
|
+
const pendingAdminApproval = stored.state.membersPendingAdminApproval.some((pending) => requesterMatches(requester, pending.userId));
|
|
1057
|
+
if (!pendingAdminApproval) {
|
|
1058
|
+
if (stored.state.accessControl.addFromInviteLink === AccessRequired.UNSATISFIABLE ||
|
|
1059
|
+
stored.state.accessControl.addFromInviteLink === AccessRequired.UNKNOWN) {
|
|
1060
|
+
rejectForbidden('Invite-link access is disabled or unknown');
|
|
1061
|
+
}
|
|
1062
|
+
if (stored.state.inviteLinkPassword.length !== INVITE_LINK_PASSWORD_LENGTH ||
|
|
1063
|
+
inviteLinkPassword.length !== INVITE_LINK_PASSWORD_LENGTH ||
|
|
1064
|
+
!constantTimeEqual(stored.state.inviteLinkPassword, inviteLinkPassword)) {
|
|
1065
|
+
rejectForbidden('Invite-link password is absent or invalid');
|
|
1066
|
+
}
|
|
1067
|
+
}
|
|
1068
|
+
const info = {
|
|
1069
|
+
publicKey: stored.state.publicKey,
|
|
1070
|
+
title: stored.state.title,
|
|
1071
|
+
avatar: stored.state.avatarUrl,
|
|
1072
|
+
memberCount: stored.state.members.length,
|
|
1073
|
+
addFromInviteLink: stored.state.accessControl.addFromInviteLink,
|
|
1074
|
+
revision: stored.state.version,
|
|
1075
|
+
pendingAdminApproval,
|
|
1076
|
+
description: stored.state.description,
|
|
1077
|
+
};
|
|
1078
|
+
return {
|
|
1079
|
+
encryptedJoinInfo: serializeEncryptedGroupJoinInfo(info),
|
|
1080
|
+
version: stored.state.version,
|
|
1081
|
+
};
|
|
1082
|
+
}
|
|
1083
|
+
async getGroupChanges(groupId, fromVersion, authorization) {
|
|
1084
|
+
// Unlike getGroup, this deliberately authorizes against the *requested*
|
|
1085
|
+
// snapshot. The walk below serves entries only while the requester stays
|
|
1086
|
+
// readable, stopping at — and including — the change that removed them,
|
|
1087
|
+
// which is how a removed member learns of their removal when they poll;
|
|
1088
|
+
// authorizing against the current state would 403 them into silence
|
|
1089
|
+
// instead. The exposure this leaves is bounded and not new: a former
|
|
1090
|
+
// member can re-fetch changes from within their own tenure, ending at
|
|
1091
|
+
// their removal — bytes they were served while entitled.
|
|
1092
|
+
//
|
|
1093
|
+
// The log is for members. A pending-profile-key entry entitles its
|
|
1094
|
+
// holder to the current state — acceptance needs that, and getGroup
|
|
1095
|
+
// serves it — but the log names the actor behind every change, and an
|
|
1096
|
+
// invitation is not a tenure, so a requester who is merely pending in
|
|
1097
|
+
// the snapshot at `fromVersion` is refused below even though that
|
|
1098
|
+
// snapshot lists them as readable. Pending principals catch up by
|
|
1099
|
+
// fetching a fresh signed snapshot instead (S10a), which is also how
|
|
1100
|
+
// the reference ecosystem's clients behave: their state processor
|
|
1101
|
+
// updates straight to the latest server state whenever the server does
|
|
1102
|
+
// not recognize the requester as a member. This membership requirement
|
|
1103
|
+
// is what closes history: for members it bounds the log at their
|
|
1104
|
+
// tenure (a pre-join snapshot does not list them in `members`), and
|
|
1105
|
+
// for invitees it closes the log outright.
|
|
1106
|
+
const stored = this.groups.get(this.key(groupId));
|
|
1107
|
+
if (!stored)
|
|
1108
|
+
return [];
|
|
1109
|
+
const snapshot = stored.snapshots.get(fromVersion);
|
|
1110
|
+
if (!snapshot) {
|
|
1111
|
+
rejectBadRequest(`Group snapshot ${fromVersion} does not exist`);
|
|
1112
|
+
}
|
|
1113
|
+
const requester = this.authenticate(groupId, authorization, snapshot.state);
|
|
1114
|
+
this.requireReadable(snapshot.state, requester);
|
|
1115
|
+
if (!snapshot.state.members.some((member) => requesterMatches(requester, member.userId))) {
|
|
1116
|
+
rejectForbidden('Only members may read the change log', 'not_a_member');
|
|
1117
|
+
}
|
|
1118
|
+
const readablePrefix = [];
|
|
1119
|
+
for (const entry of stored.changes) {
|
|
1120
|
+
if (entry.version <= fromVersion)
|
|
1121
|
+
continue;
|
|
1122
|
+
readablePrefix.push(entry);
|
|
1123
|
+
const postState = stored.snapshots.get(entry.version);
|
|
1124
|
+
if (!postState) {
|
|
1125
|
+
throw new Error(`Missing group snapshot ${entry.version}`);
|
|
1126
|
+
}
|
|
1127
|
+
if (!this.isReadable(postState.state, requester))
|
|
1128
|
+
break;
|
|
1129
|
+
}
|
|
1130
|
+
return structuredClone(readablePrefix);
|
|
1131
|
+
}
|
|
1132
|
+
async submitGroupChange(groupId, expectedVersion, actions, inviteLinkPassword, authorization) {
|
|
1133
|
+
if (arguments.length !== 5) {
|
|
1134
|
+
rejectBadRequest('Group change submission must not carry an epoch');
|
|
1135
|
+
}
|
|
1136
|
+
const stored = this.groups.get(this.key(groupId));
|
|
1137
|
+
if (!stored)
|
|
1138
|
+
rejectBadRequest('Group does not exist');
|
|
1139
|
+
const operationTime = this.runtime.now();
|
|
1140
|
+
const requester = this.authenticate(groupId, authorization, stored.state);
|
|
1141
|
+
if (stored.state.version !== expectedVersion) {
|
|
1142
|
+
rejectConflict(`Expected ${expectedVersion}, current version is ${stored.state.version}`);
|
|
1143
|
+
}
|
|
1144
|
+
let change;
|
|
1145
|
+
try {
|
|
1146
|
+
change = deserializeEncryptedGroupChange(actions);
|
|
1147
|
+
assertRecognizedActionShape(change, 'submission');
|
|
1148
|
+
}
|
|
1149
|
+
catch (error) {
|
|
1150
|
+
if (error instanceof GroupServerError)
|
|
1151
|
+
throw error;
|
|
1152
|
+
return rejectBadRequest('Actions are malformed');
|
|
1153
|
+
}
|
|
1154
|
+
if (change.groupId !== undefined) {
|
|
1155
|
+
rejectBadRequest('Client must not set Actions.groupId');
|
|
1156
|
+
}
|
|
1157
|
+
if (change.revision !== stored.state.version + 1) {
|
|
1158
|
+
rejectConflict(`Actions revision ${change.revision} does not follow ${stored.state.version}`);
|
|
1159
|
+
}
|
|
1160
|
+
verifyChangeProfileKeyPresentations(stored.state, change, this.serverSecretParams, Math.floor(operationTime / 1000));
|
|
1161
|
+
requirePniAciBinding(change, requester);
|
|
1162
|
+
const sourceUserId = sourceUserIdForChange(stored.state, change, requester);
|
|
1163
|
+
// All authorization facts are evaluated against the unchanged pre-state.
|
|
1164
|
+
authorizeEncryptedChange(stored.state, change, sourceUserId, requester);
|
|
1165
|
+
requireInviteLinkPassword(stored.state, change, requester, inviteLinkPassword);
|
|
1166
|
+
const acceptedChange = canonicalizeAcceptedChange(stored.state, change, sourceUserId, groupId, operationTime);
|
|
1167
|
+
assertRecognizedActionShape(acceptedChange, 'canonical');
|
|
1168
|
+
const nextState = applyEncryptedChange(stored.state, acceptedChange);
|
|
1169
|
+
assertEncryptedStateStructure(nextState);
|
|
1170
|
+
const acceptedActions = serializeEncryptedGroupChange(acceptedChange);
|
|
1171
|
+
const changeEpoch = requiredGroupChangeEpoch(acceptedChange);
|
|
1172
|
+
const signature = serverSign(this.serverSecretParams, this.runtime.randomBytes(32), serializeGroupChangeCommitment(changeEpoch, acceptedActions));
|
|
1173
|
+
const entry = {
|
|
1174
|
+
version: acceptedChange.revision,
|
|
1175
|
+
actions: acceptedActions,
|
|
1176
|
+
serverSignature: signature,
|
|
1177
|
+
changeEpoch,
|
|
1178
|
+
timestamp: operationTime,
|
|
1179
|
+
};
|
|
1180
|
+
stored.state = nextState;
|
|
1181
|
+
stored.snapshots.set(nextState.version, this.createStoredSnapshot(groupId, nextState));
|
|
1182
|
+
stored.changes.push(structuredClone(entry));
|
|
1183
|
+
return structuredClone(entry);
|
|
1184
|
+
}
|
|
1185
|
+
}
|
|
1186
|
+
//# sourceMappingURL=server-engine.js.map
|