@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
@@ -4,9 +4,10 @@
4
4
  * Implementation of IGroupServer using Convex mutations/queries for
5
5
  * server-side encrypted group state storage.
6
6
  *
7
- * The server stores encrypted (opaque) group state and enforces version
8
- * sequencing. It never decrypts group content. This adapter bridges
9
- * the IGroupServer interface (Uint8Array) to Convex's v.bytes() (ArrayBuffer).
7
+ * This is a client transport adapter, not an enforcing group server. The
8
+ * application-supplied Convex functions must implement the enforcing-server
9
+ * obligations. This adapter bridges IGroupServer (Uint8Array) to Convex
10
+ * v.bytes() (ArrayBuffer).
10
11
  *
11
12
  * The application supplies its generated Convex function references. Those
12
13
  * functions retain responsibility for authentication, authorization, and
@@ -15,7 +16,7 @@
15
16
  import type { ConvexReactClient } from 'convex/react';
16
17
  import type { ConvexHttpClient } from 'convex/browser';
17
18
  import type { FunctionReference } from 'convex/server';
18
- import type { IGroupServer, GroupAuthorization, GroupChangeLogEntry } from '../../../internal/groups-v2/manager.js';
19
+ import type { IGroupServer, GroupAuthorization, GroupChangeLogEntry, GroupSnapshot } from '../../../internal/groups/manager.js';
19
20
  /**
20
21
  * Either ConvexReactClient or ConvexHttpClient can be used.
21
22
  * This allows the adapter to work in both React contexts and background tasks.
@@ -25,6 +26,7 @@ type ConvexClient = ConvexReactClient | ConvexHttpClient;
25
26
  export interface ConvexGroupServerApi {
26
27
  createGroup: FunctionReference<'mutation'>;
27
28
  getGroup: FunctionReference<'query'>;
29
+ getGroupJoinInfo: FunctionReference<'query'>;
28
30
  getGroupChanges: FunctionReference<'query'>;
29
31
  submitGroupChange: FunctionReference<'mutation'>;
30
32
  }
@@ -47,8 +49,8 @@ export interface ConvexGroupServerApi {
47
49
  * const groupApi = api.signal.groups satisfies ConvexGroupServerApi;
48
50
  * const groupServer = new ConvexGroupServer(convex, groupApi);
49
51
  *
50
- * // Use with GroupsV2Manager
51
- * const manager = new GroupsV2Manager({
52
+ * // Use with GroupManager
53
+ * const manager = new GroupManager({
52
54
  * server: groupServer,
53
55
  * store: localStore,
54
56
  * ...
@@ -68,21 +70,24 @@ export declare class ConvexGroupServer implements IGroupServer {
68
70
  */
69
71
  createGroup(groupId: Uint8Array, encryptedState: Uint8Array, authorization: GroupAuthorization): Promise<void>;
70
72
  /**
71
- * Get the latest encrypted group state from the server.
73
+ * Get encrypted group state from the server.
72
74
  *
73
75
  * @param groupId - 32-byte group identifier
74
76
  * @param authorization - ZK auth credential presentation + group public params
75
- * @returns Encrypted state and version, or null if group does not exist
77
+ * @param version - Optional exact historical version
78
+ * @returns Encrypted state and version, or null if group/version does not exist
76
79
  */
77
- getGroup(groupId: Uint8Array, authorization: GroupAuthorization): Promise<{
78
- encryptedState: Uint8Array;
80
+ getGroup(groupId: Uint8Array, authorization: GroupAuthorization, version?: number): Promise<GroupSnapshot | null>;
81
+ getGroupJoinInfo(groupId: Uint8Array, inviteLinkPassword: Uint8Array, authorization: GroupAuthorization): Promise<{
82
+ encryptedJoinInfo: Uint8Array;
79
83
  version: number;
80
84
  } | null>;
81
85
  /**
82
86
  * Get change log entries from a given version.
83
87
  *
84
- * Used for incremental group state sync. The server returns all changes
85
- * after the specified version, allowing the client to replay them locally.
88
+ * Used for incremental group state sync. The enforcing backend authorizes
89
+ * at the requested snapshot and returns changes through the first
90
+ * transition that revokes the requester, inclusive.
86
91
  *
87
92
  * @param groupId - 32-byte group identifier
88
93
  * @param fromVersion - Version to start from (exclusive)
@@ -93,20 +98,17 @@ export declare class ConvexGroupServer implements IGroupServer {
93
98
  /**
94
99
  * Submit a group change with optimistic concurrency control.
95
100
  *
96
- * The server validates the expected version matches the current version,
97
- * computes a Schnorr server signature over the encrypted change, stores
98
- * the change log entry, and updates the group state atomically.
101
+ * The application server validates and applies the ciphertext Actions,
102
+ * signs the exact accepted bytes, and stores the transition atomically.
99
103
  *
100
104
  * @param groupId - 32-byte group identifier
101
105
  * @param expectedVersion - Current version for optimistic concurrency
102
- * @param encryptedChange - Serialized EncryptedGroupChange
103
- * @param updatedEncryptedState - New full encrypted state after applying the change
106
+ * @param actions - Client-proposed serialized encrypted Actions
107
+ * @param inviteLinkPassword - Independently verified link-join credential
104
108
  * @param authorization - ZK auth credential presentation + group public params
105
- * @returns Server signature over the encrypted change (for client-side verification)
109
+ * @returns Exact accepted Actions and their server signature
106
110
  */
107
- submitGroupChange(groupId: Uint8Array, expectedVersion: number, encryptedChange: Uint8Array, updatedEncryptedState: Uint8Array, authorization: GroupAuthorization): Promise<{
108
- serverSignature: Uint8Array;
109
- }>;
111
+ submitGroupChange(groupId: Uint8Array, expectedVersion: number, actions: Uint8Array, inviteLinkPassword: Uint8Array, authorization: GroupAuthorization): Promise<GroupChangeLogEntry>;
110
112
  /**
111
113
  * Convert Uint8Array to ArrayBuffer for Convex v.bytes() args.
112
114
  *
@@ -1 +1 @@
1
- {"version":3,"file":"group-server.d.ts","sourceRoot":"","sources":["../../../../remote/relay/convex/group-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,KAAK,EACV,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,qCAAqC,CAAC;AAE7C;;;GAGG;AACH,OAAO,EAAE,CAAC;AACV,KAAK,YAAY,GAAG,iBAAiB,GAAG,gBAAgB,CAAC;AAEzD,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAC3C,QAAQ,EAAE,iBAAiB,CAAC,OAAO,CAAC,CAAC;IACrC,eAAe,EAAE,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC5C,iBAAiB,EAAE,iBAAiB,CAAC,UAAU,CAAC,CAAC;CAClD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,iBAAkB,YAAW,YAAY;IAElD,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,GAAG;IAFb,YACU,MAAM,EAAE,YAAY,EACpB,GAAG,EAAE,oBAAoB,EAC/B;IAMJ;;;;;;OAMG;IACG,WAAW,CACf,OAAO,EAAE,UAAU,EACnB,cAAc,EAAE,UAAU,EAC1B,aAAa,EAAE,kBAAkB,GAChC,OAAO,CAAC,IAAI,CAAC,CAOf;IAED;;;;;;OAMG;IACG,QAAQ,CACZ,OAAO,EAAE,UAAU,EACnB,aAAa,EAAE,kBAAkB,GAChC,OAAO,CAAC;QAAE,cAAc,EAAE,UAAU,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAajE;IAED;;;;;;;;;;OAUG;IACG,eAAe,CACnB,OAAO,EAAE,UAAU,EACnB,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,kBAAkB,GAChC,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAqBhC;IAED;;;;;;;;;;;;;OAaG;IACG,iBAAiB,CACrB,OAAO,EAAE,UAAU,EACnB,eAAe,EAAE,MAAM,EACvB,eAAe,EAAE,UAAU,EAC3B,qBAAqB,EAAE,UAAU,EACjC,aAAa,EAAE,kBAAkB,GAChC,OAAO,CAAC;QAAE,eAAe,EAAE,UAAU,CAAA;KAAE,CAAC,CAW1C;IAMD;;;;;OAKG;IACH,OAAO,CAAC,OAAO;CAGhB"}
1
+ {"version":3,"file":"group-server.d.ts","sourceRoot":"","sources":["../../../../remote/relay/convex/group-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,KAAK,EACV,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,EACd,MAAM,kCAAkC,CAAC;AAE1C;;;GAGG;AACH,OAAO,EAAE,CAAC;AACV,KAAK,YAAY,GAAG,iBAAiB,GAAG,gBAAgB,CAAC;AAEzD,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAC3C,QAAQ,EAAE,iBAAiB,CAAC,OAAO,CAAC,CAAC;IACrC,gBAAgB,EAAE,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC7C,eAAe,EAAE,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC5C,iBAAiB,EAAE,iBAAiB,CAAC,UAAU,CAAC,CAAC;CAClD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,iBAAkB,YAAW,YAAY;IAElD,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,GAAG;IAFb,YACU,MAAM,EAAE,YAAY,EACpB,GAAG,EAAE,oBAAoB,EAC/B;IAMJ;;;;;;OAMG;IACG,WAAW,CACf,OAAO,EAAE,UAAU,EACnB,cAAc,EAAE,UAAU,EAC1B,aAAa,EAAE,kBAAkB,GAChC,OAAO,CAAC,IAAI,CAAC,CAOf;IAED;;;;;;;OAOG;IACG,QAAQ,CACZ,OAAO,EAAE,UAAU,EACnB,aAAa,EAAE,kBAAkB,EACjC,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAe/B;IAEK,gBAAgB,CACpB,OAAO,EAAE,UAAU,EACnB,kBAAkB,EAAE,UAAU,EAC9B,aAAa,EAAE,kBAAkB,GAChC,OAAO,CAAC;QAAE,iBAAiB,EAAE,UAAU,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAcpE;IAED;;;;;;;;;;;OAWG;IACG,eAAe,CACnB,OAAO,EAAE,UAAU,EACnB,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,kBAAkB,GAChC,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAuBhC;IAED;;;;;;;;;;;;OAYG;IACG,iBAAiB,CACrB,OAAO,EAAE,UAAU,EACnB,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,UAAU,EACnB,kBAAkB,EAAE,UAAU,EAC9B,aAAa,EAAE,kBAAkB,GAChC,OAAO,CAAC,mBAAmB,CAAC,CAsB9B;IAMD;;;;;OAKG;IACH,OAAO,CAAC,OAAO;CAGhB"}
@@ -4,9 +4,10 @@
4
4
  * Implementation of IGroupServer using Convex mutations/queries for
5
5
  * server-side encrypted group state storage.
6
6
  *
7
- * The server stores encrypted (opaque) group state and enforces version
8
- * sequencing. It never decrypts group content. This adapter bridges
9
- * the IGroupServer interface (Uint8Array) to Convex's v.bytes() (ArrayBuffer).
7
+ * This is a client transport adapter, not an enforcing group server. The
8
+ * application-supplied Convex functions must implement the enforcing-server
9
+ * obligations. This adapter bridges IGroupServer (Uint8Array) to Convex
10
+ * v.bytes() (ArrayBuffer).
10
11
  *
11
12
  * The application supplies its generated Convex function references. Those
12
13
  * functions retain responsibility for authentication, authorization, and
@@ -31,8 +32,8 @@
31
32
  * const groupApi = api.signal.groups satisfies ConvexGroupServerApi;
32
33
  * const groupServer = new ConvexGroupServer(convex, groupApi);
33
34
  *
34
- * // Use with GroupsV2Manager
35
- * const manager = new GroupsV2Manager({
35
+ * // Use with GroupManager
36
+ * const manager = new GroupManager({
36
37
  * server: groupServer,
37
38
  * store: localStore,
38
39
  * ...
@@ -65,30 +66,48 @@ export class ConvexGroupServer {
65
66
  });
66
67
  }
67
68
  /**
68
- * Get the latest encrypted group state from the server.
69
+ * Get encrypted group state from the server.
69
70
  *
70
71
  * @param groupId - 32-byte group identifier
71
72
  * @param authorization - ZK auth credential presentation + group public params
72
- * @returns Encrypted state and version, or null if group does not exist
73
+ * @param version - Optional exact historical version
74
+ * @returns Encrypted state and version, or null if group/version does not exist
73
75
  */
74
- async getGroup(groupId, authorization) {
76
+ async getGroup(groupId, authorization, version) {
75
77
  const result = await this.convex.query(this.api.getGroup, {
76
78
  groupId: this.toBytes(groupId),
77
79
  presentation: this.toBytes(authorization.presentation),
78
80
  groupPublicParams: this.toBytes(authorization.groupPublicParams),
81
+ version,
79
82
  });
80
83
  if (!result)
81
84
  return null;
82
85
  return {
83
86
  encryptedState: new Uint8Array(result.encryptedState),
84
87
  version: result.version,
88
+ baselineSignature: new Uint8Array(result.baselineSignature),
89
+ };
90
+ }
91
+ async getGroupJoinInfo(groupId, inviteLinkPassword, authorization) {
92
+ const result = await this.convex.query(this.api.getGroupJoinInfo, {
93
+ groupId: this.toBytes(groupId),
94
+ inviteLinkPassword: this.toBytes(inviteLinkPassword),
95
+ presentation: this.toBytes(authorization.presentation),
96
+ groupPublicParams: this.toBytes(authorization.groupPublicParams),
97
+ });
98
+ if (!result)
99
+ return null;
100
+ return {
101
+ encryptedJoinInfo: new Uint8Array(result.encryptedJoinInfo),
102
+ version: result.version,
85
103
  };
86
104
  }
87
105
  /**
88
106
  * Get change log entries from a given version.
89
107
  *
90
- * Used for incremental group state sync. The server returns all changes
91
- * after the specified version, allowing the client to replay them locally.
108
+ * Used for incremental group state sync. The enforcing backend authorizes
109
+ * at the requested snapshot and returns changes through the first
110
+ * transition that revokes the requester, inclusive.
92
111
  *
93
112
  * @param groupId - 32-byte group identifier
94
113
  * @param fromVersion - Version to start from (exclusive)
@@ -104,35 +123,44 @@ export class ConvexGroupServer {
104
123
  });
105
124
  return result.map((entry) => ({
106
125
  version: entry.version,
107
- encryptedChange: new Uint8Array(entry.encryptedChange),
126
+ actions: new Uint8Array(entry.actions),
108
127
  serverSignature: new Uint8Array(entry.serverSignature),
128
+ changeEpoch: entry.changeEpoch,
109
129
  timestamp: entry.timestamp,
110
130
  }));
111
131
  }
112
132
  /**
113
133
  * Submit a group change with optimistic concurrency control.
114
134
  *
115
- * The server validates the expected version matches the current version,
116
- * computes a Schnorr server signature over the encrypted change, stores
117
- * the change log entry, and updates the group state atomically.
135
+ * The application server validates and applies the ciphertext Actions,
136
+ * signs the exact accepted bytes, and stores the transition atomically.
118
137
  *
119
138
  * @param groupId - 32-byte group identifier
120
139
  * @param expectedVersion - Current version for optimistic concurrency
121
- * @param encryptedChange - Serialized EncryptedGroupChange
122
- * @param updatedEncryptedState - New full encrypted state after applying the change
140
+ * @param actions - Client-proposed serialized encrypted Actions
141
+ * @param inviteLinkPassword - Independently verified link-join credential
123
142
  * @param authorization - ZK auth credential presentation + group public params
124
- * @returns Server signature over the encrypted change (for client-side verification)
143
+ * @returns Exact accepted Actions and their server signature
125
144
  */
126
- async submitGroupChange(groupId, expectedVersion, encryptedChange, updatedEncryptedState, authorization) {
145
+ async submitGroupChange(groupId, expectedVersion, actions, inviteLinkPassword, authorization) {
146
+ if (arguments.length !== 5) {
147
+ throw new Error('INVALID_REQUEST: Group change submission must not carry an epoch');
148
+ }
127
149
  const result = await this.convex.mutation(this.api.submitGroupChange, {
128
150
  groupId: this.toBytes(groupId),
129
151
  expectedVersion,
130
- encryptedChange: this.toBytes(encryptedChange),
131
- updatedEncryptedState: this.toBytes(updatedEncryptedState),
152
+ actions: this.toBytes(actions),
153
+ inviteLinkPassword: this.toBytes(inviteLinkPassword),
132
154
  presentation: this.toBytes(authorization.presentation),
133
155
  groupPublicParams: this.toBytes(authorization.groupPublicParams),
134
156
  });
135
- return { serverSignature: new Uint8Array(result.serverSignature) };
157
+ return {
158
+ version: result.version,
159
+ actions: new Uint8Array(result.actions),
160
+ serverSignature: new Uint8Array(result.serverSignature),
161
+ changeEpoch: result.changeEpoch,
162
+ timestamp: result.timestamp,
163
+ };
136
164
  }
137
165
  // ════════════════════════════════════════════════════════════════════════════
138
166
  // UTILITY METHODS
@@ -1 +1 @@
1
- {"version":3,"file":"group-server.js","sourceRoot":"","sources":["../../../../remote/relay/convex/group-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAyBH;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,OAAO,iBAAiB;IAElB,MAAM;IACN,GAAG;IAFb,YACU,MAAoB,EACpB,GAAyB;sBADzB,MAAM;mBACN,GAAG;IACV,CAAC;IAEJ,+EAA+E;IAC/E,aAAa;IACb,+EAA+E;IAE/E;;;;;;OAMG;IACH,KAAK,CAAC,WAAW,CACf,OAAmB,EACnB,cAA0B,EAC1B,aAAiC;QAEjC,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE;YAC/C,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;YAC9B,cAAc,EAAE,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC;YAC5C,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,YAAY,CAAC;YACtD,iBAAiB,EAAE,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,iBAAiB,CAAC;SACjE,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,QAAQ,CACZ,OAAmB,EACnB,aAAiC;QAEjC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE;YACxD,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;YAC9B,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,YAAY,CAAC;YACtD,iBAAiB,EAAE,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,iBAAiB,CAAC;SACjE,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QAEzB,OAAO;YACL,cAAc,EAAE,IAAI,UAAU,CAAC,MAAM,CAAC,cAAc,CAAC;YACrD,OAAO,EAAE,MAAM,CAAC,OAAO;SACxB,CAAC;IACJ,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,eAAe,CACnB,OAAmB,EACnB,WAAmB,EACnB,aAAiC;QAEjC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE;YAC/D,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;YAC9B,WAAW;YACX,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,YAAY,CAAC;YACtD,iBAAiB,EAAE,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,iBAAiB,CAAC;SACjE,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC,GAAG,CACf,CAAC,KAKA,EAAE,EAAE,CAAC,CAAC;YACL,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,eAAe,EAAE,IAAI,UAAU,CAAC,KAAK,CAAC,eAAe,CAAC;YACtD,eAAe,EAAE,IAAI,UAAU,CAAC,KAAK,CAAC,eAAe,CAAC;YACtD,SAAS,EAAE,KAAK,CAAC,SAAS;SAC3B,CAAC,CACH,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,iBAAiB,CACrB,OAAmB,EACnB,eAAuB,EACvB,eAA2B,EAC3B,qBAAiC,EACjC,aAAiC;QAEjC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,iBAAiB,EAAE;YACpE,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;YAC9B,eAAe;YACf,eAAe,EAAE,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC;YAC9C,qBAAqB,EAAE,IAAI,CAAC,OAAO,CAAC,qBAAqB,CAAC;YAC1D,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,YAAY,CAAC;YACtD,iBAAiB,EAAE,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,iBAAiB,CAAC;SACjE,CAAC,CAAC;QAEH,OAAO,EAAE,eAAe,EAAE,IAAI,UAAU,CAAC,MAAM,CAAC,eAAe,CAAC,EAAE,CAAC;IACrE,CAAC;IAED,+EAA+E;IAC/E,kBAAkB;IAClB,+EAA+E;IAE/E;;;;;OAKG;IACK,OAAO,CAAC,IAAgB;QAC9B,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAgB,CAAC;IAC9F,CAAC;CACF"}
1
+ {"version":3,"file":"group-server.js","sourceRoot":"","sources":["../../../../remote/relay/convex/group-server.ts"],"names":[],"mappings":"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"}
@@ -19,9 +19,9 @@
19
19
  import type { ConvexReactClient } from 'convex/react';
20
20
  import type { ConvexHttpClient } from 'convex/browser';
21
21
  import type { FunctionReference } from 'convex/server';
22
- import type { ISignalProtocolRelayServer, Envelope, SealedSenderAuth, DeviceInfo, DeviceRegistration, PreKeyUpload, PreKeyBundle, EcSignedPreKeyUpload, KemLastResortPreKeyUpload, Unsubscribe, GroupMemberDevice, GroupChangeEntry, RetryRequest, AccountIdentityProvisioning, AccountIdentityRotation } from '../types.js';
22
+ import type { ISignalProtocolRelayServer, Envelope, SealedSenderAuth, DeviceInfo, DeviceRegistration, PreKeyUpload, PreKeyBundle, EcSignedPreKeyUpload, KemLastResortPreKeyUpload, Unsubscribe, GroupMemberDevice, GroupChangeEntry, RetryRequest, AccountIdentityProvisioning, AccountIdentityRotation, IRelayGroupServer } from '../types.js';
23
23
  import type { CompositeIdentityV1, IdentityType } from '../../../keys/types.js';
24
- import type { GroupAuthorization } from '../../../internal/groups-v2/manager.js';
24
+ import type { GroupAuthorization } from '../../../internal/groups/manager.js';
25
25
  import { type ILogger } from '../../../logger.js';
26
26
  /**
27
27
  * Polling interval for retry request subscription (in milliseconds).
@@ -79,15 +79,17 @@ export interface ConvexSignalProtocolRelayApi {
79
79
  rollbackProvisioning: FunctionReference<'mutation'>;
80
80
  deleteProvisioningSession: FunctionReference<'mutation'>;
81
81
  };
82
- groups: {
82
+ groups?: {
83
83
  createGroup: FunctionReference<'mutation'>;
84
84
  getGroup: FunctionReference<'query'>;
85
+ getGroupJoinInfo: FunctionReference<'query'>;
85
86
  getGroupChanges: FunctionReference<'query'>;
86
87
  submitGroupChange: FunctionReference<'mutation'>;
87
88
  refreshGroupSendEndorsements: FunctionReference<'mutation'>;
88
89
  };
89
- zkAuth: {
90
+ zkAuth?: {
90
91
  issueAuthCredentialMutation: FunctionReference<'mutation'>;
92
+ issueProfileKeyCredentialMutation: FunctionReference<'mutation'>;
91
93
  };
92
94
  }
93
95
  export interface ConvexSignalProtocolRelayOptions {
@@ -134,6 +136,7 @@ export declare class ConvexSignalProtocolRelayServer implements ISignalProtocolR
134
136
  private currentUserId?;
135
137
  private getAuthToken?;
136
138
  private readonly logger;
139
+ readonly groupServer?: IRelayGroupServer;
137
140
  /**
138
141
  * Create a new ConvexSignalProtocolRelayServer.
139
142
  *
@@ -314,19 +317,24 @@ export declare class ConvexSignalProtocolRelayServer implements ISignalProtocolR
314
317
  publicKey: string;
315
318
  } | null>;
316
319
  createGroupState(groupId: Uint8Array, encryptedState: Uint8Array, authorization: GroupAuthorization): Promise<void>;
317
- getGroupState(groupId: Uint8Array, authorization: GroupAuthorization): Promise<{
320
+ getGroupState(groupId: Uint8Array, authorization: GroupAuthorization, version?: number): Promise<{
318
321
  encryptedState: Uint8Array;
319
322
  version: number;
323
+ baselineSignature: Uint8Array;
324
+ } | null>;
325
+ getGroupJoinInfo(groupId: Uint8Array, inviteLinkPassword: Uint8Array, authorization: GroupAuthorization): Promise<{
326
+ encryptedJoinInfo: Uint8Array;
327
+ version: number;
320
328
  } | null>;
321
329
  getGroupChanges(groupId: Uint8Array, fromVersion: number, authorization: GroupAuthorization): Promise<GroupChangeEntry[]>;
322
- submitGroupChange(groupId: Uint8Array, expectedVersion: number, encryptedChange: Uint8Array, updatedEncryptedState: Uint8Array, authorization: GroupAuthorization): Promise<{
323
- serverSignature: Uint8Array;
324
- }>;
330
+ submitGroupChange(groupId: Uint8Array, expectedVersion: number, actions: Uint8Array, inviteLinkPassword: Uint8Array, authorization: GroupAuthorization): Promise<GroupChangeEntry>;
325
331
  issueAuthCredential(_userId: string): Promise<Uint8Array>;
332
+ issueProfileKeyCredential(profileKey: Uint8Array): Promise<Uint8Array>;
326
333
  refreshGroupSendEndorsements(groupId: Uint8Array, authorization: GroupAuthorization): Promise<{
327
334
  endorsements: Uint8Array;
328
335
  expiration: number;
329
336
  }>;
337
+ private requireGroupServerApi;
330
338
  /** Convert Uint8Array to ArrayBuffer for Convex v.bytes() args. */
331
339
  private toBytes;
332
340
  private uint8ArrayToBase64;
@@ -1 +1 @@
1
- {"version":3,"file":"relay.d.ts","sourceRoot":"","sources":["../../../../remote/relay/convex/relay.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"relay.d.ts","sourceRoot":"","sources":["../../../../remote/relay/convex/relay.ts"],"names":[],"mappings":"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"}
@@ -20,6 +20,7 @@ import { ConvexClient as BrowserConvexClient } from 'convex/browser';
20
20
  import { decodeCompositeIdentityV1, encodeCompositeIdentityV1 } from '../../../keys/identity.js';
21
21
  import { SealedSenderAuthError } from '../../../types/errors.js';
22
22
  import { resolveSignalProtocolLogger } from '../../../logger.js';
23
+ import { ConvexGroupServer } from './group-server.js';
23
24
  const RETRY_POLL_INTERVAL_MS = 2000;
24
25
  /**
25
26
  * Polling interval for message subscription (in milliseconds).
@@ -75,6 +76,7 @@ export class ConvexSignalProtocolRelayServer {
75
76
  currentUserId;
76
77
  getAuthToken;
77
78
  logger;
79
+ groupServer;
78
80
  /**
79
81
  * Create a new ConvexSignalProtocolRelayServer.
80
82
  *
@@ -91,6 +93,13 @@ export class ConvexSignalProtocolRelayServer {
91
93
  this.currentUserId = options.currentUserId;
92
94
  this.getAuthToken = options.getAuthToken;
93
95
  this.logger = resolveSignalProtocolLogger(options.logger);
96
+ if (api.groups && api.zkAuth) {
97
+ this.groupServer = {
98
+ server: new ConvexGroupServer(convex, api.groups),
99
+ issueAuthCredential: (userId) => this.issueAuthCredential(userId),
100
+ issueProfileKeyCredential: (_userId, profileKey) => this.issueProfileKeyCredential(profileKey),
101
+ };
102
+ }
94
103
  }
95
104
  /**
96
105
  * Get or create the internal subscription client for push-based updates.
@@ -972,31 +981,51 @@ export class ConvexSignalProtocolRelayServer {
972
981
  return metadata;
973
982
  }
974
983
  // ════════════════════════════════════════════════════════════════════════════
975
- // GROUP STATE (GroupsV2 — encrypted, server-opaque)
984
+ // GROUP STATE (encrypted, server-opaque)
976
985
  // ════════════════════════════════════════════════════════════════════════════
977
986
  async createGroupState(groupId, encryptedState, authorization) {
978
- await this.convex.mutation(this.api.groups.createGroup, {
987
+ const { groups } = this.requireGroupServerApi();
988
+ await this.convex.mutation(groups.createGroup, {
979
989
  groupId: this.toBytes(groupId),
980
990
  encryptedState: this.toBytes(encryptedState),
981
991
  presentation: this.toBytes(authorization.presentation),
982
992
  groupPublicParams: this.toBytes(authorization.groupPublicParams),
983
993
  });
984
994
  }
985
- async getGroupState(groupId, authorization) {
986
- const result = await this.convex.query(this.api.groups.getGroup, {
995
+ async getGroupState(groupId, authorization, version) {
996
+ const { groups } = this.requireGroupServerApi();
997
+ const result = await this.convex.query(groups.getGroup, {
987
998
  groupId: this.toBytes(groupId),
988
999
  presentation: this.toBytes(authorization.presentation),
989
1000
  groupPublicParams: this.toBytes(authorization.groupPublicParams),
1001
+ version,
990
1002
  });
991
1003
  if (!result)
992
1004
  return null;
993
1005
  return {
994
1006
  encryptedState: new Uint8Array(result.encryptedState),
995
1007
  version: result.version,
1008
+ baselineSignature: new Uint8Array(result.baselineSignature),
1009
+ };
1010
+ }
1011
+ async getGroupJoinInfo(groupId, inviteLinkPassword, authorization) {
1012
+ const { groups } = this.requireGroupServerApi();
1013
+ const result = await this.convex.query(groups.getGroupJoinInfo, {
1014
+ groupId: this.toBytes(groupId),
1015
+ inviteLinkPassword: this.toBytes(inviteLinkPassword),
1016
+ presentation: this.toBytes(authorization.presentation),
1017
+ groupPublicParams: this.toBytes(authorization.groupPublicParams),
1018
+ });
1019
+ if (!result)
1020
+ return null;
1021
+ return {
1022
+ encryptedJoinInfo: new Uint8Array(result.encryptedJoinInfo),
1023
+ version: result.version,
996
1024
  };
997
1025
  }
998
1026
  async getGroupChanges(groupId, fromVersion, authorization) {
999
- const result = await this.convex.query(this.api.groups.getGroupChanges, {
1027
+ const { groups } = this.requireGroupServerApi();
1028
+ const result = await this.convex.query(groups.getGroupChanges, {
1000
1029
  groupId: this.toBytes(groupId),
1001
1030
  fromVersion,
1002
1031
  presentation: this.toBytes(authorization.presentation),
@@ -1004,29 +1033,50 @@ export class ConvexSignalProtocolRelayServer {
1004
1033
  });
1005
1034
  return result.map((entry) => ({
1006
1035
  version: entry.version,
1007
- encryptedChange: new Uint8Array(entry.encryptedChange),
1036
+ actions: new Uint8Array(entry.actions),
1008
1037
  serverSignature: new Uint8Array(entry.serverSignature),
1038
+ changeEpoch: entry.changeEpoch,
1009
1039
  timestamp: entry.timestamp,
1010
1040
  }));
1011
1041
  }
1012
- async submitGroupChange(groupId, expectedVersion, encryptedChange, updatedEncryptedState, authorization) {
1013
- const result = await this.convex.mutation(this.api.groups.submitGroupChange, {
1042
+ async submitGroupChange(groupId, expectedVersion, actions, inviteLinkPassword, authorization) {
1043
+ // S13: the server derives the change epoch from the accepted actions; a
1044
+ // legacy caller-supplied epoch must be rejected, matching
1045
+ // ConvexGroupServer.submitGroupChange.
1046
+ if (arguments.length !== 5) {
1047
+ throw new Error('INVALID_REQUEST: Group change submission must not carry an epoch');
1048
+ }
1049
+ const { groups } = this.requireGroupServerApi();
1050
+ const result = await this.convex.mutation(groups.submitGroupChange, {
1014
1051
  groupId: this.toBytes(groupId),
1015
1052
  expectedVersion,
1016
- encryptedChange: this.toBytes(encryptedChange),
1017
- updatedEncryptedState: this.toBytes(updatedEncryptedState),
1053
+ actions: this.toBytes(actions),
1054
+ inviteLinkPassword: this.toBytes(inviteLinkPassword),
1018
1055
  presentation: this.toBytes(authorization.presentation),
1019
1056
  groupPublicParams: this.toBytes(authorization.groupPublicParams),
1020
1057
  });
1021
- return { serverSignature: new Uint8Array(result.serverSignature) };
1058
+ return {
1059
+ version: result.version,
1060
+ actions: new Uint8Array(result.actions),
1061
+ serverSignature: new Uint8Array(result.serverSignature),
1062
+ changeEpoch: result.changeEpoch,
1063
+ timestamp: result.timestamp,
1064
+ };
1022
1065
  }
1023
1066
  async issueAuthCredential(_userId) {
1024
1067
  // userId kept for ISignalProtocolRelayServer interface compat; server uses auth session
1025
- const result = await this.convex.mutation(this.api.zkAuth.issueAuthCredentialMutation, {});
1068
+ const api = this.requireGroupServerApi();
1069
+ const result = await this.convex.mutation(api.zkAuth.issueAuthCredentialMutation, {});
1070
+ return new Uint8Array(result);
1071
+ }
1072
+ async issueProfileKeyCredential(profileKey) {
1073
+ const api = this.requireGroupServerApi();
1074
+ const result = await this.convex.mutation(api.zkAuth.issueProfileKeyCredentialMutation, { profileKey: this.toBytes(profileKey) });
1026
1075
  return new Uint8Array(result);
1027
1076
  }
1028
1077
  async refreshGroupSendEndorsements(groupId, authorization) {
1029
- const result = await this.convex.mutation(this.api.groups.refreshGroupSendEndorsements, {
1078
+ const api = this.requireGroupServerApi();
1079
+ const result = await this.convex.mutation(api.groups.refreshGroupSendEndorsements, {
1030
1080
  groupId: this.toBytes(groupId),
1031
1081
  presentation: this.toBytes(authorization.presentation),
1032
1082
  groupPublicParams: this.toBytes(authorization.groupPublicParams),
@@ -1039,6 +1089,15 @@ export class ConvexSignalProtocolRelayServer {
1039
1089
  // ════════════════════════════════════════════════════════════════════════════
1040
1090
  // UTILITY METHODS
1041
1091
  // ════════════════════════════════════════════════════════════════════════════
1092
+ requireGroupServerApi() {
1093
+ if (!this.api.groups || !this.api.zkAuth) {
1094
+ throw new Error('This Convex relay does not expose the groupServer capability; configure both groups and zkAuth API modules');
1095
+ }
1096
+ return {
1097
+ groups: this.api.groups,
1098
+ zkAuth: this.api.zkAuth,
1099
+ };
1100
+ }
1042
1101
  /** Convert Uint8Array to ArrayBuffer for Convex v.bytes() args. */
1043
1102
  toBytes(data) {
1044
1103
  return data.buffer.slice(data.byteOffset, data.byteOffset + data.byteLength);