@open-e2ee/signal-protocol-sdk 13.4.0 → 13.5.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +417 -0
- package/README.md +1 -1
- package/SECURITY.md +2 -2
- package/dist/client/binary-send.d.ts +28 -0
- package/dist/client/binary-send.d.ts.map +1 -0
- package/dist/client/binary-send.js +26 -0
- package/dist/client/binary-send.js.map +1 -0
- package/dist/client/client.d.ts +46 -6
- package/dist/client/client.d.ts.map +1 -1
- package/dist/client/client.js +181 -66
- package/dist/client/client.js.map +1 -1
- package/dist/client/content-adapter.d.ts +18 -0
- package/dist/client/content-adapter.d.ts.map +1 -1
- package/dist/client/content-adapter.js.map +1 -1
- package/dist/client/device-set-reconciliation.d.ts +23 -8
- package/dist/client/device-set-reconciliation.d.ts.map +1 -1
- package/dist/client/device-set-reconciliation.js +25 -11
- package/dist/client/device-set-reconciliation.js.map +1 -1
- package/dist/client/event-hooks.d.ts +88 -8
- package/dist/client/event-hooks.d.ts.map +1 -1
- package/dist/client/event-hooks.js +1 -0
- package/dist/client/event-hooks.js.map +1 -1
- package/dist/client/group-outbox.d.ts +45 -10
- package/dist/client/group-outbox.d.ts.map +1 -1
- package/dist/client/group-outbox.js +246 -154
- package/dist/client/group-outbox.js.map +1 -1
- package/dist/client/group-receive-authorization.d.ts +10 -1
- package/dist/client/group-receive-authorization.d.ts.map +1 -1
- package/dist/client/group-receive-authorization.js.map +1 -1
- package/dist/client/hosted-anonymous-delivery.d.ts +18 -1
- package/dist/client/hosted-anonymous-delivery.d.ts.map +1 -1
- package/dist/client/hosted-anonymous-delivery.js +84 -12
- package/dist/client/hosted-anonymous-delivery.js.map +1 -1
- package/dist/client/hosted-connection.js +1 -1
- package/dist/client/hosted-connection.js.map +1 -1
- package/dist/client/hosted-group-authority.d.ts +6 -2
- package/dist/client/hosted-group-authority.d.ts.map +1 -1
- package/dist/client/hosted-group-authority.js +11 -7
- package/dist/client/hosted-group-authority.js.map +1 -1
- package/dist/client/hosted-groups.d.ts +5 -1
- package/dist/client/hosted-groups.d.ts.map +1 -1
- package/dist/client/hosted-groups.js +8 -4
- package/dist/client/hosted-groups.js.map +1 -1
- package/dist/client/hosted-http-error.d.ts +5 -1
- package/dist/client/hosted-http-error.d.ts.map +1 -1
- package/dist/client/hosted-http-error.js +5 -1
- package/dist/client/hosted-http-error.js.map +1 -1
- package/dist/client/hosted-mailbox-subscription.d.ts +2 -0
- package/dist/client/hosted-mailbox-subscription.d.ts.map +1 -1
- package/dist/client/hosted-mailbox-subscription.js +5 -5
- package/dist/client/hosted-mailbox-subscription.js.map +1 -1
- package/dist/client/hosted-transport.d.ts +11 -1
- package/dist/client/hosted-transport.d.ts.map +1 -1
- package/dist/client/hosted-transport.js +75 -30
- package/dist/client/hosted-transport.js.map +1 -1
- package/dist/client/hosted.d.ts.map +1 -1
- package/dist/client/hosted.js +1 -1
- package/dist/client/hosted.js.map +1 -1
- package/dist/client/index.d.ts +1 -1
- package/dist/client/index.d.ts.map +1 -1
- package/dist/client/index.js.map +1 -1
- package/dist/client/receive-queue.d.ts +5 -2
- package/dist/client/receive-queue.d.ts.map +1 -1
- package/dist/client/receive-queue.js +55 -18
- package/dist/client/receive-queue.js.map +1 -1
- package/dist/client/relay-acceptance.d.ts +49 -6
- package/dist/client/relay-acceptance.d.ts.map +1 -1
- package/dist/client/relay-acceptance.js +49 -3
- package/dist/client/relay-acceptance.js.map +1 -1
- package/dist/client/relay-protocol.d.ts +37 -7
- package/dist/client/relay-protocol.d.ts.map +1 -1
- package/dist/client/relay-protocol.js +53 -10
- package/dist/client/relay-protocol.js.map +1 -1
- package/dist/client/retry-family.d.ts +3 -3
- package/dist/client/retry-family.js +1 -1
- package/dist/client/retry-family.js.map +1 -1
- package/dist/client/retry-request-envelope.d.ts +18 -8
- package/dist/client/retry-request-envelope.d.ts.map +1 -1
- package/dist/client/retry-request-envelope.js +57 -29
- package/dist/client/retry-request-envelope.js.map +1 -1
- package/dist/client/retry-request-lifecycle.d.ts +24 -11
- package/dist/client/retry-request-lifecycle.d.ts.map +1 -1
- package/dist/client/retry-request-lifecycle.js +46 -20
- package/dist/client/retry-request-lifecycle.js.map +1 -1
- package/dist/client/retry-terminal-recovery.d.ts +11 -8
- package/dist/client/retry-terminal-recovery.d.ts.map +1 -1
- package/dist/client/retry-terminal-recovery.js +18 -12
- package/dist/client/retry-terminal-recovery.js.map +1 -1
- package/dist/client/retry.d.ts +8 -7
- package/dist/client/retry.d.ts.map +1 -1
- package/dist/client/retry.js +30 -22
- package/dist/client/retry.js.map +1 -1
- package/dist/client/send-deadline.d.ts +308 -0
- package/dist/client/send-deadline.d.ts.map +1 -0
- package/dist/client/send-deadline.js +914 -0
- package/dist/client/send-deadline.js.map +1 -0
- package/dist/client/send-intent-driver.d.ts +116 -0
- package/dist/client/send-intent-driver.d.ts.map +1 -0
- package/dist/client/send-intent-driver.js +373 -0
- package/dist/client/send-intent-driver.js.map +1 -0
- package/dist/client/signal-service-cipher.d.ts +257 -27
- package/dist/client/signal-service-cipher.d.ts.map +1 -1
- package/dist/client/signal-service-cipher.js +1274 -283
- package/dist/client/signal-service-cipher.js.map +1 -1
- package/dist/client/types.d.ts +48 -5
- package/dist/client/types.d.ts.map +1 -1
- package/dist/client/types.js.map +1 -1
- package/dist/index.d.ts +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js.map +1 -1
- package/dist/local/store/conformance/cases/metadata.d.ts +3 -2
- package/dist/local/store/conformance/cases/metadata.d.ts.map +1 -1
- package/dist/local/store/conformance/cases/metadata.js +153 -2
- package/dist/local/store/conformance/cases/metadata.js.map +1 -1
- package/dist/local/store/key-value/adapter.d.ts +2 -1
- package/dist/local/store/key-value/adapter.d.ts.map +1 -1
- package/dist/local/store/key-value/adapter.js +9 -0
- package/dist/local/store/key-value/adapter.js.map +1 -1
- package/dist/local/store/memory/adapter.d.ts +2 -1
- package/dist/local/store/memory/adapter.d.ts.map +1 -1
- package/dist/local/store/memory/adapter.js +4 -0
- package/dist/local/store/memory/adapter.js.map +1 -1
- package/dist/local/store/metadata-keys.d.ts +13 -0
- package/dist/local/store/metadata-keys.d.ts.map +1 -0
- package/dist/local/store/metadata-keys.js +20 -0
- package/dist/local/store/metadata-keys.js.map +1 -0
- package/dist/local/store/receive-work.d.ts.map +1 -1
- package/dist/local/store/receive-work.js +12 -1
- package/dist/local/store/receive-work.js.map +1 -1
- package/dist/local/store/reliability.d.ts +482 -33
- package/dist/local/store/reliability.d.ts.map +1 -1
- package/dist/local/store/reliability.js +690 -48
- package/dist/local/store/reliability.js.map +1 -1
- package/dist/local/store/sqlite/key-storage/index.d.ts +2 -1
- package/dist/local/store/sqlite/key-storage/index.d.ts.map +1 -1
- package/dist/local/store/sqlite/key-storage/index.js +3 -0
- package/dist/local/store/sqlite/key-storage/index.js.map +1 -1
- package/dist/local/store/sqlite/key-storage/metadata.d.ts +9 -0
- package/dist/local/store/sqlite/key-storage/metadata.d.ts.map +1 -1
- package/dist/local/store/sqlite/key-storage/metadata.js +12 -0
- package/dist/local/store/sqlite/key-storage/metadata.js.map +1 -1
- package/dist/local/store/sqlite/store.d.ts +2 -1
- package/dist/local/store/sqlite/store.d.ts.map +1 -1
- package/dist/local/store/sqlite/store.js +3 -0
- package/dist/local/store/sqlite/store.js.map +1 -1
- package/dist/local/store/web/adapter.d.ts +8 -1
- package/dist/local/store/web/adapter.d.ts.map +1 -1
- package/dist/local/store/web/adapter.js +18 -0
- package/dist/local/store/web/adapter.js.map +1 -1
- package/dist/remote/relay/request-admission.d.ts +49 -0
- package/dist/remote/relay/request-admission.d.ts.map +1 -0
- package/dist/remote/relay/request-admission.js +74 -0
- package/dist/remote/relay/request-admission.js.map +1 -0
- package/dist/types/api.d.ts +77 -0
- package/dist/types/api.d.ts.map +1 -1
- package/dist/types/errors.d.ts +144 -1
- package/dist/types/errors.d.ts.map +1 -1
- package/dist/types/errors.js +146 -1
- package/dist/types/errors.js.map +1 -1
- package/docs/ASSURANCE.md +5 -5
- package/docs/DEVIATIONS.md +34 -4
- package/docs/ERROR_HANDLING.md +134 -7
- package/package.json +1 -1
|
@@ -59,9 +59,11 @@ export interface DeviceSetUnresolved {
|
|
|
59
59
|
}
|
|
60
60
|
/**
|
|
61
61
|
* A declared send that ended without the acceptance of every device. The
|
|
62
|
-
* devices in `acceptedDevices` stay accepted.
|
|
63
|
-
*
|
|
64
|
-
*
|
|
62
|
+
* devices in `acceptedDevices` stay accepted. After a recipient-phase end,
|
|
63
|
+
* the outbox keeps the send as terminal with its `outcome`, and the SDK does
|
|
64
|
+
* not post it again. A later `send()` with the same `clientMessageId` throws
|
|
65
|
+
* the stored-end class of its outcome, `SendAcceptanceUnknownError` or
|
|
66
|
+
* `SendNeverAcceptedByRelayError`, and posts nothing.
|
|
65
67
|
*
|
|
66
68
|
* `isOutgoingMessageError` is true for this error.
|
|
67
69
|
*/
|
|
@@ -74,10 +76,17 @@ export declare class DeviceSetReconciliationError extends Error {
|
|
|
74
76
|
readonly acceptedDevices: readonly DeviceSetDevice[];
|
|
75
77
|
readonly unresolvedDevices: readonly DeviceSetDevice[];
|
|
76
78
|
readonly clientMessageId: string;
|
|
79
|
+
/**
|
|
80
|
+
* The stored end of the send after a recipient-phase end: `failed` or
|
|
81
|
+
* `acceptance-unknown`. With `acceptance-unknown`, the message might have
|
|
82
|
+
* arrived. Undefined after a sync-phase end, which keeps the result of
|
|
83
|
+
* the send.
|
|
84
|
+
*/
|
|
85
|
+
readonly outcome: 'failed' | 'acceptance-unknown' | undefined;
|
|
77
86
|
constructor(unresolved: DeviceSetUnresolved, devices: {
|
|
78
87
|
readonly acceptedDevices: readonly DeviceSetDevice[];
|
|
79
88
|
readonly unresolvedDevices: readonly DeviceSetDevice[];
|
|
80
|
-
}, clientMessageId: string);
|
|
89
|
+
}, clientMessageId: string, outcome?: 'failed' | 'acceptance-unknown');
|
|
81
90
|
}
|
|
82
91
|
/**
|
|
83
92
|
* The route of a send whose Relay did not mark a declared post as compared.
|
|
@@ -120,7 +129,9 @@ export interface DeclaredSyncOutcome {
|
|
|
120
129
|
export declare function syncPostReceipts(accepted: readonly RelayPostAcceptance[]): DeclaredPostReceipt[];
|
|
121
130
|
/**
|
|
122
131
|
* The protocol error of the first receipt that has no `deviceSetChecked`
|
|
123
|
-
* mark, or undefined when the Relay marked each receipt.
|
|
132
|
+
* mark, or undefined when the Relay marked each receipt. An acceptance from
|
|
133
|
+
* RETRY_CONFLICT, or from a version 2 DELIVERY_ALREADY_ACCEPTED, has no
|
|
134
|
+
* receipt, so it is not unchecked.
|
|
124
135
|
*/
|
|
125
136
|
export declare function uncheckedDeclaredPost(receipts: readonly DeclaredPostReceipt[], clientMessageId: string | undefined): RelayProtocolError | undefined;
|
|
126
137
|
/** The repairs of one account that the refusals of a pass name. */
|
|
@@ -165,8 +176,11 @@ export interface DeviceSetPhaseRun<T> {
|
|
|
165
176
|
* the new restart count in one write.
|
|
166
177
|
*/
|
|
167
178
|
repair(repairs: readonly DeviceSetAccountRepair[], restarts: number): Promise<DeviceSetRepairOutcome>;
|
|
168
|
-
/**
|
|
169
|
-
|
|
179
|
+
/**
|
|
180
|
+
* Record the terminal state of the phase. Resolves to the stored outcome
|
|
181
|
+
* of the send after a recipient-phase end, else to undefined.
|
|
182
|
+
*/
|
|
183
|
+
unresolve(unresolved: DeviceSetUnresolved): Promise<DeviceSetReconciliationError['outcome']>;
|
|
170
184
|
/** Wait before the next pass. Rejects when the send stops. */
|
|
171
185
|
wait(milliseconds: number): Promise<void>;
|
|
172
186
|
/** Log a failure of a pass that does not decide the phase. */
|
|
@@ -176,7 +190,8 @@ export interface DeviceSetPhaseRun<T> {
|
|
|
176
190
|
* Run one phase of a declared send until every device post is accepted.
|
|
177
191
|
*
|
|
178
192
|
* After a pass, the first rule that applies decides:
|
|
179
|
-
* 1. A stopped send throws `RelayWorkStopped
|
|
193
|
+
* 1. A stopped send throws `RelayWorkStopped`, and a send at its posting
|
|
194
|
+
* deadline throws the deadline error.
|
|
180
195
|
* 2. A restart post that the Relay refused with `OPERATION_EXPIRED` ends the
|
|
181
196
|
* phase with `expired`. The restart count does not change.
|
|
182
197
|
* 3. A device-set refusal repairs every device that the refusals of the pass
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"device-set-reconciliation.d.ts","sourceRoot":"","sources":["../../client/device-set-reconciliation.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,4BAA4B,CAAC;AACpC,OAAO,
|
|
1
|
+
{"version":3,"file":"device-set-reconciliation.d.ts","sourceRoot":"","sources":["../../client/device-set-reconciliation.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import { deviceSetRefusal, } from '../remote/relay/device-set.js';
|
|
2
|
-
import { relayOperationRefusal } from './relay-acceptance.js';
|
|
2
|
+
import { isConflictAcceptance, relayOperationRefusal, } from './relay-acceptance.js';
|
|
3
3
|
import { RelayWorkStopped } from './relay-work.js';
|
|
4
|
+
import { isPostingDeadlineReached } from './send-deadline.js';
|
|
4
5
|
/**
|
|
5
6
|
* The device-set reconciliation of a declared send.
|
|
6
7
|
*
|
|
@@ -27,9 +28,11 @@ export function deviceSetBundleRetryDelay(consecutiveMisses) {
|
|
|
27
28
|
}
|
|
28
29
|
/**
|
|
29
30
|
* A declared send that ended without the acceptance of every device. The
|
|
30
|
-
* devices in `acceptedDevices` stay accepted.
|
|
31
|
-
*
|
|
32
|
-
*
|
|
31
|
+
* devices in `acceptedDevices` stay accepted. After a recipient-phase end,
|
|
32
|
+
* the outbox keeps the send as terminal with its `outcome`, and the SDK does
|
|
33
|
+
* not post it again. A later `send()` with the same `clientMessageId` throws
|
|
34
|
+
* the stored-end class of its outcome, `SendAcceptanceUnknownError` or
|
|
35
|
+
* `SendNeverAcceptedByRelayError`, and posts nothing.
|
|
33
36
|
*
|
|
34
37
|
* `isOutgoingMessageError` is true for this error.
|
|
35
38
|
*/
|
|
@@ -42,7 +45,14 @@ export class DeviceSetReconciliationError extends Error {
|
|
|
42
45
|
acceptedDevices;
|
|
43
46
|
unresolvedDevices;
|
|
44
47
|
clientMessageId;
|
|
45
|
-
|
|
48
|
+
/**
|
|
49
|
+
* The stored end of the send after a recipient-phase end: `failed` or
|
|
50
|
+
* `acceptance-unknown`. With `acceptance-unknown`, the message might have
|
|
51
|
+
* arrived. Undefined after a sync-phase end, which keeps the result of
|
|
52
|
+
* the send.
|
|
53
|
+
*/
|
|
54
|
+
outcome;
|
|
55
|
+
constructor(unresolved, devices, clientMessageId, outcome) {
|
|
46
56
|
super(unresolved.reason === 'exhausted'
|
|
47
57
|
? `The Relay refused the device sets of the ${unresolved.phase} phase after ${String(unresolved.restarts)} restarts`
|
|
48
58
|
: `The Relay refused a restart of the ${unresolved.phase} phase because the operation expired`);
|
|
@@ -53,6 +63,7 @@ export class DeviceSetReconciliationError extends Error {
|
|
|
53
63
|
this.acceptedDevices = devices.acceptedDevices;
|
|
54
64
|
this.unresolvedDevices = devices.unresolvedDevices;
|
|
55
65
|
this.clientMessageId = clientMessageId;
|
|
66
|
+
this.outcome = outcome;
|
|
56
67
|
}
|
|
57
68
|
}
|
|
58
69
|
/**
|
|
@@ -94,10 +105,12 @@ export function syncPostReceipts(accepted) {
|
|
|
94
105
|
}
|
|
95
106
|
/**
|
|
96
107
|
* The protocol error of the first receipt that has no `deviceSetChecked`
|
|
97
|
-
* mark, or undefined when the Relay marked each receipt.
|
|
108
|
+
* mark, or undefined when the Relay marked each receipt. An acceptance from
|
|
109
|
+
* RETRY_CONFLICT, or from a version 2 DELIVERY_ALREADY_ACCEPTED, has no
|
|
110
|
+
* receipt, so it is not unchecked.
|
|
98
111
|
*/
|
|
99
112
|
export function uncheckedDeclaredPost(receipts, clientMessageId) {
|
|
100
|
-
const unchecked = receipts.find(([acceptance]) => acceptance.deviceSetChecked !== true);
|
|
113
|
+
const unchecked = receipts.find(([acceptance]) => acceptance.deviceSetChecked !== true && !isConflictAcceptance(acceptance));
|
|
101
114
|
return unchecked
|
|
102
115
|
? new RelayProtocolError('DEVICE_SET_UNCHECKED', clientMessageId, unchecked[1])
|
|
103
116
|
: undefined;
|
|
@@ -166,7 +179,8 @@ function deviceKey(device) {
|
|
|
166
179
|
* Run one phase of a declared send until every device post is accepted.
|
|
167
180
|
*
|
|
168
181
|
* After a pass, the first rule that applies decides:
|
|
169
|
-
* 1. A stopped send throws `RelayWorkStopped
|
|
182
|
+
* 1. A stopped send throws `RelayWorkStopped`, and a send at its posting
|
|
183
|
+
* deadline throws the deadline error.
|
|
170
184
|
* 2. A restart post that the Relay refused with `OPERATION_EXPIRED` ends the
|
|
171
185
|
* phase with `expired`. The restart count does not change.
|
|
172
186
|
* 3. A device-set refusal repairs every device that the refusals of the pass
|
|
@@ -189,7 +203,7 @@ export async function runDeviceSetPhase(run) {
|
|
|
189
203
|
restarts,
|
|
190
204
|
...(lastRefusal && { lastRefusal }),
|
|
191
205
|
};
|
|
192
|
-
await run.unresolve(unresolved);
|
|
206
|
+
const outcome = await run.unresolve(unresolved);
|
|
193
207
|
const unresolvedDevices = new Map();
|
|
194
208
|
for (const post of posts) {
|
|
195
209
|
if (!post.outcome.ok && !accepted.has(deviceKey(post.device))) {
|
|
@@ -203,7 +217,7 @@ export async function runDeviceSetPhase(run) {
|
|
|
203
217
|
throw new DeviceSetReconciliationError(unresolved, {
|
|
204
218
|
acceptedDevices: [...accepted.values()],
|
|
205
219
|
unresolvedDevices: [...unresolvedDevices.values()],
|
|
206
|
-
}, run.clientMessageId);
|
|
220
|
+
}, run.clientMessageId, outcome);
|
|
207
221
|
};
|
|
208
222
|
for (;;) {
|
|
209
223
|
const posts = await run.pass();
|
|
@@ -214,7 +228,7 @@ export async function runDeviceSetPhase(run) {
|
|
|
214
228
|
const failures = posts.flatMap((post) => post.outcome.ok ? [] : [{ device: post.device, error: post.outcome.error }]);
|
|
215
229
|
if (failures.length === 0)
|
|
216
230
|
return posts;
|
|
217
|
-
const stopped = failures.find((failure) => failure.error instanceof RelayWorkStopped);
|
|
231
|
+
const stopped = failures.find((failure) => failure.error instanceof RelayWorkStopped || isPostingDeadlineReached(failure.error));
|
|
218
232
|
if (stopped)
|
|
219
233
|
throw stopped.error;
|
|
220
234
|
if (restarts > 0 &&
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"device-set-reconciliation.js","sourceRoot":"","sources":["../../client/device-set-reconciliation.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,GAEjB,MAAM,4BAA4B,CAAC;AACpC,OAAO,
|
|
1
|
+
{"version":3,"file":"device-set-reconciliation.js","sourceRoot":"","sources":["../../client/device-set-reconciliation.ts"],"names":[],"mappings":"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"}
|
|
@@ -39,6 +39,7 @@ import type { RetryTerminalClass } from '../local/store/reliability.js';
|
|
|
39
39
|
import type { RelayProtocolError } from './device-set-reconciliation.js';
|
|
40
40
|
import type { GroupInitStatus } from './group-init-status.js';
|
|
41
41
|
import type { GroupId } from '../internal/groups/group-id.js';
|
|
42
|
+
import type { SendResult } from './types.js';
|
|
42
43
|
export type { RetryTerminalClass };
|
|
43
44
|
/**
|
|
44
45
|
* Decrypted envelope passed to onMessageDecrypted hook
|
|
@@ -77,6 +78,40 @@ export interface DeliveredEvent {
|
|
|
77
78
|
/** The group ID, for a group message. */
|
|
78
79
|
groupId?: string;
|
|
79
80
|
}
|
|
81
|
+
/**
|
|
82
|
+
* The end of one send or of one manual resend of it, or an open send whose
|
|
83
|
+
* content the SDK send driver cannot find.
|
|
84
|
+
*/
|
|
85
|
+
export interface SendOutcomeEvent {
|
|
86
|
+
/** The client message ID of the send. */
|
|
87
|
+
readonly clientMessageId: string;
|
|
88
|
+
/**
|
|
89
|
+
* `completed`: the Relay accepted the send, and `result` holds its result.
|
|
90
|
+
* `failed` and `acceptance-unknown`: the send ended at its posting
|
|
91
|
+
* deadline, and `error` holds the error of the end.
|
|
92
|
+
* `content-required`: the send is open, and the driver did not find its
|
|
93
|
+
* plaintext, or the plaintext that it found does not match the send. The
|
|
94
|
+
* send stays open until its posting deadline. Call `send()` again with the
|
|
95
|
+
* same `clientMessageId` and content before `deadlineAt`.
|
|
96
|
+
*/
|
|
97
|
+
readonly outcome: 'completed' | 'failed' | 'acceptance-unknown' | 'content-required';
|
|
98
|
+
/** The posting deadline of the send, in epoch milliseconds. */
|
|
99
|
+
readonly deadlineAt: number;
|
|
100
|
+
/** The result of a `completed` send. */
|
|
101
|
+
readonly result?: SendResult;
|
|
102
|
+
/**
|
|
103
|
+
* The error of a `failed` or `acceptance-unknown` end, as a `send()` call
|
|
104
|
+
* with the same `clientMessageId` throws it.
|
|
105
|
+
*/
|
|
106
|
+
readonly error?: Error;
|
|
107
|
+
/**
|
|
108
|
+
* The number of the manual resend that ended, from 1, for the end of a
|
|
109
|
+
* `resendMessage` operation. The event then carries the `deadlineAt`, and
|
|
110
|
+
* the `result` or `error`, of that resend. It is absent for the end of
|
|
111
|
+
* the original send.
|
|
112
|
+
*/
|
|
113
|
+
readonly manualResend?: number;
|
|
114
|
+
}
|
|
80
115
|
/**
|
|
81
116
|
* The end of a retry request with no resend. The device that asked for the
|
|
82
117
|
* resend gets it for each class except `missing-prekey`. The device that
|
|
@@ -90,14 +125,14 @@ export interface RetryTerminalEvent {
|
|
|
90
125
|
/** The Relay message ID of the envelope that the requester failed to decrypt. */
|
|
91
126
|
failedEnvelopeId: string;
|
|
92
127
|
/**
|
|
93
|
-
* The session reset of the requester. Only an `expired-content`
|
|
94
|
-
* client with a Relay has it.
|
|
128
|
+
* The session reset of the requester. Only an `expired-content` or
|
|
129
|
+
* `posting-deadline` end of a client with a Relay has it.
|
|
95
130
|
*/
|
|
96
131
|
recovery?: RetryTerminalRecoveryEvent;
|
|
97
132
|
}
|
|
98
133
|
/**
|
|
99
134
|
* The session reset of the requester after a retry request ends as
|
|
100
|
-
* `expired-content`.
|
|
135
|
+
* `expired-content` or `posting-deadline`.
|
|
101
136
|
*
|
|
102
137
|
* The requester archived its session with the device that sent the failed
|
|
103
138
|
* envelope, after each decrypt from that device in progress ended. The next
|
|
@@ -459,13 +494,52 @@ export interface SignalProtocolClientHooks {
|
|
|
459
494
|
* ```
|
|
460
495
|
*/
|
|
461
496
|
onDelivered?: (event: DeliveredEvent) => void | Promise<void>;
|
|
497
|
+
/**
|
|
498
|
+
* Runs once for each end of a send
|
|
499
|
+
*
|
|
500
|
+
* A send ends when the Relay accepts it (`completed`), or at its posting
|
|
501
|
+
* deadline (`failed` or `acceptance-unknown`). With a store that implements
|
|
502
|
+
* `listMetadataKeys`, as every built-in store does, the SDK replays each
|
|
503
|
+
* open send at start and when the Relay connection returns, until its
|
|
504
|
+
* deadline, and the hook reports each end of that replay. The hook also
|
|
505
|
+
* reports each end of a `send()` call of the application, before the call
|
|
506
|
+
* returns or throws. A replay of a send that already ended reports nothing.
|
|
507
|
+
*
|
|
508
|
+
* The driver also reports `content-required` once for each client run
|
|
509
|
+
* when it cannot find the plaintext of an open send. The send stays open,
|
|
510
|
+
* and its end at the deadline is reported too.
|
|
511
|
+
*
|
|
512
|
+
* An event can carry the ID of a sender key distribution that an earlier
|
|
513
|
+
* SDK version stored, which the application never sent. Ignore an ID that
|
|
514
|
+
* the application does not know.
|
|
515
|
+
*
|
|
516
|
+
* The hook runs at most once for each end. The driver records the report
|
|
517
|
+
* before it calls the hook, so a crash or a client stop between the two
|
|
518
|
+
* loses the event. A crash before that record reports the end at the next
|
|
519
|
+
* start. A hook that throws is logged, and it does not run again for that
|
|
520
|
+
* end. The `send()` call still returns or throws its own result.
|
|
521
|
+
*
|
|
522
|
+
* @param event - The client message ID, the outcome and the deadline of the send
|
|
523
|
+
*
|
|
524
|
+
* @example
|
|
525
|
+
* ```typescript
|
|
526
|
+
* onSendOutcome: async (event) => {
|
|
527
|
+
* if (event.outcome === 'completed') await messageStore.markSent(event.clientMessageId);
|
|
528
|
+
* else if (event.outcome === 'content-required') await messageStore.resend(event.clientMessageId);
|
|
529
|
+
* else await messageStore.markFailed(event.clientMessageId, event.outcome);
|
|
530
|
+
* }
|
|
531
|
+
* ```
|
|
532
|
+
*/
|
|
533
|
+
onSendOutcome?: (event: SendOutcomeEvent) => void | Promise<void>;
|
|
462
534
|
/**
|
|
463
535
|
* Runs when a retry request ends with no resend
|
|
464
536
|
*
|
|
465
537
|
* A failed decrypt asks the sender device for a resend. The request ends
|
|
466
538
|
* when the Relay gives a conclusive answer to its post, when it does not
|
|
467
539
|
* get its content before its deadline, 14 days after the first failure,
|
|
468
|
-
* when
|
|
540
|
+
* when a post of it is due at or after its posting deadline, 24 hours
|
|
541
|
+
* after the first failure, when the Relay refuses its post with
|
|
542
|
+
* OPERATION_EXPIRED, when the resend of the fifth attempt also fails, when the sender used up
|
|
469
543
|
* its retry allowance, when the sender device has no prekey bundle of the
|
|
470
544
|
* requester, or when the sender device refuses group content to a
|
|
471
545
|
* requester that is not a current member of the group. The content of the
|
|
@@ -476,10 +550,16 @@ export interface SignalProtocolClientHooks {
|
|
|
476
550
|
* start, or redelivery. Make the hook idempotent for one
|
|
477
551
|
* `failedEnvelopeId`.
|
|
478
552
|
*
|
|
479
|
-
* Before the hook, an `expired-content` end resets
|
|
480
|
-
* device that sent the failed envelope, and
|
|
481
|
-
* the reset did. The other classes, and a post
|
|
482
|
-
* posted again, reset nothing. `onSessionArchived`
|
|
553
|
+
* Before the hook, an `expired-content` or `posting-deadline` end resets
|
|
554
|
+
* the session with the device that sent the failed envelope, and
|
|
555
|
+
* `event.recovery` tells what the reset did. The other classes, and a post
|
|
556
|
+
* that fails and can be posted again, reset nothing. `onSessionArchived`
|
|
557
|
+
* runs for the archive.
|
|
558
|
+
*
|
|
559
|
+
* A `posting-deadline` end posts no replacement request. The session
|
|
560
|
+
* resets, and the request might have arrived at the sender. A request
|
|
561
|
+
* whose post the Relay accepted posts nothing after its posting deadline,
|
|
562
|
+
* and waits for its content until its deadline.
|
|
483
563
|
*
|
|
484
564
|
* @param event - The class of the end, the failed envelope, and the reset
|
|
485
565
|
*
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"event-hooks.d.ts","sourceRoot":"","sources":["../../client/event-hooks.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"event-hooks.d.ts","sourceRoot":"","sources":["../../client/event-hooks.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"event-hooks.js","sourceRoot":"","sources":["../../client/event-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;
|
|
1
|
+
{"version":3,"file":"event-hooks.js","sourceRoot":"","sources":["../../client/event-hooks.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,11 +1,12 @@
|
|
|
1
1
|
import type { SignalProtocolLocalStore } from '../types/index.js';
|
|
2
2
|
import { ContentHint } from '../types/messages.js';
|
|
3
3
|
import type { GroupMemberDevice, SignalProtocolRelayServer, SealedSenderAuth } from '../remote/relay/types.js';
|
|
4
|
-
import { type StoredOutgoingDeviceMessage, type StoredOutgoingMessageIntent } from '../local/store/reliability.js';
|
|
5
|
-
import { type DeviceSetAccountRepair, type DeviceSetDevice, type DeviceSetUnresolved, type DeclaredPostReceipt, type DeclaredSyncOutcome } from './device-set-reconciliation.js';
|
|
4
|
+
import { type StoredDestinationProgress, type StoredOutgoingDeviceMessage, type StoredOutgoingMessageIntent } from '../local/store/reliability.js';
|
|
5
|
+
import { type DeviceSetAccountRepair, type DeviceSetDevice, type DeviceSetReconciliationError, type DeviceSetUnresolved, type DeclaredPostReceipt, type DeclaredSyncOutcome } from './device-set-reconciliation.js';
|
|
6
6
|
import { type SendTimestampOrigin } from './send-timestamp.js';
|
|
7
7
|
import type { SendOptions, SendResult } from './types.js';
|
|
8
8
|
import { type RelayPostAcceptance } from './relay-acceptance.js';
|
|
9
|
+
import { type SendDevice, type SendDestination, type SendEndReportMark } from './send-deadline.js';
|
|
9
10
|
/** The relay phases of a group send, in their order. */
|
|
10
11
|
export type GroupSendPhase = 'pre-message' | 'device' | 'sync';
|
|
11
12
|
/** The transport of one sender-key pre-message for one dispatch. */
|
|
@@ -18,11 +19,12 @@ export interface PreMessageTransport {
|
|
|
18
19
|
/**
|
|
19
20
|
* The pre-message of one post, and whether the Relay accepted it, the send
|
|
20
21
|
* dropped it, or the send dropped it because the device list no longer shows
|
|
21
|
-
* the device.
|
|
22
|
+
* the device. `held`: the Relay holds other bytes under the repair ID of this
|
|
23
|
+
* pre-message. The send records no handoff row.
|
|
22
24
|
*/
|
|
23
25
|
export interface PreMessagePostResult {
|
|
24
26
|
message: StoredOutgoingDeviceMessage;
|
|
25
|
-
outcome: 'accepted' | 'dropped' | 'removed';
|
|
27
|
+
outcome: 'accepted' | 'held' | 'dropped' | 'removed';
|
|
26
28
|
/**
|
|
27
29
|
* True when a repair in the post refreshed the session of the device. The
|
|
28
30
|
* stored device message of the send then names the earlier registration.
|
|
@@ -58,8 +60,11 @@ export interface GroupDeviceSetContext {
|
|
|
58
60
|
* the receipt of each accepted sync post, also when the phase fails.
|
|
59
61
|
*/
|
|
60
62
|
runSyncPhase(intent: StoredOutgoingMessageIntent, rebuild: (device: DeviceSetDevice) => Promise<StoredOutgoingDeviceMessage | undefined>): Promise<DeclaredSyncOutcome>;
|
|
61
|
-
/**
|
|
62
|
-
|
|
63
|
+
/**
|
|
64
|
+
* Record the terminal state of the recipient phase, with the outcome of
|
|
65
|
+
* the send. Resolves to the stored outcome.
|
|
66
|
+
*/
|
|
67
|
+
unresolve(clientMessageId: string, unresolved: DeviceSetUnresolved): Promise<DeviceSetReconciliationError['outcome']>;
|
|
63
68
|
/** Wait before the next pass. Rejects when the send stops. */
|
|
64
69
|
wait(milliseconds: number): Promise<void>;
|
|
65
70
|
/** Log a failed post of a pass that does not decide the phase. */
|
|
@@ -87,6 +92,26 @@ export interface GroupOutboxContext {
|
|
|
87
92
|
senderUserId: string;
|
|
88
93
|
senderDeviceId: number;
|
|
89
94
|
deliveryMode: 'preferred' | 'required' | 'disabled';
|
|
95
|
+
/**
|
|
96
|
+
* Bind the evidence of this `send()` call to the stored intent, before any
|
|
97
|
+
* post. Each request of the call then meets the posting deadline of the
|
|
98
|
+
* intent, and each answer is stored in its progress.
|
|
99
|
+
*/
|
|
100
|
+
bindEvidence(intent: StoredOutgoingMessageIntent): void;
|
|
101
|
+
/**
|
|
102
|
+
* Give the evidence of the call the stored entry of a device that a repair
|
|
103
|
+
* in this call returned, so a later RETRY_CONFLICT of the repost reads its
|
|
104
|
+
* repair mark.
|
|
105
|
+
*/
|
|
106
|
+
refreshEntry(device: SendDevice, entry: StoredDestinationProgress): void;
|
|
107
|
+
/**
|
|
108
|
+
* Decide the recipient phase of a send that failed. At or after the
|
|
109
|
+
* posting deadline with an open destination, or when every open
|
|
110
|
+
* destination got OPERATION_EXPIRED, the send ends: the outbox stores its
|
|
111
|
+
* outcome, and the error is the class of the end. Before that, the error
|
|
112
|
+
* is thrown with the deadline, and the intent stays open.
|
|
113
|
+
*/
|
|
114
|
+
endRecipientPhase(intent: StoredOutgoingMessageIntent, error: unknown): Promise<never>;
|
|
90
115
|
/**
|
|
91
116
|
* Prepare the sender-key payload and a distribution pre-message for each
|
|
92
117
|
* member device that needs the current key. The preparation gets the
|
|
@@ -195,9 +220,10 @@ export interface GroupOutboxContext {
|
|
|
195
220
|
* the relay refuses the new copy as stale too, the session is archived,
|
|
196
221
|
* the copy leaves the intent, and the post resolves, so the send completes
|
|
197
222
|
* without it. When the refresh fails or the rebuild gives no copy, the
|
|
198
|
-
* post throws, and the copy and the refreshed session stay.
|
|
223
|
+
* post throws, and the copy and the refreshed session stay. Resolves to
|
|
224
|
+
* true when the posting deadline stopped the copy: it then stays pending.
|
|
199
225
|
*/
|
|
200
|
-
postSyncMessage(intent: StoredOutgoingMessageIntent, message: StoredOutgoingDeviceMessage, rebuild: (deviceId: number) => Promise<StoredOutgoingDeviceMessage | undefined>): Promise<
|
|
226
|
+
postSyncMessage(intent: StoredOutgoingMessageIntent, message: StoredOutgoingDeviceMessage, rebuild: (deviceId: number) => Promise<StoredOutgoingDeviceMessage | undefined>): Promise<boolean>;
|
|
201
227
|
/**
|
|
202
228
|
* Post one sealed device message. With `declaredDeviceIds`, the post
|
|
203
229
|
* declares the devices of its account.
|
|
@@ -215,15 +241,24 @@ export interface GroupOutboxContext {
|
|
|
215
241
|
* the error of the first failed device in input order.
|
|
216
242
|
*/
|
|
217
243
|
sendPhase<R>(messages: readonly StoredOutgoingDeviceMessage[], task: (message: StoredOutgoingDeviceMessage) => Promise<R>, phase: GroupSendPhase): Promise<R[]>;
|
|
218
|
-
/**
|
|
244
|
+
/**
|
|
245
|
+
* Send one relay request of a post under a slot of the bound. With one
|
|
246
|
+
* destination, the evidence of the call records the requests and the
|
|
247
|
+
* answer of the device. With a list, the post is a shared body, and its one
|
|
248
|
+
* answer is recorded on each destination of the list.
|
|
249
|
+
*/
|
|
219
250
|
postToRelay<T>(send: () => Promise<T>, sealed: boolean): Promise<T>;
|
|
251
|
+
postToRelay<T extends RelayPostAcceptance>(send: () => Promise<T>, sealed: boolean, destination: SendDestination): Promise<RelayPostAcceptance>;
|
|
252
|
+
postToRelay<T extends RelayPostAcceptance & {
|
|
253
|
+
uuids404: string[];
|
|
254
|
+
}>(send: () => Promise<T>, sealed: boolean, destinations: readonly SendDestination[]): Promise<T>;
|
|
220
255
|
/**
|
|
221
256
|
* The declared work of the send. Present only for a relay that compares
|
|
222
257
|
* device sets. Without it, the send keeps the per-send device list reads.
|
|
223
258
|
*/
|
|
224
259
|
deviceSets?: GroupDeviceSetContext;
|
|
225
260
|
}
|
|
226
|
-
export declare function sendGroupWithExactOutbox(context: GroupOutboxContext, groupId: string, plaintextBytes: Uint8Array, options: SendOptions & SendTimestampOrigin & {
|
|
261
|
+
export declare function sendGroupWithExactOutbox(context: GroupOutboxContext, groupId: string, plaintextBytes: Uint8Array, options: SendOptions & SendTimestampOrigin & SendEndReportMark & {
|
|
227
262
|
clientMessageId: string;
|
|
228
263
|
}): Promise<SendResult>;
|
|
229
264
|
//# sourceMappingURL=group-outbox.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"group-outbox.d.ts","sourceRoot":"","sources":["../../client/group-outbox.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAGxE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,EACV,iBAAiB,EACjB,yBAAyB,EACzB,gBAAgB,EACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAeL,KAAK,2BAA2B,EAChC,KAAK,2BAA2B,EACjC,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,eAAe,EAEpB,KAAK,mBAAmB,EAGxB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACzB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAA0B,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;
|
|
1
|
+
{"version":3,"file":"group-outbox.d.ts","sourceRoot":"","sources":["../../client/group-outbox.ts"],"names":[],"mappings":"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"}
|