@open-e2ee/signal-protocol-sdk 0.1.0-alpha.6 → 0.1.0-alpha.7

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.
Files changed (179) hide show
  1. package/ARCHITECTURE.md +1 -1
  2. package/CHANGELOG.md +196 -1
  3. package/dist/client/client.d.ts +32 -28
  4. package/dist/client/client.d.ts.map +1 -1
  5. package/dist/client/client.js +120 -72
  6. package/dist/client/client.js.map +1 -1
  7. package/dist/client/compose.d.ts +6 -1
  8. package/dist/client/compose.d.ts.map +1 -1
  9. package/dist/client/compose.js +2 -0
  10. package/dist/client/compose.js.map +1 -1
  11. package/dist/client/config.d.ts +41 -17
  12. package/dist/client/config.d.ts.map +1 -1
  13. package/dist/client/config.js.map +1 -1
  14. package/dist/client/endorsement-manager.d.ts +4 -0
  15. package/dist/client/endorsement-manager.d.ts.map +1 -1
  16. package/dist/client/endorsement-manager.js +9 -0
  17. package/dist/client/endorsement-manager.js.map +1 -1
  18. package/dist/client/groups.d.ts +29 -29
  19. package/dist/client/groups.d.ts.map +1 -1
  20. package/dist/client/groups.js +54 -37
  21. package/dist/client/groups.js.map +1 -1
  22. package/dist/client/signal-service-cipher.d.ts +5 -1
  23. package/dist/client/signal-service-cipher.d.ts.map +1 -1
  24. package/dist/client/signal-service-cipher.js +7 -1
  25. package/dist/client/signal-service-cipher.js.map +1 -1
  26. package/dist/groups/index.d.ts +4 -4
  27. package/dist/groups/index.d.ts.map +1 -1
  28. package/dist/groups/index.js +3 -3
  29. package/dist/groups/index.js.map +1 -1
  30. package/dist/index.d.ts +5 -5
  31. package/dist/index.d.ts.map +1 -1
  32. package/dist/index.js +3 -3
  33. package/dist/index.js.map +1 -1
  34. package/dist/internal/groups/access-control.d.ts +170 -0
  35. package/dist/internal/groups/access-control.d.ts.map +1 -0
  36. package/dist/internal/groups/access-control.js +284 -0
  37. package/dist/internal/groups/access-control.js.map +1 -0
  38. package/dist/internal/groups/change-actions.d.ts +57 -0
  39. package/dist/internal/groups/change-actions.d.ts.map +1 -0
  40. package/dist/internal/groups/change-actions.js +827 -0
  41. package/dist/internal/groups/change-actions.js.map +1 -0
  42. package/dist/internal/groups/change-authorization.d.ts +16 -0
  43. package/dist/internal/groups/change-authorization.d.ts.map +1 -0
  44. package/dist/internal/groups/change-authorization.js +120 -0
  45. package/dist/internal/groups/change-authorization.js.map +1 -0
  46. package/dist/internal/{groups-v2 → groups}/encrypted-state.d.ts +12 -2
  47. package/dist/internal/groups/encrypted-state.d.ts.map +1 -0
  48. package/dist/internal/{groups-v2 → groups}/encrypted-state.js +122 -22
  49. package/dist/internal/groups/encrypted-state.js.map +1 -0
  50. package/dist/internal/groups/group-id.d.ts +9 -9
  51. package/dist/internal/groups/group-id.d.ts.map +1 -1
  52. package/dist/internal/groups/group-id.js +11 -12
  53. package/dist/internal/groups/group-id.js.map +1 -1
  54. package/dist/internal/groups/index.d.ts +16 -6
  55. package/dist/internal/groups/index.d.ts.map +1 -1
  56. package/dist/internal/groups/index.js +9 -1
  57. package/dist/internal/groups/index.js.map +1 -1
  58. package/dist/internal/groups/invite-link.d.ts.map +1 -0
  59. package/dist/internal/groups/invite-link.js.map +1 -0
  60. package/dist/internal/{groups-v2 → groups}/manager.d.ts +175 -40
  61. package/dist/internal/groups/manager.d.ts.map +1 -0
  62. package/dist/internal/groups/manager.js +1862 -0
  63. package/dist/internal/groups/manager.js.map +1 -0
  64. package/dist/internal/groups/sdk-store.d.ts +32 -0
  65. package/dist/internal/groups/sdk-store.d.ts.map +1 -0
  66. package/dist/internal/groups/sdk-store.js +111 -0
  67. package/dist/internal/groups/sdk-store.js.map +1 -0
  68. package/dist/internal/groups/server-engine.d.ts +52 -0
  69. package/dist/internal/groups/server-engine.d.ts.map +1 -0
  70. package/dist/internal/groups/server-engine.js +1126 -0
  71. package/dist/internal/groups/server-engine.js.map +1 -0
  72. package/dist/internal/groups/trust-root.d.ts +32 -0
  73. package/dist/internal/groups/trust-root.d.ts.map +1 -0
  74. package/dist/internal/groups/trust-root.js +91 -0
  75. package/dist/internal/groups/trust-root.js.map +1 -0
  76. package/dist/internal/{groups-v2 → groups}/types.d.ts +188 -46
  77. package/dist/internal/groups/types.d.ts.map +1 -0
  78. package/dist/internal/{groups-v2 → groups}/types.js +3 -2
  79. package/dist/internal/groups/types.js.map +1 -0
  80. package/dist/internal/groups/wire.d.ts +68 -0
  81. package/dist/internal/groups/wire.d.ts.map +1 -0
  82. package/dist/internal/groups/wire.js +708 -0
  83. package/dist/internal/groups/wire.js.map +1 -0
  84. package/dist/internal/protocol/sender-keys/index.d.ts +1 -1
  85. package/dist/internal/protocol/sender-keys/manager.d.ts +1 -1
  86. package/dist/internal/protocol/sender-keys/manager.js +1 -1
  87. package/dist/internal/protocol/zk/groups/auth-credential.d.ts +9 -7
  88. package/dist/internal/protocol/zk/groups/auth-credential.d.ts.map +1 -1
  89. package/dist/internal/protocol/zk/groups/auth-credential.js +68 -29
  90. package/dist/internal/protocol/zk/groups/auth-credential.js.map +1 -1
  91. package/dist/internal/protocol/zk/groups/server-params.d.ts +1 -1
  92. package/dist/internal/protocol/zk/groups/server-params.d.ts.map +1 -1
  93. package/dist/internal/protocol/zk/groups/server-params.js.map +1 -1
  94. package/dist/internal/protocol/zk/groups/uid-struct.d.ts +2 -0
  95. package/dist/internal/protocol/zk/groups/uid-struct.d.ts.map +1 -1
  96. package/dist/internal/protocol/zk/groups/uid-struct.js +4 -0
  97. package/dist/internal/protocol/zk/groups/uid-struct.js.map +1 -1
  98. package/dist/layers.d.ts +1 -1
  99. package/dist/layers.js +3 -3
  100. package/dist/layers.js.map +1 -1
  101. package/dist/remote/relay/convex/group-server.d.ts +23 -21
  102. package/dist/remote/relay/convex/group-server.d.ts.map +1 -1
  103. package/dist/remote/relay/convex/group-server.js +49 -21
  104. package/dist/remote/relay/convex/group-server.js.map +1 -1
  105. package/dist/remote/relay/convex/relay.d.ts +16 -8
  106. package/dist/remote/relay/convex/relay.d.ts.map +1 -1
  107. package/dist/remote/relay/convex/relay.js +72 -13
  108. package/dist/remote/relay/convex/relay.js.map +1 -1
  109. package/dist/remote/relay/convex/server/index.d.ts +2 -0
  110. package/dist/remote/relay/convex/server/index.d.ts.map +1 -0
  111. package/dist/remote/relay/convex/server/index.js +2 -0
  112. package/dist/remote/relay/convex/server/index.js.map +1 -0
  113. package/dist/remote/relay/convex/server.d.ts +150 -0
  114. package/dist/remote/relay/convex/server.d.ts.map +1 -0
  115. package/dist/remote/relay/convex/server.js +506 -0
  116. package/dist/remote/relay/convex/server.js.map +1 -0
  117. package/dist/remote/relay/index.d.ts +1 -1
  118. package/dist/remote/relay/index.d.ts.map +1 -1
  119. package/dist/remote/relay/index.js.map +1 -1
  120. package/dist/remote/relay/mock/adapter.d.ts +31 -13
  121. package/dist/remote/relay/mock/adapter.d.ts.map +1 -1
  122. package/dist/remote/relay/mock/adapter.js +66 -61
  123. package/dist/remote/relay/mock/adapter.js.map +1 -1
  124. package/dist/remote/relay/mock/group-server.d.ts +9 -0
  125. package/dist/remote/relay/mock/group-server.d.ts.map +1 -0
  126. package/dist/remote/relay/mock/group-server.js +9 -0
  127. package/dist/remote/relay/mock/group-server.js.map +1 -0
  128. package/dist/remote/relay/types.d.ts +45 -14
  129. package/dist/remote/relay/types.d.ts.map +1 -1
  130. package/dist/types/api.d.ts +2 -2
  131. package/dist/types/api.d.ts.map +1 -1
  132. package/docs/DEVIATIONS.md +35 -32
  133. package/docs/PACKAGE_SURFACE.md +5 -0
  134. package/docs/api/classes/EndorsementManager.md +18 -0
  135. package/docs/api/classes/SignalProtocolClient.md +77 -77
  136. package/docs/api/functions/createGroupId.md +1 -1
  137. package/docs/api/functions/decodeGroupTrustRoot.md +21 -0
  138. package/docs/api/functions/encodeGroupTrustRoot.md +28 -0
  139. package/docs/api/functions/extractGroupId.md +2 -2
  140. package/docs/api/functions/isGroupId.md +1 -1
  141. package/docs/api/interfaces/GroupTrustRoot.md +33 -0
  142. package/docs/api/interfaces/IRelayGroupServer.md +60 -0
  143. package/docs/api/interfaces/ISignalProtocolClient.md +1 -1
  144. package/docs/api/interfaces/ISignalProtocolRelayServer.md +8 -0
  145. package/docs/api/interfaces/SignalProtocolClientCompositionOptions.md +66 -28
  146. package/docs/api/interfaces/SignalProtocolClientConfig.md +82 -26
  147. package/docs/api/interfaces/SignalProtocolClientIdentityConfig.md +16 -0
  148. package/docs/api/type-aliases/GroupId.md +2 -2
  149. package/docs/api/variables/GROUP_ID_PREFIX.md +11 -0
  150. package/docs/api/variables/GROUP_TRUST_ROOT_VERSION.md +11 -0
  151. package/groups/README.md +16 -5
  152. package/package.json +13 -2
  153. package/remote/relay/convex/README.md +6 -0
  154. package/remote/relay/convex/server/README.md +146 -0
  155. package/scripts/oe-groups.mjs +142 -0
  156. package/dist/internal/groups-v2/access-control.d.ts +0 -108
  157. package/dist/internal/groups-v2/access-control.d.ts.map +0 -1
  158. package/dist/internal/groups-v2/access-control.js +0 -191
  159. package/dist/internal/groups-v2/access-control.js.map +0 -1
  160. package/dist/internal/groups-v2/change-actions.d.ts +0 -40
  161. package/dist/internal/groups-v2/change-actions.d.ts.map +0 -1
  162. package/dist/internal/groups-v2/change-actions.js +0 -363
  163. package/dist/internal/groups-v2/change-actions.js.map +0 -1
  164. package/dist/internal/groups-v2/encrypted-state.d.ts.map +0 -1
  165. package/dist/internal/groups-v2/encrypted-state.js.map +0 -1
  166. package/dist/internal/groups-v2/index.d.ts +0 -19
  167. package/dist/internal/groups-v2/index.d.ts.map +0 -1
  168. package/dist/internal/groups-v2/index.js +0 -11
  169. package/dist/internal/groups-v2/index.js.map +0 -1
  170. package/dist/internal/groups-v2/invite-link.d.ts.map +0 -1
  171. package/dist/internal/groups-v2/invite-link.js.map +0 -1
  172. package/dist/internal/groups-v2/manager.d.ts.map +0 -1
  173. package/dist/internal/groups-v2/manager.js +0 -1095
  174. package/dist/internal/groups-v2/manager.js.map +0 -1
  175. package/dist/internal/groups-v2/types.d.ts.map +0 -1
  176. package/dist/internal/groups-v2/types.js.map +0 -1
  177. package/docs/api/variables/GROUP_V2_PREFIX.md +0 -11
  178. /package/dist/internal/{groups-v2 → groups}/invite-link.d.ts +0 -0
  179. /package/dist/internal/{groups-v2 → groups}/invite-link.js +0 -0
@@ -0,0 +1,146 @@
1
+ # Convex group server
2
+
3
+ This server-only subpath provides the production group-server implementation
4
+ for Convex. It owns canonical encrypted group state, immutable signed changes,
5
+ per-version signed snapshots, anonymous group authorization, credential
6
+ issuance, and group-send endorsements.
7
+
8
+ Import it from:
9
+
10
+ ```ts
11
+ import {
12
+ convexGroupServerTables,
13
+ defineConvexGroupServer,
14
+ } from "@open-e2ee/signal-protocol-sdk/remote/relay/convex/server";
15
+ ```
16
+
17
+ ## Schema
18
+
19
+ The component owns three package-scoped tables. Add them to the app schema:
20
+
21
+ ```ts
22
+ // convex/schema.ts
23
+ import { defineSchema } from "convex/server";
24
+ import {
25
+ convexGroupServerTables,
26
+ } from "@open-e2ee/signal-protocol-sdk/remote/relay/convex/server";
27
+
28
+ export default defineSchema({
29
+ ...convexGroupServerTables,
30
+ // App-owned tables...
31
+ });
32
+ ```
33
+
34
+ The tables store the latest canonical encrypted state, the exact accepted and
35
+ signed action bytes, and every historical encrypted snapshot with its cached
36
+ S14 baseline signature. They never store the group master key, group secret
37
+ parameters, plaintext group attributes, or the server secret.
38
+
39
+ Storage grows with one full encrypted snapshot per accepted version and is
40
+ never pruned. Old snapshots are load-bearing: `getGroupChanges` serves signed
41
+ history from them, so deleting rows breaks catch-up for clients behind that
42
+ version. A snapshot-compaction protocol is future work; budget storage as
43
+ O(versions × state size) per group.
44
+
45
+ ## Functions
46
+
47
+ The relay reads these functions through the same generated namespace as the
48
+ rest of the protocol API — `api.signal` in the
49
+ [Convex relay adapter](../README.md). The modules therefore must live inside
50
+ that namespace: `convex/signal/groups.ts` and `convex/signal/zkAuth.ts`, not
51
+ at the top of `convex/`. Both `groups` and `zkAuth` are optional on
52
+ `ConvexSignalProtocolRelayApi`, so a wrong location still compiles; the relay
53
+ then reports the missing `groupServer` capability on the first group call.
54
+
55
+ Create the handlers with the application's one authentication hook:
56
+
57
+ ```ts
58
+ // convex/signal/groups.ts
59
+ import {
60
+ defineConvexGroupServer,
61
+ } from "@open-e2ee/signal-protocol-sdk/remote/relay/convex/server";
62
+ import { resolveProtocolIdentity } from "../auth";
63
+
64
+ const server = defineConvexGroupServer({
65
+ identify: async (ctx) => {
66
+ const identity = await resolveProtocolIdentity(ctx);
67
+ return {
68
+ aciBytes: identity.aciBytes,
69
+ pniBytes: identity.pniBytes,
70
+ };
71
+ },
72
+ });
73
+
74
+ export const {
75
+ createGroup,
76
+ getGroup,
77
+ getGroupJoinInfo,
78
+ getGroupChanges,
79
+ submitGroupChange,
80
+ refreshGroupSendEndorsements,
81
+ } = server;
82
+ ```
83
+
84
+ Credential functions can be mounted from a second module so the generated API
85
+ matches `ConvexSignalProtocolRelayApi`:
86
+
87
+ ```ts
88
+ // convex/signal/zkAuth.ts
89
+ import {
90
+ defineConvexGroupServer,
91
+ } from "@open-e2ee/signal-protocol-sdk/remote/relay/convex/server";
92
+ import { resolveProtocolIdentity } from "../auth";
93
+
94
+ const server = defineConvexGroupServer({
95
+ identify: async (ctx) => {
96
+ const identity = await resolveProtocolIdentity(ctx);
97
+ return {
98
+ aciBytes: identity.aciBytes,
99
+ pniBytes: identity.pniBytes,
100
+ };
101
+ },
102
+ });
103
+
104
+ export const {
105
+ issueAuthCredentialMutation,
106
+ issueProfileKeyCredentialMutation,
107
+ } = server;
108
+ ```
109
+
110
+ The `identify` hook drives issuance only. Group reads and writes never trust the
111
+ app session for membership; they verify the supplied zero-knowledge
112
+ presentation and enforce S1–S14 over ciphertext.
113
+
114
+ `identify` must return the authenticated account's real ACI, and its real PNI
115
+ or **no PNI at all**. Never substitute a shared placeholder value for accounts
116
+ without a PNI: credentials are matched by ACI-or-PNI alias, so a constant PNI
117
+ issued to every account would let any authenticated user act on any
118
+ PNI-addressed pending membership. An absent PNI must be absent.
119
+
120
+ ## Secret initialization and pinned trust root
121
+
122
+ From the Convex app directory, run:
123
+
124
+ ```sh
125
+ npx oe-groups trust-root
126
+ ```
127
+
128
+ Add `--prod` for the default production deployment or
129
+ `--deployment <name-or-reference>` for another deployment. The command checks
130
+ `OE_GROUPS_SERVER_SECRET`, generates a cryptographically random 32-byte seed
131
+ only when it is absent, writes it to the selected Convex deployment through
132
+ stdin, and prints the base64 serialized trust root. Pin that printed value in
133
+ the client build. Never fetch and trust it at runtime.
134
+
135
+ The seed remains in the Convex environment and deterministically derives all
136
+ four server keypairs. It is never written to a Convex table or log. Back up the
137
+ deployment secret: deleting or replacing it rotates the trust root and strands
138
+ clients pinned to the previous deployment.
139
+
140
+ ## Profile-key issuance threat model
141
+
142
+ `issueProfileKeyCredentialMutation` receives the raw 32-byte profile key. The
143
+ group server therefore sees the plaintext profile key at issuance time. The
144
+ credential proof hides it in later group presentations, but issuance in this
145
+ credential layer is not blinded. Blinded issuance is a future credential-layer
146
+ candidate and is explicitly outside this component's scope.
@@ -0,0 +1,142 @@
1
+ #!/usr/bin/env node
2
+
3
+ import { randomBytes } from 'node:crypto';
4
+ import { spawnSync } from 'node:child_process';
5
+ import { fileURLToPath, pathToFileURL } from 'node:url';
6
+ import path from 'node:path';
7
+
8
+ const SECRET_ENV_VAR = 'OE_GROUPS_SERVER_SECRET';
9
+
10
+ function usage(message) {
11
+ if (message) process.stderr.write(`${message}\n\n`);
12
+ process.stderr.write(
13
+ 'Usage: oe-groups trust-root [--prod | --deployment <deployment>]\n'
14
+ );
15
+ process.exitCode = 2;
16
+ }
17
+
18
+ function deploymentArgs(args) {
19
+ if (args.length === 0) return [];
20
+ if (args.length === 1 && args[0] === '--prod') return ['--prod'];
21
+ if (
22
+ args.length === 2 &&
23
+ args[0] === '--deployment' &&
24
+ args[1].trim().length > 0
25
+ ) {
26
+ return args;
27
+ }
28
+ usage('Invalid deployment arguments');
29
+ return null;
30
+ }
31
+
32
+ function runConvex(args, options = {}) {
33
+ const command = process.platform === 'win32' ? 'npx.cmd' : 'npx';
34
+ const result = spawnSync(command, ['convex', 'env', ...args], {
35
+ cwd: process.cwd(),
36
+ encoding: 'utf8',
37
+ input: options.input,
38
+ stdio: ['pipe', 'pipe', 'pipe'],
39
+ });
40
+ if (result.error) throw result.error;
41
+ if (result.status !== 0) {
42
+ const detail = result.stderr?.trim();
43
+ throw new Error(
44
+ detail
45
+ ? `Convex environment command failed: ${detail}`
46
+ : `Convex environment command exited with status ${result.status}`
47
+ );
48
+ }
49
+ return result.stdout ?? '';
50
+ }
51
+
52
+ function requireSeed(encoded) {
53
+ const normalized = encoded.trim();
54
+ const seed = Buffer.from(normalized, 'base64');
55
+ if (
56
+ seed.length !== 32 ||
57
+ seed.toString('base64') !== normalized
58
+ ) {
59
+ throw new Error(
60
+ `${SECRET_ENV_VAR} must be canonical base64 encoding exactly 32 bytes`
61
+ );
62
+ }
63
+ return new Uint8Array(seed);
64
+ }
65
+
66
+ async function printTrustRoot(args) {
67
+ const selectedDeployment = deploymentArgs(args);
68
+ if (!selectedDeployment) return;
69
+
70
+ const names = runConvex([
71
+ 'list',
72
+ '--names-only',
73
+ ...selectedDeployment,
74
+ ])
75
+ .split(/\r?\n/)
76
+ .map((name) => name.trim())
77
+ .filter(Boolean);
78
+
79
+ let seed;
80
+ if (names.includes(SECRET_ENV_VAR)) {
81
+ seed = requireSeed(
82
+ runConvex(['get', SECRET_ENV_VAR, ...selectedDeployment])
83
+ );
84
+ } else {
85
+ seed = new Uint8Array(randomBytes(32));
86
+ const encoded = Buffer.from(seed).toString('base64');
87
+ runConvex(
88
+ ['set', SECRET_ENV_VAR, ...selectedDeployment],
89
+ { input: `${encoded}\n` }
90
+ );
91
+ }
92
+
93
+ const scriptDirectory = path.dirname(fileURLToPath(import.meta.url));
94
+ const [
95
+ { generateServerSecretParams, getServerPublicParams },
96
+ { encodeGroupTrustRoot },
97
+ ] = await Promise.all([
98
+ // pathToFileURL: dynamic import of a bare absolute path fails on
99
+ // Windows, where the ESM loader requires a file:// URL.
100
+ import(
101
+ pathToFileURL(
102
+ path.join(
103
+ scriptDirectory,
104
+ '../dist/internal/protocol/zk/groups/server-params.js'
105
+ )
106
+ ).href
107
+ ),
108
+ import(
109
+ pathToFileURL(
110
+ path.join(
111
+ scriptDirectory,
112
+ '../dist/internal/groups/trust-root.js'
113
+ )
114
+ ).href
115
+ ),
116
+ ]);
117
+ const secretParams = generateServerSecretParams(seed);
118
+ seed.fill(0);
119
+ const publicParams = getServerPublicParams(secretParams);
120
+ const trustRoot = encodeGroupTrustRoot({
121
+ credentialPublicKey: publicParams.credentialPublicKey,
122
+ serverSigningPublicKey: publicParams.signingPublicKey,
123
+ profileKeyCredentialPublicKey:
124
+ publicParams.profileKeyCredentialPublicKey,
125
+ endorsementRootPublicKey: publicParams.endorsementPublicKey,
126
+ });
127
+ process.stdout.write(`${Buffer.from(trustRoot).toString('base64')}\n`);
128
+ }
129
+
130
+ const [command, ...args] = process.argv.slice(2);
131
+ if (command !== 'trust-root') {
132
+ usage(command ? `Unknown command: ${command}` : undefined);
133
+ } else {
134
+ try {
135
+ await printTrustRoot(args);
136
+ } catch (error) {
137
+ process.stderr.write(
138
+ `${error instanceof Error ? error.message : String(error)}\n`
139
+ );
140
+ process.exitCode = 1;
141
+ }
142
+ }
@@ -1,108 +0,0 @@
1
- /**
2
- * GroupsV2 Access Control
3
- *
4
- * Authorization checks for group operations based on member roles and
5
- * access control settings.
6
- *
7
- * These are client-local checks over already-decrypted group state. They use
8
- * the role and access-required vocabulary of the Signal Protocol group system,
9
- * but they are not that system's enforcement model: there, the server
10
- * validates each change against embedded zero-knowledge presentations. Here
11
- * the server sees only opaque state and a version number, so these checks
12
- * bind an honest client, not a hostile one.
13
- *
14
- * @module groups-v2/access-control
15
- */
16
- import { type DecryptedGroup, type DecryptedMember, MemberRole, AccessRequired } from './types.js';
17
- /**
18
- * Actions that can be performed on a group.
19
- * Each action has specific authorization requirements.
20
- */
21
- export {};
22
- export declare enum GroupAction {
23
- MODIFY_TITLE = "MODIFY_TITLE",
24
- MODIFY_AVATAR = "MODIFY_AVATAR",
25
- MODIFY_DESCRIPTION = "MODIFY_DESCRIPTION",
26
- MODIFY_DISAPPEARING_MESSAGES = "MODIFY_DISAPPEARING_MESSAGES",
27
- ADD_MEMBER = "ADD_MEMBER",
28
- REMOVE_MEMBER = "REMOVE_MEMBER",
29
- MODIFY_MEMBER_ROLE = "MODIFY_MEMBER_ROLE",
30
- MODIFY_MEMBER_LABEL = "MODIFY_MEMBER_LABEL",
31
- MODIFY_ATTRIBUTES_ACCESS = "MODIFY_ATTRIBUTES_ACCESS",
32
- MODIFY_MEMBERS_ACCESS = "MODIFY_MEMBERS_ACCESS",
33
- MODIFY_INVITE_LINK_ACCESS = "MODIFY_INVITE_LINK_ACCESS",
34
- MODIFY_INVITE_LINK_PASSWORD = "MODIFY_INVITE_LINK_PASSWORD",
35
- MODIFY_ANNOUNCEMENTS = "MODIFY_ANNOUNCEMENTS",
36
- BAN_MEMBER = "BAN_MEMBER",
37
- UNBAN_MEMBER = "UNBAN_MEMBER",
38
- SEND_MESSAGE = "SEND_MESSAGE"
39
- }
40
- /**
41
- * Find a member in the group by their ACI (Account Identity).
42
- *
43
- * @param group - Decrypted group state
44
- * @param aciBytes - Member's ACI as bytes (32 bytes UUID)
45
- * @returns Member object if found, undefined otherwise
46
- */
47
- export declare function findMember(group: DecryptedGroup, aciBytes: Uint8Array): DecryptedMember | undefined;
48
- /**
49
- * Get a member's role in the group.
50
- *
51
- * @param group - Decrypted group state
52
- * @param aciBytes - Member's ACI as bytes
53
- * @returns Member's role, or UNKNOWN if not a member
54
- */
55
- export declare function getMemberRole(group: DecryptedGroup, aciBytes: Uint8Array): MemberRole;
56
- /**
57
- * Check if a member role satisfies an access requirement.
58
- *
59
- * @param memberRole - The member's current role
60
- * @param requirement - The required access level
61
- * @returns True if the member role meets the requirement
62
- */
63
- export declare function meetsAccessRequirement(memberRole: MemberRole, requirement: AccessRequired): boolean;
64
- /**
65
- * Check if a member can perform a specific action on the group.
66
- * Core authorization function for all group operations.
67
- *
68
- * @param group - Decrypted group state
69
- * @param aciBytes - Member's ACI as bytes
70
- * @param action - The action to check
71
- * @returns True if the member is authorized to perform the action
72
- */
73
- export declare function canPerformAction(group: DecryptedGroup, aciBytes: Uint8Array, action: GroupAction): boolean;
74
- /**
75
- * Check if a member is an administrator of the group.
76
- * Convenience function for common authorization check.
77
- *
78
- * @param group - Decrypted group state
79
- * @param aciBytes - Member's ACI as bytes
80
- * @returns True if the member is an administrator
81
- */
82
- export declare function isAdmin(group: DecryptedGroup, aciBytes: Uint8Array): boolean;
83
- /**
84
- * Check if a user is a member of the group.
85
- * Convenience function to check membership status.
86
- *
87
- * @param group - Decrypted group state
88
- * @param aciBytes - User's ACI as bytes
89
- * @returns True if the user is a member
90
- */
91
- export declare function isMember(group: DecryptedGroup, aciBytes: Uint8Array): boolean;
92
- /**
93
- * Check if a user has a pending membership invitation.
94
- *
95
- * @param group - Decrypted group state
96
- * @param serviceIdBytes - User's service ID (ACI or PNI) as bytes
97
- * @returns True if the user has a pending invitation
98
- */
99
- export declare function isPending(group: DecryptedGroup, serviceIdBytes: Uint8Array): boolean;
100
- /**
101
- * Check if a user is banned from the group.
102
- *
103
- * @param group - Decrypted group state
104
- * @param serviceIdBytes - User's service ID (ACI or PNI) as bytes
105
- * @returns True if the user is banned
106
- */
107
- export declare function isBanned(group: DecryptedGroup, serviceIdBytes: Uint8Array): boolean;
108
- //# sourceMappingURL=access-control.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"access-control.d.ts","sourceRoot":"","sources":["../../../internal/groups-v2/access-control.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,UAAU,EACV,cAAc,EAEf,MAAM,SAAS,CAAC;AAGjB;;;GAGG;AACH,OAAO,EAAE,CAAC;AACV,oBAAY,WAAW;IAErB,YAAY,iBAAiB;IAC7B,aAAa,kBAAkB;IAC/B,kBAAkB,uBAAuB;IACzC,4BAA4B,iCAAiC;IAG7D,UAAU,eAAe;IACzB,aAAa,kBAAkB;IAC/B,kBAAkB,uBAAuB;IACzC,mBAAmB,wBAAwB;IAG3C,wBAAwB,6BAA6B;IACrD,qBAAqB,0BAA0B;IAC/C,yBAAyB,8BAA8B;IACvD,2BAA2B,gCAAgC;IAG3D,oBAAoB,yBAAyB;IAG7C,UAAU,eAAe;IACzB,YAAY,iBAAiB;IAG7B,YAAY,iBAAiB;CAC9B;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,cAAc,EACrB,QAAQ,EAAE,UAAU,GACnB,eAAe,GAAG,SAAS,CAE7B;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,UAAU,GAAG,UAAU,CAGrF;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,UAAU,EACtB,WAAW,EAAE,cAAc,GAC1B,OAAO,CAoBT;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,cAAc,EACrB,QAAQ,EAAE,UAAU,EACpB,MAAM,EAAE,WAAW,GAClB,OAAO,CA4DT;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,UAAU,GAAG,OAAO,CAE5E;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,UAAU,GAAG,OAAO,CAE7E;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,GAAG,OAAO,CAEpF;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,GAAG,OAAO,CAEnF"}
@@ -1,191 +0,0 @@
1
- /**
2
- * GroupsV2 Access Control
3
- *
4
- * Authorization checks for group operations based on member roles and
5
- * access control settings.
6
- *
7
- * These are client-local checks over already-decrypted group state. They use
8
- * the role and access-required vocabulary of the Signal Protocol group system,
9
- * but they are not that system's enforcement model: there, the server
10
- * validates each change against embedded zero-knowledge presentations. Here
11
- * the server sees only opaque state and a version number, so these checks
12
- * bind an honest client, not a hostile one.
13
- *
14
- * @module groups-v2/access-control
15
- */
16
- import { MemberRole, AccessRequired, EnabledState, } from './types.js';
17
- import { constantTimeEqual as bytesEqual } from '../crypto/utils.js';
18
- export var GroupAction;
19
- (function (GroupAction) {
20
- // Attribute modifications
21
- GroupAction["MODIFY_TITLE"] = "MODIFY_TITLE";
22
- GroupAction["MODIFY_AVATAR"] = "MODIFY_AVATAR";
23
- GroupAction["MODIFY_DESCRIPTION"] = "MODIFY_DESCRIPTION";
24
- GroupAction["MODIFY_DISAPPEARING_MESSAGES"] = "MODIFY_DISAPPEARING_MESSAGES";
25
- // Membership operations
26
- GroupAction["ADD_MEMBER"] = "ADD_MEMBER";
27
- GroupAction["REMOVE_MEMBER"] = "REMOVE_MEMBER";
28
- GroupAction["MODIFY_MEMBER_ROLE"] = "MODIFY_MEMBER_ROLE";
29
- GroupAction["MODIFY_MEMBER_LABEL"] = "MODIFY_MEMBER_LABEL";
30
- // Access control modifications (admin only)
31
- GroupAction["MODIFY_ATTRIBUTES_ACCESS"] = "MODIFY_ATTRIBUTES_ACCESS";
32
- GroupAction["MODIFY_MEMBERS_ACCESS"] = "MODIFY_MEMBERS_ACCESS";
33
- GroupAction["MODIFY_INVITE_LINK_ACCESS"] = "MODIFY_INVITE_LINK_ACCESS";
34
- GroupAction["MODIFY_INVITE_LINK_PASSWORD"] = "MODIFY_INVITE_LINK_PASSWORD";
35
- // Announcement mode (admin only)
36
- GroupAction["MODIFY_ANNOUNCEMENTS"] = "MODIFY_ANNOUNCEMENTS";
37
- // Ban operations (admin only)
38
- GroupAction["BAN_MEMBER"] = "BAN_MEMBER";
39
- GroupAction["UNBAN_MEMBER"] = "UNBAN_MEMBER";
40
- // Message sending
41
- GroupAction["SEND_MESSAGE"] = "SEND_MESSAGE";
42
- })(GroupAction || (GroupAction = {}));
43
- /**
44
- * Find a member in the group by their ACI (Account Identity).
45
- *
46
- * @param group - Decrypted group state
47
- * @param aciBytes - Member's ACI as bytes (32 bytes UUID)
48
- * @returns Member object if found, undefined otherwise
49
- */
50
- export function findMember(group, aciBytes) {
51
- return group.members.find((member) => bytesEqual(member.aciBytes, aciBytes));
52
- }
53
- /**
54
- * Get a member's role in the group.
55
- *
56
- * @param group - Decrypted group state
57
- * @param aciBytes - Member's ACI as bytes
58
- * @returns Member's role, or UNKNOWN if not a member
59
- */
60
- export function getMemberRole(group, aciBytes) {
61
- const member = findMember(group, aciBytes);
62
- return member?.role ?? MemberRole.UNKNOWN;
63
- }
64
- /**
65
- * Check if a member role satisfies an access requirement.
66
- *
67
- * @param memberRole - The member's current role
68
- * @param requirement - The required access level
69
- * @returns True if the member role meets the requirement
70
- */
71
- export function meetsAccessRequirement(memberRole, requirement) {
72
- switch (requirement) {
73
- case AccessRequired.ANY:
74
- case AccessRequired.MEMBER:
75
- // Any member (DEFAULT or ADMINISTRATOR) can perform the action
76
- return memberRole === MemberRole.DEFAULT || memberRole === MemberRole.ADMINISTRATOR;
77
- case AccessRequired.ADMINISTRATOR:
78
- // Only administrators can perform the action
79
- return memberRole === MemberRole.ADMINISTRATOR;
80
- case AccessRequired.UNSATISFIABLE:
81
- // Feature is disabled, no one can perform the action
82
- return false;
83
- case AccessRequired.UNKNOWN:
84
- default:
85
- // Unknown access level, deny by default
86
- return false;
87
- }
88
- }
89
- /**
90
- * Check if a member can perform a specific action on the group.
91
- * Core authorization function for all group operations.
92
- *
93
- * @param group - Decrypted group state
94
- * @param aciBytes - Member's ACI as bytes
95
- * @param action - The action to check
96
- * @returns True if the member is authorized to perform the action
97
- */
98
- export function canPerformAction(group, aciBytes, action) {
99
- const member = findMember(group, aciBytes);
100
- if (!member) {
101
- // Not a member, cannot perform any action
102
- return false;
103
- }
104
- const role = member.role;
105
- switch (action) {
106
- // Message sending
107
- case GroupAction.SEND_MESSAGE:
108
- // In announcement groups, only admins can send messages
109
- if (group.isAnnouncementGroup === EnabledState.ENABLED) {
110
- return role === MemberRole.ADMINISTRATOR;
111
- }
112
- // Otherwise, any member can send messages
113
- return true;
114
- // Attribute modifications
115
- case GroupAction.MODIFY_TITLE:
116
- case GroupAction.MODIFY_AVATAR:
117
- case GroupAction.MODIFY_DESCRIPTION:
118
- case GroupAction.MODIFY_DISAPPEARING_MESSAGES:
119
- return meetsAccessRequirement(role, group.accessControl.attributes);
120
- // Membership operations
121
- case GroupAction.ADD_MEMBER:
122
- return meetsAccessRequirement(role, group.accessControl.members);
123
- case GroupAction.REMOVE_MEMBER:
124
- // Admins can remove any member
125
- // Non-admins can only remove themselves (self-leave)
126
- return role === MemberRole.ADMINISTRATOR;
127
- case GroupAction.MODIFY_MEMBER_ROLE:
128
- case GroupAction.MODIFY_MEMBER_LABEL:
129
- // Only admins can modify member roles and labels
130
- return role === MemberRole.ADMINISTRATOR;
131
- // Access control modifications (admin only)
132
- case GroupAction.MODIFY_ATTRIBUTES_ACCESS:
133
- case GroupAction.MODIFY_MEMBERS_ACCESS:
134
- case GroupAction.MODIFY_INVITE_LINK_ACCESS:
135
- case GroupAction.MODIFY_INVITE_LINK_PASSWORD:
136
- return role === MemberRole.ADMINISTRATOR;
137
- // Announcement mode (admin only)
138
- case GroupAction.MODIFY_ANNOUNCEMENTS:
139
- return role === MemberRole.ADMINISTRATOR;
140
- // Ban operations (admin only)
141
- case GroupAction.BAN_MEMBER:
142
- case GroupAction.UNBAN_MEMBER:
143
- return role === MemberRole.ADMINISTRATOR;
144
- default:
145
- // Unknown action, deny by default
146
- return false;
147
- }
148
- }
149
- /**
150
- * Check if a member is an administrator of the group.
151
- * Convenience function for common authorization check.
152
- *
153
- * @param group - Decrypted group state
154
- * @param aciBytes - Member's ACI as bytes
155
- * @returns True if the member is an administrator
156
- */
157
- export function isAdmin(group, aciBytes) {
158
- return getMemberRole(group, aciBytes) === MemberRole.ADMINISTRATOR;
159
- }
160
- /**
161
- * Check if a user is a member of the group.
162
- * Convenience function to check membership status.
163
- *
164
- * @param group - Decrypted group state
165
- * @param aciBytes - User's ACI as bytes
166
- * @returns True if the user is a member
167
- */
168
- export function isMember(group, aciBytes) {
169
- return findMember(group, aciBytes) !== undefined;
170
- }
171
- /**
172
- * Check if a user has a pending membership invitation.
173
- *
174
- * @param group - Decrypted group state
175
- * @param serviceIdBytes - User's service ID (ACI or PNI) as bytes
176
- * @returns True if the user has a pending invitation
177
- */
178
- export function isPending(group, serviceIdBytes) {
179
- return group.pendingMembers.some((pending) => bytesEqual(pending.serviceIdBytes, serviceIdBytes));
180
- }
181
- /**
182
- * Check if a user is banned from the group.
183
- *
184
- * @param group - Decrypted group state
185
- * @param serviceIdBytes - User's service ID (ACI or PNI) as bytes
186
- * @returns True if the user is banned
187
- */
188
- export function isBanned(group, serviceIdBytes) {
189
- return group.bannedMembers.some((banned) => bytesEqual(banned.serviceIdBytes, serviceIdBytes));
190
- }
191
- //# sourceMappingURL=access-control.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"access-control.js","sourceRoot":"","sources":["../../../internal/groups-v2/access-control.ts"],"names":[],"mappings":"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"}
@@ -1,40 +0,0 @@
1
- /**
2
- * Group Change Application
3
- *
4
- * Pure functions for applying DecryptedGroupChange operations to DecryptedGroup state.
5
- *
6
- * Operations are applied in ascending DecryptedGroupChange field-number order.
7
- * That ordering is this SDK's choice, taken from the proto field numbering for
8
- * determinism; the Signal Protocol group specifications do not define a
9
- * normative application order.
10
- *
11
- * @module change-actions
12
- */
13
- import { type DecryptedGroup, type DecryptedGroupChange } from './types.js';
14
- /**
15
- * Deep clone a DecryptedGroup to ensure immutability.
16
- */
17
- export {};
18
- /**
19
- * Apply a DecryptedGroupChange to a DecryptedGroup state.
20
- *
21
- * This is a pure function that returns a new state object without mutating the input.
22
- * Changes are applied in ascending DecryptedGroupChange proto field-number
23
- * order. See the module header: this ordering is chosen for determinism, not
24
- * mandated by a specification.
25
- *
26
- * @param state - Current group state
27
- * @param change - Change to apply
28
- * @returns New group state with changes applied
29
- * @throws Error if revision is not sequential
30
- */
31
- export declare function applyGroupChange(state: DecryptedGroup, change: DecryptedGroupChange): DecryptedGroup;
32
- /**
33
- * Validate a DecryptedGroupChange against current group state.
34
- *
35
- * @param state - Current group state
36
- * @param change - Change to validate
37
- * @returns Array of validation error strings (empty if valid)
38
- */
39
- export declare function validateChange(state: DecryptedGroup, change: DecryptedGroupChange): string[];
40
- //# sourceMappingURL=change-actions.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"change-actions.d.ts","sourceRoot":"","sources":["../../../internal/groups-v2/change-actions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,KAAK,cAAc,EAEnB,KAAK,oBAAoB,EAI1B,MAAM,SAAS,CAAC;AAGjB;;GAEG;AACH,OAAO,EAAE,CAAC;AAYV;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,oBAAoB,GAC3B,cAAc,CA+QhB;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,oBAAoB,GAAG,MAAM,EAAE,CA+H5F"}