@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.
- package/ARCHITECTURE.md +1 -1
- package/CHANGELOG.md +196 -1
- package/dist/client/client.d.ts +32 -28
- package/dist/client/client.d.ts.map +1 -1
- package/dist/client/client.js +120 -72
- 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 +41 -17
- package/dist/client/config.d.ts.map +1 -1
- package/dist/client/config.js.map +1 -1
- package/dist/client/endorsement-manager.d.ts +4 -0
- package/dist/client/endorsement-manager.d.ts.map +1 -1
- package/dist/client/endorsement-manager.js +9 -0
- 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/signal-service-cipher.d.ts +5 -1
- package/dist/client/signal-service-cipher.d.ts.map +1 -1
- package/dist/client/signal-service-cipher.js +7 -1
- package/dist/client/signal-service-cipher.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 +5 -5
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +3 -3
- package/dist/index.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 +175 -40
- package/dist/internal/groups/manager.d.ts.map +1 -0
- package/dist/internal/groups/manager.js +1862 -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 +52 -0
- package/dist/internal/groups/server-engine.d.ts.map +1 -0
- package/dist/internal/groups/server-engine.js +1126 -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/sender-keys/index.d.ts +1 -1
- package/dist/internal/protocol/sender-keys/manager.d.ts +1 -1
- package/dist/internal/protocol/sender-keys/manager.js +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/remote/relay/convex/group-server.d.ts +23 -21
- package/dist/remote/relay/convex/group-server.d.ts.map +1 -1
- package/dist/remote/relay/convex/group-server.js +49 -21
- package/dist/remote/relay/convex/group-server.js.map +1 -1
- package/dist/remote/relay/convex/relay.d.ts +16 -8
- package/dist/remote/relay/convex/relay.d.ts.map +1 -1
- package/dist/remote/relay/convex/relay.js +72 -13
- package/dist/remote/relay/convex/relay.js.map +1 -1
- package/dist/remote/relay/convex/server/index.d.ts +2 -0
- package/dist/remote/relay/convex/server/index.d.ts.map +1 -0
- package/dist/remote/relay/convex/server/index.js +2 -0
- package/dist/remote/relay/convex/server/index.js.map +1 -0
- package/dist/remote/relay/convex/server.d.ts +150 -0
- package/dist/remote/relay/convex/server.d.ts.map +1 -0
- package/dist/remote/relay/convex/server.js +506 -0
- package/dist/remote/relay/convex/server.js.map +1 -0
- package/dist/remote/relay/index.d.ts +1 -1
- package/dist/remote/relay/index.d.ts.map +1 -1
- package/dist/remote/relay/index.js.map +1 -1
- package/dist/remote/relay/mock/adapter.d.ts +31 -13
- package/dist/remote/relay/mock/adapter.d.ts.map +1 -1
- package/dist/remote/relay/mock/adapter.js +66 -61
- 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 +45 -14
- package/dist/remote/relay/types.d.ts.map +1 -1
- package/dist/types/api.d.ts +2 -2
- package/dist/types/api.d.ts.map +1 -1
- package/docs/DEVIATIONS.md +35 -32
- package/docs/PACKAGE_SURFACE.md +5 -0
- package/docs/api/classes/EndorsementManager.md +18 -0
- package/docs/api/classes/SignalProtocolClient.md +77 -77
- package/docs/api/functions/createGroupId.md +1 -1
- package/docs/api/functions/decodeGroupTrustRoot.md +21 -0
- package/docs/api/functions/encodeGroupTrustRoot.md +28 -0
- package/docs/api/functions/extractGroupId.md +2 -2
- package/docs/api/functions/isGroupId.md +1 -1
- package/docs/api/interfaces/GroupTrustRoot.md +33 -0
- package/docs/api/interfaces/IRelayGroupServer.md +60 -0
- package/docs/api/interfaces/ISignalProtocolClient.md +1 -1
- package/docs/api/interfaces/ISignalProtocolRelayServer.md +8 -0
- package/docs/api/interfaces/SignalProtocolClientCompositionOptions.md +66 -28
- package/docs/api/interfaces/SignalProtocolClientConfig.md +82 -26
- package/docs/api/interfaces/SignalProtocolClientIdentityConfig.md +16 -0
- package/docs/api/type-aliases/GroupId.md +2 -2
- package/docs/api/variables/GROUP_ID_PREFIX.md +11 -0
- package/docs/api/variables/GROUP_TRUST_ROOT_VERSION.md +11 -0
- package/groups/README.md +16 -5
- package/package.json +13 -2
- package/remote/relay/convex/README.md +6 -0
- package/remote/relay/convex/server/README.md +146 -0
- package/scripts/oe-groups.mjs +142 -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/variables/GROUP_V2_PREFIX.md +0 -11
- /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,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"}
|