@guidelytech/shared 0.10.0 → 0.12.0

package/dist/index.js

@@ -1,14 +1,31 @@
 import {
+  AGENT_METADATA_MAX_BYTES,
+  AGENT_METADATA_MAX_KEYS,
+  AGENT_OUTCOMES,
+  AGENT_TOOL_CALLS_PER_TURN,
+  AGENT_TOOL_STATUSES,
+  AGENT_TURNS_PER_BATCH,
+  AGENT_TURN_MAX_TEXT,
+  AGENT_TURN_ROLES,
   ARTICLE_VISIBILITIES,
   CAPTURE_PARAM,
   CAPTURE_SCREENSHOT_MAX_BYTES,
+  COMMON_LOCALES,
   COMPLAINT_EVENTS,
   COMPLAINT_FIELD_TYPES,
   COMPLAINT_STATUSES,
+  CONTROL_VARIANT_ID,
+  DEFAULT_FEATURE_ATTRIBUTE,
+  DEFAULT_LOCALE,
   DEFAULT_PLATFORMS,
   EMBED_IFRAME_ATTRS,
+  FEATURE_ATTRIBUTE_PATTERN,
+  FEATURE_RULE_LIMITS,
   FILE_LINK_CLASS,
   GUIDELY_ID_ATTRIBUTE,
+  GUIDE_EXPERIMENT_GOALS,
+  GUIDE_EXPERIMENT_GOAL_LABELS,
+  GUIDE_EXPERIMENT_STATUSES,
   GUIDE_VISIBILITIES,
   LOGGED_IN_AUDIENCE,
   MAX_COLLECTION_DEPTH,
@@ -17,6 +34,7 @@ import {
   MAX_COMPLAINT_CHOICES,
   MAX_COMPLAINT_FIELDS,
   MAX_COMPLAINT_LENGTH,
+  MAX_CUSTOM_CSS,
   MAX_PROPERTY_BYTES,
   MAX_STACK_FRAMES,
   MEDIA_FILE_MAX_BYTES,
@@ -27,38 +45,65 @@ import {
   MEDIA_VIDEO_MAX_BYTES,
   MEDIA_VIDEO_TYPES,
   NETWORK_PLUGIN,
+  NOISY_DATA_ATTR,
+  PAGE_RULE_LIMITS,
   PATH_ID_PATTERN,
   PDF_BLOCK_CLASS,
   PDF_MAX_PAGES,
   PDF_PAGES_CLASS,
   PLATFORMS,
+  RC_MODULE_IDS,
+  RC_MODULE_LABELS,
   RULE_FIELDS,
   RULE_OPERATORS,
+  SCOUT_AGENT_ID,
   SENSITIVE_HEADER_PATTERN,
   SENSITIVE_PARAM_PATTERN,
   SENSITIVE_PROPERTY_PATTERN,
   SERVER_ASSISTED_FIELDS,
   SHOW_ME_CLASS,
   SHOW_ME_HREF_PREFIX,
+  SNAPSHOT_ATTRS,
+  SNAPSHOT_LIMITS,
   SOURCEMAP_MAX_FILES_PER_UPLOAD,
   SOURCEMAP_MAX_FILE_BYTES,
+  SelectorSyntaxError,
+  TAG_PROPERTY_LIMITS,
   VIDEO_ATTRS,
+  WCAG_AA_LARGE,
+  WCAG_AA_TEXT,
   WS_MAX_MESSAGES_PER_SOCKET,
   WS_MAX_MESSAGE_BYTES,
+  applyGuideTranslations,
+  articleTextEntries,
+  assignGuideVariant,
+  baseLanguage,
   clamp,
   compare,
   compareVersions,
   complaintReference,
+  compoundMatches,
+  contrastIssues,
+  contrastRatio,
+  cssSelectorError,
   describeRule,
   emptyRuleGroup,
   evaluateRule,
   evaluateRules,
+  evenWeights,
+  experimentBucketRules,
+  experimentSalt,
+  featureCssSelectors,
+  featureRuleError,
+  featureRuleMatchesClick,
   fingerprintError,
   firstNameFromTraits,
   fnv1a,
   foldPathIds,
   getPath,
+  guideLocales,
   guidePlatforms,
+  guideTextEntries,
   guidelyIdFromSelector,
   hasVideoMedia,
   isAllowedEmbedSrc,
@@ -71,34 +116,68 @@ import {
   isRuleGroup,
   isSafeMediaUrl,
   isVideoContentType,
+  localeName,
+  localizeAnnouncement,
+  localizeArticle,
+  localizeGuide,
+  localizeResourceCenter,
+  matchCssSelector,
   matchUrlPattern,
   matchesAudiences,
   matchesHelpQuery,
   mediaKind,
   mediaMaxBytes,
+  needsReview,
   normalizeErrorMessage,
   normalizeFrameFile,
+  normalizeLocale,
+  normalizeSnapshot,
+  orderedModules,
   pageLabel,
+  pagePattern,
+  pageRuleError,
+  pageRuleMatches,
+  pageRulesMatch,
   pageTerms,
+  parseCssSelector,
+  parseHexColor,
   parseStack,
+  propertyAttributeAllowed,
+  queryConditionRegex,
   randomId,
+  readableTextOn,
+  relativeLuminance,
+  resolveLocale,
+  resourceCenterLocales,
   resourceCenterSections,
+  resourceCenterTextEntries,
   rolloutBucket,
   safeRegExp,
+  sanitizeCustomCss,
   sanitizeProperties,
+  scopeCustomCss,
   screenPath,
   servedArticleAudiences,
   showMeHref,
   showMeKeyFromHref,
   showMeKeys,
   slugify,
+  snapshotFromSelector,
+  stableStringify,
   stripOrigin,
   supportsPlatform,
   toEmbedUrl,
+  translationCoverage,
+  unreadAnnouncements,
+  variantProblems,
+  variantRanges,
+  visibleAnnouncements,
   visibleArticleIds,
   visitorAudiences,
+  visitorLocales,
+  withExperimentBucket,
   withVisibility
-} from "./chunk-UW6NRYRY.js";
+} from "./chunk-XJXXVV3C.js";
 
 // src/targeting.ts
 import { z } from "zod";
@@ -169,6 +248,8 @@ var StepSchema = z2.object({
   /** Sanitized HTML body (links, images, lists, formatting). */
   body: z2.string().max(2e4).default(""),
   imageUrl: z2.string().url().max(2e3).optional().or(z2.literal("")),
+  /** Alternative text for `imageUrl` (screen readers); empty = decorative. */
+  imageAlt: z2.string().max(300).optional(),
   buttons: z2.array(ButtonSchema).max(6).default([]),
   target: TargetSchema.optional(),
   placement: z2.enum(PLACEMENTS).default("auto"),
@@ -195,7 +276,12 @@ var StepSchema = z2.object({
   /** Hotspot pulse dot settings. */
   hotspot: z2.object({ size: z2.number().int().min(8).max(40).default(14), pulse: z2.boolean().default(true), openOn: z2.enum(["click", "hover"]).default("click") }).optional(),
   /** Custom step: arbitrary sanitized HTML with no chrome. */
-  customHtml: z2.string().max(5e4).optional()
+  customHtml: z2.string().max(5e4).optional(),
+  /**
+   * Code block (custom steps only): JavaScript run on the web when the step shows, only while the
+   * workspace allows code blocks (an admin setting, off by default). Mobile SDKs never receive it.
+   */
+  code: z2.string().max(2e4).optional()
 });
 var TRIGGER_TYPES = ["page_load", "url_match", "event", "element_click", "element_visible", "manual", "delay", "after_guide", "segment_enter"];
 var TriggerSchema = z2.object({
@@ -217,7 +303,9 @@ var FrequencySchema = z2.object({
   /** Guide ids that must not be active at the same time. */
   mutuallyExclusiveWith: z2.array(z2.string()).max(50).default([]),
   /** Re-show if dismissed (otherwise dismissal counts as completion for frequency). */
-  reshowAfterDismiss: z2.boolean().default(false)
+  reshowAfterDismiss: z2.boolean().default(false),
+  /** Bypass the project's guide throttling (always eligible as far as throttling goes). */
+  ignoreThrottling: z2.boolean().optional()
 });
 var AppearanceSchema = z2.object({
   theme: z2.enum(["light", "dark", "auto"]).default("auto"),
@@ -229,7 +317,9 @@ var AppearanceSchema = z2.object({
   overlayOpacity: z2.number().min(0).max(1).optional(),
   zIndex: z2.number().int().min(1).max(2147483647).optional(),
   preset: z2.string().max(50).optional(),
-  animation: z2.enum(["fade", "slide", "none"]).default("fade")
+  animation: z2.enum(["fade", "slide", "none"]).default("fade"),
+  /** Custom CSS scoped to this guide's container (sanitized; see custom-css.ts). Web only. */
+  customCss: z2.string().max(2e4).optional()
 });
 var ChecklistTaskSchema = z2.object({
   id: z2.string().min(1),
@@ -276,6 +366,30 @@ var SurveyConfigSchema = z2.object({
   startAt: z2.string().datetime().optional(),
   endAt: z2.string().datetime().optional()
 });
+var GuideScheduleSchema = z2.object({
+  startAt: z2.string().datetime().optional(),
+  endAt: z2.string().datetime().optional(),
+  timezone: z2.string().max(64).optional()
+});
+var LOCALE_PATTERN = /^[a-zA-Z]{2,3}(-[a-zA-Z0-9]{2,8}){0,2}$/;
+var LocaleSchema = z2.string().regex(LOCALE_PATTERN, "Use a language code such as fr or pt-BR").max(20);
+var GuideLocalizationSchema = z2.object({
+  translations: z2.record(LocaleSchema, z2.record(z2.string().max(200), z2.string().max(5e4))).default({})
+});
+var LocalizationSettingsSchema = z2.object({
+  defaultLocale: LocaleSchema.default("en"),
+  locales: z2.array(LocaleSchema).max(50).default([]),
+  /** Machine-translate new and changed text into every language automatically (needs an Anthropic key). */
+  autoTranslate: z2.boolean().optional(),
+  /** Machine translations go live only once a teammate approves them; until then visitors see the default language. */
+  requireReview: z2.boolean().optional()
+});
+var GuideThrottlingSchema = z2.object({
+  enabled: z2.boolean().default(false),
+  maxGuides: z2.number().int().min(1).max(50).default(1),
+  windowHours: z2.number().int().min(1).max(720).default(24),
+  minGapMinutes: z2.number().int().min(0).max(10080).default(0)
+});
 var GuideConfigSchema = z2.object({
   steps: z2.array(StepSchema).max(50).default([]),
   /** Everyone, only identified (logged-in) users, or only anonymous visitors; applied on top of `targeting`. */
@@ -289,7 +403,11 @@ var GuideConfigSchema = z2.object({
   /** Restrict guide to url pattern(s) (applied before trigger). On mobile these match the screen path `/<Screen>`. */
   urlPatterns: z2.array(z2.string().max(500)).max(20).default([]),
   /** Platforms that receive this guide. Guides created before mobile support are web-only. */
-  platforms: z2.array(z2.enum(PLATFORMS)).max(PLATFORMS.length).default(["web"])
+  platforms: z2.array(z2.enum(PLATFORMS)).max(PLATFORMS.length).default(["web"]),
+  /** Start / end window for any guide kind (surveys also honour `survey.startAt` / `endAt`). */
+  schedule: GuideScheduleSchema.optional(),
+  /** Translations (see localization.ts). */
+  localization: GuideLocalizationSchema.optional()
 });
 function defaultGuideConfig(kind) {
   return GuideConfigSchema.parse({
@@ -323,7 +441,7 @@ function defaultStep(type, overrides = {}) {
 function visibleButtons(step, canGoBack) {
   return canGoBack ? step.buttons : step.buttons.filter((b) => b.action !== "back");
 }
-function validateGuideConfig(kind, config) {
+function validateGuideConfig(kind, config, theme) {
   const issues = [];
   if (kind === "checklist") {
     if (!config.checklist || config.checklist.tasks.length === 0) issues.push({ level: "error", message: "Checklist needs at least one task." });
@@ -360,6 +478,15 @@ function validateGuideConfig(kind, config) {
   if (config.trigger.type === "element_click" && !config.trigger.value) issues.push({ level: "error", message: "Element click trigger needs a selector." });
   if (config.trigger.type === "url_match" && !config.trigger.value) issues.push({ level: "error", message: "URL trigger needs a pattern." });
   if (config.frequency.mode === "interval" && !config.frequency.intervalHours) issues.push({ level: "error", message: "Interval frequency needs an interval in hours." });
+  const sched = config.schedule;
+  if (sched?.startAt && sched.endAt && Date.parse(sched.endAt) <= Date.parse(sched.startAt)) issues.push({ level: "error", message: "The schedule ends before it starts." });
+  if (sched?.endAt && Date.parse(sched.endAt) < Date.now()) issues.push({ level: "warning", message: "The schedule has already ended, so nobody will see this guide." });
+  config.steps.forEach((step, i) => {
+    if (step.code && step.type !== "custom") issues.push({ level: "error", stepId: step.id, message: `Step ${i + 1}: code blocks can only run in custom steps.` });
+    if (step.code && mobile) issues.push({ level: "warning", stepId: step.id, message: `Step ${i + 1} runs a code block; mobile apps skip it.` });
+  });
+  const colors = { primaryColor: config.appearance.primaryColor ?? theme?.primaryColor, backgroundColor: config.appearance.backgroundColor ?? theme?.backgroundColor, textColor: config.appearance.textColor ?? theme?.textColor };
+  for (const c of contrastIssues(colors)) issues.push({ level: "warning", message: `Low contrast: ${c.message}` });
   return issues;
 }
 var ProjectThemeSchema = z2.object({
@@ -369,7 +496,9 @@ var ProjectThemeSchema = z2.object({
   borderRadius: z2.number().int().min(0).max(32).default(12),
   fontFamily: z2.string().max(200).default("Inter, system-ui, -apple-system, sans-serif"),
   logoUrl: z2.string().max(2e3).optional(),
-  brandName: z2.string().max(100).optional()
+  brandName: z2.string().max(100).optional(),
+  /** Custom CSS applied to every guide's container (sanitized and scoped like guide CSS). Web only. */
+  customCss: z2.string().max(2e4).optional()
 });
 
 // src/events.ts
@@ -405,9 +534,15 @@ var EVENT_NAMES = [
   "exception",
   "heatmap",
   // Feature flags: a user was bucketed into an experiment variation (properties: experimentKey, variationId, flagKey).
-  "experiment_viewed"
+  "experiment_viewed",
+  // Mobile app lifecycle (mobile/SPEC.md "Product analytics"): installs, updates, opens and backgrounding.
+  "app_install",
+  "app_update",
+  "app_open",
+  "app_background"
 ];
-var AUTOCAPTURE_EVENTS = ["page_view", "page_leave", "click", "rage_click", "exception", "heatmap"];
+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 SdkEventSchema = z3.object({
   eventId: z3.string().min(8).max(64),
@@ -475,7 +610,9 @@ var AuthoringPickSchema = z4.object({
   selectors: z4.array(z4.object({ kind: z4.string(), value: z4.string().max(1e3), label: z4.string().max(200).optional() })).max(10),
   textSnapshot: z4.string().max(200).optional(),
   url: z4.string().max(2e3).optional(),
-  rect: z4.object({ x: z4.number(), y: z4.number(), width: z4.number(), height: z4.number() }).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()
 });
 var PublishedGuideSchema = z4.object({
   id: z4.string(),
@@ -540,22 +677,140 @@ var FileComplaintSchema = z6.object({
   }).optional().nullable()
 });
 
-// src/capture.ts
+// src/agents.ts
 import { z as z7 } from "zod";
-var AutocaptureSettingsSchema = z7.object({ pageviews: z7.boolean(), pageLeave: z7.boolean(), clicks: z7.boolean(), rageClicks: z7.boolean(), heatmaps: z7.boolean(), mouseMovement: z7.boolean() }).partial();
-var ErrorTrackingSettingsSchema = z7.object({ enabled: z7.boolean() }).partial();
-var ReplaySettingsSchema = z7.object({
-  enabled: z7.boolean(),
-  sampleRate: z7.number().int().min(0).max(100),
-  recordConsole: z7.boolean(),
-  recordNetwork: z7.boolean(),
-  recordNetworkPayloads: z7.boolean(),
-  maskAllText: z7.boolean(),
-  blockSelectors: z7.array(z7.string().min(1).max(200)).max(50),
-  retentionDays: z7.number().int().min(1).max(365)
+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()
+}).strip();
+var AgentMetadataSchema = z7.record(z7.string().max(100), z7.unknown()).transform((m) => {
+  const out = {};
+  let size = 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;
+    out[key] = value;
+  }
+  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(),
+  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(),
+  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(
+  (v) => {
+    if (Array.isArray(v)) return { turns: v };
+    if (v && typeof v === "object" && !("turns" in v)) {
+      const { environment, ...turn } = v;
+      return { turns: [turn], environment };
+    }
+    return v;
+  },
+  z7.object({ turns, environment: z7.enum(ENVIRONMENTS).default("production"), sdk: sdkInfo })
+);
+
+// src/feedback.ts
+import { z as z8 } from "zod";
+
+// src/feedback-limits.ts
+var FEEDBACK_STATUSES = ["new", "under_review", "planned", "in_progress", "released", "declined"];
+var FEEDBACK_STATUS_LABEL = {
+  new: "New",
+  under_review: "Under review",
+  planned: "Planned",
+  in_progress: "In progress",
+  released: "Released",
+  declined: "Declined"
+};
+var FEEDBACK_PRIORITIES = ["nice_to_have", "important", "critical"];
+var FEEDBACK_PRIORITY_LABEL = { nice_to_have: "Nice to have", important: "Important", critical: "Critical" };
+var FEEDBACK_PRIORITY_WEIGHT = { nice_to_have: 1, important: 2, critical: 3 };
+var FEEDBACK_EVENTS = ["request.created", "request.status_changed", "request.voted"];
+var MAX_FEEDBACK_TITLE = 140;
+var MAX_FEEDBACK_DESCRIPTION = 4e3;
+var MAX_FEEDBACK_COMMENT = 2e3;
+var MAX_FEEDBACK_NOTE = 500;
+var feedbackReference = (number) => `#${number}`;
+
+// src/feedback.ts
+var visitor = {
+  anonymousId: z8.string().min(1).max(128),
+  userId: z8.string().max(256).optional().nullable()
+};
+var FeedbackListRequestSchema = z8.object({
+  ...visitor,
+  q: z8.string().trim().max(200).optional(),
+  sort: z8.enum(["top", "new", "trending"]).default("top"),
+  status: z8.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)
+});
+var FeedbackVisitorSchema = z8.object(visitor);
+var SubmitFeedbackSchema = z8.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"),
+  /** Filed from this Scout conversation (Scout offered it). */
+  conversationId: z8.string().min(1).max(64).optional().nullable(),
+  pageUrl: z8.string().max(2e3).optional()
+});
+var FeedbackVoteSchema = z8.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()
+});
+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() });
+
+// 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)
 }).partial();
 var DEFAULT_CAPTURE_SETTINGS = {
-  autocapture: { pageviews: true, pageLeave: true, clicks: true, rageClicks: true, heatmaps: true, mouseMovement: true },
+  autocapture: { pageviews: true, pageLeave: true, clicks: true, rageClicks: true, heatmaps: true, mouseMovement: true, appLifecycle: true },
   errorTracking: { enabled: true },
   replay: { enabled: false, sampleRate: 100, recordConsole: true, recordNetwork: true, recordNetworkPayloads: false, maskAllText: false, blockSelectors: [], retentionDays: 30 }
 };
@@ -573,18 +828,18 @@ function resolveCaptureSettings(settings) {
   };
 }
 var HEATMAP_VIEWPORTS = { mobile: [0, 767], tablet: [768, 1279], desktop: [1280, 1e5] };
-var ReplayChunkSchema = z7.object({
-  sessionId: z7.string().min(1).max(128),
-  windowId: z7.string().min(1).max(64),
-  seq: z7.number().int().min(0).max(1e6),
-  anonymousId: z7.string().min(1).max(128),
-  userId: z7.string().max(256).optional().nullable(),
+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(),
   /** rrweb `eventWithTime` objects, in order. */
-  events: z7.array(z7.object({ type: z7.number().int(), timestamp: z7.number() }).passthrough()).min(1).max(5e4),
-  url: z7.string().max(2e3).optional(),
-  device: z7.object({ type: z7.string().max(20), browser: z7.string().max(40).optional(), os: z7.string().max(40).optional() }).optional(),
-  viewport: z7.object({ width: z7.number().int().min(0).max(1e5), height: z7.number().int().min(0).max(1e5) }).optional(),
-  sdk: z7.object({ name: z7.string().max(60), version: z7.string().max(30) }).optional()
+  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()
 });
 var REPLAY_MAX_COMPRESSED_BYTES = 2 * 1024 * 1024;
 var REPLAY_MAX_RAW_BYTES = 16 * 1024 * 1024;
@@ -761,46 +1016,46 @@ var GUIDE_TEMPLATES = [
     }
   }
 ];
-function templateConfig(id) {
-  const t = GUIDE_TEMPLATES.find((x) => x.id === id);
+function templateConfig(id2) {
+  const t = GUIDE_TEMPLATES.find((x) => x.id === id2);
   if (!t) return null;
   return { template: t, config: GuideConfigSchema.parse(t.config) };
 }
 
 // src/howto.ts
-import { z as z8 } from "zod";
+import { z as z10 } from "zod";
 var HOWTO_STEP_KINDS = ["action", "text", "heading", "tip", "alert"];
 var HOWTO_ACTIONS = ["click", "type", "select", "navigate"];
-var NormalizedRectSchema = z8.object({
-  x: z8.number().min(0).max(1),
-  y: z8.number().min(0).max(1),
-  width: z8.number().min(0).max(1),
-  height: z8.number().min(0).max(1)
+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 CapturedElementSchema = z8.object({
+var CapturedElementSchema = z10.object({
   /** Visible name: aria-label, associated label, text, placeholder, alt or title. */
-  label: z8.string().max(200).default(""),
+  label: z10.string().max(200).default(""),
   /** button, link, tab, menuitem, checkbox, radio, field, dropdown, option, element… */
-  role: z8.string().max(40).default("element"),
-  tag: z8.string().max(40).default("")
+  role: z10.string().max(40).default("element"),
+  tag: z10.string().max(40).default("")
 });
-var CaptureStepSchema = z8.object({
+var CaptureStepSchema = z10.object({
   /** Random id from the SDK; a retried upload with the same id is stored once. */
-  clientId: z8.string().min(1).max(64),
-  action: z8.enum(HOWTO_ACTIONS),
-  url: z8.string().max(2e3),
-  pageTitle: z8.string().max(300).default(""),
+  clientId: z10.string().min(1).max(64),
+  action: z10.enum(HOWTO_ACTIONS),
+  url: z10.string().max(2e3),
+  pageTitle: z10.string().max(300).default(""),
   element: CapturedElementSchema.optional(),
   /** Typed text or chosen option; absent when it was sensitive (`valueRedacted`). */
-  value: z8.string().max(200).optional(),
-  valueRedacted: z8.boolean().default(false),
+  value: z10.string().max(200).optional(),
+  valueRedacted: z10.boolean().default(false),
   /** Selectors for the element, so the step can later become an interactive tour step. */
-  selectors: z8.array(SelectorStrategySchema).max(10).default([]),
+  selectors: z10.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: z8.number().int().min(0).max(1e3).default(0),
-  occurredAt: z8.string().datetime().optional()
+  redactions: z10.number().int().min(0).max(1e3).default(0),
+  occurredAt: z10.string().datetime().optional()
 });
 function quoted(s) {
   const t = (s ?? "").replace(/\s+/g, " ").trim();
@@ -871,12 +1126,12 @@ function hostAndPath(url) {
     return url.slice(0, 80);
   }
 }
-var NormalizedPointSchema = z8.object({ x: z8.number().min(0).max(1), y: z8.number().min(0).max(1) });
+var NormalizedPointSchema = z10.object({ x: z10.number().min(0).max(1), y: z10.number().min(0).max(1) });
 var ANNOTATION_COLORS = ["brand", "red", "amber", "green", "black", "white"];
-var HowToAnnotationSchema = z8.discriminatedUnion("type", [
-  z8.object({ id: z8.string().min(1).max(32), type: z8.literal("arrow"), from: NormalizedPointSchema, to: NormalizedPointSchema, color: z8.enum(ANNOTATION_COLORS).default("brand") }),
-  z8.object({ id: z8.string().min(1).max(32), type: z8.literal("text"), at: NormalizedPointSchema, text: z8.string().trim().min(1).max(120), color: z8.enum(ANNOTATION_COLORS).default("brand") }),
-  z8.object({ id: z8.string().min(1).max(32), type: z8.literal("box"), rect: NormalizedRectSchema, color: z8.enum(ANNOTATION_COLORS).default("brand") })
+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 MAX_ANNOTATIONS = 30;
 
@@ -889,6 +1144,7 @@ var SCRIPT_STUB_METHODS = [
   "setAccount",
   "updateTraits",
   "setConsent",
+  "setLocale",
   "startGuide",
   "stopGuide",
   "dismissGuide",
@@ -901,7 +1157,10 @@ var SCRIPT_STUB_METHODS = [
   "closeChecklist",
   "completeChecklistTask",
   "openComplaint",
+  "openIdeas",
   "captureException",
+  "agentConversation",
+  "trackAgentTurn",
   "on"
 ];
 var SCRIPT_STUB = `!function(w){if(w.Guidely)return;var g=w.Guidely={_q:[]},c=g._c={};function q(o,k){o[k]=function(){g._q.push([o===c?1:0,k,[].slice.call(arguments)])}}q(g,"init");"${SCRIPT_STUB_METHODS.join(" ")}".split(" ").forEach(function(k){q(c,k)});c.isFeatureEnabled=function(k,f){return!!f};c.getFeatureValue=function(k,f){return f};g.get=function(){return c}}(window);`;
@@ -913,14 +1172,129 @@ function scriptSnippet(scriptUrl, initOptions) {
 <script src="${scriptUrl}" async></script>`;
 }
 
+// src/translation-files.ts
+function xmlEscape(s) {
+  return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+}
+function xmlUnescape(s) {
+  return s.replace(/<!\[CDATA\[([\s\S]*?)\]\]>/g, (_, c) => c.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;")).replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, '"').replace(/&apos;/g, "'").replace(/&#(\d+);/g, (_, d) => String.fromCodePoint(Number(d))).replace(/&#x([0-9a-f]+);/gi, (_, h) => String.fromCodePoint(parseInt(h, 16))).replace(/&amp;/g, "&");
+}
+function toXliff(units, opts) {
+  const body = units.map(
+    (u) => `      <trans-unit id="${xmlEscape(u.key)}">
+        <source>${xmlEscape(u.source)}</source>
+        <target${u.target ? "" : ' state="needs-translation"'}>${xmlEscape(u.target)}</target>${u.note ? `
+        <note>${xmlEscape(u.note)}</note>` : ""}
+      </trans-unit>`
+  ).join("\n");
+  return `<?xml version="1.0" encoding="UTF-8"?>
+<xliff version="1.2" xmlns="urn:oasis:names:tc:xliff:document:1.2">
+  <file original="${xmlEscape(opts.original)}" source-language="${xmlEscape(opts.sourceLocale)}" target-language="${xmlEscape(opts.targetLocale)}" datatype="html">
+    <body>
+${body}
+    </body>
+  </file>
+</xliff>
+`;
+}
+function parseXliff(xml) {
+  const target = xml.match(/target-language="([^"]+)"/)?.[1] ?? xml.match(/\btrgLang="([^"]+)"/)?.[1];
+  const entries = {};
+  for (const m of xml.matchAll(/<(trans-unit|unit)\b[^>]*\bid="([^"]*)"[^>]*>([\s\S]*?)<\/\1>/g)) {
+    const key = xmlUnescape(m[2]);
+    const t = m[3].match(/<target\b[^>]*>([\s\S]*?)<\/target>/);
+    const text = t ? xmlUnescape(t[1]) : "";
+    if (key && text.trim()) entries[key] = text;
+  }
+  return { targetLocale: target ? xmlUnescape(target) : void 0, entries };
+}
+function csvCell(s) {
+  return /[",\n\r]/.test(s) ? `"${s.replace(/"/g, '""')}"` : s;
+}
+function toTranslationCsv(units, targetLocale) {
+  const rows = [["key", "context", "source", targetLocale], ...units.map((u) => [u.key, u.note ?? "", u.source, u.target])];
+  return rows.map((r) => r.map(csvCell).join(",")).join("\r\n") + "\r\n";
+}
+function parseCsvRows(text) {
+  const rows = [];
+  let row = [];
+  let cell = "";
+  let quoted2 = false;
+  const src = text.replace(/^\uFEFF/, "");
+  for (let i = 0; i < src.length; i++) {
+    const ch = src[i];
+    if (quoted2) {
+      if (ch === '"') {
+        if (src[i + 1] === '"') {
+          cell += '"';
+          i++;
+        } else quoted2 = false;
+      } else cell += ch;
+    } else if (ch === '"') quoted2 = true;
+    else if (ch === ",") {
+      row.push(cell);
+      cell = "";
+    } else if (ch === "\n" || ch === "\r") {
+      if (ch === "\r" && src[i + 1] === "\n") i++;
+      row.push(cell);
+      rows.push(row);
+      row = [];
+      cell = "";
+    } else cell += ch;
+  }
+  if (cell !== "" || row.length) {
+    row.push(cell);
+    rows.push(row);
+  }
+  return rows.filter((r) => r.some((c) => c.trim() !== ""));
+}
+function parseTranslationCsv(text) {
+  const [header, ...rows] = parseCsvRows(text);
+  if (!header) return { entries: {} };
+  const names = header.map((h) => h.trim());
+  const lower = names.map((h) => h.toLowerCase());
+  const keyCol = lower.indexOf("key");
+  if (keyCol < 0) return { entries: {} };
+  let targetCol = lower.indexOf("target");
+  if (targetCol < 0) {
+    for (let i = names.length - 1; i >= 0; i--) {
+      if (!["key", "context", "source", "label", "note"].includes(lower[i])) {
+        targetCol = i;
+        break;
+      }
+    }
+  }
+  if (targetCol < 0) return { entries: {} };
+  const entries = {};
+  for (const r of rows) {
+    const key = (r[keyCol] ?? "").trim();
+    const value = r[targetCol] ?? "";
+    if (key && value.trim()) entries[key] = value;
+  }
+  return { targetLocale: lower[targetCol] === "target" ? void 0 : names[targetCol], entries };
+}
+
 // src/index.ts
 var SDK_API_VERSION = "v1";
-var SHARED_VERSION = "0.10.0";
+var SHARED_VERSION = "0.12.0";
 export {
   ADVANCE_ON,
+  AGENT_METADATA_MAX_BYTES,
+  AGENT_METADATA_MAX_KEYS,
+  AGENT_OUTCOMES,
+  AGENT_TOOL_CALLS_PER_TURN,
+  AGENT_TOOL_STATUSES,
+  AGENT_TURNS_PER_BATCH,
+  AGENT_TURN_MAX_TEXT,
+  AGENT_TURN_ROLES,
   ANNOTATION_COLORS,
+  APP_LIFECYCLE_EVENTS,
   ARTICLE_VISIBILITIES,
   AUTOCAPTURE_EVENTS,
+  AgentEventsRequestSchema,
+  AgentMetadataSchema,
+  AgentToolCallSchema,
+  AgentTurnInputSchema,
   AppearanceSchema,
   AuthoringPickSchema,
   AutocaptureSettingsSchema,
@@ -928,9 +1302,11 @@ export {
   ButtonSchema,
   CAPTURE_PARAM,
   CAPTURE_SCREENSHOT_MAX_BYTES,
+  COMMON_LOCALES,
   COMPLAINT_EVENTS,
   COMPLAINT_FIELD_TYPES,
   COMPLAINT_STATUSES,
+  CONTROL_VARIANT_ID,
   CaptureStepSchema,
   CapturedElementSchema,
   ChecklistConfigSchema,
@@ -939,28 +1315,54 @@ export {
   ConversationLookupSchema,
   ConversationRatingSchema,
   DEFAULT_CAPTURE_SETTINGS,
+  DEFAULT_FEATURE_ATTRIBUTE,
+  DEFAULT_LOCALE,
   DEFAULT_PLATFORMS,
   EMBED_IFRAME_ATTRS,
   EVENT_NAMES,
   ErrorTrackingSettingsSchema,
   EventBatchSchema,
+  FEATURE_ATTRIBUTE_PATTERN,
+  FEATURE_RULE_LIMITS,
+  FEEDBACK_EVENTS,
+  FEEDBACK_PRIORITIES,
+  FEEDBACK_PRIORITY_LABEL,
+  FEEDBACK_PRIORITY_WEIGHT,
+  FEEDBACK_STATUSES,
+  FEEDBACK_STATUS_LABEL,
   FILE_LINK_CLASS,
+  FeedbackCommentSchema,
+  FeedbackFollowSchema,
+  FeedbackListRequestSchema,
+  FeedbackSimilarSchema,
+  FeedbackUpdatesReadSchema,
+  FeedbackVisitorSchema,
+  FeedbackVoteSchema,
   FileComplaintSchema,
   FrequencySchema,
   GUIDELY_ID_ATTRIBUTE,
+  GUIDE_EXPERIMENT_GOALS,
+  GUIDE_EXPERIMENT_GOAL_LABELS,
+  GUIDE_EXPERIMENT_STATUSES,
   GUIDE_KINDS,
   GUIDE_LIFECYCLE_EVENTS,
   GUIDE_STATUSES,
   GUIDE_TEMPLATES,
   GUIDE_VISIBILITIES,
   GuideConfigSchema,
+  GuideLocalizationSchema,
+  GuideScheduleSchema,
   GuideStateUpdateSchema,
+  GuideThrottlingSchema,
   HEATMAP_VIEWPORTS,
   HOWTO_ACTIONS,
   HOWTO_STEP_KINDS,
   HowToAnnotationSchema,
   IdentifyRequestSchema,
+  LOCALE_PATTERN,
   LOGGED_IN_AUDIENCE,
+  LocaleSchema,
+  LocalizationSettingsSchema,
   MAX_ANNOTATIONS,
   MAX_COLLECTION_DEPTH,
   MAX_COMPLAINT_ANSWER_LENGTH,
@@ -968,6 +1370,11 @@ export {
   MAX_COMPLAINT_CHOICES,
   MAX_COMPLAINT_FIELDS,
   MAX_COMPLAINT_LENGTH,
+  MAX_CUSTOM_CSS,
+  MAX_FEEDBACK_COMMENT,
+  MAX_FEEDBACK_DESCRIPTION,
+  MAX_FEEDBACK_NOTE,
+  MAX_FEEDBACK_TITLE,
   MAX_MESSAGE_LENGTH,
   MAX_PROPERTY_BYTES,
   MAX_STACK_FRAMES,
@@ -981,8 +1388,10 @@ export {
   MESSAGE_AUTHORS,
   MessengerPageRequestSchema,
   NETWORK_PLUGIN,
+  NOISY_DATA_ATTR,
   NormalizedPointSchema,
   NormalizedRectSchema,
+  PAGE_RULE_LIMITS,
   PATH_ID_PATTERN,
   PDF_BLOCK_CLASS,
   PDF_MAX_PAGES,
@@ -992,6 +1401,8 @@ export {
   PostMessageSchema,
   ProjectThemeSchema,
   PublishedGuideSchema,
+  RC_MODULE_IDS,
+  RC_MODULE_LABELS,
   REPLAY_MAX_COMPRESSED_BYTES,
   REPLAY_MAX_RAW_BYTES,
   REPLY_TIMES,
@@ -1001,6 +1412,7 @@ export {
   ReplaySettingsSchema,
   RuleGroupSchema,
   RuleSchema,
+  SCOUT_AGENT_ID,
   SCRIPT_STUB,
   SCRIPT_STUB_METHODS,
   SDK_API_VERSION,
@@ -1012,30 +1424,46 @@ export {
   SHARED_VERSION,
   SHOW_ME_CLASS,
   SHOW_ME_HREF_PREFIX,
+  SNAPSHOT_ATTRS,
+  SNAPSHOT_LIMITS,
   SOURCEMAP_MAX_FILES_PER_UPLOAD,
   SOURCEMAP_MAX_FILE_BYTES,
   STATUS_LEVELS,
   STEP_TYPES,
   SURVEY_QUESTION_TYPES,
+  SdkAgentEventsSchema,
   SdkEventSchema,
   SelectorStrategySchema,
+  SelectorSyntaxError,
   StartConversationSchema,
   StepBranchSchema,
   StepSchema,
+  SubmitFeedbackSchema,
   SurveyConfigSchema,
   SurveyQuestionSchema,
   SurveyResponseRequestSchema,
+  TAG_PROPERTY_LIMITS,
   TRIGGER_TYPES,
   TargetSchema,
   TriggerSchema,
   VIDEO_ATTRS,
+  WCAG_AA_LARGE,
+  WCAG_AA_TEXT,
   WS_MAX_MESSAGES_PER_SOCKET,
   WS_MAX_MESSAGE_BYTES,
+  applyGuideTranslations,
+  articleTextEntries,
+  assignGuideVariant,
+  baseLanguage,
   clamp,
   cleanLabel,
   compare,
   compareVersions,
   complaintReference,
+  compoundMatches,
+  contrastIssues,
+  contrastRatio,
+  cssSelectorError,
   defaultGuideConfig,
   defaultStep,
   describeCaptureStep,
@@ -1043,12 +1471,21 @@ export {
   emptyRuleGroup,
   evaluateRule,
   evaluateRules,
+  evenWeights,
+  experimentBucketRules,
+  experimentSalt,
+  featureCssSelectors,
+  featureRuleError,
+  featureRuleMatchesClick,
+  feedbackReference,
   fingerprintError,
   firstNameFromTraits,
   fnv1a,
   foldPathIds,
   getPath,
+  guideLocales,
   guidePlatforms,
+  guideTextEntries,
   guidelyIdFromSelector,
   hasVideoMedia,
   isAllowedEmbedSrc,
@@ -1061,23 +1498,51 @@ export {
   isRuleGroup,
   isSafeMediaUrl,
   isVideoContentType,
+  localeName,
+  localizeAnnouncement,
+  localizeArticle,
+  localizeGuide,
+  localizeResourceCenter,
+  matchCssSelector,
   matchUrlPattern,
   matchesAudiences,
   matchesHelpQuery,
   mediaKind,
   mediaMaxBytes,
+  needsReview,
   normalizeErrorMessage,
   normalizeFrameFile,
+  normalizeLocale,
+  normalizeSnapshot,
+  orderedModules,
   pageLabel,
   pageName,
+  pagePattern,
+  pageRuleError,
+  pageRuleMatches,
+  pageRulesMatch,
   pageTerms,
+  parseCssSelector,
+  parseCsvRows,
+  parseHexColor,
   parseStack,
+  parseTranslationCsv,
+  parseXliff,
+  propertyAttributeAllowed,
+  queryConditionRegex,
   randomId,
+  readableTextOn,
+  relativeLuminance,
   resolveCaptureSettings,
+  resolveLocale,
+  resourceCenterLocales,
   resourceCenterSections,
+  resourceCenterTextEntries,
   rolloutBucket,
   safeRegExp,
+  sanitizeCustomCss,
   sanitizeProperties,
+  scopeCustomCss,
   screenPath,
   scriptSnippet,
   servedArticleAudiences,
@@ -1085,14 +1550,25 @@ export {
   showMeKeyFromHref,
   showMeKeys,
   slugify,
+  snapshotFromSelector,
+  stableStringify,
   stripOrigin,
   supportsPlatform,
   templateConfig,
   toEmbedUrl,
+  toTranslationCsv,
+  toXliff,
+  translationCoverage,
+  unreadAnnouncements,
   validateGuideConfig,
+  variantProblems,
+  variantRanges,
+  visibleAnnouncements,
   visibleArticleIds,
   visibleButtons,
   visitorAudiences,
+  visitorLocales,
+  withExperimentBucket,
   withVisibility
 };
 //# sourceMappingURL=index.js.map