@guidelytech/shared 0.16.0 → 0.17.0

package/dist/index.js

@@ -29,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,
@@ -36,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,
@@ -89,8 +100,10 @@ import {
   contrastIssues,
   contrastRatio,
   cssSelectorError,
+  customFingerprint,
   describeRule,
   emptyRuleGroup,
+  errorFilterDrops,
   evaluateRule,
   evaluateRules,
   evenWeights,
@@ -132,10 +145,12 @@ import {
   mediaKind,
   mediaMaxBytes,
   needsReview,
+  normalizeAppVersion,
   normalizeErrorMessage,
   normalizeFrameFile,
   normalizeLocale,
   normalizeSnapshot,
+  normalizeTags,
   orderedModules,
   pageLabel,
   pagePattern,
@@ -149,6 +164,7 @@ import {
   propertyAttributeAllowed,
   queryConditionRegex,
   randomId,
+  reactNativeBundleUrl,
   readableTextOn,
   relativeLuminance,
   resolveLocale,
@@ -173,6 +189,7 @@ import {
   supportsPlatform,
   toEmbedUrl,
   translationCoverage,
+  trimExceptionDetail,
   unreadAnnouncements,
   variantProblems,
   variantRanges,
@@ -183,7 +200,7 @@ import {
   visitorLocales,
   withExperimentBucket,
   withVisibility
-} from "./chunk-7PWYIAJI.js";
+} from "./chunk-YL65O3FS.js";
 
 // src/targeting.ts
 import { z } from "zod";
@@ -557,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),
@@ -572,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.string(), 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),
@@ -690,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)) {
@@ -712,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)) {
@@ -745,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"];
@@ -773,58 +833,60 @@ 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"];
@@ -851,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;
@@ -1053,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();
@@ -1156,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;
 
@@ -1189,6 +1255,16 @@ var SCRIPT_STUB_METHODS = [
   "openComplaint",
   "openIdeas",
   "captureException",
+  "captureFeedback",
+  "showBugReport",
+  "captureMessage",
+  "addBreadcrumb",
+  "setTag",
+  "setTags",
+  "setExtra",
+  "setExtras",
+  "setContext",
+  "setUser",
   "agentConversation",
   "trackAgentTurn",
   "on"
@@ -1306,7 +1382,7 @@ function parseTranslationCsv(text) {
 
 // src/index.ts
 var SDK_API_VERSION = "v1";
-var SHARED_VERSION = "0.16.0";
+var SHARED_VERSION = "0.17.0";
 export {
   ADVANCE_ON,
   AGENT_METADATA_MAX_BYTES,
@@ -1330,6 +1406,7 @@ export {
   AuthoringPickSchema,
   AutocaptureSettingsSchema,
   BUTTON_ACTIONS,
+  BugReportSchema,
   ButtonSchema,
   CAPTURE_PARAM,
   CAPTURE_SCREENSHOT_MAX_BYTES,
@@ -1395,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,
@@ -1402,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,
@@ -1429,6 +1517,7 @@ export {
   PDF_PAGES_CLASS,
   PLACEMENTS,
   PLATFORMS,
+  PerformanceSettingsSchema,
   PostMessageSchema,
   ProjectThemeSchema,
   PublishedGuideSchema,
@@ -1498,11 +1587,13 @@ export {
   contrastIssues,
   contrastRatio,
   cssSelectorError,
+  customFingerprint,
   defaultGuideConfig,
   defaultStep,
   describeCaptureStep,
   describeRule,
   emptyRuleGroup,
+  errorFilterDrops,
   evaluateRule,
   evaluateRules,
   evenWeights,
@@ -1545,10 +1636,12 @@ export {
   mediaKind,
   mediaMaxBytes,
   needsReview,
+  normalizeAppVersion,
   normalizeErrorMessage,
   normalizeFrameFile,
   normalizeLocale,
   normalizeSnapshot,
+  normalizeTags,
   orderedModules,
   pageLabel,
   pageName,
@@ -1566,6 +1659,7 @@ export {
   propertyAttributeAllowed,
   queryConditionRegex,
   randomId,
+  reactNativeBundleUrl,
   readableTextOn,
   recordingLevel,
   relativeLuminance,
@@ -1596,6 +1690,7 @@ export {
   toTranslationCsv,
   toXliff,
   translationCoverage,
+  trimExceptionDetail,
   unreadAnnouncements,
   validateGuideConfig,
   variantProblems,