@mentra/miniapp 3.3.0-dev.328 → 3.3.0-dev.331
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/dist/background/index.d.ts +3 -1
- package/dist/background/index.d.ts.map +1 -1
- package/dist/background/index.js +1 -0
- package/dist/background/index.js.map +1 -1
- package/dist/index.d.ts +4 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +2 -0
- package/dist/index.js.map +1 -1
- package/dist/modules/meeting.d.ts +11 -0
- package/dist/modules/meeting.d.ts.map +1 -1
- package/dist/modules/meeting.js +19 -0
- package/dist/modules/meeting.js.map +1 -1
- package/dist/modules/stream.d.ts +46 -0
- package/dist/modules/stream.d.ts.map +1 -1
- package/dist/modules/stream.js +107 -0
- package/dist/modules/stream.js.map +1 -1
- package/dist/protocol.d.ts +35 -0
- package/dist/protocol.d.ts.map +1 -1
- package/dist/protocol.js +32 -0
- package/dist/protocol.js.map +1 -1
- package/dist/react/StreamPreview.d.ts +41 -0
- package/dist/react/StreamPreview.d.ts.map +1 -0
- package/dist/react/StreamPreview.js +144 -0
- package/dist/react/StreamPreview.js.map +1 -0
- package/dist/react/index.d.ts +2 -0
- package/dist/react/index.d.ts.map +1 -1
- package/dist/react/index.js +1 -0
- package/dist/react/index.js.map +1 -1
- package/dist/react/stream-preview/PreviewConnection.d.ts +139 -0
- package/dist/react/stream-preview/PreviewConnection.d.ts.map +1 -0
- package/dist/react/stream-preview/PreviewConnection.js +454 -0
- package/dist/react/stream-preview/PreviewConnection.js.map +1 -0
- package/dist/react/stream-preview/controlChannel.d.ts +75 -0
- package/dist/react/stream-preview/controlChannel.d.ts.map +1 -0
- package/dist/react/stream-preview/controlChannel.js +55 -0
- package/dist/react/stream-preview/controlChannel.js.map +1 -0
- package/dist/react/stream-preview/creditLoop.d.ts +81 -0
- package/dist/react/stream-preview/creditLoop.d.ts.map +1 -0
- package/dist/react/stream-preview/creditLoop.js +146 -0
- package/dist/react/stream-preview/creditLoop.js.map +1 -0
- package/dist/react/stream-preview/protocol.d.ts +113 -0
- package/dist/react/stream-preview/protocol.d.ts.map +1 -0
- package/dist/react/stream-preview/protocol.js +148 -0
- package/dist/react/stream-preview/protocol.js.map +1 -0
- package/dist/react/stream-preview/resizeCoalescer.d.ts +38 -0
- package/dist/react/stream-preview/resizeCoalescer.d.ts.map +1 -0
- package/dist/react/stream-preview/resizeCoalescer.js +71 -0
- package/dist/react/stream-preview/resizeCoalescer.js.map +1 -0
- package/dist/react/stream-preview/testFrames.d.ts +38 -0
- package/dist/react/stream-preview/testFrames.d.ts.map +1 -0
- package/dist/react/stream-preview/testFrames.js +50 -0
- package/dist/react/stream-preview/testFrames.js.map +1 -0
- package/dist/react/stream-preview/tiers.d.ts +21 -0
- package/dist/react/stream-preview/tiers.d.ts.map +1 -0
- package/dist/react/stream-preview/tiers.js +33 -0
- package/dist/react/stream-preview/tiers.js.map +1 -0
- package/dist/react/stream-preview/trace.d.ts +23 -0
- package/dist/react/stream-preview/trace.d.ts.map +1 -0
- package/dist/react/stream-preview/trace.js +71 -0
- package/dist/react/stream-preview/trace.js.map +1 -0
- package/dist/react/stream-preview/transport.d.ts +79 -0
- package/dist/react/stream-preview/transport.d.ts.map +1 -0
- package/dist/react/stream-preview/transport.js +209 -0
- package/dist/react/stream-preview/transport.js.map +1 -0
- package/dist/react/stream-preview/yuvRenderer.d.ts +31 -0
- package/dist/react/stream-preview/yuvRenderer.d.ts.map +1 -0
- package/dist/react/stream-preview/yuvRenderer.js +398 -0
- package/dist/react/stream-preview/yuvRenderer.js.map +1 -0
- package/dist/session.d.ts.map +1 -1
- package/dist/session.js +5 -0
- package/dist/session.js.map +1 -1
- package/dist/ui/index.d.ts +2 -0
- package/dist/ui/index.d.ts.map +1 -1
- package/dist/ui/index.js +1 -0
- package/dist/ui/index.js.map +1 -1
- package/package.json +8 -3
- package/src/background/index.ts +9 -1
- package/src/index.ts +7 -0
- package/src/modules/meeting.ts +23 -0
- package/src/modules/stream.ts +153 -1
- package/src/protocol.ts +71 -0
- package/src/react/StreamPreview.tsx +187 -0
- package/src/react/index.ts +2 -0
- package/src/react/stream-preview/PreviewConnection.ts +543 -0
- package/src/react/stream-preview/controlChannel.ts +119 -0
- package/src/react/stream-preview/creditLoop.ts +189 -0
- package/src/react/stream-preview/protocol.ts +227 -0
- package/src/react/stream-preview/resizeCoalescer.ts +88 -0
- package/src/react/stream-preview/testFrames.ts +86 -0
- package/src/react/stream-preview/tiers.ts +37 -0
- package/src/react/stream-preview/trace.ts +81 -0
- package/src/react/stream-preview/transport.ts +242 -0
- package/src/react/stream-preview/yuvRenderer.ts +453 -0
- package/src/session.ts +6 -0
- package/src/ui/index.ts +2 -0
|
@@ -0,0 +1,454 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The preview connection for this document.
|
|
3
|
+
*
|
|
4
|
+
* Three owners with three lifetimes meet here:
|
|
5
|
+
* - The **lease** belongs to the miniapp's background (`session.stream.preview()`). The page
|
|
6
|
+
* never creates or releases it; it only hears `lease_available` / `lease_ended`.
|
|
7
|
+
* - The **connection** belongs to this document: the host config (token, docGen), the frame
|
|
8
|
+
* transport and the credit loop. It is a module-scoped singleton so it survives
|
|
9
|
+
* `<StreamPreview>` unmounting and remounting; a remount sends `start` without a handshake.
|
|
10
|
+
* It ends with the document (reload, navigation, `pagehide`) or when the lease ends.
|
|
11
|
+
* - The **renderer** belongs to the component and is attached here only as a draw callback.
|
|
12
|
+
*
|
|
13
|
+
* Control is desired-state: the component says which mount epoch wants which tier and whether it
|
|
14
|
+
* wants frames, and `sync()` sends the difference to the host over `_preview`. A new document
|
|
15
|
+
* always needs a new handshake; a new mount never does.
|
|
16
|
+
*/
|
|
17
|
+
import { createMentraControlChannel, PreviewControlError } from "./controlChannel";
|
|
18
|
+
import { CreditLoop } from "./creditLoop";
|
|
19
|
+
import { sameTier } from "./tiers";
|
|
20
|
+
import { previewTrace, previewTraceWarn, previewTraceWarnLimited } from "./trace";
|
|
21
|
+
import { ackMessage, createPreviewTransport } from "./transport";
|
|
22
|
+
/** The only control protocol this SDK speaks. Anything else is reported as `unsupported`. */
|
|
23
|
+
export const PREVIEW_PROTOCOL_VERSION = 1;
|
|
24
|
+
/** Automatic re-handshakes after a transport failure, per window, before giving up until remount. */
|
|
25
|
+
const RECONNECT_BUDGET = 3;
|
|
26
|
+
const RECONNECT_WINDOW_MS = 60000;
|
|
27
|
+
/** Immediate re-handshakes after the host answers a handshake as stale. */
|
|
28
|
+
const STALE_HANDSHAKE_RETRIES = 2;
|
|
29
|
+
function defaultListen(target, type, handler) {
|
|
30
|
+
const node = target === "document"
|
|
31
|
+
? typeof document === "undefined"
|
|
32
|
+
? null
|
|
33
|
+
: document
|
|
34
|
+
: typeof window === "undefined"
|
|
35
|
+
? null
|
|
36
|
+
: window;
|
|
37
|
+
if (!node)
|
|
38
|
+
return () => { };
|
|
39
|
+
node.addEventListener(type, handler);
|
|
40
|
+
return () => node.removeEventListener(type, handler);
|
|
41
|
+
}
|
|
42
|
+
function defaultIsVisible() {
|
|
43
|
+
return typeof document === "undefined" || document.visibilityState !== "hidden";
|
|
44
|
+
}
|
|
45
|
+
const NOTHING_APPLIED = { epoch: -1, tier: null, running: false };
|
|
46
|
+
export class PreviewConnection {
|
|
47
|
+
constructor(deps) {
|
|
48
|
+
this.deps = deps;
|
|
49
|
+
this.detail = {};
|
|
50
|
+
this.docGen = 0;
|
|
51
|
+
this.config = null;
|
|
52
|
+
this.transport = null;
|
|
53
|
+
/** Bumped whenever the transport is dropped, so a stale async continuation can tell. */
|
|
54
|
+
this.connectionGen = 0;
|
|
55
|
+
this.mountEpochCounter = 0;
|
|
56
|
+
this.latestEpoch = 0;
|
|
57
|
+
this.sink = null;
|
|
58
|
+
this.desired = null;
|
|
59
|
+
this.applied = NOTHING_APPLIED;
|
|
60
|
+
/** Epoch whose production the host halted on a non-recoverable error; not restarted until remount. */
|
|
61
|
+
this.haltedEpoch = -1;
|
|
62
|
+
this.handshaking = null;
|
|
63
|
+
this.opChain = Promise.resolve();
|
|
64
|
+
this.reconnectTimes = [];
|
|
65
|
+
this.paused = false;
|
|
66
|
+
this.unsubscribers = [];
|
|
67
|
+
this.counters = { handshakes: 0, reconnects: 0, staleReplies: 0, staleLocalOps: 0, tierChanges: 0 };
|
|
68
|
+
this.createTransport = deps.createTransport ?? createPreviewTransport;
|
|
69
|
+
this.now = deps.now ?? (() => (typeof performance !== "undefined" ? performance.now() : Date.now()));
|
|
70
|
+
this.isVisible = deps.isDocumentVisible ?? defaultIsVisible;
|
|
71
|
+
this.state = deps.channel ? "idle" : "unavailable";
|
|
72
|
+
this.creditLoop = new CreditLoop({
|
|
73
|
+
sendAck: (gen, seq) => this.transport?.sendText(ackMessage(gen, seq)),
|
|
74
|
+
onParseError: (reason) => previewTraceWarnLimited(`parse:${reason}`, "parse_reject", { reason, docGen: this.docGen }),
|
|
75
|
+
});
|
|
76
|
+
if (deps.channel) {
|
|
77
|
+
this.unsubscribers.push(deps.channel.onEvent((event) => this.handleHostEvent(event)));
|
|
78
|
+
const listen = deps.listen ?? defaultListen;
|
|
79
|
+
this.unsubscribers.push(listen("window", "pagehide", () => this.close("pagehide")));
|
|
80
|
+
// A page restored from the back/forward cache is the same document with a dead transport.
|
|
81
|
+
this.unsubscribers.push(listen("window", "pageshow", () => {
|
|
82
|
+
if (this.state !== "closed")
|
|
83
|
+
return;
|
|
84
|
+
this.setState("idle", { reason: "pageshow" });
|
|
85
|
+
this.sync();
|
|
86
|
+
}));
|
|
87
|
+
this.unsubscribers.push(listen("document", "visibilitychange", () => this.handleVisibility()));
|
|
88
|
+
}
|
|
89
|
+
}
|
|
90
|
+
get currentState() {
|
|
91
|
+
return this.state;
|
|
92
|
+
}
|
|
93
|
+
get documentGeneration() {
|
|
94
|
+
return this.docGen;
|
|
95
|
+
}
|
|
96
|
+
snapshot() {
|
|
97
|
+
return { ...this.counters, page: this.creditLoop.snapshot() };
|
|
98
|
+
}
|
|
99
|
+
/** A fresh, strictly increasing epoch for a component mounting in this document. */
|
|
100
|
+
nextMountEpoch() {
|
|
101
|
+
this.mountEpochCounter += 1;
|
|
102
|
+
return this.mountEpochCounter;
|
|
103
|
+
}
|
|
104
|
+
/**
|
|
105
|
+
* Route frames to this component's renderer. The newest mount wins; an older sink detaching
|
|
106
|
+
* later cannot remove a newer one.
|
|
107
|
+
*/
|
|
108
|
+
attach(sink) {
|
|
109
|
+
if (sink.mountEpoch < this.latestEpoch) {
|
|
110
|
+
this.counters.staleLocalOps += 1;
|
|
111
|
+
return () => { };
|
|
112
|
+
}
|
|
113
|
+
this.latestEpoch = sink.mountEpoch;
|
|
114
|
+
this.sink = sink;
|
|
115
|
+
this.creditLoop.setDraw((frame) => sink.draw(frame));
|
|
116
|
+
sink.onState(this.state, { ...this.detail, paused: this.paused });
|
|
117
|
+
return () => {
|
|
118
|
+
if (this.sink !== sink)
|
|
119
|
+
return;
|
|
120
|
+
this.sink = null;
|
|
121
|
+
this.creditLoop.setDraw(null);
|
|
122
|
+
};
|
|
123
|
+
}
|
|
124
|
+
/** Declare what `mountEpoch` wants. Operations from a superseded epoch are ignored. */
|
|
125
|
+
update(mountEpoch, state) {
|
|
126
|
+
if (mountEpoch < this.latestEpoch) {
|
|
127
|
+
this.counters.staleLocalOps += 1;
|
|
128
|
+
previewTrace("stale_local_op", { mountEpoch, latestEpoch: this.latestEpoch });
|
|
129
|
+
return;
|
|
130
|
+
}
|
|
131
|
+
this.latestEpoch = mountEpoch;
|
|
132
|
+
this.desired = { epoch: mountEpoch, state };
|
|
133
|
+
this.sync();
|
|
134
|
+
}
|
|
135
|
+
reportRendererError(mountEpoch, message) {
|
|
136
|
+
this.creditLoop.recordError(message);
|
|
137
|
+
if (this.state !== "open" || !this.config)
|
|
138
|
+
return;
|
|
139
|
+
void this.send({ cmd: "rendererError", mountEpoch, message }).catch(() => undefined);
|
|
140
|
+
}
|
|
141
|
+
/** End of document. The lease is untouched; a new document will handshake again. */
|
|
142
|
+
close(reason) {
|
|
143
|
+
if (this.state === "closed")
|
|
144
|
+
return;
|
|
145
|
+
previewTrace("connection_closed", { reason, docGen: this.docGen });
|
|
146
|
+
this.dropTransport();
|
|
147
|
+
this.setState("closed", { reason });
|
|
148
|
+
}
|
|
149
|
+
/** Test seam: detach from the channel and document. */
|
|
150
|
+
dispose() {
|
|
151
|
+
for (const unsubscribe of this.unsubscribers.splice(0))
|
|
152
|
+
unsubscribe();
|
|
153
|
+
this.dropTransport();
|
|
154
|
+
}
|
|
155
|
+
// ---------------------------------------------------------------------------
|
|
156
|
+
sync() {
|
|
157
|
+
this.opChain = this.opChain
|
|
158
|
+
.then(() => this.syncOnce())
|
|
159
|
+
.catch((error) => {
|
|
160
|
+
previewTraceWarn("sync_failed", { error: error instanceof Error ? error.message : String(error) });
|
|
161
|
+
});
|
|
162
|
+
}
|
|
163
|
+
wantsFrames() {
|
|
164
|
+
const desired = this.desired;
|
|
165
|
+
return !!desired && desired.state.running && desired.state.tier !== null && desired.epoch !== this.haltedEpoch;
|
|
166
|
+
}
|
|
167
|
+
async syncOnce() {
|
|
168
|
+
const desired = this.desired;
|
|
169
|
+
if (!desired)
|
|
170
|
+
return;
|
|
171
|
+
if (this.state !== "open") {
|
|
172
|
+
// Hidden components never force a handshake; the next visible one will.
|
|
173
|
+
if (!this.wantsFrames())
|
|
174
|
+
return;
|
|
175
|
+
if (!(await this.ensureOpen()))
|
|
176
|
+
return;
|
|
177
|
+
}
|
|
178
|
+
const gen = this.connectionGen;
|
|
179
|
+
const { epoch, state } = desired;
|
|
180
|
+
if (state.tier && !sameTier(state.tier, this.applied.tier)) {
|
|
181
|
+
const reply = await this.send({
|
|
182
|
+
cmd: "configure",
|
|
183
|
+
mountEpoch: epoch,
|
|
184
|
+
boxWidth: state.boxWidth,
|
|
185
|
+
boxHeight: state.boxHeight,
|
|
186
|
+
});
|
|
187
|
+
if (gen !== this.connectionGen || !this.accept(reply, "configure"))
|
|
188
|
+
return;
|
|
189
|
+
this.counters.tierChanges += 1;
|
|
190
|
+
previewTrace("tier_sent", {
|
|
191
|
+
mountEpoch: epoch,
|
|
192
|
+
width: state.tier.width,
|
|
193
|
+
height: state.tier.height,
|
|
194
|
+
docGen: this.docGen,
|
|
195
|
+
});
|
|
196
|
+
this.applied = { ...this.applied, tier: state.tier };
|
|
197
|
+
}
|
|
198
|
+
const running = this.wantsFrames();
|
|
199
|
+
if (running !== this.applied.running || (running && epoch !== this.applied.epoch)) {
|
|
200
|
+
const reply = await this.send({ cmd: running ? "start" : "stop", mountEpoch: epoch });
|
|
201
|
+
if (gen !== this.connectionGen || !this.accept(reply, running ? "start" : "stop"))
|
|
202
|
+
return;
|
|
203
|
+
this.applied = { ...this.applied, epoch, running };
|
|
204
|
+
}
|
|
205
|
+
}
|
|
206
|
+
/** False when the host dropped the op as stale; our identity is then out of date. */
|
|
207
|
+
accept(reply, cmd) {
|
|
208
|
+
if (!reply)
|
|
209
|
+
return false;
|
|
210
|
+
if (!reply.stale)
|
|
211
|
+
return true;
|
|
212
|
+
this.counters.staleReplies += 1;
|
|
213
|
+
previewTraceWarn("control_stale", { cmd, docGen: this.docGen });
|
|
214
|
+
// The host no longer recognises this document's credential: start over with a handshake.
|
|
215
|
+
this.dropTransport();
|
|
216
|
+
this.setState("idle", { reason: "stale_identity" });
|
|
217
|
+
this.scheduleReconnect("stale_identity");
|
|
218
|
+
return false;
|
|
219
|
+
}
|
|
220
|
+
async send(request) {
|
|
221
|
+
const channel = this.deps.channel;
|
|
222
|
+
if (!channel)
|
|
223
|
+
return null;
|
|
224
|
+
try {
|
|
225
|
+
const reply = await channel.request({ ...request, docGen: this.docGen, token: this.config?.token });
|
|
226
|
+
return (reply ?? {});
|
|
227
|
+
}
|
|
228
|
+
catch (error) {
|
|
229
|
+
const code = error instanceof PreviewControlError ? error.code : "transport_failed";
|
|
230
|
+
previewTraceWarn("control_failed", { cmd: request.cmd, code, docGen: this.docGen });
|
|
231
|
+
this.sink?.onError(code);
|
|
232
|
+
return null;
|
|
233
|
+
}
|
|
234
|
+
}
|
|
235
|
+
ensureOpen() {
|
|
236
|
+
if (this.state === "open")
|
|
237
|
+
return Promise.resolve(true);
|
|
238
|
+
if (this.state === "unsupported" || this.state === "unavailable" || this.state === "closed") {
|
|
239
|
+
return Promise.resolve(false);
|
|
240
|
+
}
|
|
241
|
+
if (!this.handshaking) {
|
|
242
|
+
this.handshaking = this.handshake().finally(() => {
|
|
243
|
+
this.handshaking = null;
|
|
244
|
+
});
|
|
245
|
+
}
|
|
246
|
+
return this.handshaking;
|
|
247
|
+
}
|
|
248
|
+
async handshake(staleRetries = STALE_HANDSHAKE_RETRIES) {
|
|
249
|
+
const channel = this.deps.channel;
|
|
250
|
+
if (!channel)
|
|
251
|
+
return false;
|
|
252
|
+
const gen = this.connectionGen;
|
|
253
|
+
const mountEpoch = this.desired?.epoch ?? 0;
|
|
254
|
+
this.setState("handshaking");
|
|
255
|
+
previewTrace("handshake_attempt", { docGen: this.docGen, mountEpoch });
|
|
256
|
+
let result;
|
|
257
|
+
try {
|
|
258
|
+
result = (await channel.request({ cmd: "handshake", docGen: this.docGen, mountEpoch }));
|
|
259
|
+
}
|
|
260
|
+
catch (error) {
|
|
261
|
+
const code = error instanceof PreviewControlError ? error.code : "transport_failed";
|
|
262
|
+
previewTraceWarn("handshake_failed", { code, docGen: this.docGen });
|
|
263
|
+
this.setState(code === "unsupported" ? "unsupported" : "error", { code });
|
|
264
|
+
this.sink?.onError(code);
|
|
265
|
+
return false;
|
|
266
|
+
}
|
|
267
|
+
if (gen !== this.connectionGen)
|
|
268
|
+
return false;
|
|
269
|
+
if (!result || typeof result !== "object") {
|
|
270
|
+
this.setState("error", { code: "transport_failed" });
|
|
271
|
+
return false;
|
|
272
|
+
}
|
|
273
|
+
if ("stale" in result) {
|
|
274
|
+
// The docGen this page claimed (or the one minted for it mid-handshake) was superseded,
|
|
275
|
+
// e.g. by the `ready` that follows `handshake_without_ready`. Ask again as a page that does
|
|
276
|
+
// not know its document yet; the host answers with its current one.
|
|
277
|
+
this.counters.staleReplies += 1;
|
|
278
|
+
previewTraceWarn("handshake_stale", { docGen: this.docGen, staleRetries });
|
|
279
|
+
this.docGen = 0;
|
|
280
|
+
if (staleRetries > 0)
|
|
281
|
+
return this.handshake(staleRetries - 1);
|
|
282
|
+
this.setState("error", { reason: "stale_identity" });
|
|
283
|
+
return false;
|
|
284
|
+
}
|
|
285
|
+
if (result.t === "waiting_for_lease") {
|
|
286
|
+
if (typeof result.docGen === "number")
|
|
287
|
+
this.docGen = result.docGen;
|
|
288
|
+
previewTrace("waiting_for_lease", { docGen: this.docGen });
|
|
289
|
+
this.setState("waiting_for_lease");
|
|
290
|
+
return false;
|
|
291
|
+
}
|
|
292
|
+
return this.openTransport(result);
|
|
293
|
+
}
|
|
294
|
+
async openTransport(config) {
|
|
295
|
+
if (config.protocolVersion !== PREVIEW_PROTOCOL_VERSION) {
|
|
296
|
+
previewTraceWarn("handshake_rejected", { reason: "unsupported_version", protocolVersion: config.protocolVersion });
|
|
297
|
+
this.setState("unsupported", { code: "unsupported" });
|
|
298
|
+
this.sink?.onError("unsupported");
|
|
299
|
+
return false;
|
|
300
|
+
}
|
|
301
|
+
this.docGen = config.docGen;
|
|
302
|
+
this.config = config;
|
|
303
|
+
this.counters.handshakes += 1;
|
|
304
|
+
this.setState("connecting");
|
|
305
|
+
const gen = ++this.connectionGen;
|
|
306
|
+
let transport;
|
|
307
|
+
try {
|
|
308
|
+
transport = this.createTransport(config.transport, {
|
|
309
|
+
url: config.url,
|
|
310
|
+
portName: config.portName,
|
|
311
|
+
token: config.token,
|
|
312
|
+
});
|
|
313
|
+
transport.onBinary((buffer) => this.creditLoop.handleBinary(buffer));
|
|
314
|
+
transport.onError((reason) => this.handleTransportError(gen, reason));
|
|
315
|
+
await transport.connect();
|
|
316
|
+
}
|
|
317
|
+
catch (error) {
|
|
318
|
+
const reason = error.reason ?? "connect_failed";
|
|
319
|
+
previewTraceWarn("transport_failed", { reason, docGen: this.docGen, transport: config.transport });
|
|
320
|
+
if (gen === this.connectionGen) {
|
|
321
|
+
this.config = null;
|
|
322
|
+
this.setState("error", { code: "transport_failed", reason });
|
|
323
|
+
this.sink?.onError("transport_failed");
|
|
324
|
+
}
|
|
325
|
+
return false;
|
|
326
|
+
}
|
|
327
|
+
if (gen !== this.connectionGen) {
|
|
328
|
+
transport.close();
|
|
329
|
+
return false;
|
|
330
|
+
}
|
|
331
|
+
this.transport = transport;
|
|
332
|
+
this.applied = NOTHING_APPLIED;
|
|
333
|
+
previewTrace("handshake_ok", {
|
|
334
|
+
docGen: this.docGen,
|
|
335
|
+
transport: config.transport,
|
|
336
|
+
handshakes: this.counters.handshakes,
|
|
337
|
+
});
|
|
338
|
+
this.setState("open");
|
|
339
|
+
return true;
|
|
340
|
+
}
|
|
341
|
+
handleTransportError(gen, reason) {
|
|
342
|
+
if (gen !== this.connectionGen)
|
|
343
|
+
return;
|
|
344
|
+
previewTraceWarn("transport_closed", { reason, docGen: this.docGen });
|
|
345
|
+
this.dropTransport();
|
|
346
|
+
this.setState("error", { code: "transport_failed", reason });
|
|
347
|
+
this.sink?.onError("transport_failed");
|
|
348
|
+
// A socket the OS tore down while suspended is re-established on foreground instead.
|
|
349
|
+
if (this.isVisible())
|
|
350
|
+
this.scheduleReconnect(reason);
|
|
351
|
+
}
|
|
352
|
+
handleHostEvent(event) {
|
|
353
|
+
switch (event.t) {
|
|
354
|
+
case "lease_available":
|
|
355
|
+
previewTrace("lease_available", { docGen: this.docGen, state: this.state });
|
|
356
|
+
if (this.state === "waiting_for_lease" || this.state === "idle" || this.state === "error") {
|
|
357
|
+
this.setState("idle");
|
|
358
|
+
// Hidden stays connected-but-stopped, so handshake as soon as anyone has mounted.
|
|
359
|
+
if (this.desired)
|
|
360
|
+
void this.ensureOpen().then((open) => open && this.sync());
|
|
361
|
+
}
|
|
362
|
+
return;
|
|
363
|
+
case "lease_ended":
|
|
364
|
+
previewTrace("lease_ended", { reason: event.reason, docGen: this.docGen });
|
|
365
|
+
this.dropTransport();
|
|
366
|
+
this.setState("waiting_for_lease", { reason: event.reason });
|
|
367
|
+
if (event.reason === "source_ended")
|
|
368
|
+
this.sink?.onError("source_ended");
|
|
369
|
+
return;
|
|
370
|
+
case "error":
|
|
371
|
+
if (typeof event.docGen === "number" && event.docGen !== this.docGen)
|
|
372
|
+
return;
|
|
373
|
+
this.handleHostError(event.code);
|
|
374
|
+
return;
|
|
375
|
+
case "status":
|
|
376
|
+
this.sink?.onStatus({ ...event, page: this.snapshot() });
|
|
377
|
+
return;
|
|
378
|
+
case "paused_background":
|
|
379
|
+
this.paused = true;
|
|
380
|
+
this.sink?.onState(this.state, { ...this.detail, paused: true });
|
|
381
|
+
return;
|
|
382
|
+
case "resumed":
|
|
383
|
+
this.paused = false;
|
|
384
|
+
this.sink?.onState(this.state, { ...this.detail, paused: false });
|
|
385
|
+
return;
|
|
386
|
+
case "config":
|
|
387
|
+
if (event.docGen === this.docGen && this.state !== "open" && this.state !== "connecting") {
|
|
388
|
+
void this.openTransport(event).then((open) => open && this.sync());
|
|
389
|
+
}
|
|
390
|
+
return;
|
|
391
|
+
}
|
|
392
|
+
}
|
|
393
|
+
handleHostError(code) {
|
|
394
|
+
previewTraceWarn("host_error", { code, docGen: this.docGen });
|
|
395
|
+
this.sink?.onError(code);
|
|
396
|
+
if (code === "transport_failed" || code === "ack_timeout") {
|
|
397
|
+
this.dropTransport();
|
|
398
|
+
this.setState("error", { code });
|
|
399
|
+
this.scheduleReconnect(code);
|
|
400
|
+
return;
|
|
401
|
+
}
|
|
402
|
+
// The host halted production (pack_failed, diagnostics_disabled, ...). Restarting would only
|
|
403
|
+
// hit the same failure; a new mount epoch may try again.
|
|
404
|
+
this.applied = { ...this.applied, running: false };
|
|
405
|
+
this.haltedEpoch = this.desired?.epoch ?? this.haltedEpoch;
|
|
406
|
+
}
|
|
407
|
+
handleVisibility() {
|
|
408
|
+
const visible = this.isVisible();
|
|
409
|
+
previewTrace("visibility", { visible, state: this.state, docGen: this.docGen });
|
|
410
|
+
if (visible && (this.state === "error" || this.state === "idle"))
|
|
411
|
+
this.sync();
|
|
412
|
+
}
|
|
413
|
+
scheduleReconnect(reason) {
|
|
414
|
+
const at = this.now();
|
|
415
|
+
this.reconnectTimes = this.reconnectTimes.filter((t) => at - t < RECONNECT_WINDOW_MS);
|
|
416
|
+
if (this.reconnectTimes.length >= RECONNECT_BUDGET) {
|
|
417
|
+
previewTraceWarn("reconnect_budget_exhausted", { reason, docGen: this.docGen });
|
|
418
|
+
return;
|
|
419
|
+
}
|
|
420
|
+
this.reconnectTimes.push(at);
|
|
421
|
+
this.counters.reconnects += 1;
|
|
422
|
+
previewTrace("reconnect", { reason, docGen: this.docGen, reconnects: this.counters.reconnects });
|
|
423
|
+
this.sync();
|
|
424
|
+
}
|
|
425
|
+
dropTransport() {
|
|
426
|
+
this.connectionGen += 1;
|
|
427
|
+
const transport = this.transport;
|
|
428
|
+
this.transport = null;
|
|
429
|
+
this.config = null;
|
|
430
|
+
this.applied = NOTHING_APPLIED;
|
|
431
|
+
if (transport) {
|
|
432
|
+
transport.close();
|
|
433
|
+
previewTrace("transport_close", { docGen: this.docGen });
|
|
434
|
+
}
|
|
435
|
+
}
|
|
436
|
+
setState(state, detail = {}) {
|
|
437
|
+
this.state = state;
|
|
438
|
+
this.detail = detail;
|
|
439
|
+
this.sink?.onState(state, { ...detail, paused: this.paused });
|
|
440
|
+
}
|
|
441
|
+
}
|
|
442
|
+
let shared = null;
|
|
443
|
+
/** The connection for this document, created on first use. */
|
|
444
|
+
export function getPreviewConnection() {
|
|
445
|
+
if (!shared)
|
|
446
|
+
shared = new PreviewConnection({ channel: createMentraControlChannel() });
|
|
447
|
+
return shared;
|
|
448
|
+
}
|
|
449
|
+
/** Test seam: replace (or clear) the document singleton, as a reload would. */
|
|
450
|
+
export function setPreviewConnectionForTests(next) {
|
|
451
|
+
shared?.dispose();
|
|
452
|
+
shared = next;
|
|
453
|
+
}
|
|
454
|
+
//# sourceMappingURL=PreviewConnection.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"PreviewConnection.js","sourceRoot":"","sources":["../../../src/react/stream-preview/PreviewConnection.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,75 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The reserved `_preview` UI channel, as seen from the page.
|
|
3
|
+
*
|
|
4
|
+
* The Mentra App answers this channel itself; it never reaches the miniapp's background. Requests
|
|
5
|
+
* ride `mentra.request`, and host events arrive on `mentra.on("_preview")`. Every control request
|
|
6
|
+
* carries the page identity (`docGen`, `token`, `mountEpoch`) so the host can drop operations
|
|
7
|
+
* from a document or a component that has since been replaced.
|
|
8
|
+
*/
|
|
9
|
+
/** `injectFault` is honoured only in debug builds or with the host's hidden developer setting. */
|
|
10
|
+
export type PreviewCommand = "handshake" | "configure" | "start" | "stop" | "rendererError" | "injectFault";
|
|
11
|
+
export interface PreviewControlRequest {
|
|
12
|
+
cmd: PreviewCommand;
|
|
13
|
+
/** 0 until the first handshake has told the page which document it is. */
|
|
14
|
+
docGen: number;
|
|
15
|
+
token?: string;
|
|
16
|
+
mountEpoch: number;
|
|
17
|
+
/** `configure` only: rendered box in device pixels, after rotation. */
|
|
18
|
+
boxWidth?: number;
|
|
19
|
+
boxHeight?: number;
|
|
20
|
+
/** `rendererError` only. */
|
|
21
|
+
message?: string;
|
|
22
|
+
/** `injectFault` only: `ack_delay`, `ack_drop`, `transport_close`, `pack_throw`, `sink_throw`, `clear`. */
|
|
23
|
+
kind?: string;
|
|
24
|
+
ms?: number;
|
|
25
|
+
}
|
|
26
|
+
export interface PreviewDocumentConfig {
|
|
27
|
+
t: "config";
|
|
28
|
+
protocolVersion: number;
|
|
29
|
+
transport: "webmessage" | "websocket";
|
|
30
|
+
url?: string;
|
|
31
|
+
portName?: string;
|
|
32
|
+
token: string;
|
|
33
|
+
docGen: number;
|
|
34
|
+
}
|
|
35
|
+
/** `stale`: the host minted a newer document while this handshake was in flight. */
|
|
36
|
+
export type PreviewHandshakeResult = PreviewDocumentConfig | {
|
|
37
|
+
t: "waiting_for_lease";
|
|
38
|
+
docGen: number;
|
|
39
|
+
} | {
|
|
40
|
+
t?: undefined;
|
|
41
|
+
stale: true;
|
|
42
|
+
};
|
|
43
|
+
/** Reply to configure/start/stop. `stale` means the host dropped it; that is not an error. */
|
|
44
|
+
export interface PreviewControlReply {
|
|
45
|
+
applied?: boolean;
|
|
46
|
+
stale?: boolean;
|
|
47
|
+
}
|
|
48
|
+
export type PreviewHostEvent = PreviewDocumentConfig | ({
|
|
49
|
+
t: "status";
|
|
50
|
+
} & Record<string, unknown>) | {
|
|
51
|
+
t: "lease_available";
|
|
52
|
+
} | {
|
|
53
|
+
t: "lease_ended";
|
|
54
|
+
reason: string;
|
|
55
|
+
} | {
|
|
56
|
+
t: "error";
|
|
57
|
+
code: string;
|
|
58
|
+
docGen?: number;
|
|
59
|
+
} | {
|
|
60
|
+
t: "paused_background";
|
|
61
|
+
} | {
|
|
62
|
+
t: "resumed";
|
|
63
|
+
};
|
|
64
|
+
/** A `_preview` request the host refused. `code` is a preview error code. */
|
|
65
|
+
export declare class PreviewControlError extends Error {
|
|
66
|
+
readonly code: string;
|
|
67
|
+
constructor(code: string, message?: string);
|
|
68
|
+
}
|
|
69
|
+
export interface PreviewControlChannel {
|
|
70
|
+
request(request: PreviewControlRequest): Promise<unknown>;
|
|
71
|
+
onEvent(cb: (event: PreviewHostEvent) => void): () => void;
|
|
72
|
+
}
|
|
73
|
+
/** The channel over the injected `window.mentra` bridge. Null outside a Mentra App WebView. */
|
|
74
|
+
export declare function createMentraControlChannel(): PreviewControlChannel | null;
|
|
75
|
+
//# sourceMappingURL=controlChannel.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"controlChannel.d.ts","sourceRoot":"","sources":["../../../src/react/stream-preview/controlChannel.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,kGAAkG;AAClG,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,eAAe,GAAG,aAAa,CAAA;AAE3G,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,cAAc,CAAA;IACnB,0EAA0E;IAC1E,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;IAClB,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,4BAA4B;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,2GAA2G;IAC3G,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,EAAE,CAAC,EAAE,MAAM,CAAA;CACZ;AAED,MAAM,WAAW,qBAAqB;IACpC,CAAC,EAAE,QAAQ,CAAA;IACX,eAAe,EAAE,MAAM,CAAA;IACvB,SAAS,EAAE,YAAY,GAAG,WAAW,CAAA;IACrC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf;AAED,oFAAoF;AACpF,MAAM,MAAM,sBAAsB,GAC9B,qBAAqB,GACrB;IAAC,CAAC,EAAE,mBAAmB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAC,GACxC;IAAC,CAAC,CAAC,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,IAAI,CAAA;CAAC,CAAA;AAEhC,8FAA8F;AAC9F,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,MAAM,MAAM,gBAAgB,GACxB,qBAAqB,GACrB,CAAC;IAAC,CAAC,EAAE,QAAQ,CAAA;CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACzC;IAAC,CAAC,EAAE,iBAAiB,CAAA;CAAC,GACtB;IAAC,CAAC,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAC,GAClC;IAAC,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAC,GAC3C;IAAC,CAAC,EAAE,mBAAmB,CAAA;CAAC,GACxB;IAAC,CAAC,EAAE,SAAS,CAAA;CAAC,CAAA;AAElB,6EAA6E;AAC7E,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;gBAET,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAK3C;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACzD,OAAO,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAA;CAC3D;AAgBD,+FAA+F;AAC/F,wBAAgB,0BAA0B,IAAI,qBAAqB,GAAG,IAAI,CA0BzE"}
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The reserved `_preview` UI channel, as seen from the page.
|
|
3
|
+
*
|
|
4
|
+
* The Mentra App answers this channel itself; it never reaches the miniapp's background. Requests
|
|
5
|
+
* ride `mentra.request`, and host events arrive on `mentra.on("_preview")`. Every control request
|
|
6
|
+
* carries the page identity (`docGen`, `token`, `mountEpoch`) so the host can drop operations
|
|
7
|
+
* from a document or a component that has since been replaced.
|
|
8
|
+
*/
|
|
9
|
+
import { PREVIEW_UI_CHANNEL } from "../../protocol";
|
|
10
|
+
/** A `_preview` request the host refused. `code` is a preview error code. */
|
|
11
|
+
export class PreviewControlError extends Error {
|
|
12
|
+
constructor(code, message) {
|
|
13
|
+
super(message ?? code);
|
|
14
|
+
this.name = "PreviewControlError";
|
|
15
|
+
this.code = code;
|
|
16
|
+
}
|
|
17
|
+
}
|
|
18
|
+
/** Host replies are local and fast; this only bounds a host that never answers. */
|
|
19
|
+
const REQUEST_TIMEOUT_MS = 10000;
|
|
20
|
+
function mentraGlobal() {
|
|
21
|
+
const candidate = globalThis.mentra;
|
|
22
|
+
if (!candidate || typeof candidate.request !== "function" || typeof candidate.on !== "function")
|
|
23
|
+
return null;
|
|
24
|
+
return candidate;
|
|
25
|
+
}
|
|
26
|
+
/** The channel over the injected `window.mentra` bridge. Null outside a Mentra App WebView. */
|
|
27
|
+
export function createMentraControlChannel() {
|
|
28
|
+
const mentra = mentraGlobal();
|
|
29
|
+
if (!mentra)
|
|
30
|
+
return null;
|
|
31
|
+
return {
|
|
32
|
+
async request(request) {
|
|
33
|
+
try {
|
|
34
|
+
return await mentra.request(PREVIEW_UI_CHANNEL, request, { timeout: REQUEST_TIMEOUT_MS });
|
|
35
|
+
}
|
|
36
|
+
catch (error) {
|
|
37
|
+
const value = (error ?? {});
|
|
38
|
+
const code = typeof value.code === "string"
|
|
39
|
+
? value.code
|
|
40
|
+
: value.name === "MentraRpcTimeoutError"
|
|
41
|
+
? "transport_failed"
|
|
42
|
+
: "unsupported";
|
|
43
|
+
throw new PreviewControlError(code, typeof value.message === "string" ? value.message : undefined);
|
|
44
|
+
}
|
|
45
|
+
},
|
|
46
|
+
onEvent(cb) {
|
|
47
|
+
return mentra.on(PREVIEW_UI_CHANNEL, (payload) => {
|
|
48
|
+
if (payload && typeof payload === "object" && typeof payload.t === "string") {
|
|
49
|
+
cb(payload);
|
|
50
|
+
}
|
|
51
|
+
});
|
|
52
|
+
},
|
|
53
|
+
};
|
|
54
|
+
}
|
|
55
|
+
//# sourceMappingURL=controlChannel.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"controlChannel.js","sourceRoot":"","sources":["../../../src/react/stream-preview/controlChannel.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAC,kBAAkB,EAAC,MAAM,gBAAgB,CAAA;AAoDjD,6EAA6E;AAC7E,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAG5C,YAAY,IAAY,EAAE,OAAgB;QACxC,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC,CAAA;QACtB,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAA;QACjC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;CACF;AAYD,mFAAmF;AACnF,MAAM,kBAAkB,GAAG,KAAM,CAAA;AAEjC,SAAS,YAAY;IACnB,MAAM,SAAS,GAAI,UAAwD,CAAC,MAAM,CAAA;IAClF,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,CAAC,OAAO,KAAK,UAAU,IAAI,OAAO,SAAS,CAAC,EAAE,KAAK,UAAU;QAAE,OAAO,IAAI,CAAA;IAC5G,OAAO,SAAuB,CAAA;AAChC,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,0BAA0B;IACxC,MAAM,MAAM,GAAG,YAAY,EAAE,CAAA;IAC7B,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAA;IACxB,OAAO;QACL,KAAK,CAAC,OAAO,CAAC,OAAO;YACnB,IAAI,CAAC;gBACH,OAAO,MAAM,MAAM,CAAC,OAAO,CAAC,kBAAkB,EAAE,OAAO,EAAE,EAAC,OAAO,EAAE,kBAAkB,EAAC,CAAC,CAAA;YACzF,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,KAAK,GAAG,CAAC,KAAK,IAAI,EAAE,CAAwD,CAAA;gBAClF,MAAM,IAAI,GACR,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;oBAC5B,CAAC,CAAC,KAAK,CAAC,IAAI;oBACZ,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,uBAAuB;wBACtC,CAAC,CAAC,kBAAkB;wBACpB,CAAC,CAAC,aAAa,CAAA;gBACrB,MAAM,IAAI,mBAAmB,CAAC,IAAI,EAAE,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;YACpG,CAAC;QACH,CAAC;QACD,OAAO,CAAC,EAAE;YACR,OAAO,MAAM,CAAC,EAAE,CAAC,kBAAkB,EAAE,CAAC,OAAO,EAAE,EAAE;gBAC/C,IAAI,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAQ,OAAyB,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;oBAC/F,EAAE,CAAC,OAA2B,CAAC,CAAA;gBACjC,CAAC;YACH,CAAC,CAAC,CAAA;QACJ,CAAC;KACF,CAAA;AACH,CAAC"}
|