@spotify-confidence/csr-common 0.18.1 → 0.18.3

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/src/events.ts CHANGED
@@ -224,6 +224,7 @@ export type FlagEvaluationPluginData = {
224
224
  payload: {
225
225
  flagKey: string;
226
226
  variant: string;
227
+ assignmentOrigin: string;
227
228
  };
228
229
  };
229
230
 
@@ -0,0 +1,312 @@
1
+ import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
2
+ import type { CreateUploaderOptions } from './types';
3
+
4
+ vi.mock('./worker/worker-script', () => ({
5
+ workerScript: 'console.log("worker")',
6
+ }));
7
+
8
+ const DEFAULTS: CreateUploaderOptions = {
9
+ apiUrl: 'https://api.example',
10
+ clientSecret: 'secret',
11
+ };
12
+
13
+ function fakeSessionStorage(): Storage {
14
+ const store: Record<string, string> = {};
15
+ return {
16
+ getItem: (key: string) => store[key] ?? null,
17
+ setItem: (key: string, value: string) => {
18
+ store[key] = value;
19
+ },
20
+ removeItem: (key: string) => {
21
+ delete store[key];
22
+ },
23
+ clear: () => Object.keys(store).forEach(k => delete store[k]),
24
+ get length() {
25
+ return Object.keys(store).length;
26
+ },
27
+ key: (i: number) => Object.keys(store)[i] ?? null,
28
+ };
29
+ }
30
+
31
+ class StubWorker {
32
+ onerror: ((e: Event) => void) | null = null;
33
+ onmessage: ((e: MessageEvent) => void) | null = null;
34
+ postMessage() {}
35
+ }
36
+
37
+ function installWorkerStubs(opts?: { workerThrows?: boolean; sharedWorkerThrows?: boolean }) {
38
+ (globalThis as Record<string, unknown>).Worker = opts?.workerThrows
39
+ ? class {
40
+ constructor() {
41
+ throw new DOMException('Blocked', 'SecurityError');
42
+ }
43
+ }
44
+ : StubWorker;
45
+
46
+ if (opts?.sharedWorkerThrows) {
47
+ (globalThis as Record<string, unknown>).SharedWorker = class {
48
+ constructor() {
49
+ throw new DOMException('Blocked', 'SecurityError');
50
+ }
51
+ };
52
+ } else {
53
+ (globalThis as Record<string, unknown>).SharedWorker = class {
54
+ onerror: ((e: Event) => void) | null = null;
55
+ port = {
56
+ start() {},
57
+ onmessage: null as ((e: MessageEvent) => void) | null,
58
+ postMessage() {},
59
+ };
60
+ };
61
+ }
62
+ }
63
+
64
+ function tick() {
65
+ return new Promise(r => setTimeout(r, 0));
66
+ }
67
+
68
+ describe('createUploader', () => {
69
+ const blobUrls: string[] = [];
70
+
71
+ beforeEach(() => {
72
+ globalThis.sessionStorage = fakeSessionStorage();
73
+
74
+ if (!globalThis.crypto) {
75
+ (globalThis as Record<string, unknown>).crypto = {};
76
+ }
77
+ if (!globalThis.crypto.randomUUID) {
78
+ globalThis.crypto.randomUUID = () =>
79
+ '00000000-0000-0000-0000-000000000000' as `${string}-${string}-${string}-${string}-${string}`;
80
+ }
81
+ if (!globalThis.crypto.subtle?.digest) {
82
+ (globalThis.crypto as Record<string, unknown>).subtle = {
83
+ digest: async () => new ArrayBuffer(32),
84
+ };
85
+ }
86
+
87
+ vi.spyOn(URL, 'createObjectURL').mockImplementation(() => {
88
+ const url = `blob:http://localhost/${blobUrls.length}`;
89
+ blobUrls.push(url);
90
+ return url;
91
+ });
92
+ });
93
+
94
+ afterEach(() => {
95
+ vi.restoreAllMocks();
96
+ blobUrls.length = 0;
97
+ delete (globalThis as Record<string, unknown>).SharedWorker;
98
+ });
99
+
100
+ async function loadCreateUploader() {
101
+ vi.resetModules();
102
+ // .js extension is required by Node16 module resolution for dynamic imports
103
+ // (static `import` lines work without it because the package is CJS — see package.json).
104
+ // eslint-disable-next-line es/no-dynamic-import
105
+ const mod = await import('./create-uploader.js');
106
+ return mod.createUploader;
107
+ }
108
+
109
+ describe('blob: fallback', () => {
110
+ it('uses data: URL when Worker constructor succeeds', async () => {
111
+ installWorkerStubs();
112
+
113
+ const createUploader = await loadCreateUploader();
114
+ const logs: string[] = [];
115
+ createUploader({ ...DEFAULTS, workerMode: 'dedicated', debugLogger: m => logs.push(m) });
116
+ await tick();
117
+
118
+ expect(blobUrls).toHaveLength(0);
119
+ expect(logs.some(l => l.includes('via data'))).toBe(true);
120
+ });
121
+
122
+ it('falls back to blob: when data: Worker throws', async () => {
123
+ let constructedUrl: string | undefined;
124
+ (globalThis as Record<string, unknown>).Worker = class {
125
+ onerror: ((e: Event) => void) | null = null;
126
+ onmessage: ((e: MessageEvent) => void) | null = null;
127
+ postMessage() {}
128
+ constructor(url: string) {
129
+ if (url.startsWith('data:')) {
130
+ throw new DOMException('Blocked', 'SecurityError');
131
+ }
132
+ constructedUrl = url;
133
+ }
134
+ };
135
+ delete (globalThis as Record<string, unknown>).SharedWorker;
136
+
137
+ const createUploader = await loadCreateUploader();
138
+ const logs: string[] = [];
139
+ createUploader({ ...DEFAULTS, workerMode: 'dedicated', debugLogger: m => logs.push(m) });
140
+ await tick();
141
+
142
+ expect(blobUrls).toHaveLength(1);
143
+ expect(constructedUrl).toBe(blobUrls[0]);
144
+ expect(logs.some(l => l.includes('falling back to blob:'))).toBe(true);
145
+ expect(logs.some(l => l.includes('via blob'))).toBe(true);
146
+ });
147
+
148
+ it('falls back to blob: dedicated worker when SharedWorker data: throws', async () => {
149
+ (globalThis as Record<string, unknown>).SharedWorker = class {
150
+ constructor() {
151
+ throw new DOMException('Blocked', 'SecurityError');
152
+ }
153
+ };
154
+ let constructedUrl: string | undefined;
155
+ (globalThis as Record<string, unknown>).Worker = class {
156
+ onerror: ((e: Event) => void) | null = null;
157
+ onmessage: ((e: MessageEvent) => void) | null = null;
158
+ postMessage() {}
159
+ constructor(url: string) {
160
+ constructedUrl = url;
161
+ }
162
+ };
163
+
164
+ const createUploader = await loadCreateUploader();
165
+ const logs: string[] = [];
166
+ createUploader({ ...DEFAULTS, workerMode: 'shared', debugLogger: m => logs.push(m) });
167
+ await tick();
168
+
169
+ expect(blobUrls).toHaveLength(1);
170
+ expect(constructedUrl).toBe(blobUrls[0]);
171
+ expect(logs.some(l => l.includes('falling back to blob:'))).toBe(true);
172
+ });
173
+
174
+ it('falls back to blob: when SharedWorker onerror fires asynchronously (Chrome CSP)', async () => {
175
+ let constructedUrl: string | undefined;
176
+ (globalThis as Record<string, unknown>).SharedWorker = class {
177
+ onerror: ((e: Event) => void) | null = null;
178
+ port = {
179
+ start() {},
180
+ onmessage: null as ((e: MessageEvent) => void) | null,
181
+ postMessage() {},
182
+ };
183
+ constructor() {
184
+ setTimeout(() => this.onerror?.(new Event('error')), 0);
185
+ }
186
+ };
187
+ (globalThis as Record<string, unknown>).Worker = class {
188
+ onerror: ((e: Event) => void) | null = null;
189
+ onmessage: ((e: MessageEvent) => void) | null = null;
190
+ postMessage() {}
191
+ constructor(url: string) {
192
+ constructedUrl = url;
193
+ }
194
+ };
195
+
196
+ const createUploader = await loadCreateUploader();
197
+ const logs: string[] = [];
198
+ // Await the full async chain: openWorkerPort detects the async onerror,
199
+ // falls back to blob, then createUploader eventually hits the welcome timeout.
200
+ const p = createUploader({
201
+ ...DEFAULTS,
202
+ workerMode: 'shared',
203
+ debugLogger: m => logs.push(m),
204
+ _welcomeTimeoutMs: 50,
205
+ });
206
+ await expect(p).rejects.toThrow(/welcome timeout/);
207
+
208
+ expect(blobUrls).toHaveLength(1);
209
+ expect(constructedUrl).toBe(blobUrls[0]);
210
+ expect(logs.some(l => l.includes('falling back to blob:'))).toBe(true);
211
+ });
212
+
213
+ it('throws with CSP hint when both data: and blob: are blocked', async () => {
214
+ (globalThis as Record<string, unknown>).Worker = class {
215
+ constructor() {
216
+ throw new DOMException('Blocked', 'SecurityError');
217
+ }
218
+ };
219
+ delete (globalThis as Record<string, unknown>).SharedWorker;
220
+
221
+ const createUploader = await loadCreateUploader();
222
+
223
+ await expect(createUploader({ ...DEFAULTS, workerMode: 'dedicated' })).rejects.toThrow(/worker-src/);
224
+ });
225
+
226
+ it('logs CSP hint via debugLogger when both data: and blob: are blocked', async () => {
227
+ (globalThis as Record<string, unknown>).Worker = class {
228
+ constructor() {
229
+ throw new DOMException('Blocked', 'SecurityError');
230
+ }
231
+ };
232
+ delete (globalThis as Record<string, unknown>).SharedWorker;
233
+
234
+ const createUploader = await loadCreateUploader();
235
+ const logs: string[] = [];
236
+
237
+ await expect(
238
+ createUploader({ ...DEFAULTS, workerMode: 'dedicated', debugLogger: m => logs.push(m) }),
239
+ ).rejects.toThrow();
240
+ expect(logs.some(l => l.includes('worker-load-failed') && l.includes('worker-src'))).toBe(true);
241
+ });
242
+
243
+ it('does not fall back when a custom workerUrl is provided', async () => {
244
+ (globalThis as Record<string, unknown>).Worker = class {
245
+ constructor() {
246
+ throw new Error('custom URL not found');
247
+ }
248
+ };
249
+ delete (globalThis as Record<string, unknown>).SharedWorker;
250
+
251
+ const createUploader = await loadCreateUploader();
252
+
253
+ await expect(
254
+ createUploader({ ...DEFAULTS, workerMode: 'dedicated', workerUrl: 'https://cdn.example/worker.js' }),
255
+ ).rejects.toThrow();
256
+ expect(blobUrls).toHaveLength(0);
257
+ });
258
+ });
259
+
260
+ describe('worker load failure (async error)', () => {
261
+ it('throws with CSP hint when dedicated Worker fires onerror', async () => {
262
+ (globalThis as Record<string, unknown>).Worker = class {
263
+ onerror: ((e: Event) => void) | null = null;
264
+ onmessage: ((e: MessageEvent) => void) | null = null;
265
+ postMessage() {}
266
+ constructor() {
267
+ setTimeout(() => this.onerror?.(new Event('error')), 5);
268
+ }
269
+ };
270
+ delete (globalThis as Record<string, unknown>).SharedWorker;
271
+
272
+ const createUploader = await loadCreateUploader();
273
+
274
+ await expect(createUploader({ ...DEFAULTS, workerMode: 'dedicated' })).rejects.toThrow(/worker-src/);
275
+ });
276
+
277
+ it('throws with CSP hint when SharedWorker fires onerror', async () => {
278
+ (globalThis as Record<string, unknown>).SharedWorker = class {
279
+ onerror: ((e: Event) => void) | null = null;
280
+ port = {
281
+ start() {},
282
+ onmessage: null as ((e: MessageEvent) => void) | null,
283
+ postMessage() {},
284
+ };
285
+ constructor() {
286
+ setTimeout(() => this.onerror?.(new Event('error')), 5);
287
+ }
288
+ };
289
+
290
+ const createUploader = await loadCreateUploader();
291
+
292
+ await expect(createUploader({ ...DEFAULTS, workerMode: 'shared' })).rejects.toThrow(/worker-src/);
293
+ });
294
+ });
295
+
296
+ describe('welcome timeout', () => {
297
+ it('rejects when the worker never sends a welcome', async () => {
298
+ (globalThis as Record<string, unknown>).Worker = class {
299
+ onerror: ((e: Event) => void) | null = null;
300
+ onmessage: ((e: MessageEvent) => void) | null = null;
301
+ postMessage() {}
302
+ };
303
+ delete (globalThis as Record<string, unknown>).SharedWorker;
304
+
305
+ const createUploader = await loadCreateUploader();
306
+
307
+ await expect(createUploader({ ...DEFAULTS, workerMode: 'dedicated', _welcomeTimeoutMs: 50 })).rejects.toThrow(
308
+ /welcome timeout/,
309
+ );
310
+ });
311
+ });
312
+ });
@@ -6,10 +6,12 @@ const STORAGE_TAB_ID = 'csr:tabId';
6
6
  const STORAGE_SESSION = 'csr:session';
7
7
  const STORAGE_COUNTER = 'csr:counter';
8
8
  const DEFAULT_SESSION_TTL_MS = 30 * 60 * 1000;
9
+ const WELCOME_TIMEOUT_MS = 10_000;
9
10
 
10
11
  interface PortLike {
11
12
  postMessage(m: unknown): void;
12
13
  setHandler(cb: (data: unknown) => void): void;
14
+ onError(cb: (err: Error) => void): void;
13
15
  }
14
16
 
15
17
  interface WelcomeMessage {
@@ -49,7 +51,11 @@ export async function createUploader(opts: CreateUploaderOptions): Promise<Uploa
49
51
  } counterHint=${counterHint}`,
50
52
  );
51
53
 
52
- const port = await openWorkerPort(mode, opts.clientSecret, opts.workerUrl);
54
+ const workerName = mode === 'shared' ? await hashSecret(opts.clientSecret) : undefined;
55
+ const { port, urlScheme } = await openWorkerPort(mode, opts.workerUrl, workerName, log);
56
+ log?.(
57
+ `tab: worker loaded via ${urlScheme}${urlScheme === 'blob' ? ' (fallback — cross-tab sharing unavailable)' : ''}`,
58
+ );
53
59
 
54
60
  // State accessible to both the message handler (for post-welcome state/dead messages)
55
61
  // and the post-welcome setup code below. Mutable so welcome can populate them.
@@ -118,14 +124,36 @@ export async function createUploader(opts: CreateUploaderOptions): Promise<Uploa
118
124
  });
119
125
  log?.('tab: hello sent, awaiting welcome');
120
126
 
121
- const welcome = await welcomePromise;
127
+ const timeoutMs = opts._welcomeTimeoutMs ?? WELCOME_TIMEOUT_MS;
128
+ let welcomeTimer: ReturnType<typeof setTimeout> | undefined;
129
+ const welcomeDeadline = new Promise<never>((_, reject) => {
130
+ port.onError(err => reject(err));
131
+ welcomeTimer = setTimeout(
132
+ () =>
133
+ reject(
134
+ new Error(
135
+ 'uploader: welcome timeout. The worker did not respond within ' +
136
+ `${timeoutMs / 1000}s. This may indicate a CSP policy blocking ` +
137
+ 'the worker script from loading. Check your browser console for errors.',
138
+ ),
139
+ ),
140
+ timeoutMs,
141
+ );
142
+ });
143
+ welcomeDeadline.catch(() => {});
144
+ const welcome = await Promise.race([
145
+ welcomePromise.then(msg => {
146
+ clearTimeout(welcomeTimer);
147
+ return msg;
148
+ }),
149
+ welcomeDeadline,
150
+ ]);
122
151
  log?.(
123
152
  welcome.type === 'welcome'
124
153
  ? `tab: welcome (${'sessionId' in welcome.result ? `sessionId=${welcome.result.sessionId}` : 'skipRecording'})`
125
154
  : `tab: dead reason=${welcome.reason}`,
126
155
  );
127
156
  if (welcome.type === 'dead') {
128
- // Worker died before establishing a session — surface the reason instead of swallowing it as `null`.
129
157
  throw new Error(`uploader: ${welcome.reason}`);
130
158
  }
131
159
  if ('skipRecording' in welcome.result) {
@@ -211,44 +239,117 @@ function resolveMode(mode: 'shared' | 'dedicated' | 'auto'): 'shared' | 'dedicat
211
239
  return mode;
212
240
  }
213
241
 
242
+ type UrlScheme = 'data' | 'blob' | 'custom';
243
+
244
+ interface InternalPort extends PortLike {
245
+ getBufferedError(): Error | null;
246
+ }
247
+
214
248
  async function openWorkerPort(
215
249
  mode: 'shared' | 'dedicated',
216
- clientSecret: string,
217
250
  workerUrl: string | undefined,
218
- ): Promise<PortLike> {
219
- // Default to a content-derived data URL: identical across tabs (so SharedWorker
220
- // sharing works) and self-contained (no infrastructure for SDK consumers).
221
- const url = workerUrl ?? toDataUrl(workerScript);
222
-
223
- if (mode === 'shared') {
224
- const name = await hashSecret(clientSecret);
225
- // `extendedLifetime` keeps the SharedWorker alive across top-level navigations on
226
- // Chrome 139+. No-op everywhere else. Cast required because the option isn't in the
227
- // standard SharedWorker type yet.
228
- const options = {
229
- name,
230
- type: 'module',
231
- extendedLifetime: true,
232
- } as WorkerOptions;
233
- const worker = new SharedWorker(url, options);
234
- worker.port.start();
235
- return {
236
- postMessage: m => worker.port.postMessage(m),
237
- setHandler: cb => {
238
- worker.port.onmessage = (e: MessageEvent) => cb(e.data);
239
- },
240
- };
251
+ workerName: string | undefined,
252
+ log: ((msg: string) => void) | undefined,
253
+ ): Promise<{ port: PortLike; urlScheme: UrlScheme }> {
254
+ if (workerUrl) {
255
+ return { port: createWorker(mode, workerUrl, workerName), urlScheme: 'custom' };
256
+ }
257
+
258
+ const dataUrl = toDataUrl(workerScript);
259
+ try {
260
+ const port = createWorker(mode, dataUrl, workerName);
261
+ // Chrome's SharedWorker doesn't throw synchronously for CSP blocks — it fires
262
+ // onerror asynchronously. Yield one macrotask to let it fire, then check.
263
+ await new Promise(resolve => setTimeout(resolve, 0));
264
+ const asyncErr = port.getBufferedError();
265
+ if (asyncErr) throw asyncErr;
266
+ return { port, urlScheme: 'data' };
267
+ } catch (_dataErr) {
268
+ log?.('tab: data: worker blocked, falling back to blob: URL (dedicated mode)');
269
+ const blobUrl = toBlobUrl(workerScript);
270
+ try {
271
+ return { port: createDedicatedWorker(blobUrl), urlScheme: 'blob' };
272
+ } catch (blobErr) {
273
+ const hint =
274
+ 'Your Content Security Policy blocks both `data:` and `blob:` in `worker-src`. ' +
275
+ 'To fix this, either add `blob:` to your `worker-src` directive, or ' +
276
+ 'use the `workerUrl` option to serve the worker script from your own origin.';
277
+ log?.(`tab: worker-load-failed: ${hint}`);
278
+ throw new Error(`worker-load-failed: ${hint}`, blobErr instanceof Error ? { cause: blobErr } : undefined);
279
+ }
241
280
  }
281
+ }
282
+
283
+ function createWorker(mode: 'shared' | 'dedicated', url: string, workerName: string | undefined): InternalPort {
284
+ if (mode === 'shared') return createSharedWorker(url, workerName!);
285
+ return createDedicatedWorker(url);
286
+ }
287
+
288
+ function createSharedWorker(url: string, name: string): InternalPort {
289
+ const options = {
290
+ name,
291
+ type: 'module',
292
+ extendedLifetime: true,
293
+ } as WorkerOptions;
294
+ const worker = new SharedWorker(url, options);
295
+ let errorCb: ((err: Error) => void) | null = null;
296
+ let bufferedError: Error | null = null;
242
297
 
298
+ worker.onerror = e => {
299
+ const err = workerLoadError(e, url);
300
+ if (errorCb) errorCb(err);
301
+ else bufferedError = err;
302
+ };
303
+ worker.port.start();
304
+ return {
305
+ postMessage: m => worker.port.postMessage(m),
306
+ setHandler: cb => {
307
+ worker.port.onmessage = (e: MessageEvent) => cb(e.data);
308
+ },
309
+ onError: cb => {
310
+ errorCb = cb;
311
+ if (bufferedError) cb(bufferedError);
312
+ },
313
+ getBufferedError: () => bufferedError,
314
+ };
315
+ }
316
+
317
+ function createDedicatedWorker(url: string): InternalPort {
243
318
  const worker = new Worker(url, { type: 'module' });
319
+ let errorCb: ((err: Error) => void) | null = null;
320
+ let bufferedError: Error | null = null;
321
+
322
+ worker.onerror = e => {
323
+ const err = workerLoadError(e, url);
324
+ if (errorCb) errorCb(err);
325
+ else bufferedError = err;
326
+ };
244
327
  return {
245
328
  postMessage: m => worker.postMessage(m),
246
329
  setHandler: cb => {
247
330
  worker.onmessage = (e: MessageEvent) => cb(e.data);
248
331
  },
332
+ onError: cb => {
333
+ errorCb = cb;
334
+ if (bufferedError) cb(bufferedError);
335
+ },
336
+ getBufferedError: () => bufferedError,
249
337
  };
250
338
  }
251
339
 
340
+ function workerLoadError(cause: unknown, url: string): Error {
341
+ const isDataUrl = url.startsWith('data:');
342
+ const hint = isDataUrl
343
+ ? 'This is likely caused by a Content Security Policy (CSP) that blocks `data:` in ' +
344
+ '`worker-src`. To fix this, either add `data:` to your `worker-src` directive, or ' +
345
+ 'use the `workerUrl` option to serve the worker script from your own origin.'
346
+ : `Failed to load the worker script from ${url}. Check that the URL is reachable and ` +
347
+ 'that your CSP `worker-src` directive allows it.';
348
+
349
+ const msg = `worker-load-failed: ${hint}`;
350
+ return new Error(msg, cause instanceof Error ? { cause } : undefined);
351
+ }
352
+
252
353
  function toDataUrl(script: string): string {
253
354
  // UTF-8-safe base64. The worker bundle is ASCII today but esbuild may emit non-ASCII
254
355
  // identifiers if the source ever contains them; this avoids `btoa` choking.
@@ -258,6 +359,10 @@ function toDataUrl(script: string): string {
258
359
  return `data:application/javascript;base64,${btoa(binary)}`;
259
360
  }
260
361
 
362
+ function toBlobUrl(script: string): string {
363
+ return URL.createObjectURL(new Blob([script], { type: 'application/javascript' }));
364
+ }
365
+
261
366
  async function hashSecret(secret: string): Promise<string> {
262
367
  const buf = await crypto.subtle.digest('SHA-256', new TextEncoder().encode(secret));
263
368
  return Array.from(new Uint8Array(buf))
@@ -59,6 +59,8 @@ export interface CreateUploaderOptions {
59
59
  * Worker messages are forwarded over the port and tagged so you can tell them apart.
60
60
  */
61
61
  debugLogger?: (msg: string) => void;
62
+ /** @internal Override the welcome-handshake timeout for testing. */
63
+ _welcomeTimeoutMs?: number;
62
64
  }
63
65
 
64
66
  // --- Internal types: used across the worker / tab pieces, not part of the public API. ---
@@ -95,6 +95,18 @@ describe('CsrClient.openTransport', () => {
95
95
  await expect(client.openTransport('tok')).resolves.toBeDefined();
96
96
  });
97
97
 
98
+ it('redacts session_token from debug log', async () => {
99
+ installMockWsServer('wss://api/sessions/stream?session_token=secret-tok');
100
+
101
+ const logs: string[] = [];
102
+ const client = new CsrClient('https://api', 'secret', undefined, undefined, msg => logs.push(msg));
103
+ await client.openTransport('secret-tok');
104
+
105
+ expect(logs).toHaveLength(1);
106
+ expect(logs[0]).toContain('session_token=[REDACTED]');
107
+ expect(logs[0]).not.toContain('secret-tok');
108
+ });
109
+
98
110
  it('URL-encodes the session token', async () => {
99
111
  installMockWsServer('wss://api/sessions/stream?session_token=tok%2Fwith%3Dspecials');
100
112
 
@@ -47,7 +47,7 @@ export class CsrClient implements Client {
47
47
  const wsBase = this.websocketUrl ?? `${this.toWsScheme(this.trimSlash(this.apiUrl))}/sessions/stream`;
48
48
  const sep = wsBase.includes('?') ? '&' : '?';
49
49
  const url = `${wsBase}${sep}session_token=${encodeURIComponent(sessionToken)}`;
50
- this.log(`WebSocket connect ${url}`);
50
+ this.log(`WebSocket connect ${url.replace(/session_token=[^&]*/, 'session_token=[REDACTED]')}`);
51
51
  const transport = new WebSocketTransport(url);
52
52
  await transport.ready();
53
53
  return transport;
@@ -1,3 +1,3 @@
1
1
  // Generated by scripts/build-worker.mjs at build time. Do not edit.
2
2
  // Run `yarn workspace @spotify-confidence/csr-common build:worker` to regenerate.
3
- export const workerScript: string = "//#region src/uploader/worker/web-socket-transport.ts\n/**\n* WebSocket-backed Transport. Internal retry policy: clean server-initiated close after the\n* first successful open → reconnect and resume; abrupt close (or any close before the first\n* open) → fire `onClose` and stop. Frames received while a (re)connect is in progress are\n* buffered and flushed on open.\n*\n* `ready()` resolves on the first successful open and rejects on close-before-open. Callers\n* should await it before treating the Transport as live, so a failure to open can be caught\n* (e.g. 4404 unknown session) and recovered from.\n*/\nvar WebSocketTransport = class {\n\turl;\n\tws = null;\n\tonCloseCb = null;\n\tonStateChangeCb = null;\n\tintentionallyClosed = false;\n\tdead = false;\n\t/** Frames buffered while a (re)connect is in progress. */\n\tpending = [];\n\treadyPromise;\n\tconstructor(url) {\n\t\tthis.url = url;\n\t\tthis.readyPromise = new Promise((resolve, reject) => {\n\t\t\tthis.connect(false, resolve, reject);\n\t\t});\n\t\tthis.readyPromise.catch(() => {});\n\t}\n\tready() {\n\t\treturn this.readyPromise;\n\t}\n\tsend(frame) {\n\t\tif (this.dead || this.intentionallyClosed) return;\n\t\tif (this.ws?.readyState === WebSocket.OPEN) this.ws.send(JSON.stringify(frame));\n\t\telse this.pending.push(frame);\n\t}\n\tclose(reason = \"transport-close\") {\n\t\tthis.intentionallyClosed = true;\n\t\tthis.ws?.close(1e3, reason);\n\t}\n\tonClose(cb) {\n\t\tthis.onCloseCb = cb;\n\t}\n\tonStateChange(cb) {\n\t\tthis.onStateChangeCb = cb;\n\t}\n\tconnect(isReconnect, onReady, onReadyFail) {\n\t\tconst ws = new WebSocket(this.url);\n\t\tthis.ws = ws;\n\t\tlet opened = false;\n\t\tws.onopen = () => {\n\t\t\topened = true;\n\t\t\tonReady?.();\n\t\t\tif (isReconnect) this.onStateChangeCb?.({ connected: true });\n\t\t\twhile (this.pending.length > 0) {\n\t\t\t\tconst f = this.pending.shift();\n\t\t\t\tws.send(JSON.stringify(f));\n\t\t\t}\n\t\t};\n\t\tws.onclose = (event) => {\n\t\t\tif (this.intentionallyClosed) return;\n\t\t\tif (!opened) {\n\t\t\t\tconst reason = `${isReconnect ? \"reconnect\" : \"initial\"}-failed code=${event.code}`;\n\t\t\t\tif (onReadyFail) {\n\t\t\t\t\tonReadyFail(new Error(reason));\n\t\t\t\t\tthis.dead = true;\n\t\t\t\t} else this.die(reason);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (event.wasClean && (event.code === 1e3 || event.code === 1001)) {\n\t\t\t\tthis.onStateChangeCb?.({ connected: false });\n\t\t\t\tthis.connect(true);\n\t\t\t} else this.die(`close code=${event.code} wasClean=${event.wasClean}`);\n\t\t};\n\t}\n\tdie(reason) {\n\t\tthis.dead = true;\n\t\tthis.onCloseCb?.({ reason });\n\t}\n};\n//#endregion\n//#region src/uploader/worker/csr-client.ts\n/**\n* Single Client implementation that talks to the recording backend's REST + WS protocol.\n* Both dev-server and prod implement the same protocol, so we don't need polymorphism here yet.\n*/\nvar CsrClient = class {\n\tapiUrl;\n\tclientSecret;\n\tcontext;\n\twebsocketUrl;\n\tlog;\n\tforceRecord;\n\tconstructor(apiUrl, clientSecret, context, websocketUrl, log = () => {}, forceRecord) {\n\t\tthis.apiUrl = apiUrl;\n\t\tthis.clientSecret = clientSecret;\n\t\tthis.context = context;\n\t\tthis.websocketUrl = websocketUrl;\n\t\tthis.log = log;\n\t\tthis.forceRecord = forceRecord;\n\t}\n\tasync initSession() {\n\t\tconst url = `${this.trimSlash(this.apiUrl)}/v1/sessions:initSession`;\n\t\tthis.log(`fetch POST ${url}`);\n\t\tconst res = await fetch(url, {\n\t\t\tmethod: \"POST\",\n\t\t\theaders: { \"Content-Type\": \"application/json\" },\n\t\t\tbody: JSON.stringify({\n\t\t\t\tclientSecret: this.clientSecret,\n\t\t\t\t...this.context && Object.keys(this.context).length > 0 ? { context: this.context } : {},\n\t\t\t\t...this.forceRecord ? { forceRecord: true } : {}\n\t\t\t})\n\t\t});\n\t\tif (!res.ok) throw new Error(`init-session failed: HTTP ${res.status}`);\n\t\tconst data = await res.json();\n\t\tif (data.skipRecording) return { skipRecording: true };\n\t\tif (!data.sessionId || !data.sessionToken) throw new Error(\"init-session response missing sessionId or sessionToken\");\n\t\treturn {\n\t\t\tsessionId: data.sessionId,\n\t\t\tsessionToken: data.sessionToken\n\t\t};\n\t}\n\tasync openTransport(sessionToken) {\n\t\tconst wsBase = this.websocketUrl ?? `${this.toWsScheme(this.trimSlash(this.apiUrl))}/sessions/stream`;\n\t\tconst url = `${wsBase}${wsBase.includes(\"?\") ? \"&\" : \"?\"}session_token=${encodeURIComponent(sessionToken)}`;\n\t\tthis.log(`WebSocket connect ${url}`);\n\t\tconst transport = new WebSocketTransport(url);\n\t\tawait transport.ready();\n\t\treturn transport;\n\t}\n\ttrimSlash(s) {\n\t\treturn s.endsWith(\"/\") ? s.slice(0, -1) : s;\n\t}\n\ttoWsScheme(base) {\n\t\tif (base.startsWith(\"https://\")) return `wss://${base.slice(8)}`;\n\t\tif (base.startsWith(\"http://\")) return `ws://${base.slice(7)}`;\n\t\treturn base;\n\t}\n};\n//#endregion\n//#region src/uploader/worker/core.ts\nconst IDLE_GRACE_MS = 5e3;\nlet state = { phase: \"init\" };\nconst ports = [];\nlet idleTimer = null;\nfunction cancelIdleTimer() {\n\tif (idleTimer !== null) {\n\t\tclearTimeout(idleTimer);\n\t\tidleTimer = null;\n\t}\n}\nfunction log(msg) {\n\tfor (const handle of ports) if (handle.debugLogs) handle.port.postMessage({\n\t\ttype: \"log\",\n\t\tmsg\n\t});\n}\n/**\n* The first hello \"locks in\" the session's apiUrl/clientSecret. Any later tab arriving\n* with different values is misconfigured — we reject it rather than silently using the\n* locked values. In SharedWorker mode the `name = hash(clientSecret)` scoping already\n* prevents secret-mismatch from sharing a worker, but this defends against the dedicated\n* path and against future bugs.\n*/\nlet lockedConfig = null;\nfunction registerPort(adapter) {\n\tcancelIdleTimer();\n\tconst handle = {\n\t\tport: adapter,\n\t\thello: null,\n\t\tdebugLogs: false\n\t};\n\tports.push(handle);\n\tadapter.onmessage((data) => {\n\t\thandleMessage(handle, data);\n\t});\n}\nfunction handleMessage(handle, message) {\n\tswitch (message.type) {\n\t\tcase \"hello\":\n\t\t\thandle.hello = message;\n\t\t\thandle.debugLogs = message.debugLogs ?? false;\n\t\t\tif (rejectIfIncompatible(handle)) return;\n\t\t\tif (state.phase !== \"dead\" && state.phase !== \"skipping\") detectDuplicateTab(handle);\n\t\t\tonHello(handle);\n\t\t\treturn;\n\t\tcase \"frame\":\n\t\t\tonFrame(message.frame);\n\t\t\treturn;\n\t\tcase \"bye\":\n\t\t\tonBye(handle);\n\t\t\treturn;\n\t\tdefault: break;\n\t}\n}\n/**\n* Reject hellos whose `apiUrl`/`clientSecret` don't match the values established by the\n* first hello. Returns true if the port was rejected (caller should not continue\n* processing this hello).\n*/\nfunction rejectIfIncompatible(handle) {\n\tif (lockedConfig === null) return false;\n\tconst incoming = handle.hello;\n\tif (incoming.apiUrl === lockedConfig.apiUrl && incoming.websocketUrl === lockedConfig.websocketUrl && incoming.clientSecret === lockedConfig.clientSecret) return false;\n\thandle.port.postMessage({\n\t\ttype: \"dead\",\n\t\treason: \"incompatible-options: apiUrl/websocketUrl/clientSecret differ from the worker session\"\n\t});\n\tconst idx = ports.indexOf(handle);\n\tif (idx >= 0) ports.splice(idx, 1);\n\treturn true;\n}\n/**\n* If another already-connected port has the same `tabId`, this hello is from a duplicate\n* tab (browser \"Duplicate\" command clones sessionStorage). Mint a fresh `tabId` so the two\n* tabs don't collide on the same `(sessionId, tabId)` Recording. The new tabId is returned\n* to the tab in `welcome` so it can update its own state and sessionStorage.\n*/\nfunction detectDuplicateTab(handle) {\n\tconst tabId = handle.hello.tabId;\n\tif (!ports.some((p) => p !== handle && p.hello?.tabId === tabId)) return;\n\tconst fresh = crypto.randomUUID();\n\thandle.newTabId = fresh;\n\thandle.hello.tabId = fresh;\n}\nfunction onHello(handle) {\n\tswitch (state.phase) {\n\t\tcase \"init\":\n\t\t\tlockedConfig = {\n\t\t\t\tapiUrl: handle.hello.apiUrl,\n\t\t\t\twebsocketUrl: handle.hello.websocketUrl,\n\t\t\t\tclientSecret: handle.hello.clientSecret\n\t\t\t};\n\t\t\tlog(`hello received apiUrl=${handle.hello.apiUrl} websocketUrl=${handle.hello.websocketUrl ?? \"(derive)\"} sessionIdHint=${handle.hello.sessionIdHint ?? \"(none)\"}`);\n\t\t\tstate = { phase: \"initializing\" };\n\t\t\tinitializeSession(handle.hello).then(flushPendingWelcomes);\n\t\t\treturn;\n\t\tcase \"initializing\": return;\n\t\tcase \"active\":\n\t\t\tsendActiveWelcome(handle, state.sessionId, state.sessionToken);\n\t\t\treturn;\n\t\tcase \"idle\": {\n\t\t\tconst { client, sessionId, sessionToken } = state;\n\t\t\tstate = { phase: \"initializing\" };\n\t\t\tresumeTransport(client, sessionId, sessionToken).then(flushPendingWelcomes);\n\t\t\treturn;\n\t\t}\n\t\tcase \"skipping\":\n\t\t\tif (handle.hello.forceRecord) {\n\t\t\t\tlog(\"forceRecord set; re-initializing from skipping state\");\n\t\t\t\tstate = { phase: \"initializing\" };\n\t\t\t\tinitializeSession(handle.hello).then(flushPendingWelcomes);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\thandle.port.postMessage({\n\t\t\t\ttype: \"welcome\",\n\t\t\t\tresult: { skipRecording: true }\n\t\t\t});\n\t\t\treturn;\n\t\tcase \"dead\":\n\t\t\thandle.port.postMessage({\n\t\t\t\ttype: \"dead\",\n\t\t\t\treason: state.reason\n\t\t\t});\n\t\t\treturn;\n\t\tdefault: break;\n\t}\n}\nasync function initializeSession(firstHello) {\n\tconst client = new CsrClient(firstHello.apiUrl, firstHello.clientSecret, firstHello.context, firstHello.websocketUrl, log, firstHello.forceRecord);\n\tif (firstHello.sessionIdHint && firstHello.sessionTokenHint) {\n\t\tlog(`adopting sessionIdHint=${firstHello.sessionIdHint}`);\n\t\ttry {\n\t\t\tconst transport = await client.openTransport(firstHello.sessionTokenHint);\n\t\t\twireTransport(transport);\n\t\t\tstate = {\n\t\t\t\tphase: \"active\",\n\t\t\t\tclient,\n\t\t\t\ttransport,\n\t\t\t\tsessionId: firstHello.sessionIdHint,\n\t\t\t\tsessionToken: firstHello.sessionTokenHint\n\t\t\t};\n\t\t\tlog(\"hint adopted; transport open\");\n\t\t\tif (ports.length === 0) idleTimer = setTimeout(enterIdle, IDLE_GRACE_MS);\n\t\t\treturn;\n\t\t} catch (err) {\n\t\t\tlog(`hint rejected (${String(err)}); falling back to fresh init`);\n\t\t}\n\t}\n\tlet result;\n\ttry {\n\t\tresult = await client.initSession();\n\t} catch (err) {\n\t\tlog(`init-session threw: ${String(err)}`);\n\t\ttransitionToDead(`init-session-failed: ${String(err)}`);\n\t\treturn;\n\t}\n\tif (\"skipRecording\" in result) {\n\t\tlog(\"init-session: skipRecording\");\n\t\tstate = { phase: \"skipping\" };\n\t\treturn;\n\t}\n\tlog(`init-session ok sessionId=${result.sessionId}`);\n\tlet transport;\n\ttry {\n\t\ttransport = await client.openTransport(result.sessionToken);\n\t} catch (err) {\n\t\tlog(`openTransport threw: ${String(err)}`);\n\t\ttransitionToDead(`open-transport-failed: ${String(err)}`);\n\t\treturn;\n\t}\n\twireTransport(transport);\n\tlog(\"transport open; session active\");\n\tstate = {\n\t\tphase: \"active\",\n\t\tclient,\n\t\ttransport,\n\t\tsessionId: result.sessionId,\n\t\tsessionToken: result.sessionToken\n\t};\n\tif (ports.length === 0) idleTimer = setTimeout(enterIdle, IDLE_GRACE_MS);\n}\nasync function resumeTransport(client, sessionId, sessionToken) {\n\tlog(\"resuming transport from idle\");\n\tlet transport;\n\ttry {\n\t\ttransport = await client.openTransport(sessionToken);\n\t} catch (err) {\n\t\tlog(`resume-transport threw: ${String(err)}`);\n\t\ttransitionToDead(`resume-transport-failed: ${String(err)}`);\n\t\treturn;\n\t}\n\twireTransport(transport);\n\tlog(\"transport resumed\");\n\tstate = {\n\t\tphase: \"active\",\n\t\tclient,\n\t\ttransport,\n\t\tsessionId,\n\t\tsessionToken\n\t};\n\tif (ports.length === 0) idleTimer = setTimeout(enterIdle, IDLE_GRACE_MS);\n}\nfunction wireTransport(transport) {\n\ttransport.onClose((info) => {\n\t\tif (state.phase !== \"active\") return;\n\t\ttransitionToDead(info.reason);\n\t});\n\ttransport.onStateChange((info) => {\n\t\tif (state.phase !== \"active\") return;\n\t\tfor (const handle of ports) handle.port.postMessage({\n\t\t\ttype: \"state\",\n\t\t\tconnected: info.connected\n\t\t});\n\t});\n}\nfunction transitionToDead(reason) {\n\tstate = {\n\t\tphase: \"dead\",\n\t\treason\n\t};\n\tfor (const handle of ports) handle.port.postMessage({\n\t\ttype: \"dead\",\n\t\treason\n\t});\n}\nfunction flushPendingWelcomes() {\n\tfor (const handle of ports) {\n\t\tif (handle.hello === null) continue;\n\t\tif (state.phase === \"active\") sendActiveWelcome(handle, state.sessionId, state.sessionToken);\n\t\telse if (state.phase === \"skipping\") handle.port.postMessage({\n\t\t\ttype: \"welcome\",\n\t\t\tresult: { skipRecording: true }\n\t\t});\n\t\telse if (state.phase === \"dead\") handle.port.postMessage({\n\t\t\ttype: \"dead\",\n\t\t\treason: state.reason\n\t\t});\n\t}\n}\nfunction sendActiveWelcome(handle, currentSessionId, currentSessionToken) {\n\tconst hint = handle.hello?.sessionIdHint;\n\tconst adopted = hint !== void 0 && hint !== currentSessionId;\n\tconst newTabId = handle.newTabId;\n\thandle.port.postMessage({\n\t\ttype: \"welcome\",\n\t\tresult: {\n\t\t\tsessionId: currentSessionId,\n\t\t\tsessionToken: currentSessionToken\n\t\t},\n\t\tadoptedFromSessionId: adopted ? hint : void 0,\n\t\tnewTabId,\n\t\tresetCounter: adopted || newTabId !== void 0\n\t});\n}\nfunction onFrame(frame) {\n\tif (state.phase !== \"active\") return;\n\tstate.transport.send(frame);\n}\nfunction onBye(handle) {\n\tconst idx = ports.indexOf(handle);\n\tif (idx >= 0) ports.splice(idx, 1);\n\tif (ports.length === 0 && state.phase === \"active\") {\n\t\tlog(`last tab disconnected; closing transport in ${IDLE_GRACE_MS}ms`);\n\t\tidleTimer = setTimeout(enterIdle, IDLE_GRACE_MS);\n\t}\n}\nfunction enterIdle() {\n\tidleTimer = null;\n\tif (state.phase !== \"active\" || ports.length > 0) return;\n\tlog(\"idle timeout; closing transport\");\n\tstate.transport.close(\"idle\");\n\tstate = {\n\t\tphase: \"idle\",\n\t\tclient: state.client,\n\t\tsessionId: state.sessionId,\n\t\tsessionToken: state.sessionToken\n\t};\n}\n//#endregion\n//#region src/uploader/worker/entry.ts\nconst SharedWorkerScopeCtor = globalThis.SharedWorkerGlobalScope;\nif (typeof SharedWorkerScopeCtor === \"function\" && self instanceof SharedWorkerScopeCtor) self.onconnect = (event) => {\n\tconst port = event.ports[0];\n\tport.start();\n\tregisterPort(adaptMessagePort(port));\n};\nelse registerPort(adaptDedicatedSelf());\nfunction adaptMessagePort(port) {\n\treturn {\n\t\tpostMessage: (message) => port.postMessage(message),\n\t\tonmessage: (cb) => {\n\t\t\tport.onmessage = (e) => cb(e.data);\n\t\t}\n\t};\n}\nfunction adaptDedicatedSelf() {\n\tconst ws = self;\n\treturn {\n\t\tpostMessage: (message) => ws.postMessage(message),\n\t\tonmessage: (cb) => {\n\t\t\tws.onmessage = (e) => cb(e.data);\n\t\t}\n\t};\n}\n//#endregion\n";
3
+ export const workerScript: string = "//#region src/uploader/worker/web-socket-transport.ts\n/**\n* WebSocket-backed Transport. Internal retry policy: clean server-initiated close after the\n* first successful open → reconnect and resume; abrupt close (or any close before the first\n* open) → fire `onClose` and stop. Frames received while a (re)connect is in progress are\n* buffered and flushed on open.\n*\n* `ready()` resolves on the first successful open and rejects on close-before-open. Callers\n* should await it before treating the Transport as live, so a failure to open can be caught\n* (e.g. 4404 unknown session) and recovered from.\n*/\nvar WebSocketTransport = class {\n\turl;\n\tws = null;\n\tonCloseCb = null;\n\tonStateChangeCb = null;\n\tintentionallyClosed = false;\n\tdead = false;\n\t/** Frames buffered while a (re)connect is in progress. */\n\tpending = [];\n\treadyPromise;\n\tconstructor(url) {\n\t\tthis.url = url;\n\t\tthis.readyPromise = new Promise((resolve, reject) => {\n\t\t\tthis.connect(false, resolve, reject);\n\t\t});\n\t\tthis.readyPromise.catch(() => {});\n\t}\n\tready() {\n\t\treturn this.readyPromise;\n\t}\n\tsend(frame) {\n\t\tif (this.dead || this.intentionallyClosed) return;\n\t\tif (this.ws?.readyState === WebSocket.OPEN) this.ws.send(JSON.stringify(frame));\n\t\telse this.pending.push(frame);\n\t}\n\tclose(reason = \"transport-close\") {\n\t\tthis.intentionallyClosed = true;\n\t\tthis.ws?.close(1e3, reason);\n\t}\n\tonClose(cb) {\n\t\tthis.onCloseCb = cb;\n\t}\n\tonStateChange(cb) {\n\t\tthis.onStateChangeCb = cb;\n\t}\n\tconnect(isReconnect, onReady, onReadyFail) {\n\t\tconst ws = new WebSocket(this.url);\n\t\tthis.ws = ws;\n\t\tlet opened = false;\n\t\tws.onopen = () => {\n\t\t\topened = true;\n\t\t\tonReady?.();\n\t\t\tif (isReconnect) this.onStateChangeCb?.({ connected: true });\n\t\t\twhile (this.pending.length > 0) {\n\t\t\t\tconst f = this.pending.shift();\n\t\t\t\tws.send(JSON.stringify(f));\n\t\t\t}\n\t\t};\n\t\tws.onclose = (event) => {\n\t\t\tif (this.intentionallyClosed) return;\n\t\t\tif (!opened) {\n\t\t\t\tconst reason = `${isReconnect ? \"reconnect\" : \"initial\"}-failed code=${event.code}`;\n\t\t\t\tif (onReadyFail) {\n\t\t\t\t\tonReadyFail(new Error(reason));\n\t\t\t\t\tthis.dead = true;\n\t\t\t\t} else this.die(reason);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (event.wasClean && (event.code === 1e3 || event.code === 1001)) {\n\t\t\t\tthis.onStateChangeCb?.({ connected: false });\n\t\t\t\tthis.connect(true);\n\t\t\t} else this.die(`close code=${event.code} wasClean=${event.wasClean}`);\n\t\t};\n\t}\n\tdie(reason) {\n\t\tthis.dead = true;\n\t\tthis.onCloseCb?.({ reason });\n\t}\n};\n//#endregion\n//#region src/uploader/worker/csr-client.ts\n/**\n* Single Client implementation that talks to the recording backend's REST + WS protocol.\n* Both dev-server and prod implement the same protocol, so we don't need polymorphism here yet.\n*/\nvar CsrClient = class {\n\tapiUrl;\n\tclientSecret;\n\tcontext;\n\twebsocketUrl;\n\tlog;\n\tforceRecord;\n\tconstructor(apiUrl, clientSecret, context, websocketUrl, log = () => {}, forceRecord) {\n\t\tthis.apiUrl = apiUrl;\n\t\tthis.clientSecret = clientSecret;\n\t\tthis.context = context;\n\t\tthis.websocketUrl = websocketUrl;\n\t\tthis.log = log;\n\t\tthis.forceRecord = forceRecord;\n\t}\n\tasync initSession() {\n\t\tconst url = `${this.trimSlash(this.apiUrl)}/v1/sessions:initSession`;\n\t\tthis.log(`fetch POST ${url}`);\n\t\tconst res = await fetch(url, {\n\t\t\tmethod: \"POST\",\n\t\t\theaders: { \"Content-Type\": \"application/json\" },\n\t\t\tbody: JSON.stringify({\n\t\t\t\tclientSecret: this.clientSecret,\n\t\t\t\t...this.context && Object.keys(this.context).length > 0 ? { context: this.context } : {},\n\t\t\t\t...this.forceRecord ? { forceRecord: true } : {}\n\t\t\t})\n\t\t});\n\t\tif (!res.ok) throw new Error(`init-session failed: HTTP ${res.status}`);\n\t\tconst data = await res.json();\n\t\tif (data.skipRecording) return { skipRecording: true };\n\t\tif (!data.sessionId || !data.sessionToken) throw new Error(\"init-session response missing sessionId or sessionToken\");\n\t\treturn {\n\t\t\tsessionId: data.sessionId,\n\t\t\tsessionToken: data.sessionToken\n\t\t};\n\t}\n\tasync openTransport(sessionToken) {\n\t\tconst wsBase = this.websocketUrl ?? `${this.toWsScheme(this.trimSlash(this.apiUrl))}/sessions/stream`;\n\t\tconst url = `${wsBase}${wsBase.includes(\"?\") ? \"&\" : \"?\"}session_token=${encodeURIComponent(sessionToken)}`;\n\t\tthis.log(`WebSocket connect ${url.replace(/session_token=[^&]*/, \"session_token=[REDACTED]\")}`);\n\t\tconst transport = new WebSocketTransport(url);\n\t\tawait transport.ready();\n\t\treturn transport;\n\t}\n\ttrimSlash(s) {\n\t\treturn s.endsWith(\"/\") ? s.slice(0, -1) : s;\n\t}\n\ttoWsScheme(base) {\n\t\tif (base.startsWith(\"https://\")) return `wss://${base.slice(8)}`;\n\t\tif (base.startsWith(\"http://\")) return `ws://${base.slice(7)}`;\n\t\treturn base;\n\t}\n};\n//#endregion\n//#region src/uploader/worker/core.ts\nconst IDLE_GRACE_MS = 5e3;\nlet state = { phase: \"init\" };\nconst ports = [];\nlet idleTimer = null;\nfunction cancelIdleTimer() {\n\tif (idleTimer !== null) {\n\t\tclearTimeout(idleTimer);\n\t\tidleTimer = null;\n\t}\n}\nfunction log(msg) {\n\tfor (const handle of ports) if (handle.debugLogs) handle.port.postMessage({\n\t\ttype: \"log\",\n\t\tmsg\n\t});\n}\n/**\n* The first hello \"locks in\" the session's apiUrl/clientSecret. Any later tab arriving\n* with different values is misconfigured — we reject it rather than silently using the\n* locked values. In SharedWorker mode the `name = hash(clientSecret)` scoping already\n* prevents secret-mismatch from sharing a worker, but this defends against the dedicated\n* path and against future bugs.\n*/\nlet lockedConfig = null;\nfunction registerPort(adapter) {\n\tcancelIdleTimer();\n\tconst handle = {\n\t\tport: adapter,\n\t\thello: null,\n\t\tdebugLogs: false\n\t};\n\tports.push(handle);\n\tadapter.onmessage((data) => {\n\t\thandleMessage(handle, data);\n\t});\n}\nfunction handleMessage(handle, message) {\n\tswitch (message.type) {\n\t\tcase \"hello\":\n\t\t\thandle.hello = message;\n\t\t\thandle.debugLogs = message.debugLogs ?? false;\n\t\t\tif (rejectIfIncompatible(handle)) return;\n\t\t\tif (state.phase !== \"dead\" && state.phase !== \"skipping\") detectDuplicateTab(handle);\n\t\t\tonHello(handle);\n\t\t\treturn;\n\t\tcase \"frame\":\n\t\t\tonFrame(message.frame);\n\t\t\treturn;\n\t\tcase \"bye\":\n\t\t\tonBye(handle);\n\t\t\treturn;\n\t\tdefault: break;\n\t}\n}\n/**\n* Reject hellos whose `apiUrl`/`clientSecret` don't match the values established by the\n* first hello. Returns true if the port was rejected (caller should not continue\n* processing this hello).\n*/\nfunction rejectIfIncompatible(handle) {\n\tif (lockedConfig === null) return false;\n\tconst incoming = handle.hello;\n\tif (incoming.apiUrl === lockedConfig.apiUrl && incoming.websocketUrl === lockedConfig.websocketUrl && incoming.clientSecret === lockedConfig.clientSecret) return false;\n\thandle.port.postMessage({\n\t\ttype: \"dead\",\n\t\treason: \"incompatible-options: apiUrl/websocketUrl/clientSecret differ from the worker session\"\n\t});\n\tconst idx = ports.indexOf(handle);\n\tif (idx >= 0) ports.splice(idx, 1);\n\treturn true;\n}\n/**\n* If another already-connected port has the same `tabId`, this hello is from a duplicate\n* tab (browser \"Duplicate\" command clones sessionStorage). Mint a fresh `tabId` so the two\n* tabs don't collide on the same `(sessionId, tabId)` Recording. The new tabId is returned\n* to the tab in `welcome` so it can update its own state and sessionStorage.\n*/\nfunction detectDuplicateTab(handle) {\n\tconst tabId = handle.hello.tabId;\n\tif (!ports.some((p) => p !== handle && p.hello?.tabId === tabId)) return;\n\tconst fresh = crypto.randomUUID();\n\thandle.newTabId = fresh;\n\thandle.hello.tabId = fresh;\n}\nfunction onHello(handle) {\n\tswitch (state.phase) {\n\t\tcase \"init\":\n\t\t\tlockedConfig = {\n\t\t\t\tapiUrl: handle.hello.apiUrl,\n\t\t\t\twebsocketUrl: handle.hello.websocketUrl,\n\t\t\t\tclientSecret: handle.hello.clientSecret\n\t\t\t};\n\t\t\tlog(`hello received apiUrl=${handle.hello.apiUrl} websocketUrl=${handle.hello.websocketUrl ?? \"(derive)\"} sessionIdHint=${handle.hello.sessionIdHint ?? \"(none)\"}`);\n\t\t\tstate = { phase: \"initializing\" };\n\t\t\tinitializeSession(handle.hello).then(flushPendingWelcomes);\n\t\t\treturn;\n\t\tcase \"initializing\": return;\n\t\tcase \"active\":\n\t\t\tsendActiveWelcome(handle, state.sessionId, state.sessionToken);\n\t\t\treturn;\n\t\tcase \"idle\": {\n\t\t\tconst { client, sessionId, sessionToken } = state;\n\t\t\tstate = { phase: \"initializing\" };\n\t\t\tresumeTransport(client, sessionId, sessionToken).then(flushPendingWelcomes);\n\t\t\treturn;\n\t\t}\n\t\tcase \"skipping\":\n\t\t\tif (handle.hello.forceRecord) {\n\t\t\t\tlog(\"forceRecord set; re-initializing from skipping state\");\n\t\t\t\tstate = { phase: \"initializing\" };\n\t\t\t\tinitializeSession(handle.hello).then(flushPendingWelcomes);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\thandle.port.postMessage({\n\t\t\t\ttype: \"welcome\",\n\t\t\t\tresult: { skipRecording: true }\n\t\t\t});\n\t\t\treturn;\n\t\tcase \"dead\":\n\t\t\thandle.port.postMessage({\n\t\t\t\ttype: \"dead\",\n\t\t\t\treason: state.reason\n\t\t\t});\n\t\t\treturn;\n\t\tdefault: break;\n\t}\n}\nasync function initializeSession(firstHello) {\n\tconst client = new CsrClient(firstHello.apiUrl, firstHello.clientSecret, firstHello.context, firstHello.websocketUrl, log, firstHello.forceRecord);\n\tif (firstHello.sessionIdHint && firstHello.sessionTokenHint) {\n\t\tlog(`adopting sessionIdHint=${firstHello.sessionIdHint}`);\n\t\ttry {\n\t\t\tconst transport = await client.openTransport(firstHello.sessionTokenHint);\n\t\t\twireTransport(transport);\n\t\t\tstate = {\n\t\t\t\tphase: \"active\",\n\t\t\t\tclient,\n\t\t\t\ttransport,\n\t\t\t\tsessionId: firstHello.sessionIdHint,\n\t\t\t\tsessionToken: firstHello.sessionTokenHint\n\t\t\t};\n\t\t\tlog(\"hint adopted; transport open\");\n\t\t\tif (ports.length === 0) idleTimer = setTimeout(enterIdle, IDLE_GRACE_MS);\n\t\t\treturn;\n\t\t} catch (err) {\n\t\t\tlog(`hint rejected (${String(err)}); falling back to fresh init`);\n\t\t}\n\t}\n\tlet result;\n\ttry {\n\t\tresult = await client.initSession();\n\t} catch (err) {\n\t\tlog(`init-session threw: ${String(err)}`);\n\t\ttransitionToDead(`init-session-failed: ${String(err)}`);\n\t\treturn;\n\t}\n\tif (\"skipRecording\" in result) {\n\t\tlog(\"init-session: skipRecording\");\n\t\tstate = { phase: \"skipping\" };\n\t\treturn;\n\t}\n\tlog(`init-session ok sessionId=${result.sessionId}`);\n\tlet transport;\n\ttry {\n\t\ttransport = await client.openTransport(result.sessionToken);\n\t} catch (err) {\n\t\tlog(`openTransport threw: ${String(err)}`);\n\t\ttransitionToDead(`open-transport-failed: ${String(err)}`);\n\t\treturn;\n\t}\n\twireTransport(transport);\n\tlog(\"transport open; session active\");\n\tstate = {\n\t\tphase: \"active\",\n\t\tclient,\n\t\ttransport,\n\t\tsessionId: result.sessionId,\n\t\tsessionToken: result.sessionToken\n\t};\n\tif (ports.length === 0) idleTimer = setTimeout(enterIdle, IDLE_GRACE_MS);\n}\nasync function resumeTransport(client, sessionId, sessionToken) {\n\tlog(\"resuming transport from idle\");\n\tlet transport;\n\ttry {\n\t\ttransport = await client.openTransport(sessionToken);\n\t} catch (err) {\n\t\tlog(`resume-transport threw: ${String(err)}`);\n\t\ttransitionToDead(`resume-transport-failed: ${String(err)}`);\n\t\treturn;\n\t}\n\twireTransport(transport);\n\tlog(\"transport resumed\");\n\tstate = {\n\t\tphase: \"active\",\n\t\tclient,\n\t\ttransport,\n\t\tsessionId,\n\t\tsessionToken\n\t};\n\tif (ports.length === 0) idleTimer = setTimeout(enterIdle, IDLE_GRACE_MS);\n}\nfunction wireTransport(transport) {\n\ttransport.onClose((info) => {\n\t\tif (state.phase !== \"active\") return;\n\t\ttransitionToDead(info.reason);\n\t});\n\ttransport.onStateChange((info) => {\n\t\tif (state.phase !== \"active\") return;\n\t\tfor (const handle of ports) handle.port.postMessage({\n\t\t\ttype: \"state\",\n\t\t\tconnected: info.connected\n\t\t});\n\t});\n}\nfunction transitionToDead(reason) {\n\tstate = {\n\t\tphase: \"dead\",\n\t\treason\n\t};\n\tfor (const handle of ports) handle.port.postMessage({\n\t\ttype: \"dead\",\n\t\treason\n\t});\n}\nfunction flushPendingWelcomes() {\n\tfor (const handle of ports) {\n\t\tif (handle.hello === null) continue;\n\t\tif (state.phase === \"active\") sendActiveWelcome(handle, state.sessionId, state.sessionToken);\n\t\telse if (state.phase === \"skipping\") handle.port.postMessage({\n\t\t\ttype: \"welcome\",\n\t\t\tresult: { skipRecording: true }\n\t\t});\n\t\telse if (state.phase === \"dead\") handle.port.postMessage({\n\t\t\ttype: \"dead\",\n\t\t\treason: state.reason\n\t\t});\n\t}\n}\nfunction sendActiveWelcome(handle, currentSessionId, currentSessionToken) {\n\tconst hint = handle.hello?.sessionIdHint;\n\tconst adopted = hint !== void 0 && hint !== currentSessionId;\n\tconst newTabId = handle.newTabId;\n\thandle.port.postMessage({\n\t\ttype: \"welcome\",\n\t\tresult: {\n\t\t\tsessionId: currentSessionId,\n\t\t\tsessionToken: currentSessionToken\n\t\t},\n\t\tadoptedFromSessionId: adopted ? hint : void 0,\n\t\tnewTabId,\n\t\tresetCounter: adopted || newTabId !== void 0\n\t});\n}\nfunction onFrame(frame) {\n\tif (state.phase !== \"active\") return;\n\tstate.transport.send(frame);\n}\nfunction onBye(handle) {\n\tconst idx = ports.indexOf(handle);\n\tif (idx >= 0) ports.splice(idx, 1);\n\tif (ports.length === 0 && state.phase === \"active\") {\n\t\tlog(`last tab disconnected; closing transport in ${IDLE_GRACE_MS}ms`);\n\t\tidleTimer = setTimeout(enterIdle, IDLE_GRACE_MS);\n\t}\n}\nfunction enterIdle() {\n\tidleTimer = null;\n\tif (state.phase !== \"active\" || ports.length > 0) return;\n\tlog(\"idle timeout; closing transport\");\n\tstate.transport.close(\"idle\");\n\tstate = {\n\t\tphase: \"idle\",\n\t\tclient: state.client,\n\t\tsessionId: state.sessionId,\n\t\tsessionToken: state.sessionToken\n\t};\n}\n//#endregion\n//#region src/uploader/worker/entry.ts\nconst SharedWorkerScopeCtor = globalThis.SharedWorkerGlobalScope;\nif (typeof SharedWorkerScopeCtor === \"function\" && self instanceof SharedWorkerScopeCtor) self.onconnect = (event) => {\n\tconst port = event.ports[0];\n\tport.start();\n\tregisterPort(adaptMessagePort(port));\n};\nelse registerPort(adaptDedicatedSelf());\nfunction adaptMessagePort(port) {\n\treturn {\n\t\tpostMessage: (message) => port.postMessage(message),\n\t\tonmessage: (cb) => {\n\t\t\tport.onmessage = (e) => cb(e.data);\n\t\t}\n\t};\n}\nfunction adaptDedicatedSelf() {\n\tconst ws = self;\n\treturn {\n\t\tpostMessage: (message) => ws.postMessage(message),\n\t\tonmessage: (cb) => {\n\t\t\tws.onmessage = (e) => cb(e.data);\n\t\t}\n\t};\n}\n//#endregion\n";