@guidelytech/shared 0.15.0 → 0.17.0

package/dist/index.js

@@ -7,6 +7,7 @@ import {
   AGENT_TURNS_PER_BATCH,
   AGENT_TURN_MAX_TEXT,
   AGENT_TURN_ROLES,
+  ARTICLE_HREF_PREFIX,
   ARTICLE_VISIBILITIES,
   CAPTURE_PARAM,
   CAPTURE_SCREENSHOT_MAX_BYTES,
@@ -28,6 +29,10 @@ import {
   GUIDE_EXPERIMENT_STATUSES,
   GUIDE_VISIBILITIES,
   LOGGED_IN_AUDIENCE,
+  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,
@@ -35,6 +40,13 @@ import {
   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_PROPERTY_BYTES,
   MAX_STACK_FRAMES,
   MEDIA_FILE_MAX_BYTES,
@@ -75,6 +87,8 @@ import {
   WS_MAX_MESSAGES_PER_SOCKET,
   WS_MAX_MESSAGE_BYTES,
   applyGuideTranslations,
+  articleHref,
+  articleIdFromHref,
   articleTextEntries,
   assignGuideVariant,
   baseLanguage,
@@ -86,8 +100,10 @@ import {
   contrastIssues,
   contrastRatio,
   cssSelectorError,
+  customFingerprint,
   describeRule,
   emptyRuleGroup,
+  errorFilterDrops,
   evaluateRule,
   evaluateRules,
   evenWeights,
@@ -116,6 +132,7 @@ import {
   isRuleGroup,
   isSafeMediaUrl,
   isVideoContentType,
+  isVideoFileUrl,
   localeName,
   localizeAnnouncement,
   localizeArticle,
@@ -128,10 +145,12 @@ import {
   mediaKind,
   mediaMaxBytes,
   needsReview,
+  normalizeAppVersion,
   normalizeErrorMessage,
   normalizeFrameFile,
   normalizeLocale,
   normalizeSnapshot,
+  normalizeTags,
   orderedModules,
   pageLabel,
   pagePattern,
@@ -145,6 +164,7 @@ import {
   propertyAttributeAllowed,
   queryConditionRegex,
   randomId,
+  reactNativeBundleUrl,
   readableTextOn,
   relativeLuminance,
   resolveLocale,
@@ -164,20 +184,23 @@ import {
   slugify,
   snapshotFromSelector,
   stableStringify,
+  stepVideo,
   stripOrigin,
   supportsPlatform,
   toEmbedUrl,
   translationCoverage,
+  trimExceptionDetail,
   unreadAnnouncements,
   variantProblems,
   variantRanges,
+  videoThumbnailUrl,
   visibleAnnouncements,
   visibleArticleIds,
   visitorAudiences,
   visitorLocales,
   withExperimentBucket,
   withVisibility
-} from "./chunk-XJXXVV3C.js";
+} from "./chunk-YL65O3FS.js";
 
 // src/targeting.ts
 import { z } from "zod";
@@ -250,6 +273,11 @@ var StepSchema = z2.object({
   imageUrl: z2.string().url().max(2e3).optional().or(z2.literal("")),
   /** Alternative text for `imageUrl` (screen readers); empty = decorative. */
   imageAlt: z2.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: z2.string().url().max(2e3).optional().or(z2.literal("")),
   buttons: z2.array(ButtonSchema).max(6).default([]),
   target: TargetSchema.optional(),
   placement: z2.enum(PLACEMENTS).default("auto"),
@@ -395,9 +423,9 @@ var GuideConfigSchema = z2.object({
   /** Everyone, only identified (logged-in) users, or only anonymous visitors; applied on top of `targeting`. */
   visibility: z2.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>`. */
@@ -512,6 +540,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",
@@ -544,6 +574,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 = z3.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;
+  }
+}, z3.record(z3.string(), z3.unknown()).optional());
 var SdkEventSchema = z3.object({
   eventId: z3.string().min(8).max(64),
   name: z3.enum(EVENT_NAMES),
@@ -559,7 +597,19 @@ var SdkEventSchema = z3.object({
   stepId: z3.string().max(64).optional(),
   stepIndex: z3.number().int().min(0).optional(),
   url: z3.string().max(2e3).optional(),
-  properties: z3.record(z3.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: z3.string().max(200).optional().nullable(),
+  properties: z3.record(z3.string(), z3.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 = z3.object({
   events: z3.array(SdkEventSchema).min(1).max(50),
@@ -572,8 +622,8 @@ import { z as z4 } from "zod";
 var IdentifyRequestSchema = z4.object({
   anonymousId: z4.string().min(1).max(128),
   userId: z4.string().min(1).max(256).optional().nullable(),
-  traits: z4.record(z4.unknown()).optional(),
-  account: z4.object({ id: z4.string().min(1).max(256), traits: z4.record(z4.unknown()).optional() }).optional().nullable(),
+  traits: z4.record(z4.string(), z4.unknown()).optional(),
+  account: z4.object({ id: z4.string().min(1).max(256), traits: z4.record(z4.string(), z4.unknown()).optional() }).optional().nullable(),
   sessionId: z4.string().max(128).optional(),
   url: z4.string().max(2e3).optional()
 });
@@ -590,7 +640,7 @@ var SurveyResponseRequestSchema = z4.object({
   userId: z4.string().max(256).optional().nullable(),
   accountId: z4.string().max(256).optional().nullable(),
   guideVersion: z4.number().int(),
-  answers: z4.record(z4.union([z4.string().max(5e3), z4.number(), z4.boolean(), z4.array(z4.string().max(500)).max(50)])),
+  answers: z4.record(z4.string(), z4.union([z4.string().max(5e3), z4.number(), z4.boolean(), z4.array(z4.string().max(500)).max(50)])),
   responseId: z4.string().min(8).max(64)
 });
 var GuideStateUpdateSchema = z4.object({
@@ -612,7 +662,7 @@ var AuthoringPickSchema = z4.object({
   url: z4.string().max(2e3).optional(),
   rect: z4.object({ x: z4.number(), y: z4.number(), width: z4.number(), height: z4.number() }).optional(),
   /** Compact snapshot of the picked element (tag mode: feature rules are proposed from it). */
-  elementSnapshot: z4.record(z4.unknown()).optional()
+  elementSnapshot: z4.record(z4.string(), z4.unknown()).optional()
 });
 var PublishedGuideSchema = z4.object({
   id: z4.string(),
@@ -677,15 +727,38 @@ var FileComplaintSchema = z6.object({
   }).optional().nullable()
 });
 
-// src/agents.ts
+// src/bug-reports.ts
 import { z as z7 } from "zod";
-var ENVIRONMENTS = ["development", "staging", "production"];
-var AgentToolCallSchema = z7.object({
-  name: z7.string().trim().min(1).max(100),
-  status: z7.enum(AGENT_TOOL_STATUSES).optional(),
-  latencyMs: z7.number().int().min(0).max(36e5).optional()
+var BugReportSchema = z7.object({
+  anonymousId: z7.string().min(1).max(128),
+  userId: z7.string().max(256).optional().nullable(),
+  sessionId: z7.string().max(128).optional().nullable(),
+  message: z7.string().trim().min(1).max(MAX_BUG_REPORT_LENGTH),
+  email: z7.string().trim().toLowerCase().email().max(254).optional().nullable(),
+  name: z7.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: z7.string().trim().max(64).optional().nullable(),
+  url: z7.string().max(2e3).optional().nullable(),
+  appVersion: z7.string().max(200).optional().nullable(),
+  /** widget (the built-in dialog) or api (captureFeedback). */
+  source: z7.enum(["widget", "api"]).default("api"),
+  tags: z7.record(z7.string().max(64), z7.string().max(200)).optional(),
+  sdk: z7.object({ name: z7.string().max(60), version: z7.string().max(30) }).optional(),
+  screenshot: z7.object({
+    fileName: z7.string().trim().min(1).max(200),
+    data: z7.string().max(Math.ceil(MAX_BUG_REPORT_SCREENSHOT_BYTES * 4 / 3) + 64)
+  }).optional().nullable()
+});
+
+// src/agents.ts
+import { z as z8 } from "zod";
+var EnvironmentKey = z8.string().trim().regex(/^[a-z][a-z0-9-]{0,29}$/, "environment: use an environment key such as production");
+var AgentToolCallSchema = z8.object({
+  name: z8.string().trim().min(1).max(100),
+  status: z8.enum(AGENT_TOOL_STATUSES).optional(),
+  latencyMs: z8.number().int().min(0).max(36e5).optional()
 }).strip();
-var AgentMetadataSchema = z7.record(z7.string().max(100), z7.unknown()).transform((m) => {
+var AgentMetadataSchema = z8.record(z8.string().max(100), z8.unknown()).transform((m) => {
   const out = {};
   let size = 0;
   for (const [k, v] of Object.entries(m)) {
@@ -699,31 +772,31 @@ var AgentMetadataSchema = z7.record(z7.string().max(100), z7.unknown()).transfor
   }
   return out;
 });
-var id = (max) => z7.string().trim().min(1).max(max);
-var optionalId = (max) => z7.string().trim().max(max).optional().nullable().transform((v) => v || null);
-var AgentTurnInputSchema = z7.object({
-  type: z7.literal("agent.conversation").optional(),
+var id = (max) => z8.string().trim().min(1).max(max);
+var optionalId = (max) => z8.string().trim().max(max).optional().nullable().transform((v) => v || null);
+var AgentTurnInputSchema = z8.object({
+  type: z8.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: z7.string().trim().max(100).optional(),
-  turnId: z7.string().trim().min(1).max(128).optional(),
-  role: z7.enum(AGENT_TURN_ROLES),
-  text: z7.string().max(AGENT_TURN_MAX_TEXT).default(""),
-  toolCalls: z7.array(AgentToolCallSchema).max(AGENT_TOOL_CALLS_PER_TURN).default([]),
-  latencyMs: z7.number().int().min(0).max(36e5).optional(),
-  outcome: z7.enum(AGENT_OUTCOMES).optional(),
-  taskSuccess: z7.boolean().optional(),
-  occurredAt: z7.string().datetime({ offset: true }).optional(),
+  agentName: z8.string().trim().max(100).optional(),
+  turnId: z8.string().trim().min(1).max(128).optional(),
+  role: z8.enum(AGENT_TURN_ROLES),
+  text: z8.string().max(AGENT_TURN_MAX_TEXT).default(""),
+  toolCalls: z8.array(AgentToolCallSchema).max(AGENT_TOOL_CALLS_PER_TURN).default([]),
+  latencyMs: z8.number().int().min(0).max(36e5).optional(),
+  outcome: z8.enum(AGENT_OUTCOMES).optional(),
+  taskSuccess: z8.boolean().optional(),
+  occurredAt: z8.string().datetime({ offset: true }).optional(),
   userId: optionalId(256),
   anonymousId: optionalId(128),
   accountId: optionalId(256),
   sessionId: optionalId(128),
   metadata: AgentMetadataSchema.default({})
 });
-var turns = z7.array(AgentTurnInputSchema).min(1).max(AGENT_TURNS_PER_BATCH);
-var sdkInfo = z7.object({ name: z7.string().max(60), version: z7.string().max(30) }).optional();
-var SdkAgentEventsSchema = z7.object({ turns, sdk: sdkInfo });
-var AgentEventsRequestSchema = z7.preprocess(
+var turns = z8.array(AgentTurnInputSchema).min(1).max(AGENT_TURNS_PER_BATCH);
+var sdkInfo = z8.object({ name: z8.string().max(60), version: z8.string().max(30) }).optional();
+var SdkAgentEventsSchema = z8.object({ turns, sdk: sdkInfo });
+var AgentEventsRequestSchema = z8.preprocess(
   (v) => {
     if (Array.isArray(v)) return { turns: v };
     if (v && typeof v === "object" && !("turns" in v)) {
@@ -732,11 +805,11 @@ var AgentEventsRequestSchema = z7.preprocess(
     }
     return v;
   },
-  z7.object({ turns, environment: z7.enum(ENVIRONMENTS).default("production"), sdk: sdkInfo })
+  z8.object({ turns, environment: EnvironmentKey.default("production"), sdk: sdkInfo })
 );
 
 // src/feedback.ts
-import { z as z8 } from "zod";
+import { z as z9 } from "zod";
 
 // src/feedback-limits.ts
 var FEEDBACK_STATUSES = ["new", "under_review", "planned", "in_progress", "released", "declined"];
@@ -760,60 +833,79 @@ var feedbackReference = (number) => `#${number}`;
 
 // src/feedback.ts
 var visitor = {
-  anonymousId: z8.string().min(1).max(128),
-  userId: z8.string().max(256).optional().nullable()
+  anonymousId: z9.string().min(1).max(128),
+  userId: z9.string().max(256).optional().nullable()
 };
-var FeedbackListRequestSchema = z8.object({
+var FeedbackListRequestSchema = z9.object({
   ...visitor,
-  q: z8.string().trim().max(200).optional(),
-  sort: z8.enum(["top", "new", "trending"]).default("top"),
-  status: z8.enum(FEEDBACK_STATUSES).optional(),
+  q: z9.string().trim().max(200).optional(),
+  sort: z9.enum(["top", "new", "trending"]).default("top"),
+  status: z9.enum(FEEDBACK_STATUSES).optional(),
   /** "open" = not released or declined. */
-  filter: z8.enum(["open", "all", "mine", "following"]).default("open"),
-  productArea: z8.string().trim().max(60).optional(),
-  page: z8.number().int().min(1).max(100).default(1)
+  filter: z9.enum(["open", "all", "mine", "following"]).default("open"),
+  productArea: z9.string().trim().max(60).optional(),
+  page: z9.number().int().min(1).max(100).default(1)
 });
-var FeedbackVisitorSchema = z8.object(visitor);
-var SubmitFeedbackSchema = z8.object({
+var FeedbackVisitorSchema = z9.object(visitor);
+var SubmitFeedbackSchema = z9.object({
   ...visitor,
-  title: z8.string().trim().min(3, "Give your idea a short title").max(MAX_FEEDBACK_TITLE),
-  description: z8.string().trim().max(MAX_FEEDBACK_DESCRIPTION).default(""),
-  productArea: z8.string().trim().max(60).optional().nullable(),
-  priority: z8.enum(FEEDBACK_PRIORITIES).default("nice_to_have"),
+  title: z9.string().trim().min(3, "Give your idea a short title").max(MAX_FEEDBACK_TITLE),
+  description: z9.string().trim().max(MAX_FEEDBACK_DESCRIPTION).default(""),
+  productArea: z9.string().trim().max(60).optional().nullable(),
+  priority: z9.enum(FEEDBACK_PRIORITIES).default("nice_to_have"),
   /** Filed from this Scout conversation (Scout offered it). */
-  conversationId: z8.string().min(1).max(64).optional().nullable(),
-  pageUrl: z8.string().max(2e3).optional()
+  conversationId: z9.string().min(1).max(64).optional().nullable(),
+  pageUrl: z9.string().max(2e3).optional()
 });
-var FeedbackVoteSchema = z8.object({
+var FeedbackVoteSchema = z9.object({
   ...visitor,
-  priority: z8.enum(FEEDBACK_PRIORITIES).default("nice_to_have"),
-  note: z8.string().trim().max(MAX_FEEDBACK_NOTE).optional(),
-  conversationId: z8.string().min(1).max(64).optional().nullable()
+  priority: z9.enum(FEEDBACK_PRIORITIES).default("nice_to_have"),
+  note: z9.string().trim().max(MAX_FEEDBACK_NOTE).optional(),
+  conversationId: z9.string().min(1).max(64).optional().nullable()
 });
-var FeedbackFollowSchema = z8.object({ ...visitor, follow: z8.boolean() });
-var FeedbackCommentSchema = z8.object({ ...visitor, body: z8.string().trim().min(1).max(MAX_FEEDBACK_COMMENT) });
-var FeedbackSimilarSchema = z8.object({ ...visitor, title: z8.string().trim().min(3).max(MAX_FEEDBACK_TITLE) });
-var FeedbackUpdatesReadSchema = z8.object({ ...visitor, ids: z8.array(z8.string().min(1).max(64)).max(100).optional() });
+var FeedbackFollowSchema = z9.object({ ...visitor, follow: z9.boolean() });
+var FeedbackCommentSchema = z9.object({ ...visitor, body: z9.string().trim().min(1).max(MAX_FEEDBACK_COMMENT) });
+var FeedbackSimilarSchema = z9.object({ ...visitor, title: z9.string().trim().min(3).max(MAX_FEEDBACK_TITLE) });
+var FeedbackUpdatesReadSchema = z9.object({ ...visitor, ids: z9.array(z9.string().min(1).max(64)).max(100).optional() });
 
 // src/capture.ts
-import { z as z9 } from "zod";
-var AutocaptureSettingsSchema = z9.object({ pageviews: z9.boolean(), pageLeave: z9.boolean(), clicks: z9.boolean(), rageClicks: z9.boolean(), heatmaps: z9.boolean(), mouseMovement: z9.boolean(), appLifecycle: z9.boolean() }).partial();
-var ErrorTrackingSettingsSchema = z9.object({ enabled: z9.boolean() }).partial();
-var ReplaySettingsSchema = z9.object({
-  enabled: z9.boolean(),
-  sampleRate: z9.number().int().min(0).max(100),
-  recordConsole: z9.boolean(),
-  recordNetwork: z9.boolean(),
-  recordNetworkPayloads: z9.boolean(),
-  maskAllText: z9.boolean(),
-  blockSelectors: z9.array(z9.string().min(1).max(200)).max(50),
-  retentionDays: z9.number().int().min(1).max(365)
+import { z as z10 } from "zod";
+var AutocaptureSettingsSchema = z10.object({ pageviews: z10.boolean(), pageLeave: z10.boolean(), clicks: z10.boolean(), rageClicks: z10.boolean(), heatmaps: z10.boolean(), mouseMovement: z10.boolean(), appLifecycle: z10.boolean() }).partial();
+var ErrorTrackingSettingsSchema = z10.object({ enabled: z10.boolean() }).partial();
+var PerformanceSettingsSchema = z10.object({ enabled: z10.boolean(), sampleRate: z10.number().min(0).max(100) }).partial();
+var ReplaySettingsSchema = z10.object({
+  enabled: z10.boolean(),
+  sampleRate: z10.number().int().min(0).max(100),
+  recordConsole: z10.boolean(),
+  recordNetwork: z10.boolean(),
+  recordNetworkPayloads: z10.boolean(),
+  maskAllText: z10.boolean(),
+  blockSelectors: z10.array(z10.string().min(1).max(200)).max(50),
+  retentionDays: z10.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 : {};
@@ -821,25 +913,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 = z9.object({
-  sessionId: z9.string().min(1).max(128),
-  windowId: z9.string().min(1).max(64),
-  seq: z9.number().int().min(0).max(1e6),
-  anonymousId: z9.string().min(1).max(128),
-  userId: z9.string().max(256).optional().nullable(),
+var ReplayChunkSchema = z10.object({
+  sessionId: z10.string().min(1).max(128),
+  windowId: z10.string().min(1).max(64),
+  seq: z10.number().int().min(0).max(1e6),
+  anonymousId: z10.string().min(1).max(128),
+  userId: z10.string().max(256).optional().nullable(),
   /** rrweb `eventWithTime` objects, in order. */
-  events: z9.array(z9.object({ type: z9.number().int(), timestamp: z9.number() }).passthrough()).min(1).max(5e4),
-  url: z9.string().max(2e3).optional(),
-  device: z9.object({ type: z9.string().max(20), browser: z9.string().max(40).optional(), os: z9.string().max(40).optional() }).optional(),
-  viewport: z9.object({ width: z9.number().int().min(0).max(1e5), height: z9.number().int().min(0).max(1e5) }).optional(),
-  sdk: z9.object({ name: z9.string().max(60), version: z9.string().max(30) }).optional()
+  events: z10.array(z10.object({ type: z10.number().int(), timestamp: z10.number() }).passthrough()).min(1).max(5e4),
+  url: z10.string().max(2e3).optional(),
+  device: z10.object({ type: z10.string().max(20), browser: z10.string().max(40).optional(), os: z10.string().max(40).optional() }).optional(),
+  viewport: z10.object({ width: z10.number().int().min(0).max(1e5), height: z10.number().int().min(0).max(1e5) }).optional(),
+  sdk: z10.object({ name: z10.string().max(60), version: z10.string().max(30) }).optional(),
+  /** The app's version (`appVersion` SDK option); recordings can be filtered by it. */
+  appVersion: z10.string().max(200).optional()
 });
 var REPLAY_MAX_COMPRESSED_BYTES = 2 * 1024 * 1024;
 var REPLAY_MAX_RAW_BYTES = 16 * 1024 * 1024;
@@ -1023,39 +1119,39 @@ function templateConfig(id2) {
 }
 
 // src/howto.ts
-import { z as z10 } from "zod";
+import { z as z11 } from "zod";
 var HOWTO_STEP_KINDS = ["action", "text", "heading", "tip", "alert"];
 var HOWTO_ACTIONS = ["click", "type", "select", "navigate"];
-var NormalizedRectSchema = z10.object({
-  x: z10.number().min(0).max(1),
-  y: z10.number().min(0).max(1),
-  width: z10.number().min(0).max(1),
-  height: z10.number().min(0).max(1)
+var NormalizedRectSchema = z11.object({
+  x: z11.number().min(0).max(1),
+  y: z11.number().min(0).max(1),
+  width: z11.number().min(0).max(1),
+  height: z11.number().min(0).max(1)
 });
-var CapturedElementSchema = z10.object({
+var CapturedElementSchema = z11.object({
   /** Visible name: aria-label, associated label, text, placeholder, alt or title. */
-  label: z10.string().max(200).default(""),
+  label: z11.string().max(200).default(""),
   /** button, link, tab, menuitem, checkbox, radio, field, dropdown, option, element… */
-  role: z10.string().max(40).default("element"),
-  tag: z10.string().max(40).default("")
+  role: z11.string().max(40).default("element"),
+  tag: z11.string().max(40).default("")
 });
-var CaptureStepSchema = z10.object({
+var CaptureStepSchema = z11.object({
   /** Random id from the SDK; a retried upload with the same id is stored once. */
-  clientId: z10.string().min(1).max(64),
-  action: z10.enum(HOWTO_ACTIONS),
-  url: z10.string().max(2e3),
-  pageTitle: z10.string().max(300).default(""),
+  clientId: z11.string().min(1).max(64),
+  action: z11.enum(HOWTO_ACTIONS),
+  url: z11.string().max(2e3),
+  pageTitle: z11.string().max(300).default(""),
   element: CapturedElementSchema.optional(),
   /** Typed text or chosen option; absent when it was sensitive (`valueRedacted`). */
-  value: z10.string().max(200).optional(),
-  valueRedacted: z10.boolean().default(false),
+  value: z11.string().max(200).optional(),
+  valueRedacted: z11.boolean().default(false),
   /** Selectors for the element, so the step can later become an interactive tour step. */
-  selectors: z10.array(SelectorStrategySchema).max(10).default([]),
+  selectors: z11.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: z10.number().int().min(0).max(1e3).default(0),
-  occurredAt: z10.string().datetime().optional()
+  redactions: z11.number().int().min(0).max(1e3).default(0),
+  occurredAt: z11.string().datetime().optional()
 });
 function quoted(s) {
   const t = (s ?? "").replace(/\s+/g, " ").trim();
@@ -1126,12 +1222,12 @@ function hostAndPath(url) {
     return url.slice(0, 80);
   }
 }
-var NormalizedPointSchema = z10.object({ x: z10.number().min(0).max(1), y: z10.number().min(0).max(1) });
+var NormalizedPointSchema = z11.object({ x: z11.number().min(0).max(1), y: z11.number().min(0).max(1) });
 var ANNOTATION_COLORS = ["brand", "red", "amber", "green", "black", "white"];
-var HowToAnnotationSchema = z10.discriminatedUnion("type", [
-  z10.object({ id: z10.string().min(1).max(32), type: z10.literal("arrow"), from: NormalizedPointSchema, to: NormalizedPointSchema, color: z10.enum(ANNOTATION_COLORS).default("brand") }),
-  z10.object({ id: z10.string().min(1).max(32), type: z10.literal("text"), at: NormalizedPointSchema, text: z10.string().trim().min(1).max(120), color: z10.enum(ANNOTATION_COLORS).default("brand") }),
-  z10.object({ id: z10.string().min(1).max(32), type: z10.literal("box"), rect: NormalizedRectSchema, color: z10.enum(ANNOTATION_COLORS).default("brand") })
+var HowToAnnotationSchema = z11.discriminatedUnion("type", [
+  z11.object({ id: z11.string().min(1).max(32), type: z11.literal("arrow"), from: NormalizedPointSchema, to: NormalizedPointSchema, color: z11.enum(ANNOTATION_COLORS).default("brand") }),
+  z11.object({ id: z11.string().min(1).max(32), type: z11.literal("text"), at: NormalizedPointSchema, text: z11.string().trim().min(1).max(120), color: z11.enum(ANNOTATION_COLORS).default("brand") }),
+  z11.object({ id: z11.string().min(1).max(32), type: z11.literal("box"), rect: NormalizedRectSchema, color: z11.enum(ANNOTATION_COLORS).default("brand") })
 ]);
 var MAX_ANNOTATIONS = 30;
 
@@ -1159,6 +1255,16 @@ var SCRIPT_STUB_METHODS = [
   "openComplaint",
   "openIdeas",
   "captureException",
+  "captureFeedback",
+  "showBugReport",
+  "captureMessage",
+  "addBreadcrumb",
+  "setTag",
+  "setTags",
+  "setExtra",
+  "setExtras",
+  "setContext",
+  "setUser",
   "agentConversation",
   "trackAgentTurn",
   "on"
@@ -1276,7 +1382,7 @@ function parseTranslationCsv(text) {
 
 // src/index.ts
 var SDK_API_VERSION = "v1";
-var SHARED_VERSION = "0.15.0";
+var SHARED_VERSION = "0.17.0";
 export {
   ADVANCE_ON,
   AGENT_METADATA_MAX_BYTES,
@@ -1289,6 +1395,7 @@ export {
   AGENT_TURN_ROLES,
   ANNOTATION_COLORS,
   APP_LIFECYCLE_EVENTS,
+  ARTICLE_HREF_PREFIX,
   ARTICLE_VISIBILITIES,
   AUTOCAPTURE_EVENTS,
   AgentEventsRequestSchema,
@@ -1299,6 +1406,7 @@ export {
   AuthoringPickSchema,
   AutocaptureSettingsSchema,
   BUTTON_ACTIONS,
+  BugReportSchema,
   ButtonSchema,
   CAPTURE_PARAM,
   CAPTURE_SCREENSHOT_MAX_BYTES,
@@ -1364,6 +1472,10 @@ export {
   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,
@@ -1371,6 +1483,13 @@ export {
   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,
@@ -1398,11 +1517,13 @@ export {
   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,
@@ -1452,6 +1573,8 @@ export {
   WS_MAX_MESSAGES_PER_SOCKET,
   WS_MAX_MESSAGE_BYTES,
   applyGuideTranslations,
+  articleHref,
+  articleIdFromHref,
   articleTextEntries,
   assignGuideVariant,
   baseLanguage,
@@ -1464,11 +1587,13 @@ export {
   contrastIssues,
   contrastRatio,
   cssSelectorError,
+  customFingerprint,
   defaultGuideConfig,
   defaultStep,
   describeCaptureStep,
   describeRule,
   emptyRuleGroup,
+  errorFilterDrops,
   evaluateRule,
   evaluateRules,
   evenWeights,
@@ -1498,6 +1623,7 @@ export {
   isRuleGroup,
   isSafeMediaUrl,
   isVideoContentType,
+  isVideoFileUrl,
   localeName,
   localizeAnnouncement,
   localizeArticle,
@@ -1510,10 +1636,12 @@ export {
   mediaKind,
   mediaMaxBytes,
   needsReview,
+  normalizeAppVersion,
   normalizeErrorMessage,
   normalizeFrameFile,
   normalizeLocale,
   normalizeSnapshot,
+  normalizeTags,
   orderedModules,
   pageLabel,
   pageName,
@@ -1531,7 +1659,9 @@ export {
   propertyAttributeAllowed,
   queryConditionRegex,
   randomId,
+  reactNativeBundleUrl,
   readableTextOn,
+  recordingLevel,
   relativeLuminance,
   resolveCaptureSettings,
   resolveLocale,
@@ -1552,6 +1682,7 @@ export {
   slugify,
   snapshotFromSelector,
   stableStringify,
+  stepVideo,
   stripOrigin,
   supportsPlatform,
   templateConfig,
@@ -1559,16 +1690,19 @@ export {
   toTranslationCsv,
   toXliff,
   translationCoverage,
+  trimExceptionDetail,
   unreadAnnouncements,
   validateGuideConfig,
   variantProblems,
   variantRanges,
+  videoThumbnailUrl,
   visibleAnnouncements,
   visibleArticleIds,
   visibleButtons,
   visitorAudiences,
   visitorLocales,
   withExperimentBucket,
+  withRecordingLevel,
   withVisibility
 };
 //# sourceMappingURL=index.js.map