@sightspool/sdk 0.2.1 → 0.4.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.
Files changed (35) hide show
  1. package/CHANGELOG.md +15 -0
  2. package/README.md +111 -333
  3. package/SECURITY.md +16 -0
  4. package/dist/index.cjs +159 -1080
  5. package/dist/index.cjs.map +1 -1
  6. package/dist/index.d.cts +20 -41
  7. package/dist/index.d.ts +20 -41
  8. package/dist/index.js +160 -734
  9. package/dist/index.js.map +1 -1
  10. package/dist/release.json +21 -0
  11. package/dist/sdk.global.js +2 -38
  12. package/dist/sdk.global.js.map +1 -1
  13. package/dist/source.json +11 -0
  14. package/package.json +14 -12
  15. package/site/CNAME +1 -0
  16. package/site/demo.html +6 -0
  17. package/site/demo.js +27 -0
  18. package/site/index.html +74 -0
  19. package/site/release.js +20 -0
  20. package/site/releases/0.4.0/2acf3463db7571c459ca01a4516341891bb4c2ec6265962f494ca8b553cc0e9f/release.json +21 -0
  21. package/site/releases/0.4.0/2acf3463db7571c459ca01a4516341891bb4c2ec6265962f494ca8b553cc0e9f/sdk.global.js +3 -0
  22. package/site/releases/0.4.0/2acf3463db7571c459ca01a4516341891bb4c2ec6265962f494ca8b553cc0e9f/sdk.global.js.map +1 -0
  23. package/site/releases/0.4.0/2acf3463db7571c459ca01a4516341891bb4c2ec6265962f494ca8b553cc0e9f/source.json +11 -0
  24. package/site/releases/0.4.0/c21bee307a5c53e3ebb49d21f0f1ef2cce06a4483fa9824122bd6897ad6ca3ac/release.json +21 -0
  25. package/site/releases/0.4.0/c21bee307a5c53e3ebb49d21f0f1ef2cce06a4483fa9824122bd6897ad6ca3ac/sdk.global.js +3 -0
  26. package/site/releases/0.4.0/c21bee307a5c53e3ebb49d21f0f1ef2cce06a4483fa9824122bd6897ad6ca3ac/sdk.global.js.map +1 -0
  27. package/site/releases/0.4.0/c21bee307a5c53e3ebb49d21f0f1ef2cce06a4483fa9824122bd6897ad6ca3ac/source.json +11 -0
  28. package/site/styles.css +69 -0
  29. package/site/trust.html +36 -0
  30. package/dist/chunk-4PADVIIO.js +0 -41
  31. package/dist/chunk-4PADVIIO.js.map +0 -1
  32. package/dist/prompt-GDFYC75D.js +0 -139
  33. package/dist/prompt-GDFYC75D.js.map +0 -1
  34. package/dist/survey-CICJQ5VI.js +0 -145
  35. package/dist/survey-CICJQ5VI.js.map +0 -1
package/dist/index.js CHANGED
@@ -1,781 +1,207 @@
1
- import { redactText, isIgnoredElement, matchesRedactSelector, REDACTED } from './chunk-4PADVIIO.js';
2
-
3
- // src/capture.ts
4
- var TRAIL_MAX = 30;
5
- var DEAD_CLICK_MS = 700;
6
- var RAGE_WINDOW_MS = 1e3;
7
- var RAGE_COUNT = 3;
8
- function hasDom() {
9
- return typeof window !== "undefined" && typeof document !== "undefined";
10
- }
11
- function createCapture(opts) {
12
- var _a2, _b;
13
- const redactSelectors = (_a2 = opts.redact) != null ? _a2 : [];
14
- const blockSelectors = (_b = opts.block) != null ? _b : [];
15
- let buf = [];
16
- let lastError;
17
- let started = false;
18
- const subs = [];
19
- const cleanups = [];
20
- let recentClicks = [];
21
- function notify() {
22
- for (const cb of subs) {
23
- try {
24
- cb();
25
- } catch (e) {
26
- }
27
- }
28
- }
29
- function push(type, label) {
30
- try {
31
- buf.push({ t: Date.now(), type, label: label ? redactText(label) : void 0 });
32
- if (buf.length > TRAIL_MAX) buf = buf.slice(-TRAIL_MAX);
33
- if (opts.debug) console.debug("[sightspool] event", type, label);
34
- notify();
35
- } catch (e) {
36
- }
37
- }
38
- function currentRoute() {
39
- try {
40
- return location.pathname + location.search;
41
- } catch (e) {
42
- return "";
43
- }
44
- }
45
- function currentLabel() {
46
- try {
47
- return document.title || "";
48
- } catch (e) {
49
- return "";
1
+ // src/research.ts
2
+ var slot = /* @__PURE__ */ Symbol.for("sightspool.research.runtime.v1");
3
+ var host = () => typeof window === "undefined" ? null : window;
4
+ var current = () => {
5
+ var _a;
6
+ return (_a = host()) == null ? void 0 : _a[slot];
7
+ };
8
+ var eligible = (r) => r.audience === "all_visitors" || r.identified;
9
+ function remove(r) {
10
+ var _a;
11
+ (_a = r.button) == null ? void 0 : _a.remove();
12
+ r.button = null;
13
+ r.offer = null;
14
+ }
15
+ function invalidate(r) {
16
+ var _a;
17
+ r.generation += 1;
18
+ (_a = r.pending) == null ? void 0 : _a.abort();
19
+ r.pending = null;
20
+ remove(r);
21
+ }
22
+ function status(r, value) {
23
+ r.status = value;
24
+ }
25
+ async function check(r) {
26
+ if (r.disposed || r.paused || !eligible(r) || r.pending || document.visibilityState !== "visible") return;
27
+ const generation = r.generation;
28
+ const request = new AbortController();
29
+ r.pending = request;
30
+ const timeout = window.setTimeout(() => request.abort(), 1e4);
31
+ if (!r.button) status(r, "checking");
32
+ try {
33
+ const response = await fetch(r.endpoint + "/widget-offer", {
34
+ method: "POST",
35
+ credentials: "omit",
36
+ cache: "no-store",
37
+ referrerPolicy: "no-referrer",
38
+ headers: { "Content-Type": "application/json" },
39
+ body: JSON.stringify({ operation: "offer", key: r.key, device: r.device }),
40
+ signal: request.signal
41
+ });
42
+ if (!response.ok) throw Error("offer unavailable");
43
+ const result = await response.json();
44
+ if (r.disposed || generation !== r.generation || r.paused || !eligible(r)) return;
45
+ if (result.available !== true || typeof result.offer !== "string" || !result.offer) {
46
+ remove(r);
47
+ status(r, "unavailable");
48
+ return;
50
49
  }
51
- }
52
- function onClick(ev) {
53
- var _a3;
54
- try {
55
- const target = ev.target;
56
- if (isIgnoredElement(target, blockSelectors)) return;
57
- const text = target && (((_a3 = target.getAttribute) == null ? void 0 : _a3.call(target, "aria-label")) || target.textContent) || "";
58
- const label = matchesRedactSelector(target, redactSelectors) ? REDACTED : text.trim().slice(0, 60);
59
- const t = Date.now();
60
- recentClicks = recentClicks.filter((ts) => t - ts <= RAGE_WINDOW_MS);
61
- recentClicks.push(t);
62
- const isRage = recentClicks.length >= RAGE_COUNT;
63
- push(isRage ? "rage_click" : "click", label);
64
- const routeBefore = currentRoute();
65
- let mutated = false;
66
- let observer = null;
50
+ r.offer = result.offer;
51
+ status(r, "available");
52
+ if (r.button) return;
53
+ const button = document.createElement("button");
54
+ button.type = "button";
55
+ button.textContent = "Talk to the founder \xB7 5 min";
56
+ button.setAttribute("aria-label", "Sightspool: join a five-minute user interview");
57
+ button.style.cssText = "position:fixed;bottom:20px;right:20px;z-index:2147483000;padding:14px 18px;border:0;border-radius:16px;background:#171717;color:white;font:500 14px system-ui;box-shadow:0 8px 30px #0003;cursor:pointer;max-width:calc(100vw - 40px)";
58
+ button.onclick = () => {
67
59
  try {
68
- observer = new MutationObserver(() => {
69
- mutated = true;
70
- });
71
- observer.observe(document.body, { childList: true, subtree: true, attributes: true });
72
- } catch (e) {
73
- }
74
- window.setTimeout(() => {
75
- try {
76
- observer == null ? void 0 : observer.disconnect();
77
- if (!mutated && currentRoute() === routeBefore && label) {
78
- push("dead_click", label);
79
- }
80
- } catch (e) {
81
- }
82
- }, DEAD_CLICK_MS);
83
- } catch (e) {
84
- }
85
- }
86
- function onError(ev) {
87
- try {
88
- lastError = String(ev.message || "error");
89
- push("error", lastError);
90
- } catch (e) {
91
- }
92
- }
93
- function onRejection(ev) {
94
- try {
95
- const reason = ev.reason;
96
- lastError = reason instanceof Error ? reason.message : String(reason);
97
- push("error", lastError);
98
- } catch (e) {
99
- }
100
- }
101
- function installRouteTracking() {
102
- try {
103
- const fire = () => push("route", currentRoute());
104
- const origPush = history.pushState;
105
- const origReplace = history.replaceState;
106
- history.pushState = function(...args) {
107
- const r = origPush.apply(this, args);
108
- fire();
109
- return r;
110
- };
111
- history.replaceState = function(...args) {
112
- const r = origReplace.apply(this, args);
113
- fire();
114
- return r;
115
- };
116
- window.addEventListener("popstate", fire);
117
- cleanups.push(() => {
118
- history.pushState = origPush;
119
- history.replaceState = origReplace;
120
- window.removeEventListener("popstate", fire);
121
- });
122
- push("route", currentRoute());
123
- } catch (e) {
124
- }
125
- }
126
- function installFetchTracking() {
127
- try {
128
- if (typeof window.fetch !== "function") return;
129
- const orig = window.fetch.bind(window);
130
- window.fetch = async (...args) => {
131
- try {
132
- const res = await orig(...args);
133
- if (!res.ok) push("request_error", `HTTP ${res.status}`);
134
- return res;
135
- } catch (err) {
136
- push("request_error", err instanceof Error ? err.message : "network error");
137
- throw err;
60
+ if (r.disposed || r.paused || !eligible(r) || !r.offer) return;
61
+ if (r.popup && !r.popup.closed) {
62
+ r.popup.focus();
63
+ return;
138
64
  }
139
- };
140
- cleanups.push(() => {
141
- window.fetch = orig;
142
- });
143
- } catch (e) {
144
- }
145
- }
146
- return {
147
- start() {
148
- if (started || !hasDom()) return;
149
- started = true;
150
- try {
151
- document.addEventListener("click", onClick, true);
152
- window.addEventListener("error", onError);
153
- window.addEventListener("unhandledrejection", onRejection);
154
- cleanups.push(() => {
155
- document.removeEventListener("click", onClick, true);
156
- window.removeEventListener("error", onError);
157
- window.removeEventListener("unhandledrejection", onRejection);
158
- });
159
- installRouteTracking();
160
- installFetchTracking();
65
+ const hash = new URLSearchParams({ offer: r.offer, device: r.device });
66
+ r.popup = window.open(r.endpoint + "/interview-widget#" + hash, "sightspool-interview", "popup,width=520,height=760");
161
67
  } catch (e) {
162
68
  }
163
- },
164
- stop() {
165
- started = false;
166
- for (const c of cleanups.splice(0)) {
167
- try {
168
- c();
169
- } catch (e) {
170
- }
171
- }
172
- },
173
- trail() {
174
- return buf.slice();
175
- },
176
- route: currentRoute,
177
- label: currentLabel,
178
- error() {
179
- return lastError;
180
- },
181
- onEvent(cb) {
182
- subs.push(cb);
183
- },
184
- recordSearch(query, zeroResult) {
185
- const q = query.trim();
186
- if (!q) return;
187
- push(zeroResult ? "zero_result" : "search", q);
188
- }
189
- };
190
- }
191
-
192
- // src/harvest.ts
193
- var SEARCH_HINT_RE = /search|filter|find|query|command|lookup/i;
194
- var DEBOUNCE_MS = 800;
195
- function looksLikeSearch(el) {
196
- try {
197
- const input = el;
198
- if (input.type === "search") return true;
199
- const role = el.getAttribute("role") || "";
200
- if (role === "searchbox" || role === "combobox") return true;
201
- const hay = [
202
- input.name,
203
- input.placeholder,
204
- el.getAttribute("aria-label"),
205
- el.id,
206
- el.className
207
- ].filter(Boolean).join(" ");
208
- return SEARCH_HINT_RE.test(hay);
69
+ };
70
+ r.button = button;
71
+ document.body.appendChild(button);
209
72
  } catch (e) {
210
- return false;
211
- }
212
- }
213
- function createHarvest(capture, opts) {
214
- var _a2, _b;
215
- let hint;
216
- let timer = null;
217
- let started = false;
218
- const redactSelectors = (_a2 = opts.redact) != null ? _a2 : [];
219
- const blockSelectors = (_b = opts.block) != null ? _b : [];
220
- function onInput(ev) {
221
- try {
222
- const target = ev.target;
223
- if (!target || target.tagName !== "INPUT" && target.tagName !== "TEXTAREA") return;
224
- if (!looksLikeSearch(target)) return;
225
- if (isIgnoredElement(target, blockSelectors) || matchesRedactSelector(target, redactSelectors))
226
- return;
227
- const value = (target.value || "").trim();
228
- if (value.length < 2) return;
229
- if (timer !== null) window.clearTimeout(timer);
230
- timer = window.setTimeout(() => {
231
- hint = value;
232
- capture.recordSearch(value);
233
- if (opts.debug) console.debug("[sightspool] harvested intent", value);
234
- }, DEBOUNCE_MS);
235
- } catch (e) {
73
+ if (!r.disposed && generation === r.generation) {
74
+ remove(r);
75
+ status(r, "error");
236
76
  }
77
+ } finally {
78
+ window.clearTimeout(timeout);
79
+ if (r.pending === request) r.pending = null;
237
80
  }
238
- return {
239
- start() {
240
- if (started || typeof document === "undefined") return;
241
- started = true;
242
- try {
243
- document.addEventListener("input", onInput, true);
244
- } catch (e) {
245
- }
246
- },
247
- stop() {
248
- started = false;
249
- try {
250
- document.removeEventListener("input", onInput, true);
251
- if (timer !== null) window.clearTimeout(timer);
252
- } catch (e) {
253
- }
254
- },
255
- lastIntentHint() {
256
- return hint;
257
- }
258
- };
259
81
  }
260
-
261
- // src/egress.ts
262
- var FLUSH_BATCH = 10;
263
- var FLUSH_INTERVAL_MS = 15e3;
264
- function createEgress(opts) {
265
- let queue = [];
266
- let identity;
267
- let interval = null;
268
- let started = false;
269
- const url = `${opts.endpoint.replace(/\/+$/, "")}/api/sdk/ingest`;
270
- function send(signals) {
271
- if (signals.length === 0) return;
272
- const body = { key: opts.key, identity, signals };
273
- const json = JSON.stringify(body);
274
- try {
275
- if (typeof navigator !== "undefined" && typeof navigator.sendBeacon === "function") {
276
- const blob = new Blob([json], { type: "text/plain" });
277
- const ok = navigator.sendBeacon(url, blob);
278
- if (ok) {
279
- if (opts.debug) console.debug("[sightspool] beacon", signals.length);
280
- return;
281
- }
282
- }
283
- void fetch(url, {
284
- method: "POST",
285
- headers: { "Content-Type": "text/plain" },
286
- body: json,
287
- keepalive: true,
288
- mode: "cors",
289
- credentials: "omit"
290
- }).catch(() => {
291
- });
292
- } catch (e) {
293
- }
294
- }
295
- function onVisibility() {
82
+ function init(config) {
83
+ try {
84
+ const browser = host();
85
+ if (!browser || !config || !/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(config.key)) return;
86
+ if (config.audience !== "all_visitors" && config.audience !== "signed_in") return;
87
+ const url = new URL(config.endpoint || "https://www.sightspool.com");
88
+ if (url.protocol !== "https:" && !(url.protocol === "http:" && ["localhost", "127.0.0.1", "[::1]"].includes(url.hostname))) return;
89
+ if (url.username || url.password) return;
90
+ const previous = current();
91
+ if (previous && previous.key === config.key && previous.endpoint === url.origin && previous.audience === config.audience) return;
92
+ if (previous) destroy();
93
+ let device = "";
296
94
  try {
297
- if (document.visibilityState === "hidden") flush();
95
+ device = sessionStorage.getItem("sightspool-widget-device:" + config.key) || "";
298
96
  } catch (e) {
299
97
  }
300
- }
301
- function flush() {
302
- if (queue.length === 0) return;
303
- const batch = queue;
304
- queue = [];
305
- send(batch);
306
- }
307
- return {
308
- start() {
309
- if (started || typeof window === "undefined") return;
310
- started = true;
98
+ if (!/^ss_fcd_[A-Za-z0-9_-]{43}$/.test(device)) {
99
+ const bytes = crypto.getRandomValues(new Uint8Array(32));
100
+ device = "ss_fcd_" + btoa(String.fromCharCode(...bytes)).replaceAll("+", "-").replaceAll("/", "_").replace(/=+$/, "");
311
101
  try {
312
- document.addEventListener("visibilitychange", onVisibility);
313
- window.addEventListener("pagehide", flush);
314
- interval = window.setInterval(flush, FLUSH_INTERVAL_MS);
102
+ sessionStorage.setItem("sightspool-widget-device:" + config.key, device);
315
103
  } catch (e) {
316
104
  }
317
- },
318
- stop() {
319
- started = false;
105
+ }
106
+ const r = {
107
+ key: config.key,
108
+ endpoint: url.origin,
109
+ audience: config.audience,
110
+ identified: false,
111
+ paused: false,
112
+ disposed: false,
113
+ generation: 0,
114
+ device,
115
+ offer: null,
116
+ button: null,
117
+ popup: null,
118
+ pending: null,
119
+ timer: 0,
120
+ visibility: () => {
121
+ },
122
+ status: "signed_out"
123
+ };
124
+ browser[slot] = r;
125
+ r.visibility = () => {
320
126
  try {
321
- document.removeEventListener("visibilitychange", onVisibility);
322
- window.removeEventListener("pagehide", flush);
323
- if (interval !== null) window.clearInterval(interval);
127
+ if (document.visibilityState === "visible") void check(r);
128
+ else {
129
+ invalidate(r);
130
+ status(r, r.paused ? "paused" : eligible(r) ? "unavailable" : "signed_out");
131
+ }
324
132
  } catch (e) {
325
133
  }
326
- flush();
327
- },
328
- enqueue(signal) {
329
- queue.push(signal);
330
- if (queue.length >= FLUSH_BATCH) flush();
331
- },
332
- flush,
333
- setIdentity(next) {
334
- identity = next;
335
- }
336
- };
337
- }
338
-
339
- // src/triggers.ts
340
- var RAGE_CLICK_COUNT = 3;
341
- var RAGE_WINDOW_MS2 = 1e3;
342
- var FRICTION_RETRY_COUNT = 3;
343
- var FRICTION_WINDOW_MS = 8e3;
344
- function detectFriction(trail, now, windowMs = FRICTION_WINDOW_MS) {
345
- var _a2;
346
- const recent = trail.filter((e) => now - e.t <= windowMs);
347
- if (recent.some((e) => e.type === "error" || e.type === "request_error")) return "error";
348
- const clicks = recent.filter((e) => e.type === "click" || e.type === "rage_click");
349
- for (let i = 0; i < clicks.length; i++) {
350
- const burst = clicks.filter(
351
- (e) => e.t >= clicks[i].t && e.t - clicks[i].t <= RAGE_WINDOW_MS2
352
- );
353
- if (burst.length >= RAGE_CLICK_COUNT) return "rage";
354
- }
355
- if (recent.some((e) => e.type === "dead_click")) return "dead_end";
356
- const byLabel = /* @__PURE__ */ new Map();
357
- for (const e of clicks) {
358
- if (!e.label) continue;
359
- const n = ((_a2 = byLabel.get(e.label)) != null ? _a2 : 0) + 1;
360
- byLabel.set(e.label, n);
361
- if (n >= FRICTION_RETRY_COUNT) return "retry";
362
- }
363
- return null;
364
- }
365
- var DEFAULT_CAPS = {
366
- maxPromptsPerSession: 1,
367
- cooldownMs: 5 * 6e4
368
- };
369
- function canPrompt(state, now, caps = DEFAULT_CAPS) {
370
- if (state.promptsShown >= caps.maxPromptsPerSession) return false;
371
- if (state.lastPromptAt !== null && now - state.lastPromptAt < caps.cooldownMs) return false;
372
- return true;
373
- }
374
-
375
- // src/intervention.ts
376
- var RENDERABLE = /* @__PURE__ */ new Set(["survey"]);
377
- function str(v, max) {
378
- if (typeof v !== "string") return void 0;
379
- const t = v.trim();
380
- return t ? t.slice(0, max) : void 0;
381
- }
382
- function buildServeContext(route, identity) {
383
- const ctx = {};
384
- const r = str(route, 500);
385
- if (r) ctx.route = r;
386
- const account = str(identity == null ? void 0 : identity.account, 200);
387
- if (account) ctx.account = account;
388
- const plan = str(identity == null ? void 0 : identity.plan, 80);
389
- if (plan) ctx.plan = plan;
390
- return ctx;
391
- }
392
- function normalizeServed(raw) {
393
- if (!raw || typeof raw !== "object") return null;
394
- const r = raw;
395
- const id = str(r.id, 64);
396
- const type = str(r.type, 40);
397
- if (!id || !type || !RENDERABLE.has(type)) return null;
398
- const cfg = r.config && typeof r.config === "object" ? r.config : {};
399
- const question = str(cfg.question, 500);
400
- if (!question) return null;
401
- const options = Array.isArray(cfg.options) ? cfg.options.map((o) => str(o, 200)).filter((o) => !!o).slice(0, 6) : void 0;
402
- const config = {
403
- question,
404
- ...options && options.length ? { options } : {},
405
- allow_text: cfg.allow_text === true
406
- };
407
- return { id, type, config };
408
- }
409
- function pickRespondentKey(userId, persisted, sessionRef) {
410
- const uid = str(userId, 200);
411
- if (uid) return uid;
412
- const p = str(persisted, 200);
413
- if (p) return p;
414
- return sessionRef;
415
- }
416
- var RK_STORAGE_KEY = "sightspool_rk";
417
- function getRespondentKey(identity, sessionRef) {
418
- const uid = str(identity == null ? void 0 : identity.userId, 200);
419
- if (uid) return uid;
420
- try {
421
- let v = localStorage.getItem(RK_STORAGE_KEY);
422
- if (!v) {
423
- v = "anon-" + Math.random().toString(36).slice(2) + Date.now().toString(36);
424
- localStorage.setItem(RK_STORAGE_KEY, v);
425
- }
426
- return pickRespondentKey(void 0, v, sessionRef);
427
- } catch (e) {
428
- return sessionRef;
429
- }
430
- }
431
- function serveUrl(endpoint, path) {
432
- return `${endpoint.replace(/\/+$/, "")}/api/sdk/${path}`;
433
- }
434
- async function fetchIntervention(opts) {
435
- var _a2;
436
- try {
437
- if (typeof fetch !== "function") return null;
438
- const res = await fetch(serveUrl(opts.endpoint, "serve"), {
439
- method: "POST",
440
- headers: { "Content-Type": "text/plain" },
441
- body: JSON.stringify({
442
- key: opts.key,
443
- context: opts.ctx,
444
- respondent_key: opts.respondentKey
445
- }),
446
- mode: "cors",
447
- credentials: "omit"
448
- });
449
- if (!res.ok) return null;
450
- const data = await res.json();
451
- const served = normalizeServed(data == null ? void 0 : data.intervention);
452
- if (opts.debug) console.debug("[sightspool] serve", (_a2 = served == null ? void 0 : served.id) != null ? _a2 : "(none)");
453
- return served;
454
- } catch (e) {
455
- return null;
456
- }
457
- }
458
- function submitResponse(opts) {
459
- try {
460
- const url = serveUrl(opts.endpoint, "respond");
461
- const json = JSON.stringify({
462
- key: opts.key,
463
- intervention_id: opts.interventionId,
464
- response: opts.response,
465
- respondent_key: opts.respondentKey
466
- });
467
- if (typeof navigator !== "undefined" && typeof navigator.sendBeacon === "function") {
468
- const blob = new Blob([json], { type: "text/plain" });
469
- if (navigator.sendBeacon(url, blob)) return;
470
- }
471
- if (typeof fetch === "function") {
472
- void fetch(url, {
473
- method: "POST",
474
- headers: { "Content-Type": "text/plain" },
475
- body: json,
476
- keepalive: true,
477
- mode: "cors",
478
- credentials: "omit"
479
- }).catch(() => {
480
- });
481
- }
482
- } catch (e) {
483
- }
484
- }
485
-
486
- // src/env.ts
487
- var LOCAL_HOSTS = /* @__PURE__ */ new Set(["localhost", "127.0.0.1", "0.0.0.0", "::1", ""]);
488
- function isLocalhost(hostname) {
489
- const h = (hostname != null ? hostname : "").trim().toLowerCase();
490
- if (LOCAL_HOSTS.has(h)) return true;
491
- return h.endsWith(".local") || h.endsWith(".localhost");
492
- }
493
-
494
- // src/index.ts
495
- var DEFAULT_ENDPOINT = "https://www.sightspool.com";
496
- var FRICTION_EMIT_COOLDOWN_MS = 3e4;
497
- var EVENT_DEBOUNCE_MS = 600;
498
- var SERVE_SETTLE_MS = 2500;
499
- var MAX_INTERVENTIONS_PER_SESSION = 1;
500
- function currentHostname() {
501
- try {
502
- return typeof location !== "undefined" ? location.hostname : "";
134
+ };
135
+ document.addEventListener("visibilitychange", r.visibility);
136
+ r.timer = window.setInterval(() => {
137
+ void check(r);
138
+ }, 15e3);
139
+ if (eligible(r)) void check(r);
503
140
  } catch (e) {
504
- return "";
505
141
  }
506
142
  }
507
- var ctrl = null;
508
- function uuid() {
143
+ function identify(userId) {
509
144
  try {
510
- if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
511
- return crypto.randomUUID();
512
- }
513
- } catch (e) {
514
- }
515
- return "s-" + Math.random().toString(36).slice(2) + Date.now().toString(36);
516
- }
517
- function deriveCandidates(c) {
518
- const out = [];
519
- const hint = c.harvest.lastIntentHint();
520
- if (hint) out.push(`Searching for \u201C${hint}\u201D`);
521
- const label = c.capture.label();
522
- if (label) out.push(`Something on \u201C${label.slice(0, 40)}\u201D`);
523
- return out;
524
- }
525
- function buildSignal(c, trigger, extra = {}) {
526
- const err = c.capture.error();
527
- return {
528
- captured_at: (/* @__PURE__ */ new Date()).toISOString(),
529
- route: c.capture.route(),
530
- client_label: c.capture.label(),
531
- trail: c.capture.trail(),
532
- session_ref: c.sessionRef,
533
- trigger,
534
- intent_hint: c.harvest.lastIntentHint(),
535
- error: err,
536
- outcome: err || trigger === "friction" ? "failed" : "unknown",
537
- ...extra
538
- };
539
- }
540
- async function maybePrompt(c, trigger) {
541
- var _a2;
542
- const now = Date.now();
543
- if (canPrompt(c.fatigue, now, DEFAULT_CAPS)) {
544
- c.fatigue.promptsShown += 1;
545
- c.fatigue.lastPromptAt = now;
546
- try {
547
- const { showPrompt } = await import('./prompt-GDFYC75D.js');
548
- const result = await showPrompt({ candidates: deriveCandidates(c) });
549
- c.egress.enqueue(
550
- buildSignal(c, trigger, {
551
- answer: result.answer,
552
- verbatim: result.verbatim,
553
- intent_hint: (_a2 = result.intent) != null ? _a2 : c.harvest.lastIntentHint(),
554
- outcome: result.answer === "yes" ? "achieved" : "failed"
555
- })
556
- );
557
- } catch (e) {
558
- c.egress.enqueue(buildSignal(c, trigger));
559
- }
560
- } else {
561
- c.egress.enqueue(buildSignal(c, trigger));
562
- }
563
- }
564
- async function maybeServeIntervention(c) {
565
- if (!c.running || !c.interventionsEnabled || c.suppressed) return;
566
- if (c.surveyOnScreen) return;
567
- if (c.interventionsShown >= MAX_INTERVENTIONS_PER_SESSION) return;
568
- const now = Date.now();
569
- if (c.fatigue.lastPromptAt !== null && now - c.fatigue.lastPromptAt < DEFAULT_CAPS.cooldownMs)
570
- return;
571
- const respondentKey = getRespondentKey(c.identity, c.sessionRef);
572
- const served = await fetchIntervention({
573
- endpoint: c.config.endpoint,
574
- key: c.config.key,
575
- ctx: buildServeContext(c.capture.route(), c.identity),
576
- respondentKey,
577
- debug: c.config.debug
578
- });
579
- if (!served || !c.running) return;
580
- c.surveyOnScreen = true;
581
- c.interventionsShown += 1;
582
- c.fatigue.lastPromptAt = Date.now();
583
- try {
584
- const { showSurvey } = await import('./survey-CICJQ5VI.js');
585
- const result = await showSurvey(served.config);
586
- if (!result.dismissed && (result.choice || result.text)) {
587
- submitResponse({
588
- endpoint: c.config.endpoint,
589
- key: c.config.key,
590
- interventionId: served.id,
591
- response: { choice: result.choice, text: result.text },
592
- respondentKey
593
- });
145
+ const r = current();
146
+ if (!r) return;
147
+ const identified = typeof userId === "string" && userId.trim().length > 0;
148
+ if (!identified && !r.identified) {
149
+ if (!r.paused && eligible(r)) void check(r);
150
+ return;
594
151
  }
152
+ invalidate(r);
153
+ r.identified = identified;
154
+ status(r, r.paused ? "paused" : eligible(r) ? "unavailable" : "signed_out");
155
+ if (eligible(r) && !r.paused) void check(r);
595
156
  } catch (e) {
596
- } finally {
597
- c.surveyOnScreen = false;
598
157
  }
599
158
  }
600
- function onCaptureEvent() {
601
- const c = ctrl;
602
- if (!c || !c.running) return;
159
+ function pause() {
603
160
  try {
604
- const route = c.capture.route();
605
- if (route && route !== c.lastServeRoute) {
606
- c.lastServeRoute = route;
607
- void maybeServeIntervention(c);
161
+ const r = current();
162
+ if (r) {
163
+ r.paused = true;
164
+ invalidate(r);
165
+ status(r, "paused");
608
166
  }
609
167
  } catch (e) {
610
168
  }
611
- if (c.eventTimer !== null) return;
612
- c.eventTimer = (typeof window !== "undefined" ? window.setTimeout : setTimeout)(() => {
613
- c.eventTimer = null;
614
- try {
615
- const now = Date.now();
616
- if (now - c.lastFrictionEmitAt < FRICTION_EMIT_COOLDOWN_MS) return;
617
- const kind = detectFriction(c.capture.trail(), now);
618
- if (!kind) return;
619
- c.lastFrictionEmitAt = now;
620
- void maybePrompt(c, "friction");
621
- } catch (e) {
622
- }
623
- }, EVENT_DEBOUNCE_MS);
624
- }
625
- function onExitIntent(ev) {
626
- const c = ctrl;
627
- if (!c || !c.running || !c.config.boundaryAsk) return;
628
- try {
629
- if (ev.clientY <= 0) void maybePrompt(c, "boundary");
630
- } catch (e) {
631
- }
632
- }
633
- function startRuntime(c) {
634
- if (c.running) return;
635
- if (c.suppressed) {
636
- if (c.config.debug)
637
- console.debug(
638
- "[sightspool] capture suppressed on localhost (set captureOnLocalhost:true to override)"
639
- );
640
- return;
641
- }
642
- c.running = true;
643
- c.capture.start();
644
- c.harvest.start();
645
- c.egress.start();
646
- c.capture.onEvent(onCaptureEvent);
647
- try {
648
- document.addEventListener("mouseout", onExitIntent);
649
- } catch (e) {
650
- }
651
- if (c.interventionsEnabled) {
652
- c.lastServeRoute = (() => {
653
- try {
654
- return c.capture.route();
655
- } catch (e) {
656
- return null;
657
- }
658
- })();
659
- (typeof window !== "undefined" ? window.setTimeout : setTimeout)(() => {
660
- void maybeServeIntervention(c);
661
- }, SERVE_SETTLE_MS);
662
- }
663
- if (c.config.debug) console.debug("[sightspool] started", c.sessionRef);
664
169
  }
665
- function init(config) {
170
+ function resume() {
666
171
  try {
667
- if (!config || !config.key) {
668
- console.warn("[sightspool] init: a `key` is required");
669
- return;
172
+ const r = current();
173
+ if (r) {
174
+ r.paused = false;
175
+ if (!eligible(r)) status(r, "signed_out");
176
+ void check(r);
670
177
  }
671
- if (ctrl) return;
672
- const endpoint = config.endpoint || DEFAULT_ENDPOINT;
673
- const privacyOpts = { redact: config.redact, block: config.block };
674
- const capture = createCapture({ debug: !!config.debug, ...privacyOpts });
675
- const harvest = createHarvest(capture, { debug: !!config.debug, ...privacyOpts });
676
- const egress = createEgress({ key: config.key, endpoint, debug: !!config.debug });
677
- ctrl = {
678
- config: {
679
- ...config,
680
- key: config.key,
681
- endpoint,
682
- boundaryAsk: config.boundaryAsk !== false,
683
- debug: !!config.debug
684
- },
685
- capture,
686
- harvest,
687
- egress,
688
- identity: {},
689
- sessionRef: uuid(),
690
- fatigue: { promptsShown: 0, lastPromptAt: null },
691
- lastFrictionEmitAt: 0,
692
- eventTimer: null,
693
- running: false,
694
- suppressed: isLocalhost(currentHostname()) && config.captureOnLocalhost !== true,
695
- interventionsEnabled: config.interventions !== false,
696
- lastServeRoute: null,
697
- surveyOnScreen: false,
698
- interventionsShown: 0
699
- };
700
- if (config.consent !== false) startRuntime(ctrl);
701
- } catch (err) {
702
- try {
703
- console.warn("[sightspool] init failed", err);
704
- } catch (e) {
705
- }
706
- }
707
- }
708
- function identify(userId, traits) {
709
- try {
710
- if (!ctrl) return;
711
- ctrl.identity = { userId, account: traits == null ? void 0 : traits.account, plan: traits == null ? void 0 : traits.plan };
712
- ctrl.egress.setIdentity(ctrl.identity);
713
178
  } catch (e) {
714
179
  }
715
180
  }
716
- function start() {
181
+ function destroy() {
717
182
  try {
718
- if (ctrl) startRuntime(ctrl);
183
+ const r = current();
184
+ if (!r) return;
185
+ r.disposed = true;
186
+ invalidate(r);
187
+ window.clearInterval(r.timer);
188
+ document.removeEventListener("visibilitychange", r.visibility);
189
+ delete host()[slot];
719
190
  } catch (e) {
720
191
  }
721
192
  }
722
- function consent(granted) {
193
+ function getStatus() {
194
+ var _a, _b;
723
195
  try {
724
- if (!ctrl) return;
725
- if (granted) startRuntime(ctrl);
726
- else stop();
196
+ return (_b = (_a = current()) == null ? void 0 : _a.status) != null ? _b : "not_initialized";
727
197
  } catch (e) {
198
+ return "error";
728
199
  }
729
200
  }
730
- function stop() {
731
- try {
732
- if (!ctrl) return;
733
- ctrl.running = false;
734
- ctrl.capture.stop();
735
- ctrl.harvest.stop();
736
- ctrl.egress.stop();
737
- try {
738
- document.removeEventListener("mouseout", onExitIntent);
739
- } catch (e) {
740
- }
741
- } catch (e) {
742
- }
743
- }
744
- var api = { init, identify, start, stop, consent };
745
- var src_default = api;
746
- var _a;
747
- try {
748
- if (typeof document !== "undefined") {
749
- const el = (_a = document.currentScript) != null ? _a : document.querySelector("script[data-sightspool-key]");
750
- const key = el == null ? void 0 : el.getAttribute("data-sightspool-key");
751
- if (key) {
752
- let endpoint = (el == null ? void 0 : el.getAttribute("data-sightspool-endpoint")) || void 0;
753
- if (!endpoint && (el == null ? void 0 : el.src)) {
754
- try {
755
- endpoint = new URL(el.src).origin;
756
- } catch (e) {
757
- }
758
- }
759
- const list = (attr) => {
760
- const raw = el == null ? void 0 : el.getAttribute(attr);
761
- if (!raw) return void 0;
762
- const out = raw.split(",").map((s) => s.trim()).filter(Boolean);
763
- return out.length ? out : void 0;
764
- };
765
- init({
766
- key,
767
- endpoint,
768
- redact: list("data-sightspool-redact"),
769
- block: list("data-sightspool-block"),
770
- captureOnLocalhost: (el == null ? void 0 : el.hasAttribute("data-sightspool-capture-localhost")) || void 0,
771
- interventions: (el == null ? void 0 : el.hasAttribute("data-sightspool-no-interventions")) ? false : void 0,
772
- debug: (el == null ? void 0 : el.hasAttribute("data-sightspool-debug")) || void 0
773
- });
774
- }
775
- }
776
- } catch (e) {
777
- }
778
201
 
779
- export { consent, src_default as default, identify, init, start, stop };
202
+ // src/index.ts
203
+ var src_default = { init, identify, pause, resume, destroy, getStatus };
204
+
205
+ export { src_default as default, destroy, getStatus, identify, init, pause, resume };
780
206
  //# sourceMappingURL=index.js.map
781
207
  //# sourceMappingURL=index.js.map