@guidelytech/shared 0.15.0 → 0.17.0

package/dist/index.cjs

@@ -31,6 +31,7 @@ __export(index_exports, {
   AGENT_TURN_ROLES: () => AGENT_TURN_ROLES,
   ANNOTATION_COLORS: () => ANNOTATION_COLORS,
   APP_LIFECYCLE_EVENTS: () => APP_LIFECYCLE_EVENTS,
+  ARTICLE_HREF_PREFIX: () => ARTICLE_HREF_PREFIX,
   ARTICLE_VISIBILITIES: () => ARTICLE_VISIBILITIES,
   AUTOCAPTURE_EVENTS: () => AUTOCAPTURE_EVENTS,
   AgentEventsRequestSchema: () => AgentEventsRequestSchema,
@@ -41,6 +42,7 @@ __export(index_exports, {
   AuthoringPickSchema: () => AuthoringPickSchema,
   AutocaptureSettingsSchema: () => AutocaptureSettingsSchema,
   BUTTON_ACTIONS: () => BUTTON_ACTIONS,
+  BugReportSchema: () => BugReportSchema,
   ButtonSchema: () => ButtonSchema,
   CAPTURE_PARAM: () => CAPTURE_PARAM,
   CAPTURE_SCREENSHOT_MAX_BYTES: () => CAPTURE_SCREENSHOT_MAX_BYTES,
@@ -106,6 +108,10 @@ __export(index_exports, {
   LocaleSchema: () => LocaleSchema,
   LocalizationSettingsSchema: () => LocalizationSettingsSchema,
   MAX_ANNOTATIONS: () => MAX_ANNOTATIONS,
+  MAX_APP_VERSION_LENGTH: () => MAX_APP_VERSION_LENGTH,
+  MAX_BREADCRUMBS: () => MAX_BREADCRUMBS,
+  MAX_BUG_REPORT_LENGTH: () => MAX_BUG_REPORT_LENGTH,
+  MAX_BUG_REPORT_SCREENSHOT_BYTES: () => MAX_BUG_REPORT_SCREENSHOT_BYTES,
   MAX_COLLECTION_DEPTH: () => MAX_COLLECTION_DEPTH,
   MAX_COMPLAINT_ANSWER_LENGTH: () => MAX_COMPLAINT_ANSWER_LENGTH,
   MAX_COMPLAINT_ATTACHMENT_BYTES: () => MAX_COMPLAINT_ATTACHMENT_BYTES,
@@ -113,6 +119,13 @@ __export(index_exports, {
   MAX_COMPLAINT_FIELDS: () => MAX_COMPLAINT_FIELDS,
   MAX_COMPLAINT_LENGTH: () => MAX_COMPLAINT_LENGTH,
   MAX_CUSTOM_CSS: () => MAX_CUSTOM_CSS,
+  MAX_DEBUG_IMAGES: () => MAX_DEBUG_IMAGES,
+  MAX_DETAIL_FRAMES: () => MAX_DETAIL_FRAMES,
+  MAX_DETAIL_THREADS: () => MAX_DETAIL_THREADS,
+  MAX_ERROR_TAGS: () => MAX_ERROR_TAGS,
+  MAX_EXCEPTION_CHAIN: () => MAX_EXCEPTION_CHAIN,
+  MAX_EXCEPTION_DETAIL_BYTES: () => MAX_EXCEPTION_DETAIL_BYTES,
+  MAX_EXCEPTION_DETAIL_RAW_BYTES: () => MAX_EXCEPTION_DETAIL_RAW_BYTES,
   MAX_FEEDBACK_COMMENT: () => MAX_FEEDBACK_COMMENT,
   MAX_FEEDBACK_DESCRIPTION: () => MAX_FEEDBACK_DESCRIPTION,
   MAX_FEEDBACK_NOTE: () => MAX_FEEDBACK_NOTE,
@@ -140,11 +153,13 @@ __export(index_exports, {
   PDF_PAGES_CLASS: () => PDF_PAGES_CLASS,
   PLACEMENTS: () => PLACEMENTS,
   PLATFORMS: () => PLATFORMS,
+  PerformanceSettingsSchema: () => PerformanceSettingsSchema,
   PostMessageSchema: () => PostMessageSchema,
   ProjectThemeSchema: () => ProjectThemeSchema,
   PublishedGuideSchema: () => PublishedGuideSchema,
   RC_MODULE_IDS: () => RC_MODULE_IDS,
   RC_MODULE_LABELS: () => RC_MODULE_LABELS,
+  RECORDING_LEVELS: () => RECORDING_LEVELS,
   REPLAY_MAX_COMPRESSED_BYTES: () => REPLAY_MAX_COMPRESSED_BYTES,
   REPLAY_MAX_RAW_BYTES: () => REPLAY_MAX_RAW_BYTES,
   REPLY_TIMES: () => REPLY_TIMES,
@@ -194,6 +209,8 @@ __export(index_exports, {
   WS_MAX_MESSAGES_PER_SOCKET: () => WS_MAX_MESSAGES_PER_SOCKET,
   WS_MAX_MESSAGE_BYTES: () => WS_MAX_MESSAGE_BYTES,
   applyGuideTranslations: () => applyGuideTranslations,
+  articleHref: () => articleHref,
+  articleIdFromHref: () => articleIdFromHref,
   articleTextEntries: () => articleTextEntries,
   assignGuideVariant: () => assignGuideVariant,
   baseLanguage: () => baseLanguage,
@@ -206,11 +223,13 @@ __export(index_exports, {
   contrastIssues: () => contrastIssues,
   contrastRatio: () => contrastRatio,
   cssSelectorError: () => cssSelectorError,
+  customFingerprint: () => customFingerprint,
   defaultGuideConfig: () => defaultGuideConfig,
   defaultStep: () => defaultStep,
   describeCaptureStep: () => describeCaptureStep,
   describeRule: () => describeRule,
   emptyRuleGroup: () => emptyRuleGroup,
+  errorFilterDrops: () => errorFilterDrops,
   evaluateRule: () => evaluateRule,
   evaluateRules: () => evaluateRules,
   evenWeights: () => evenWeights,
@@ -240,6 +259,7 @@ __export(index_exports, {
   isRuleGroup: () => isRuleGroup,
   isSafeMediaUrl: () => isSafeMediaUrl,
   isVideoContentType: () => isVideoContentType,
+  isVideoFileUrl: () => isVideoFileUrl,
   localeName: () => localeName,
   localizeAnnouncement: () => localizeAnnouncement,
   localizeArticle: () => localizeArticle,
@@ -252,10 +272,12 @@ __export(index_exports, {
   mediaKind: () => mediaKind,
   mediaMaxBytes: () => mediaMaxBytes,
   needsReview: () => needsReview,
+  normalizeAppVersion: () => normalizeAppVersion,
   normalizeErrorMessage: () => normalizeErrorMessage,
   normalizeFrameFile: () => normalizeFrameFile,
   normalizeLocale: () => normalizeLocale,
   normalizeSnapshot: () => normalizeSnapshot,
+  normalizeTags: () => normalizeTags,
   orderedModules: () => orderedModules,
   pageLabel: () => pageLabel,
   pageName: () => pageName,
@@ -273,7 +295,9 @@ __export(index_exports, {
   propertyAttributeAllowed: () => propertyAttributeAllowed,
   queryConditionRegex: () => queryConditionRegex,
   randomId: () => randomId,
+  reactNativeBundleUrl: () => reactNativeBundleUrl,
   readableTextOn: () => readableTextOn,
+  recordingLevel: () => recordingLevel,
   relativeLuminance: () => relativeLuminance,
   resolveCaptureSettings: () => resolveCaptureSettings,
   resolveLocale: () => resolveLocale,
@@ -294,6 +318,7 @@ __export(index_exports, {
   slugify: () => slugify,
   snapshotFromSelector: () => snapshotFromSelector,
   stableStringify: () => stableStringify,
+  stepVideo: () => stepVideo,
   stripOrigin: () => stripOrigin,
   supportsPlatform: () => supportsPlatform,
   templateConfig: () => templateConfig,
@@ -301,16 +326,19 @@ __export(index_exports, {
   toTranslationCsv: () => toTranslationCsv,
   toXliff: () => toXliff,
   translationCoverage: () => translationCoverage,
+  trimExceptionDetail: () => trimExceptionDetail,
   unreadAnnouncements: () => unreadAnnouncements,
   validateGuideConfig: () => validateGuideConfig,
   variantProblems: () => variantProblems,
   variantRanges: () => variantRanges,
+  videoThumbnailUrl: () => videoThumbnailUrl,
   visibleAnnouncements: () => visibleAnnouncements,
   visibleArticleIds: () => visibleArticleIds,
   visibleButtons: () => visibleButtons,
   visitorAudiences: () => visitorAudiences,
   visitorLocales: () => visitorLocales,
   withExperimentBucket: () => withExperimentBucket,
+  withRecordingLevel: () => withRecordingLevel,
   withVisibility: () => withVisibility
 });
 module.exports = __toCommonJS(index_exports);
@@ -331,18 +359,18 @@ function slugify(input) {
   return input.toLowerCase().trim().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 64) || "untitled";
 }
 var ALPHABET = "0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ";
-function randomId(size = 16) {
+function randomId(size2 = 16) {
   const g = typeof globalThis !== "undefined" ? globalThis : {};
   let bytes;
   if (g.crypto && typeof g.crypto.getRandomValues === "function") {
-    bytes = new Uint8Array(size);
+    bytes = new Uint8Array(size2);
     g.crypto.getRandomValues(bytes);
   } else {
-    bytes = new Uint8Array(size);
-    for (let i = 0; i < size; i++) bytes[i] = Math.floor(Math.random() * 256);
+    bytes = new Uint8Array(size2);
+    for (let i = 0; i < size2; i++) bytes[i] = Math.floor(Math.random() * 256);
   }
   let out = "";
-  for (let i = 0; i < size; i++) out += ALPHABET[bytes[i] % ALPHABET.length];
+  for (let i = 0; i < size2; i++) out += ALPHABET[bytes[i] % ALPHABET.length];
   return out;
 }
 function isPlainObject(v) {
@@ -820,6 +848,11 @@ var StepSchema = import_zod2.z.object({
   imageUrl: import_zod2.z.string().url().max(2e3).optional().or(import_zod2.z.literal("")),
   /** Alternative text for `imageUrl` (screen readers); empty = decorative. */
   imageAlt: import_zod2.z.string().max(300).optional(),
+  /**
+   * Video (YouTube, Vimeo, Loom, a file…): drawn as a poster with a play button that opens the video
+   * in a new tab. The poster is `imageUrl` when set, else the provider's thumbnail.
+   */
+  videoUrl: import_zod2.z.string().url().max(2e3).optional().or(import_zod2.z.literal("")),
   buttons: import_zod2.z.array(ButtonSchema).max(6).default([]),
   target: TargetSchema.optional(),
   placement: import_zod2.z.enum(PLACEMENTS).default("auto"),
@@ -965,9 +998,9 @@ var GuideConfigSchema = import_zod2.z.object({
   /** Everyone, only identified (logged-in) users, or only anonymous visitors; applied on top of `targeting`. */
   visibility: import_zod2.z.enum(GUIDE_VISIBILITIES).default("everyone"),
   targeting: RuleGroupSchema.default(() => emptyRuleGroup()),
-  trigger: TriggerSchema.default({}),
-  frequency: FrequencySchema.default({}),
-  appearance: AppearanceSchema.default({}),
+  trigger: TriggerSchema.prefault({}),
+  frequency: FrequencySchema.prefault({}),
+  appearance: AppearanceSchema.prefault({}),
   checklist: ChecklistConfigSchema.optional(),
   survey: SurveyConfigSchema.optional(),
   /** Restrict guide to url pattern(s) (applied before trigger). On mobile these match the screen path `/<Screen>`. */
@@ -1074,19 +1107,91 @@ var ProjectThemeSchema = import_zod2.z.object({
 // src/events.ts
 var import_zod3 = require("zod");
 
+// src/error-detail.ts
+var MAX_EXCEPTION_DETAIL_BYTES = 64 * 1024;
+var MAX_EXCEPTION_DETAIL_RAW_BYTES = 1024 * 1024;
+var MAX_BREADCRUMBS = 100;
+var MAX_EXCEPTION_CHAIN = 20;
+var MAX_DETAIL_FRAMES = 250;
+var MAX_DETAIL_THREADS = 100;
+var MAX_DEBUG_IMAGES = 500;
+var MAX_ERROR_TAGS = 50;
+var size = (v) => {
+  try {
+    return JSON.stringify(v)?.length ?? 0;
+  } catch {
+    return Infinity;
+  }
+};
+function normalizeTags(tags) {
+  const out = {};
+  for (const [k, v] of Object.entries(tags ?? {})) {
+    if (Object.keys(out).length >= MAX_ERROR_TAGS) break;
+    if (!k || v === void 0 || v === null) continue;
+    out[k.slice(0, 32)] = String(v).slice(0, 200);
+  }
+  return out;
+}
+function trimExceptionDetail(detail, max = MAX_EXCEPTION_DETAIL_BYTES) {
+  const d = detail;
+  if (d.breadcrumbs?.values && d.breadcrumbs.values.length > MAX_BREADCRUMBS) d.breadcrumbs.values = d.breadcrumbs.values.slice(-MAX_BREADCRUMBS);
+  if (d.exception?.values && d.exception.values.length > MAX_EXCEPTION_CHAIN) d.exception.values = d.exception.values.slice(-MAX_EXCEPTION_CHAIN);
+  if (d.threads?.values && d.threads.values.length > MAX_DETAIL_THREADS) d.threads.values = d.threads.values.slice(0, MAX_DETAIL_THREADS);
+  if (d.debug_meta?.images && d.debug_meta.images.length > MAX_DEBUG_IMAGES) d.debug_meta.images = d.debug_meta.images.slice(0, MAX_DEBUG_IMAGES);
+  const stacks = () => [...d.exception?.values ?? [], ...d.threads?.values ?? []].map((x) => x.stacktrace).filter((s) => !!s);
+  for (const s of stacks()) if (s.frames && s.frames.length > MAX_DETAIL_FRAMES) s.frames = s.frames.slice(-MAX_DETAIL_FRAMES);
+  if (size(d) <= max) return d;
+  while (d.breadcrumbs?.values.length && size(d) > max) d.breadcrumbs.values = d.breadcrumbs.values.slice(Math.ceil(d.breadcrumbs.values.length / 2));
+  if (size(d) <= max) return d;
+  for (const s of stacks())
+    for (const f of s.frames ?? []) {
+      delete f.vars;
+      delete f.pre_context;
+      delete f.post_context;
+    }
+  if (size(d) <= max) return d;
+  if (d.threads?.values) d.threads.values = d.threads.values.filter((t) => t.crashed || t.current);
+  if (size(d) <= max) return d;
+  if (d.extra) d.extra = { _trimmed: true };
+  if (d.request) delete d.request.data;
+  for (const s of stacks()) while (s.frames && s.frames.length > 20 && size(d) > max) s.frames.splice(Math.floor(s.frames.length / 2) - 5, 10);
+  if (d.debug_meta?.images && size(d) > max) d.debug_meta.images = d.debug_meta.images.slice(0, 50);
+  return d;
+}
+var matches = (patterns, value) => patterns.some((p) => typeof p === "string" ? p !== "" && value.includes(p) : safeTest(p, value));
+function safeTest(re, value) {
+  re.lastIndex = 0;
+  return re.test(value);
+}
+function errorFilterDrops(e, opts) {
+  const message = e.message ?? "";
+  if (opts.ignoreErrors?.length && (matches(opts.ignoreErrors, `${e.type || "Error"}: ${message}`) || matches(opts.ignoreErrors, message))) return true;
+  if (!e.file) return false;
+  if (opts.denyUrls?.length && matches(opts.denyUrls, e.file)) return true;
+  if (opts.allowUrls?.length && !matches(opts.allowUrls, e.file)) return true;
+  return false;
+}
+
 // src/events-util.ts
 var SENSITIVE_PROPERTY_PATTERN = /(password|passwd|secret|token|credit|card|cvv|ssn|iban)/i;
 var MAX_PROPERTY_BYTES = 8 * 1024;
+var MAX_APP_VERSION_LENGTH = 64;
+function normalizeAppVersion(input) {
+  if (typeof input !== "string" && typeof input !== "number") return null;
+  const printable = Array.from(String(input)).filter((c) => c.charCodeAt(0) > 31 && c.charCodeAt(0) !== 127).join("");
+  const v = printable.trim().slice(0, MAX_APP_VERSION_LENGTH).trim();
+  return v || null;
+}
 function sanitizeProperties(props) {
   if (!props) return {};
   const out = {};
-  let size = 0;
+  let size2 = 0;
   for (const [k, v] of Object.entries(props)) {
     if (SENSITIVE_PROPERTY_PATTERN.test(k)) continue;
     if (typeof v === "function" || typeof v === "symbol") continue;
     const str2 = typeof v === "string" ? v : JSON.stringify(v ?? null);
-    size += k.length + (str2?.length ?? 0);
-    if (size > MAX_PROPERTY_BYTES) break;
+    size2 += k.length + (str2?.length ?? 0);
+    if (size2 > MAX_PROPERTY_BYTES) break;
     out[k.slice(0, 100)] = typeof v === "string" ? v.slice(0, 1e3) : v;
   }
   return out;
@@ -1096,16 +1201,23 @@ function sanitizeProperties(props) {
 var MAX_STACK_FRAMES = 30;
 var V8 = /^\s*at (?:(.+?) \()?((?:[a-z][\w+.-]*:)?[^\s()]+?):(\d+):(\d+)\)?\s*$/i;
 var GECKO = /^\s*(.*?)@(.+?):(\d+):(\d+)\s*$/;
+var HERMES = /^\s*at (?:(.+?) \()?address at ([^\s()]+?):(\d+):(\d+)\)?\s*$/;
+function reactNativeBundleUrl(file) {
+  const base = file.replace(/[?#].*$/, "").split("/").pop() || file;
+  return `app:///${base}`;
+}
 function parseStack(stack, max = MAX_STACK_FRAMES) {
   if (!stack || typeof stack !== "string") return [];
   const frames = [];
   for (const raw of stack.split("\n")) {
     if (frames.length >= max) break;
     const line = raw.slice(0, 1e3);
-    const m = V8.exec(line) ?? GECKO.exec(line);
+    const hermes = HERMES.exec(line);
+    const m = hermes ?? V8.exec(line) ?? GECKO.exec(line);
     if (!m) continue;
     const fn = (m[1] || "").trim();
-    frames.push({ fn: fn ? fn.slice(0, 200) : void 0, file: m[2]?.slice(0, 500), line: Number(m[3]), col: Number(m[4]) });
+    const file = hermes ? reactNativeBundleUrl(m[2]) : m[2];
+    frames.push({ fn: fn ? fn.slice(0, 200) : void 0, file: file?.slice(0, 500), line: Number(m[3]), col: Number(m[4]) });
   }
   return frames;
 }
@@ -1125,13 +1237,23 @@ function normalizeFrameFile(file) {
 var SOURCEMAP_MAX_FILE_BYTES = 100 * 1024 * 1024;
 var SOURCEMAP_MAX_FILES_PER_UPLOAD = 200;
 function fingerprintError(input) {
-  const top = (input.frames ?? []).find((f) => f.file);
-  const frameKey = input.original ? `src:${input.original.source}:${input.original.name || "?"}` : top ? `${normalizeFrameFile(top.file)}:${top.fn || "?"}` : "";
+  const withFile = (input.frames ?? []).filter((f) => f.file || f.module);
+  const top = withFile.find((f) => f.inApp === true) ?? withFile.find((f) => f.inApp !== false) ?? withFile[0];
+  const frameKey = input.original ? `src:${input.original.source}:${input.original.name || "?"}` : top ? `${top.file ? normalizeFrameFile(top.file) : `mod:${top.module}`}:${top.fn || "?"}` : "";
   const key = [input.type || "Error", normalizeErrorMessage(input.message || ""), frameKey].join("|");
   const a = fnv1a(key).toString(16).padStart(8, "0");
   const b = fnv1a(`guidely:${key}`).toString(16).padStart(8, "0");
   return a + b;
 }
+function customFingerprint(parts, computed) {
+  if (!Array.isArray(parts) || parts.length === 0) return computed;
+  const items = parts.filter((p) => typeof p === "string" || typeof p === "number").map((p) => String(p).slice(0, 200)).slice(0, 20);
+  if (items.length === 0) return computed;
+  const isDefault = (p) => /^\{\{\s*default\s*\}\}$/i.test(p);
+  if (items.every(isDefault)) return computed;
+  const key = items.map((p) => isDefault(p) ? computed : p).join("|");
+  return fnv1a(key).toString(16).padStart(8, "0") + fnv1a(`guidely:fp:${key}`).toString(16).padStart(8, "0");
+}
 
 // src/events.ts
 var EVENT_NAMES = [
@@ -1143,6 +1265,8 @@ var EVENT_NAMES = [
   "guide_skipped",
   "guide_dismissed",
   "guide_abandoned",
+  /** The video on a guide step was clicked (opened in a new tab). Properties: videoUrl. */
+  "guide_video_clicked",
   "checklist_task_completed",
   "checklist_completed",
   "checklist_dismissed",
@@ -1175,6 +1299,14 @@ var EVENT_NAMES = [
 var AUTOCAPTURE_EVENTS = ["page_view", "page_leave", "click", "rage_click", "exception", "heatmap", "app_install", "app_update", "app_open", "app_background"];
 var APP_LIFECYCLE_EVENTS = ["app_install", "app_update", "app_open", "app_background"];
 var GUIDE_LIFECYCLE_EVENTS = ["guide_viewed", "guide_started", "step_viewed", "step_completed", "guide_completed", "guide_skipped", "guide_dismissed", "guide_abandoned"];
+var ExceptionDetailField = import_zod3.z.preprocess((v) => {
+  if (!v || typeof v !== "object" || Array.isArray(v)) return void 0;
+  try {
+    return JSON.stringify(v).length > MAX_EXCEPTION_DETAIL_RAW_BYTES ? void 0 : v;
+  } catch {
+    return void 0;
+  }
+}, import_zod3.z.record(import_zod3.z.string(), import_zod3.z.unknown()).optional());
 var SdkEventSchema = import_zod3.z.object({
   eventId: import_zod3.z.string().min(8).max(64),
   name: import_zod3.z.enum(EVENT_NAMES),
@@ -1190,7 +1322,19 @@ var SdkEventSchema = import_zod3.z.object({
   stepId: import_zod3.z.string().max(64).optional(),
   stepIndex: import_zod3.z.number().int().min(0).optional(),
   url: import_zod3.z.string().max(2e3).optional(),
-  properties: import_zod3.z.record(import_zod3.z.unknown()).optional()
+  /**
+   * Version of the customer's app when the event happened (`appVersion` SDK option, auto-detected on
+   * mobile). Stored per event so reports can filter and break down by version; see `normalizeAppVersion`.
+   */
+  appVersion: import_zod3.z.string().max(200).optional().nullable(),
+  properties: import_zod3.z.record(import_zod3.z.string(), import_zod3.z.unknown()).optional(),
+  /**
+   * `exception` events only: breadcrumbs, contexts, tags, extra, the exception chain, threads and
+   * debug images in the Sentry event shape (`ExceptionDetail`, docs/error-monitoring/sdks.md), outside
+   * the 8 KB property budget. The server trims it to 64 KB and stores it in ErrorEventDetail; one over
+   * 1 MB (or that isn't an object) is dropped without failing the batch.
+   */
+  detail: ExceptionDetailField
 });
 var EventBatchSchema = import_zod3.z.object({
   events: import_zod3.z.array(SdkEventSchema).min(1).max(50),
@@ -1203,8 +1347,8 @@ var import_zod4 = require("zod");
 var IdentifyRequestSchema = import_zod4.z.object({
   anonymousId: import_zod4.z.string().min(1).max(128),
   userId: import_zod4.z.string().min(1).max(256).optional().nullable(),
-  traits: import_zod4.z.record(import_zod4.z.unknown()).optional(),
-  account: import_zod4.z.object({ id: import_zod4.z.string().min(1).max(256), traits: import_zod4.z.record(import_zod4.z.unknown()).optional() }).optional().nullable(),
+  traits: import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown()).optional(),
+  account: import_zod4.z.object({ id: import_zod4.z.string().min(1).max(256), traits: import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown()).optional() }).optional().nullable(),
   sessionId: import_zod4.z.string().max(128).optional(),
   url: import_zod4.z.string().max(2e3).optional()
 });
@@ -1221,7 +1365,7 @@ var SurveyResponseRequestSchema = import_zod4.z.object({
   userId: import_zod4.z.string().max(256).optional().nullable(),
   accountId: import_zod4.z.string().max(256).optional().nullable(),
   guideVersion: import_zod4.z.number().int(),
-  answers: import_zod4.z.record(import_zod4.z.union([import_zod4.z.string().max(5e3), import_zod4.z.number(), import_zod4.z.boolean(), import_zod4.z.array(import_zod4.z.string().max(500)).max(50)])),
+  answers: import_zod4.z.record(import_zod4.z.string(), import_zod4.z.union([import_zod4.z.string().max(5e3), import_zod4.z.number(), import_zod4.z.boolean(), import_zod4.z.array(import_zod4.z.string().max(500)).max(50)])),
   responseId: import_zod4.z.string().min(8).max(64)
 });
 var GuideStateUpdateSchema = import_zod4.z.object({
@@ -1243,7 +1387,7 @@ var AuthoringPickSchema = import_zod4.z.object({
   url: import_zod4.z.string().max(2e3).optional(),
   rect: import_zod4.z.object({ x: import_zod4.z.number(), y: import_zod4.z.number(), width: import_zod4.z.number(), height: import_zod4.z.number() }).optional(),
   /** Compact snapshot of the picked element (tag mode: feature rules are proposed from it). */
-  elementSnapshot: import_zod4.z.record(import_zod4.z.unknown()).optional()
+  elementSnapshot: import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown()).optional()
 });
 var PublishedGuideSchema = import_zod4.z.object({
   id: import_zod4.z.string(),
@@ -1321,9 +1465,38 @@ var FileComplaintSchema = import_zod6.z.object({
   }).optional().nullable()
 });
 
-// src/agents.ts
+// src/bug-reports.ts
 var import_zod7 = require("zod");
 
+// src/bug-reports-limits.ts
+var MAX_BUG_REPORT_LENGTH = 4e3;
+var MAX_BUG_REPORT_SCREENSHOT_BYTES = 4 * 1024 * 1024;
+
+// src/bug-reports.ts
+var BugReportSchema = import_zod7.z.object({
+  anonymousId: import_zod7.z.string().min(1).max(128),
+  userId: import_zod7.z.string().max(256).optional().nullable(),
+  sessionId: import_zod7.z.string().max(128).optional().nullable(),
+  message: import_zod7.z.string().trim().min(1).max(MAX_BUG_REPORT_LENGTH),
+  email: import_zod7.z.string().trim().toLowerCase().email().max(254).optional().nullable(),
+  name: import_zod7.z.string().trim().max(200).optional().nullable(),
+  /** The exception event the report is about (the SDK sends the page's last error unless told otherwise). */
+  associatedEventId: import_zod7.z.string().trim().max(64).optional().nullable(),
+  url: import_zod7.z.string().max(2e3).optional().nullable(),
+  appVersion: import_zod7.z.string().max(200).optional().nullable(),
+  /** widget (the built-in dialog) or api (captureFeedback). */
+  source: import_zod7.z.enum(["widget", "api"]).default("api"),
+  tags: import_zod7.z.record(import_zod7.z.string().max(64), import_zod7.z.string().max(200)).optional(),
+  sdk: import_zod7.z.object({ name: import_zod7.z.string().max(60), version: import_zod7.z.string().max(30) }).optional(),
+  screenshot: import_zod7.z.object({
+    fileName: import_zod7.z.string().trim().min(1).max(200),
+    data: import_zod7.z.string().max(Math.ceil(MAX_BUG_REPORT_SCREENSHOT_BYTES * 4 / 3) + 64)
+  }).optional().nullable()
+});
+
+// src/agents.ts
+var import_zod8 = require("zod");
+
 // src/agents-limits.ts
 var AGENT_TURN_ROLES = ["user", "assistant", "tool", "system"];
 var AGENT_OUTCOMES = ["success", "failure", "escalated", "abandoned"];
@@ -1336,51 +1509,51 @@ var AGENT_METADATA_MAX_BYTES = 4096;
 var SCOUT_AGENT_ID = "scout";
 
 // src/agents.ts
-var ENVIRONMENTS = ["development", "staging", "production"];
-var AgentToolCallSchema = import_zod7.z.object({
-  name: import_zod7.z.string().trim().min(1).max(100),
-  status: import_zod7.z.enum(AGENT_TOOL_STATUSES).optional(),
-  latencyMs: import_zod7.z.number().int().min(0).max(36e5).optional()
+var EnvironmentKey = import_zod8.z.string().trim().regex(/^[a-z][a-z0-9-]{0,29}$/, "environment: use an environment key such as production");
+var AgentToolCallSchema = import_zod8.z.object({
+  name: import_zod8.z.string().trim().min(1).max(100),
+  status: import_zod8.z.enum(AGENT_TOOL_STATUSES).optional(),
+  latencyMs: import_zod8.z.number().int().min(0).max(36e5).optional()
 }).strip();
-var AgentMetadataSchema = import_zod7.z.record(import_zod7.z.string().max(100), import_zod7.z.unknown()).transform((m) => {
+var AgentMetadataSchema = import_zod8.z.record(import_zod8.z.string().max(100), import_zod8.z.unknown()).transform((m) => {
   const out = {};
-  let size = 0;
+  let size2 = 0;
   for (const [k, v] of Object.entries(m)) {
     const key = k.trim();
     if (!key || key.startsWith("$") || SENSITIVE_PROPERTY_PATTERN.test(key)) continue;
     if (!(typeof v === "string" || typeof v === "boolean" || v === null || typeof v === "number" && Number.isFinite(v))) continue;
     const value = typeof v === "string" ? v.slice(0, 500) : v;
-    size += key.length + String(value).length;
-    if (size > AGENT_METADATA_MAX_BYTES || Object.keys(out).length >= AGENT_METADATA_MAX_KEYS) break;
+    size2 += key.length + String(value).length;
+    if (size2 > AGENT_METADATA_MAX_BYTES || Object.keys(out).length >= AGENT_METADATA_MAX_KEYS) break;
     out[key] = value;
   }
   return out;
 });
-var id = (max) => import_zod7.z.string().trim().min(1).max(max);
-var optionalId = (max) => import_zod7.z.string().trim().max(max).optional().nullable().transform((v) => v || null);
-var AgentTurnInputSchema = import_zod7.z.object({
-  type: import_zod7.z.literal("agent.conversation").optional(),
+var id = (max) => import_zod8.z.string().trim().min(1).max(max);
+var optionalId = (max) => import_zod8.z.string().trim().max(max).optional().nullable().transform((v) => v || null);
+var AgentTurnInputSchema = import_zod8.z.object({
+  type: import_zod8.z.literal("agent.conversation").optional(),
   conversationId: id(128),
   agentId: id(64).refine((v) => v.toLowerCase() !== SCOUT_AGENT_ID, { message: `"${SCOUT_AGENT_ID}" is reserved for Guidely's built-in Scout agent` }),
-  agentName: import_zod7.z.string().trim().max(100).optional(),
-  turnId: import_zod7.z.string().trim().min(1).max(128).optional(),
-  role: import_zod7.z.enum(AGENT_TURN_ROLES),
-  text: import_zod7.z.string().max(AGENT_TURN_MAX_TEXT).default(""),
-  toolCalls: import_zod7.z.array(AgentToolCallSchema).max(AGENT_TOOL_CALLS_PER_TURN).default([]),
-  latencyMs: import_zod7.z.number().int().min(0).max(36e5).optional(),
-  outcome: import_zod7.z.enum(AGENT_OUTCOMES).optional(),
-  taskSuccess: import_zod7.z.boolean().optional(),
-  occurredAt: import_zod7.z.string().datetime({ offset: true }).optional(),
+  agentName: import_zod8.z.string().trim().max(100).optional(),
+  turnId: import_zod8.z.string().trim().min(1).max(128).optional(),
+  role: import_zod8.z.enum(AGENT_TURN_ROLES),
+  text: import_zod8.z.string().max(AGENT_TURN_MAX_TEXT).default(""),
+  toolCalls: import_zod8.z.array(AgentToolCallSchema).max(AGENT_TOOL_CALLS_PER_TURN).default([]),
+  latencyMs: import_zod8.z.number().int().min(0).max(36e5).optional(),
+  outcome: import_zod8.z.enum(AGENT_OUTCOMES).optional(),
+  taskSuccess: import_zod8.z.boolean().optional(),
+  occurredAt: import_zod8.z.string().datetime({ offset: true }).optional(),
   userId: optionalId(256),
   anonymousId: optionalId(128),
   accountId: optionalId(256),
   sessionId: optionalId(128),
   metadata: AgentMetadataSchema.default({})
 });
-var turns = import_zod7.z.array(AgentTurnInputSchema).min(1).max(AGENT_TURNS_PER_BATCH);
-var sdkInfo = import_zod7.z.object({ name: import_zod7.z.string().max(60), version: import_zod7.z.string().max(30) }).optional();
-var SdkAgentEventsSchema = import_zod7.z.object({ turns, sdk: sdkInfo });
-var AgentEventsRequestSchema = import_zod7.z.preprocess(
+var turns = import_zod8.z.array(AgentTurnInputSchema).min(1).max(AGENT_TURNS_PER_BATCH);
+var sdkInfo = import_zod8.z.object({ name: import_zod8.z.string().max(60), version: import_zod8.z.string().max(30) }).optional();
+var SdkAgentEventsSchema = import_zod8.z.object({ turns, sdk: sdkInfo });
+var AgentEventsRequestSchema = import_zod8.z.preprocess(
   (v) => {
     if (Array.isArray(v)) return { turns: v };
     if (v && typeof v === "object" && !("turns" in v)) {
@@ -1389,11 +1562,11 @@ var AgentEventsRequestSchema = import_zod7.z.preprocess(
     }
     return v;
   },
-  import_zod7.z.object({ turns, environment: import_zod7.z.enum(ENVIRONMENTS).default("production"), sdk: sdkInfo })
+  import_zod8.z.object({ turns, environment: EnvironmentKey.default("production"), sdk: sdkInfo })
 );
 
 // src/feedback.ts
-var import_zod8 = require("zod");
+var import_zod9 = require("zod");
 
 // src/feedback-limits.ts
 var FEEDBACK_STATUSES = ["new", "under_review", "planned", "in_progress", "released", "declined"];
@@ -1417,60 +1590,79 @@ var feedbackReference = (number) => `#${number}`;
 
 // src/feedback.ts
 var visitor = {
-  anonymousId: import_zod8.z.string().min(1).max(128),
-  userId: import_zod8.z.string().max(256).optional().nullable()
+  anonymousId: import_zod9.z.string().min(1).max(128),
+  userId: import_zod9.z.string().max(256).optional().nullable()
 };
-var FeedbackListRequestSchema = import_zod8.z.object({
+var FeedbackListRequestSchema = import_zod9.z.object({
   ...visitor,
-  q: import_zod8.z.string().trim().max(200).optional(),
-  sort: import_zod8.z.enum(["top", "new", "trending"]).default("top"),
-  status: import_zod8.z.enum(FEEDBACK_STATUSES).optional(),
+  q: import_zod9.z.string().trim().max(200).optional(),
+  sort: import_zod9.z.enum(["top", "new", "trending"]).default("top"),
+  status: import_zod9.z.enum(FEEDBACK_STATUSES).optional(),
   /** "open" = not released or declined. */
-  filter: import_zod8.z.enum(["open", "all", "mine", "following"]).default("open"),
-  productArea: import_zod8.z.string().trim().max(60).optional(),
-  page: import_zod8.z.number().int().min(1).max(100).default(1)
+  filter: import_zod9.z.enum(["open", "all", "mine", "following"]).default("open"),
+  productArea: import_zod9.z.string().trim().max(60).optional(),
+  page: import_zod9.z.number().int().min(1).max(100).default(1)
 });
-var FeedbackVisitorSchema = import_zod8.z.object(visitor);
-var SubmitFeedbackSchema = import_zod8.z.object({
+var FeedbackVisitorSchema = import_zod9.z.object(visitor);
+var SubmitFeedbackSchema = import_zod9.z.object({
   ...visitor,
-  title: import_zod8.z.string().trim().min(3, "Give your idea a short title").max(MAX_FEEDBACK_TITLE),
-  description: import_zod8.z.string().trim().max(MAX_FEEDBACK_DESCRIPTION).default(""),
-  productArea: import_zod8.z.string().trim().max(60).optional().nullable(),
-  priority: import_zod8.z.enum(FEEDBACK_PRIORITIES).default("nice_to_have"),
+  title: import_zod9.z.string().trim().min(3, "Give your idea a short title").max(MAX_FEEDBACK_TITLE),
+  description: import_zod9.z.string().trim().max(MAX_FEEDBACK_DESCRIPTION).default(""),
+  productArea: import_zod9.z.string().trim().max(60).optional().nullable(),
+  priority: import_zod9.z.enum(FEEDBACK_PRIORITIES).default("nice_to_have"),
   /** Filed from this Scout conversation (Scout offered it). */
-  conversationId: import_zod8.z.string().min(1).max(64).optional().nullable(),
-  pageUrl: import_zod8.z.string().max(2e3).optional()
+  conversationId: import_zod9.z.string().min(1).max(64).optional().nullable(),
+  pageUrl: import_zod9.z.string().max(2e3).optional()
 });
-var FeedbackVoteSchema = import_zod8.z.object({
+var FeedbackVoteSchema = import_zod9.z.object({
   ...visitor,
-  priority: import_zod8.z.enum(FEEDBACK_PRIORITIES).default("nice_to_have"),
-  note: import_zod8.z.string().trim().max(MAX_FEEDBACK_NOTE).optional(),
-  conversationId: import_zod8.z.string().min(1).max(64).optional().nullable()
+  priority: import_zod9.z.enum(FEEDBACK_PRIORITIES).default("nice_to_have"),
+  note: import_zod9.z.string().trim().max(MAX_FEEDBACK_NOTE).optional(),
+  conversationId: import_zod9.z.string().min(1).max(64).optional().nullable()
 });
-var FeedbackFollowSchema = import_zod8.z.object({ ...visitor, follow: import_zod8.z.boolean() });
-var FeedbackCommentSchema = import_zod8.z.object({ ...visitor, body: import_zod8.z.string().trim().min(1).max(MAX_FEEDBACK_COMMENT) });
-var FeedbackSimilarSchema = import_zod8.z.object({ ...visitor, title: import_zod8.z.string().trim().min(3).max(MAX_FEEDBACK_TITLE) });
-var FeedbackUpdatesReadSchema = import_zod8.z.object({ ...visitor, ids: import_zod8.z.array(import_zod8.z.string().min(1).max(64)).max(100).optional() });
+var FeedbackFollowSchema = import_zod9.z.object({ ...visitor, follow: import_zod9.z.boolean() });
+var FeedbackCommentSchema = import_zod9.z.object({ ...visitor, body: import_zod9.z.string().trim().min(1).max(MAX_FEEDBACK_COMMENT) });
+var FeedbackSimilarSchema = import_zod9.z.object({ ...visitor, title: import_zod9.z.string().trim().min(3).max(MAX_FEEDBACK_TITLE) });
+var FeedbackUpdatesReadSchema = import_zod9.z.object({ ...visitor, ids: import_zod9.z.array(import_zod9.z.string().min(1).max(64)).max(100).optional() });
 
 // src/capture.ts
-var import_zod9 = require("zod");
-var AutocaptureSettingsSchema = import_zod9.z.object({ pageviews: import_zod9.z.boolean(), pageLeave: import_zod9.z.boolean(), clicks: import_zod9.z.boolean(), rageClicks: import_zod9.z.boolean(), heatmaps: import_zod9.z.boolean(), mouseMovement: import_zod9.z.boolean(), appLifecycle: import_zod9.z.boolean() }).partial();
-var ErrorTrackingSettingsSchema = import_zod9.z.object({ enabled: import_zod9.z.boolean() }).partial();
-var ReplaySettingsSchema = import_zod9.z.object({
-  enabled: import_zod9.z.boolean(),
-  sampleRate: import_zod9.z.number().int().min(0).max(100),
-  recordConsole: import_zod9.z.boolean(),
-  recordNetwork: import_zod9.z.boolean(),
-  recordNetworkPayloads: import_zod9.z.boolean(),
-  maskAllText: import_zod9.z.boolean(),
-  blockSelectors: import_zod9.z.array(import_zod9.z.string().min(1).max(200)).max(50),
-  retentionDays: import_zod9.z.number().int().min(1).max(365)
+var import_zod10 = require("zod");
+var AutocaptureSettingsSchema = import_zod10.z.object({ pageviews: import_zod10.z.boolean(), pageLeave: import_zod10.z.boolean(), clicks: import_zod10.z.boolean(), rageClicks: import_zod10.z.boolean(), heatmaps: import_zod10.z.boolean(), mouseMovement: import_zod10.z.boolean(), appLifecycle: import_zod10.z.boolean() }).partial();
+var ErrorTrackingSettingsSchema = import_zod10.z.object({ enabled: import_zod10.z.boolean() }).partial();
+var PerformanceSettingsSchema = import_zod10.z.object({ enabled: import_zod10.z.boolean(), sampleRate: import_zod10.z.number().min(0).max(100) }).partial();
+var ReplaySettingsSchema = import_zod10.z.object({
+  enabled: import_zod10.z.boolean(),
+  sampleRate: import_zod10.z.number().int().min(0).max(100),
+  recordConsole: import_zod10.z.boolean(),
+  recordNetwork: import_zod10.z.boolean(),
+  recordNetworkPayloads: import_zod10.z.boolean(),
+  maskAllText: import_zod10.z.boolean(),
+  blockSelectors: import_zod10.z.array(import_zod10.z.string().min(1).max(200)).max(50),
+  retentionDays: import_zod10.z.number().int().min(1).max(365)
 }).partial();
 var DEFAULT_CAPTURE_SETTINGS = {
   autocapture: { pageviews: true, pageLeave: true, clicks: true, rageClicks: true, heatmaps: true, mouseMovement: true, appLifecycle: true },
   errorTracking: { enabled: true },
+  performance: { enabled: false, sampleRate: 100 },
   replay: { enabled: false, sampleRate: 100, recordConsole: true, recordNetwork: true, recordNetworkPayloads: false, maskAllText: false, blockSelectors: [], retentionDays: 30 }
 };
+var RECORDING_LEVELS = ["off", "privacy", "standard", "full"];
+var RECORDING_PRESETS = {
+  privacy: { maskAllText: true, recordConsole: false, recordNetwork: false, recordNetworkPayloads: false },
+  standard: { maskAllText: false, recordConsole: true, recordNetwork: true, recordNetworkPayloads: false },
+  full: { maskAllText: false, recordConsole: true, recordNetwork: true, recordNetworkPayloads: true }
+};
+function recordingLevel(replay) {
+  if (!replay.enabled) return "off";
+  for (const level of ["privacy", "standard", "full"]) {
+    const preset = RECORDING_PRESETS[level];
+    if (Object.keys(preset).every((k) => replay[k] === preset[k])) return level;
+  }
+  return "custom";
+}
+function withRecordingLevel(replay, level) {
+  return level === "off" ? { ...replay, enabled: false } : { ...replay, ...RECORDING_PRESETS[level], enabled: true };
+}
 function resolveCaptureSettings(settings) {
   const s = settings && typeof settings === "object" ? settings : {};
   const obj = (v) => v && typeof v === "object" && !Array.isArray(v) ? v : {};
@@ -1478,25 +1670,29 @@ function resolveCaptureSettings(settings) {
   const a = AutocaptureSettingsSchema.safeParse(obj(s.autocapture));
   const e = ErrorTrackingSettingsSchema.safeParse(obj(s.errorTracking));
   const r = ReplaySettingsSchema.safeParse(obj(s.replay));
+  const p = PerformanceSettingsSchema.safeParse(obj(s.performance));
   return {
     autocapture: { ...d.autocapture, ...a.success ? a.data : {} },
     errorTracking: { ...d.errorTracking, ...e.success ? e.data : {} },
-    replay: { ...d.replay, ...r.success ? r.data : {} }
+    replay: { ...d.replay, ...r.success ? r.data : {} },
+    performance: { ...d.performance, ...p.success ? p.data : {} }
   };
 }
 var HEATMAP_VIEWPORTS = { mobile: [0, 767], tablet: [768, 1279], desktop: [1280, 1e5] };
-var ReplayChunkSchema = import_zod9.z.object({
-  sessionId: import_zod9.z.string().min(1).max(128),
-  windowId: import_zod9.z.string().min(1).max(64),
-  seq: import_zod9.z.number().int().min(0).max(1e6),
-  anonymousId: import_zod9.z.string().min(1).max(128),
-  userId: import_zod9.z.string().max(256).optional().nullable(),
+var ReplayChunkSchema = import_zod10.z.object({
+  sessionId: import_zod10.z.string().min(1).max(128),
+  windowId: import_zod10.z.string().min(1).max(64),
+  seq: import_zod10.z.number().int().min(0).max(1e6),
+  anonymousId: import_zod10.z.string().min(1).max(128),
+  userId: import_zod10.z.string().max(256).optional().nullable(),
   /** rrweb `eventWithTime` objects, in order. */
-  events: import_zod9.z.array(import_zod9.z.object({ type: import_zod9.z.number().int(), timestamp: import_zod9.z.number() }).passthrough()).min(1).max(5e4),
-  url: import_zod9.z.string().max(2e3).optional(),
-  device: import_zod9.z.object({ type: import_zod9.z.string().max(20), browser: import_zod9.z.string().max(40).optional(), os: import_zod9.z.string().max(40).optional() }).optional(),
-  viewport: import_zod9.z.object({ width: import_zod9.z.number().int().min(0).max(1e5), height: import_zod9.z.number().int().min(0).max(1e5) }).optional(),
-  sdk: import_zod9.z.object({ name: import_zod9.z.string().max(60), version: import_zod9.z.string().max(30) }).optional()
+  events: import_zod10.z.array(import_zod10.z.object({ type: import_zod10.z.number().int(), timestamp: import_zod10.z.number() }).passthrough()).min(1).max(5e4),
+  url: import_zod10.z.string().max(2e3).optional(),
+  device: import_zod10.z.object({ type: import_zod10.z.string().max(20), browser: import_zod10.z.string().max(40).optional(), os: import_zod10.z.string().max(40).optional() }).optional(),
+  viewport: import_zod10.z.object({ width: import_zod10.z.number().int().min(0).max(1e5), height: import_zod10.z.number().int().min(0).max(1e5) }).optional(),
+  sdk: import_zod10.z.object({ name: import_zod10.z.string().max(60), version: import_zod10.z.string().max(30) }).optional(),
+  /** The app's version (`appVersion` SDK option); recordings can be filtered by it. */
+  appVersion: import_zod10.z.string().max(200).optional()
 });
 var REPLAY_MAX_COMPRESSED_BYTES = 2 * 1024 * 1024;
 var REPLAY_MAX_RAW_BYTES = 16 * 1024 * 1024;
@@ -1813,6 +2009,19 @@ function isSafeMediaUrl(url) {
     return false;
   }
 }
+function videoThumbnailUrl(url) {
+  const embed = url ? toEmbedUrl(url) : null;
+  if (embed?.provider !== "youtube") return null;
+  const id2 = embed.src.split("/embed/")[1]?.split("?")[0];
+  return id2 ? `https://i.ytimg.com/vi/${id2}/hqdefault.jpg` : null;
+}
+function isVideoFileUrl(url) {
+  return isSafeMediaUrl(url) && /\.(mp4|webm|m4v|mov|ogv)$/i.test(new URL(url).pathname);
+}
+function stepVideo(step) {
+  if (!step.videoUrl || !isSafeMediaUrl(step.videoUrl)) return null;
+  return { url: step.videoUrl, poster: (step.imageUrl && isSafeMediaUrl(step.imageUrl) ? step.imageUrl : null) ?? videoThumbnailUrl(step.videoUrl) };
+}
 
 // src/resource-center.ts
 var MAX_COLLECTION_DEPTH = 3;
@@ -1935,9 +2144,19 @@ function unreadAnnouncements(items, lastSeenAt) {
   if (Number.isNaN(seen)) return items.length;
   return items.filter((a) => Date.parse(a.publishedAt) > seen).length;
 }
+var ARTICLE_HREF_PREFIX = "#guidely-article:";
+var ARTICLE_ID = /^[A-Za-z0-9_-]{1,64}$/;
+function articleHref(articleId) {
+  return `${ARTICLE_HREF_PREFIX}${articleId}`;
+}
+function articleIdFromHref(href) {
+  if (!href || !href.startsWith(ARTICLE_HREF_PREFIX)) return null;
+  const id2 = href.slice(ARTICLE_HREF_PREFIX.length);
+  return ARTICLE_ID.test(id2) ? id2 : null;
+}
 
 // src/howto.ts
-var import_zod10 = require("zod");
+var import_zod11 = require("zod");
 
 // src/howto-limits.ts
 var CAPTURE_PARAM = "guidely_capture";
@@ -1946,36 +2165,36 @@ var CAPTURE_SCREENSHOT_MAX_BYTES = 8 * 1024 * 1024;
 // src/howto.ts
 var HOWTO_STEP_KINDS = ["action", "text", "heading", "tip", "alert"];
 var HOWTO_ACTIONS = ["click", "type", "select", "navigate"];
-var NormalizedRectSchema = import_zod10.z.object({
-  x: import_zod10.z.number().min(0).max(1),
-  y: import_zod10.z.number().min(0).max(1),
-  width: import_zod10.z.number().min(0).max(1),
-  height: import_zod10.z.number().min(0).max(1)
+var NormalizedRectSchema = import_zod11.z.object({
+  x: import_zod11.z.number().min(0).max(1),
+  y: import_zod11.z.number().min(0).max(1),
+  width: import_zod11.z.number().min(0).max(1),
+  height: import_zod11.z.number().min(0).max(1)
 });
-var CapturedElementSchema = import_zod10.z.object({
+var CapturedElementSchema = import_zod11.z.object({
   /** Visible name: aria-label, associated label, text, placeholder, alt or title. */
-  label: import_zod10.z.string().max(200).default(""),
+  label: import_zod11.z.string().max(200).default(""),
   /** button, link, tab, menuitem, checkbox, radio, field, dropdown, option, element… */
-  role: import_zod10.z.string().max(40).default("element"),
-  tag: import_zod10.z.string().max(40).default("")
+  role: import_zod11.z.string().max(40).default("element"),
+  tag: import_zod11.z.string().max(40).default("")
 });
-var CaptureStepSchema = import_zod10.z.object({
+var CaptureStepSchema = import_zod11.z.object({
   /** Random id from the SDK; a retried upload with the same id is stored once. */
-  clientId: import_zod10.z.string().min(1).max(64),
-  action: import_zod10.z.enum(HOWTO_ACTIONS),
-  url: import_zod10.z.string().max(2e3),
-  pageTitle: import_zod10.z.string().max(300).default(""),
+  clientId: import_zod11.z.string().min(1).max(64),
+  action: import_zod11.z.enum(HOWTO_ACTIONS),
+  url: import_zod11.z.string().max(2e3),
+  pageTitle: import_zod11.z.string().max(300).default(""),
   element: CapturedElementSchema.optional(),
   /** Typed text or chosen option; absent when it was sensitive (`valueRedacted`). */
-  value: import_zod10.z.string().max(200).optional(),
-  valueRedacted: import_zod10.z.boolean().default(false),
+  value: import_zod11.z.string().max(200).optional(),
+  valueRedacted: import_zod11.z.boolean().default(false),
   /** Selectors for the element, so the step can later become an interactive tour step. */
-  selectors: import_zod10.z.array(SelectorStrategySchema).max(10).default([]),
+  selectors: import_zod11.z.array(SelectorStrategySchema).max(10).default([]),
   /** Where the element sits in the screenshot. */
   highlight: NormalizedRectSchema.optional(),
   /** Number of regions the SDK blurred in the screenshot before upload. */
-  redactions: import_zod10.z.number().int().min(0).max(1e3).default(0),
-  occurredAt: import_zod10.z.string().datetime().optional()
+  redactions: import_zod11.z.number().int().min(0).max(1e3).default(0),
+  occurredAt: import_zod11.z.string().datetime().optional()
 });
 function quoted(s) {
   const t = (s ?? "").replace(/\s+/g, " ").trim();
@@ -2046,12 +2265,12 @@ function hostAndPath(url) {
     return url.slice(0, 80);
   }
 }
-var NormalizedPointSchema = import_zod10.z.object({ x: import_zod10.z.number().min(0).max(1), y: import_zod10.z.number().min(0).max(1) });
+var NormalizedPointSchema = import_zod11.z.object({ x: import_zod11.z.number().min(0).max(1), y: import_zod11.z.number().min(0).max(1) });
 var ANNOTATION_COLORS = ["brand", "red", "amber", "green", "black", "white"];
-var HowToAnnotationSchema = import_zod10.z.discriminatedUnion("type", [
-  import_zod10.z.object({ id: import_zod10.z.string().min(1).max(32), type: import_zod10.z.literal("arrow"), from: NormalizedPointSchema, to: NormalizedPointSchema, color: import_zod10.z.enum(ANNOTATION_COLORS).default("brand") }),
-  import_zod10.z.object({ id: import_zod10.z.string().min(1).max(32), type: import_zod10.z.literal("text"), at: NormalizedPointSchema, text: import_zod10.z.string().trim().min(1).max(120), color: import_zod10.z.enum(ANNOTATION_COLORS).default("brand") }),
-  import_zod10.z.object({ id: import_zod10.z.string().min(1).max(32), type: import_zod10.z.literal("box"), rect: NormalizedRectSchema, color: import_zod10.z.enum(ANNOTATION_COLORS).default("brand") })
+var HowToAnnotationSchema = import_zod11.z.discriminatedUnion("type", [
+  import_zod11.z.object({ id: import_zod11.z.string().min(1).max(32), type: import_zod11.z.literal("arrow"), from: NormalizedPointSchema, to: NormalizedPointSchema, color: import_zod11.z.enum(ANNOTATION_COLORS).default("brand") }),
+  import_zod11.z.object({ id: import_zod11.z.string().min(1).max(32), type: import_zod11.z.literal("text"), at: NormalizedPointSchema, text: import_zod11.z.string().trim().min(1).max(120), color: import_zod11.z.enum(ANNOTATION_COLORS).default("brand") }),
+  import_zod11.z.object({ id: import_zod11.z.string().min(1).max(32), type: import_zod11.z.literal("box"), rect: NormalizedRectSchema, color: import_zod11.z.enum(ANNOTATION_COLORS).default("brand") })
 ]);
 var MAX_ANNOTATIONS = 30;
 
@@ -2653,6 +2872,16 @@ var SCRIPT_STUB_METHODS = [
   "openComplaint",
   "openIdeas",
   "captureException",
+  "captureFeedback",
+  "showBugReport",
+  "captureMessage",
+  "addBreadcrumb",
+  "setTag",
+  "setTags",
+  "setExtra",
+  "setExtras",
+  "setContext",
+  "setUser",
   "agentConversation",
   "trackAgentTurn",
   "on"
@@ -3184,7 +3413,7 @@ function parseTranslationCsv(text) {
 
 // src/index.ts
 var SDK_API_VERSION = "v1";
-var SHARED_VERSION = "0.15.0";
+var SHARED_VERSION = "0.17.0";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ADVANCE_ON,
@@ -3198,6 +3427,7 @@ var SHARED_VERSION = "0.15.0";
   AGENT_TURN_ROLES,
   ANNOTATION_COLORS,
   APP_LIFECYCLE_EVENTS,
+  ARTICLE_HREF_PREFIX,
   ARTICLE_VISIBILITIES,
   AUTOCAPTURE_EVENTS,
   AgentEventsRequestSchema,
@@ -3208,6 +3438,7 @@ var SHARED_VERSION = "0.15.0";
   AuthoringPickSchema,
   AutocaptureSettingsSchema,
   BUTTON_ACTIONS,
+  BugReportSchema,
   ButtonSchema,
   CAPTURE_PARAM,
   CAPTURE_SCREENSHOT_MAX_BYTES,
@@ -3273,6 +3504,10 @@ var SHARED_VERSION = "0.15.0";
   LocaleSchema,
   LocalizationSettingsSchema,
   MAX_ANNOTATIONS,
+  MAX_APP_VERSION_LENGTH,
+  MAX_BREADCRUMBS,
+  MAX_BUG_REPORT_LENGTH,
+  MAX_BUG_REPORT_SCREENSHOT_BYTES,
   MAX_COLLECTION_DEPTH,
   MAX_COMPLAINT_ANSWER_LENGTH,
   MAX_COMPLAINT_ATTACHMENT_BYTES,
@@ -3280,6 +3515,13 @@ var SHARED_VERSION = "0.15.0";
   MAX_COMPLAINT_FIELDS,
   MAX_COMPLAINT_LENGTH,
   MAX_CUSTOM_CSS,
+  MAX_DEBUG_IMAGES,
+  MAX_DETAIL_FRAMES,
+  MAX_DETAIL_THREADS,
+  MAX_ERROR_TAGS,
+  MAX_EXCEPTION_CHAIN,
+  MAX_EXCEPTION_DETAIL_BYTES,
+  MAX_EXCEPTION_DETAIL_RAW_BYTES,
   MAX_FEEDBACK_COMMENT,
   MAX_FEEDBACK_DESCRIPTION,
   MAX_FEEDBACK_NOTE,
@@ -3307,11 +3549,13 @@ var SHARED_VERSION = "0.15.0";
   PDF_PAGES_CLASS,
   PLACEMENTS,
   PLATFORMS,
+  PerformanceSettingsSchema,
   PostMessageSchema,
   ProjectThemeSchema,
   PublishedGuideSchema,
   RC_MODULE_IDS,
   RC_MODULE_LABELS,
+  RECORDING_LEVELS,
   REPLAY_MAX_COMPRESSED_BYTES,
   REPLAY_MAX_RAW_BYTES,
   REPLY_TIMES,
@@ -3361,6 +3605,8 @@ var SHARED_VERSION = "0.15.0";
   WS_MAX_MESSAGES_PER_SOCKET,
   WS_MAX_MESSAGE_BYTES,
   applyGuideTranslations,
+  articleHref,
+  articleIdFromHref,
   articleTextEntries,
   assignGuideVariant,
   baseLanguage,
@@ -3373,11 +3619,13 @@ var SHARED_VERSION = "0.15.0";
   contrastIssues,
   contrastRatio,
   cssSelectorError,
+  customFingerprint,
   defaultGuideConfig,
   defaultStep,
   describeCaptureStep,
   describeRule,
   emptyRuleGroup,
+  errorFilterDrops,
   evaluateRule,
   evaluateRules,
   evenWeights,
@@ -3407,6 +3655,7 @@ var SHARED_VERSION = "0.15.0";
   isRuleGroup,
   isSafeMediaUrl,
   isVideoContentType,
+  isVideoFileUrl,
   localeName,
   localizeAnnouncement,
   localizeArticle,
@@ -3419,10 +3668,12 @@ var SHARED_VERSION = "0.15.0";
   mediaKind,
   mediaMaxBytes,
   needsReview,
+  normalizeAppVersion,
   normalizeErrorMessage,
   normalizeFrameFile,
   normalizeLocale,
   normalizeSnapshot,
+  normalizeTags,
   orderedModules,
   pageLabel,
   pageName,
@@ -3440,7 +3691,9 @@ var SHARED_VERSION = "0.15.0";
   propertyAttributeAllowed,
   queryConditionRegex,
   randomId,
+  reactNativeBundleUrl,
   readableTextOn,
+  recordingLevel,
   relativeLuminance,
   resolveCaptureSettings,
   resolveLocale,
@@ -3461,6 +3714,7 @@ var SHARED_VERSION = "0.15.0";
   slugify,
   snapshotFromSelector,
   stableStringify,
+  stepVideo,
   stripOrigin,
   supportsPlatform,
   templateConfig,
@@ -3468,16 +3722,19 @@ var SHARED_VERSION = "0.15.0";
   toTranslationCsv,
   toXliff,
   translationCoverage,
+  trimExceptionDetail,
   unreadAnnouncements,
   validateGuideConfig,
   variantProblems,
   variantRanges,
+  videoThumbnailUrl,
   visibleAnnouncements,
   visibleArticleIds,
   visibleButtons,
   visitorAudiences,
   visitorLocales,
   withExperimentBucket,
+  withRecordingLevel,
   withVisibility
 });
 //# sourceMappingURL=index.cjs.map