@guidelytech/shared 0.4.1 → 0.6.1

package/dist/index.cjs

@@ -21,12 +21,17 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   ADVANCE_ON: () => ADVANCE_ON,
+  ANNOTATION_COLORS: () => ANNOTATION_COLORS,
   AUTOCAPTURE_EVENTS: () => AUTOCAPTURE_EVENTS,
   AppearanceSchema: () => AppearanceSchema,
   AuthoringPickSchema: () => AuthoringPickSchema,
   AutocaptureSettingsSchema: () => AutocaptureSettingsSchema,
   BUTTON_ACTIONS: () => BUTTON_ACTIONS,
   ButtonSchema: () => ButtonSchema,
+  CAPTURE_PARAM: () => CAPTURE_PARAM,
+  CAPTURE_SCREENSHOT_MAX_BYTES: () => CAPTURE_SCREENSHOT_MAX_BYTES,
+  CaptureStepSchema: () => CaptureStepSchema,
+  CapturedElementSchema: () => CapturedElementSchema,
   ChecklistConfigSchema: () => ChecklistConfigSchema,
   ChecklistProgressRequestSchema: () => ChecklistProgressRequestSchema,
   ChecklistTaskSchema: () => ChecklistTaskSchema,
@@ -34,9 +39,11 @@ __export(index_exports, {
   ConversationRatingSchema: () => ConversationRatingSchema,
   DEFAULT_CAPTURE_SETTINGS: () => DEFAULT_CAPTURE_SETTINGS,
   DEFAULT_PLATFORMS: () => DEFAULT_PLATFORMS,
+  EMBED_IFRAME_ATTRS: () => EMBED_IFRAME_ATTRS,
   EVENT_NAMES: () => EVENT_NAMES,
   ErrorTrackingSettingsSchema: () => ErrorTrackingSettingsSchema,
   EventBatchSchema: () => EventBatchSchema,
+  FILE_LINK_CLASS: () => FILE_LINK_CLASS,
   FrequencySchema: () => FrequencySchema,
   GUIDELY_ID_ATTRIBUTE: () => GUIDELY_ID_ATTRIBUTE,
   GUIDE_KINDS: () => GUIDE_KINDS,
@@ -46,12 +53,31 @@ __export(index_exports, {
   GuideConfigSchema: () => GuideConfigSchema,
   GuideStateUpdateSchema: () => GuideStateUpdateSchema,
   HEATMAP_VIEWPORTS: () => HEATMAP_VIEWPORTS,
+  HOWTO_ACTIONS: () => HOWTO_ACTIONS,
+  HOWTO_STEP_KINDS: () => HOWTO_STEP_KINDS,
+  HowToAnnotationSchema: () => HowToAnnotationSchema,
   IdentifyRequestSchema: () => IdentifyRequestSchema,
+  MAX_ANNOTATIONS: () => MAX_ANNOTATIONS,
+  MAX_COLLECTION_DEPTH: () => MAX_COLLECTION_DEPTH,
   MAX_MESSAGE_LENGTH: () => MAX_MESSAGE_LENGTH,
   MAX_PROPERTY_BYTES: () => MAX_PROPERTY_BYTES,
   MAX_STACK_FRAMES: () => MAX_STACK_FRAMES,
+  MEDIA_FILE_MAX_BYTES: () => MEDIA_FILE_MAX_BYTES,
+  MEDIA_FILE_TYPES: () => MEDIA_FILE_TYPES,
+  MEDIA_IMAGE_MAX_BYTES: () => MEDIA_IMAGE_MAX_BYTES,
+  MEDIA_IMAGE_TYPES: () => MEDIA_IMAGE_TYPES,
+  MEDIA_MAX_BYTES: () => MEDIA_MAX_BYTES,
+  MEDIA_VIDEO_MAX_BYTES: () => MEDIA_VIDEO_MAX_BYTES,
+  MEDIA_VIDEO_TYPES: () => MEDIA_VIDEO_TYPES,
   MESSAGE_AUTHORS: () => MESSAGE_AUTHORS,
+  MessengerPageRequestSchema: () => MessengerPageRequestSchema,
   NETWORK_PLUGIN: () => NETWORK_PLUGIN,
+  NormalizedPointSchema: () => NormalizedPointSchema,
+  NormalizedRectSchema: () => NormalizedRectSchema,
+  PATH_ID_PATTERN: () => PATH_ID_PATTERN,
+  PDF_BLOCK_CLASS: () => PDF_BLOCK_CLASS,
+  PDF_MAX_PAGES: () => PDF_MAX_PAGES,
+  PDF_PAGES_CLASS: () => PDF_PAGES_CLASS,
   PLACEMENTS: () => PLACEMENTS,
   PLATFORMS: () => PLATFORMS,
   PostMessageSchema: () => PostMessageSchema,
@@ -59,6 +85,7 @@ __export(index_exports, {
   PublishedGuideSchema: () => PublishedGuideSchema,
   REPLAY_MAX_COMPRESSED_BYTES: () => REPLAY_MAX_COMPRESSED_BYTES,
   REPLAY_MAX_RAW_BYTES: () => REPLAY_MAX_RAW_BYTES,
+  REPLY_TIMES: () => REPLY_TIMES,
   RULE_FIELDS: () => RULE_FIELDS,
   RULE_OPERATORS: () => RULE_OPERATORS,
   ReplayChunkSchema: () => ReplayChunkSchema,
@@ -74,6 +101,7 @@ __export(index_exports, {
   SHARED_VERSION: () => SHARED_VERSION,
   SOURCEMAP_MAX_FILES_PER_UPLOAD: () => SOURCEMAP_MAX_FILES_PER_UPLOAD,
   SOURCEMAP_MAX_FILE_BYTES: () => SOURCEMAP_MAX_FILE_BYTES,
+  STATUS_LEVELS: () => STATUS_LEVELS,
   STEP_TYPES: () => STEP_TYPES,
   SURVEY_QUESTION_TYPES: () => SURVEY_QUESTION_TYPES,
   SdkEventSchema: () => SdkEventSchema,
@@ -87,32 +115,50 @@ __export(index_exports, {
   TRIGGER_TYPES: () => TRIGGER_TYPES,
   TargetSchema: () => TargetSchema,
   TriggerSchema: () => TriggerSchema,
+  VIDEO_ATTRS: () => VIDEO_ATTRS,
   WS_MAX_MESSAGES_PER_SOCKET: () => WS_MAX_MESSAGES_PER_SOCKET,
   WS_MAX_MESSAGE_BYTES: () => WS_MAX_MESSAGE_BYTES,
   clamp: () => clamp,
+  cleanLabel: () => cleanLabel,
   compare: () => compare,
   compareVersions: () => compareVersions,
   defaultGuideConfig: () => defaultGuideConfig,
   defaultStep: () => defaultStep,
+  describeCaptureStep: () => describeCaptureStep,
   describeRule: () => describeRule,
   emptyRuleGroup: () => emptyRuleGroup,
   evaluateRule: () => evaluateRule,
   evaluateRules: () => evaluateRules,
   fingerprintError: () => fingerprintError,
+  firstNameFromTraits: () => firstNameFromTraits,
   fnv1a: () => fnv1a,
+  foldPathIds: () => foldPathIds,
   getPath: () => getPath,
   guidePlatforms: () => guidePlatforms,
   guidelyIdFromSelector: () => guidelyIdFromSelector,
+  isAllowedEmbedSrc: () => isAllowedEmbedSrc,
+  isArticleListed: () => isArticleListed,
   isChecklistComplete: () => isChecklistComplete,
+  isFileLink: () => isFileLink,
+  isMediaContentType: () => isMediaContentType,
   isPlainObject: () => isPlainObject,
   isQuestionVisible: () => isQuestionVisible,
   isRuleGroup: () => isRuleGroup,
+  isSafeMediaUrl: () => isSafeMediaUrl,
+  isVideoContentType: () => isVideoContentType,
   matchUrlPattern: () => matchUrlPattern,
+  matchesAudiences: () => matchesAudiences,
+  mediaKind: () => mediaKind,
+  mediaMaxBytes: () => mediaMaxBytes,
   normalizeErrorMessage: () => normalizeErrorMessage,
   normalizeFrameFile: () => normalizeFrameFile,
+  pageLabel: () => pageLabel,
+  pageName: () => pageName,
+  pageTerms: () => pageTerms,
   parseStack: () => parseStack,
   randomId: () => randomId,
   resolveCaptureSettings: () => resolveCaptureSettings,
+  resourceCenterSections: () => resourceCenterSections,
   rolloutBucket: () => rolloutBucket,
   safeRegExp: () => safeRegExp,
   sanitizeProperties: () => sanitizeProperties,
@@ -121,7 +167,9 @@ __export(index_exports, {
   stripOrigin: () => stripOrigin,
   supportsPlatform: () => supportsPlatform,
   templateConfig: () => templateConfig,
+  toEmbedUrl: () => toEmbedUrl,
   validateGuideConfig: () => validateGuideConfig,
+  visibleArticleIds: () => visibleArticleIds,
   visibleButtons: () => visibleButtons
 });
 module.exports = __toCommonJS(index_exports);
@@ -938,6 +986,14 @@ var PublishedGuideSchema = import_zod4.z.object({
 
 // src/messenger.ts
 var import_zod5 = require("zod");
+var REPLY_TIMES = ["minutes", "hour", "hours", "day"];
+var STATUS_LEVELS = ["operational", "degraded", "outage", "maintenance"];
+var MessengerPageRequestSchema = import_zod5.z.object({
+  anonymousId: import_zod5.z.string().min(1).max(128),
+  userId: import_zod5.z.string().max(256).optional().nullable(),
+  /** Pathname only: query strings and fragments are never sent. */
+  path: import_zod5.z.string().min(1).max(1e3)
+});
 var MESSAGE_AUTHORS = ["user", "scout", "agent", "system"];
 var MAX_MESSAGE_LENGTH = 4e3;
 var messageText = import_zod5.z.string().trim().min(1).max(MAX_MESSAGE_LENGTH);
@@ -950,7 +1006,11 @@ var StartConversationSchema = import_zod5.z.object({
 var ConversationLookupSchema = import_zod5.z.object({
   tokens: import_zod5.z.array(import_zod5.z.string().min(16).max(128)).max(50)
 });
-var PostMessageSchema = import_zod5.z.object({ message: messageText });
+var PostMessageSchema = import_zod5.z.object({
+  message: messageText,
+  /** The page the user is on now (omitted when URL collection is off and by older SDKs), so Scout answers for that page. */
+  pageUrl: import_zod5.z.string().max(2e3).optional()
+});
 var ConversationRatingSchema = import_zod5.z.object({
   rating: import_zod5.z.number().int().min(1).max(5),
   comment: import_zod5.z.string().max(1e3).optional()
@@ -1190,18 +1250,357 @@ function templateConfig(id) {
   return { template: t, config: GuideConfigSchema.parse(t.config) };
 }
 
+// src/media.ts
+var MEDIA_IMAGE_TYPES = ["image/png", "image/jpeg", "image/gif", "image/webp"];
+var MEDIA_VIDEO_TYPES = ["video/mp4", "video/webm"];
+var MEDIA_FILE_TYPES = ["application/pdf"];
+var MEDIA_IMAGE_MAX_BYTES = 10 * 1024 * 1024;
+var MEDIA_VIDEO_MAX_BYTES = 200 * 1024 * 1024;
+var MEDIA_FILE_MAX_BYTES = 50 * 1024 * 1024;
+var MEDIA_MAX_BYTES = Math.max(MEDIA_IMAGE_MAX_BYTES, MEDIA_VIDEO_MAX_BYTES, MEDIA_FILE_MAX_BYTES);
+function isMediaContentType(type) {
+  return mediaKind(type) !== null;
+}
+function isVideoContentType(type) {
+  return MEDIA_VIDEO_TYPES.includes(type);
+}
+function mediaKind(type) {
+  if (MEDIA_IMAGE_TYPES.includes(type)) return "image";
+  if (MEDIA_VIDEO_TYPES.includes(type)) return "video";
+  if (MEDIA_FILE_TYPES.includes(type)) return "file";
+  return null;
+}
+function mediaMaxBytes(type) {
+  const kind = mediaKind(type);
+  return kind === "video" ? MEDIA_VIDEO_MAX_BYTES : kind === "file" ? MEDIA_FILE_MAX_BYTES : MEDIA_IMAGE_MAX_BYTES;
+}
+var FILE_LINK_CLASS = "gd-file";
+var PDF_BLOCK_CLASS = "gd-pdf";
+var PDF_PAGES_CLASS = "gd-pdf-pages";
+var PDF_MAX_PAGES = 40;
+function isFileLink(className, href) {
+  return !!className && className.split(/\s+/).includes(FILE_LINK_CLASS) && isSafeMediaUrl(href);
+}
+var YOUTUBE_ID = /^[A-Za-z0-9_-]{11}$/;
+var VIMEO_ID = /^\d{1,12}$/;
+var VIMEO_HASH = /^[0-9a-f]{6,20}$/i;
+var LOOM_ID = /^[0-9a-f]{32}$/i;
+var WISTIA_ID = /^[a-z0-9]{10}$/i;
+function parseUrl(input) {
+  const s = input.trim();
+  if (!s) return null;
+  try {
+    const u = new URL(/^[a-z][a-z0-9+.-]*:/i.test(s) ? s : `https://${s}`);
+    if (u.protocol !== "https:" && u.protocol !== "http:") return null;
+    if (u.username || u.password || u.port && u.port !== "443" && u.port !== "80") return null;
+    return u;
+  } catch {
+    return null;
+  }
+}
+function parseStart(v) {
+  if (!v) return 0;
+  if (/^\d+$/.test(v)) return Math.min(Number(v), 86400);
+  const m = /^(?:(\d+)h)?(?:(\d+)m)?(?:(\d+)s)?$/.exec(v);
+  if (!m || !m[0]) return 0;
+  return Math.min(Number(m[1] ?? 0) * 3600 + Number(m[2] ?? 0) * 60 + Number(m[3] ?? 0), 86400);
+}
+function youtube(id, start) {
+  if (!YOUTUBE_ID.test(id)) return null;
+  return {
+    provider: "youtube",
+    src: `https://www.youtube-nocookie.com/embed/${id}${start ? `?start=${start}` : ""}`,
+    watchUrl: `https://www.youtube.com/watch?v=${id}${start ? `&t=${start}s` : ""}`,
+    title: "YouTube video"
+  };
+}
+function vimeo(id, hash) {
+  if (!VIMEO_ID.test(id) || hash !== null && !VIMEO_HASH.test(hash)) return null;
+  const h = hash ? hash.toLowerCase() : null;
+  return { provider: "vimeo", src: `https://player.vimeo.com/video/${id}${h ? `?h=${h}` : ""}`, watchUrl: `https://vimeo.com/${id}${h ? `/${h}` : ""}`, title: "Vimeo video" };
+}
+function toEmbedUrl(input) {
+  const u = parseUrl(input);
+  if (!u) return null;
+  const host = u.hostname.toLowerCase().replace(/^www\./, "");
+  const parts = u.pathname.split("/").filter(Boolean);
+  switch (host) {
+    case "youtube.com":
+    case "m.youtube.com":
+    case "youtube-nocookie.com": {
+      const start = parseStart(u.searchParams.get("start") ?? u.searchParams.get("t"));
+      if (parts[0] === "watch" && parts.length === 1) return youtube(u.searchParams.get("v") ?? "", start);
+      if ((parts[0] === "embed" || parts[0] === "shorts" || parts[0] === "live") && parts.length === 2) return youtube(parts[1], start);
+      return null;
+    }
+    case "youtu.be":
+      return parts.length === 1 ? youtube(parts[0], parseStart(u.searchParams.get("t") ?? u.searchParams.get("start"))) : null;
+    case "vimeo.com":
+      if (parts.length === 1) return vimeo(parts[0], null);
+      if (parts.length === 2 && VIMEO_ID.test(parts[0])) return vimeo(parts[0], parts[1]);
+      return null;
+    case "player.vimeo.com":
+      return parts[0] === "video" && parts.length === 2 ? vimeo(parts[1], u.searchParams.get("h")) : null;
+    case "loom.com":
+      if ((parts[0] === "share" || parts[0] === "embed") && parts.length === 2 && LOOM_ID.test(parts[1])) {
+        const id = parts[1].toLowerCase();
+        return { provider: "loom", src: `https://www.loom.com/embed/${id}`, watchUrl: `https://www.loom.com/share/${id}`, title: "Loom video" };
+      }
+      return null;
+    default: {
+      let id;
+      if (host === "fast.wistia.net" || host === "fast.wistia.com") id = parts[0] === "embed" && parts[1] === "iframe" && parts.length === 3 ? parts[2] : void 0;
+      else if (host === "wi.st" || host === "wistia.com" || /^[a-z0-9-]+\.wistia\.com$/.test(host)) id = parts[0] === "medias" && parts.length === 2 ? parts[1] : void 0;
+      if (!id || !WISTIA_ID.test(id)) return null;
+      return { provider: "wistia", src: `https://fast.wistia.net/embed/iframe/${id}`, watchUrl: `https://fast.wistia.net/embed/iframe/${id}`, title: "Wistia video" };
+    }
+  }
+}
+function isAllowedEmbedSrc(src) {
+  if (!src) return false;
+  return toEmbedUrl(src)?.src === src;
+}
+var EMBED_IFRAME_ATTRS = {
+  allow: "fullscreen; picture-in-picture; encrypted-media",
+  allowfullscreen: "",
+  loading: "lazy",
+  referrerpolicy: "strict-origin-when-cross-origin",
+  sandbox: "allow-scripts allow-same-origin allow-presentation allow-popups allow-popups-to-escape-sandbox"
+};
+var VIDEO_ATTRS = { controls: "", preload: "metadata", playsinline: "" };
+function isSafeMediaUrl(url) {
+  if (!url) return false;
+  try {
+    const u = new URL(url);
+    return (u.protocol === "https:" || u.protocol === "http:") && !u.username && !u.password;
+  } catch {
+    return false;
+  }
+}
+
+// src/resource-center.ts
+var MAX_COLLECTION_DEPTH = 3;
+function matchesAudiences(required, member) {
+  if (!required || required.length === 0) return true;
+  if (!member) return false;
+  const has2 = member instanceof Set ? (id) => member.has(id) : (id) => member.includes(id);
+  return required.some(has2);
+}
+function resourceCenterSections(collections, articles, member) {
+  const byId = new Map(collections.map((c) => [c.id, c]));
+  const children = /* @__PURE__ */ new Map();
+  for (const c of collections) {
+    const parent = c.parentId && c.parentId !== c.id && byId.has(c.parentId) ? c.parentId : null;
+    const list = children.get(parent) ?? [];
+    list.push(c);
+    children.set(parent, list);
+  }
+  for (const list of children.values()) list.sort((a, b) => a.order - b.order || a.name.localeCompare(b.name));
+  const direct = /* @__PURE__ */ new Map();
+  const uncategorized = [];
+  for (const a of articles) {
+    if (!matchesAudiences(a.audienceIds, member)) continue;
+    if (a.collectionId && byId.has(a.collectionId)) {
+      const list = direct.get(a.collectionId) ?? [];
+      list.push(a);
+      direct.set(a.collectionId, list);
+    } else uncategorized.push(a);
+  }
+  const sections = [];
+  const seen = /* @__PURE__ */ new Set();
+  const visit = (c, path) => {
+    if (seen.has(c.id)) return;
+    seen.add(c.id);
+    if (!matchesAudiences(c.audienceIds, member)) return;
+    const here = [...path, c.name];
+    const list = direct.get(c.id);
+    if (list?.length) sections.push({ collection: c, path: here, depth: here.length - 1, articles: list });
+    for (const child of children.get(c.id) ?? []) visit(child, here);
+  };
+  for (const root of children.get(null) ?? []) visit(root, []);
+  if (uncategorized.length) sections.push({ collection: null, path: [], depth: 0, articles: uncategorized });
+  return sections;
+}
+function isArticleListed(collections, article, member) {
+  if (!matchesAudiences(article.audienceIds, member)) return false;
+  const byId = new Map(collections.map((c) => [c.id, c]));
+  let cur = article.collectionId ? byId.get(article.collectionId) : void 0;
+  for (let guard = 0; cur && guard <= MAX_COLLECTION_DEPTH * 4; guard++) {
+    if (!matchesAudiences(cur.audienceIds, member)) return false;
+    cur = cur.parentId ? byId.get(cur.parentId) : void 0;
+  }
+  return true;
+}
+function visibleArticleIds(collections, articles, member) {
+  return new Set(resourceCenterSections(collections, articles, member).flatMap((s) => s.articles.map((a) => a.id)));
+}
+
+// src/howto.ts
+var import_zod7 = require("zod");
+
+// src/howto-limits.ts
+var CAPTURE_PARAM = "guidely_capture";
+var CAPTURE_SCREENSHOT_MAX_BYTES = 8 * 1024 * 1024;
+
+// src/howto.ts
+var HOWTO_STEP_KINDS = ["action", "text", "heading", "tip", "alert"];
+var HOWTO_ACTIONS = ["click", "type", "select", "navigate"];
+var NormalizedRectSchema = import_zod7.z.object({
+  x: import_zod7.z.number().min(0).max(1),
+  y: import_zod7.z.number().min(0).max(1),
+  width: import_zod7.z.number().min(0).max(1),
+  height: import_zod7.z.number().min(0).max(1)
+});
+var CapturedElementSchema = import_zod7.z.object({
+  /** Visible name: aria-label, associated label, text, placeholder, alt or title. */
+  label: import_zod7.z.string().max(200).default(""),
+  /** button, link, tab, menuitem, checkbox, radio, field, dropdown, option, element… */
+  role: import_zod7.z.string().max(40).default("element"),
+  tag: import_zod7.z.string().max(40).default("")
+});
+var CaptureStepSchema = import_zod7.z.object({
+  /** Random id from the SDK; a retried upload with the same id is stored once. */
+  clientId: import_zod7.z.string().min(1).max(64),
+  action: import_zod7.z.enum(HOWTO_ACTIONS),
+  url: import_zod7.z.string().max(2e3),
+  pageTitle: import_zod7.z.string().max(300).default(""),
+  element: CapturedElementSchema.optional(),
+  /** Typed text or chosen option; absent when it was sensitive (`valueRedacted`). */
+  value: import_zod7.z.string().max(200).optional(),
+  valueRedacted: import_zod7.z.boolean().default(false),
+  /** Selectors for the element, so the step can later become an interactive tour step. */
+  selectors: import_zod7.z.array(SelectorStrategySchema).max(10).default([]),
+  /** Where the element sits in the screenshot. */
+  highlight: NormalizedRectSchema.optional(),
+  /** Number of regions the SDK blurred in the screenshot before upload. */
+  redactions: import_zod7.z.number().int().min(0).max(1e3).default(0),
+  occurredAt: import_zod7.z.string().datetime().optional()
+});
+function quoted(s) {
+  const t = (s ?? "").replace(/\s+/g, " ").trim();
+  return t.length > 60 ? `\u201C${t.slice(0, 57)}\u2026\u201D` : `\u201C${t}\u201D`;
+}
+function cleanLabel(label) {
+  const raw = (label ?? "").replace(/\s+/g, " ").trim();
+  const cleaned = raw.replace(/^[^\p{L}\p{N}“"'(]+/u, "").replace(/[\s:*]+$/u, "").replace(/[^\p{L}\p{N})”"'?!.%]+$/u, "").trim();
+  return cleaned || raw;
+}
+var SEPARATORS = /\s+[·|•–—-]\s+|\s*[|·•]\s*/;
+var ID_SEGMENT = /^(?:\d+|[0-9a-f]{8,}(?:-[0-9a-f]{4,})*|[A-Za-z0-9_-]{20,})$/i;
+function humanize(segment) {
+  const words = decodeURIComponent(segment).replace(/[-_+]+/g, " ").trim();
+  return words ? words.charAt(0).toUpperCase() + words.slice(1) : "";
+}
+function pageName(url, pageTitle) {
+  const title = (pageTitle ?? "").replace(/\s+/g, " ").trim();
+  const parts = title.split(SEPARATORS).map((p) => p.trim()).filter(Boolean);
+  if (parts.length > 1) return parts[0];
+  let segments = [];
+  try {
+    segments = new URL(url).pathname.split("/").filter((p) => p && !ID_SEGMENT.test(p));
+  } catch {
+    segments = [];
+  }
+  const fromPath = segments.slice(-2).map(humanize).filter(Boolean).join(" \u203A ");
+  if (!fromPath) return title || hostAndPath(url);
+  if (!title) return fromPath;
+  const lower = title.toLowerCase();
+  const mentionsPath = segments.some((seg) => humanize(seg).toLowerCase().split(" ").some((w) => w.length > 2 && lower.includes(w)));
+  return mentionsPath ? title : fromPath;
+}
+var ROLE_NOUN = { tab: "tab", menuitem: "menu item", field: "field", dropdown: "dropdown", option: "option" };
+function describeCaptureStep(step) {
+  const label = cleanLabel(step.element?.label);
+  const role = step.element?.role ?? "";
+  switch (step.action) {
+    case "navigate": {
+      const where = pageName(step.url, step.pageTitle);
+      return where ? `Go to ${quoted(where)}` : "Open the page";
+    }
+    case "type": {
+      const field = label ? quoted(label) : "the field";
+      if (step.valueRedacted || !step.value) return `Fill in ${field}`;
+      return `Type ${quoted(step.value)} into ${field}`;
+    }
+    case "select":
+      if (step.value && label) return `Select ${quoted(step.value)} from ${quoted(label)}`;
+      if (step.value) return `Select ${quoted(step.value)}`;
+      return label ? `Choose an option in ${quoted(label)}` : "Choose an option";
+    case "click":
+    default:
+      if (role === "checkbox") return label ? `Check ${quoted(label)}` : "Check the box";
+      if (role === "switch") return label ? `Turn ${quoted(label)} on or off` : "Flip the switch";
+      if (role === "radio") return label ? `Select ${quoted(label)}` : "Select the option";
+      if (role === "menuitem") return label ? `Choose ${quoted(label)} from the menu` : "Choose the menu item";
+      if (role === "tab") return label ? `Open the ${quoted(label)} tab` : "Open the tab";
+      if (label) return `Click ${quoted(label)}`;
+      return ROLE_NOUN[role] ? `Click the ${ROLE_NOUN[role]}` : role === "link" ? "Click the link" : "Click the button";
+  }
+}
+function hostAndPath(url) {
+  try {
+    const u = new URL(url);
+    return `${u.host}${u.pathname === "/" ? "" : u.pathname}`;
+  } catch {
+    return url.slice(0, 80);
+  }
+}
+var NormalizedPointSchema = import_zod7.z.object({ x: import_zod7.z.number().min(0).max(1), y: import_zod7.z.number().min(0).max(1) });
+var ANNOTATION_COLORS = ["brand", "red", "amber", "green", "black", "white"];
+var HowToAnnotationSchema = import_zod7.z.discriminatedUnion("type", [
+  import_zod7.z.object({ id: import_zod7.z.string().min(1).max(32), type: import_zod7.z.literal("arrow"), from: NormalizedPointSchema, to: NormalizedPointSchema, color: import_zod7.z.enum(ANNOTATION_COLORS).default("brand") }),
+  import_zod7.z.object({ id: import_zod7.z.string().min(1).max(32), type: import_zod7.z.literal("text"), at: NormalizedPointSchema, text: import_zod7.z.string().trim().min(1).max(120), color: import_zod7.z.enum(ANNOTATION_COLORS).default("brand") }),
+  import_zod7.z.object({ id: import_zod7.z.string().min(1).max(32), type: import_zod7.z.literal("box"), rect: NormalizedRectSchema, color: import_zod7.z.enum(ANNOTATION_COLORS).default("brand") })
+]);
+var MAX_ANNOTATIONS = 30;
+
+// src/page.ts
+var PATH_ID_PATTERN = "/([0-9]+|[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}|[0-9a-f]{12,})(?=/|$)";
+function foldPathIds(path) {
+  return path.replace(new RegExp(PATH_ID_PATTERN, "gi"), "/:id");
+}
+var GENERIC_SEGMENTS = /* @__PURE__ */ new Set(["", ":id", "app", "apps", "dashboard", "home", "index", "main", "new", "edit", "view", "show", "details", "detail", "overview", "list", "all", "page", "pages", "en", "v1", "v2"]);
+function segmentsOf(path) {
+  const clean = foldPathIds((path.split(/[?#]/)[0] || "/").toLowerCase());
+  return clean.split("/").map((s) => s.replace(/\.(html?|php|aspx?)$/, "")).filter((s) => !GENERIC_SEGMENTS.has(s) && /[a-z]/.test(s) && s.length <= 40);
+}
+function pageTerms(path) {
+  const words = segmentsOf(path).flatMap((s) => s.split(/[-_.+\s]+/).filter((w) => w.length > 1 && /[a-z]/.test(w)));
+  return [...new Set(words)].slice(0, 8);
+}
+function pageLabel(path) {
+  const last = segmentsOf(path).at(-1);
+  if (!last) return null;
+  const words = last.split(/[-_.+\s]+/).filter(Boolean);
+  if (!words.length) return null;
+  const label = words.join(" ");
+  return label.charAt(0).toUpperCase() + label.slice(1);
+}
+function firstNameFromTraits(traits) {
+  if (!traits) return null;
+  const pick = (v) => typeof v === "string" ? v.trim() : "";
+  const first = pick(traits.firstName) || pick(traits.first_name) || pick(traits.firstname) || pick(traits.name).split(/\s+/)[0] || "";
+  if (!first || first.length > 40 || first.includes("@") || !/\p{L}/u.test(first)) return null;
+  return first;
+}
+
 // src/index.ts
 var SDK_API_VERSION = "v1";
-var SHARED_VERSION = "0.4.1";
+var SHARED_VERSION = "0.6.1";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ADVANCE_ON,
+  ANNOTATION_COLORS,
   AUTOCAPTURE_EVENTS,
   AppearanceSchema,
   AuthoringPickSchema,
   AutocaptureSettingsSchema,
   BUTTON_ACTIONS,
   ButtonSchema,
+  CAPTURE_PARAM,
+  CAPTURE_SCREENSHOT_MAX_BYTES,
+  CaptureStepSchema,
+  CapturedElementSchema,
   ChecklistConfigSchema,
   ChecklistProgressRequestSchema,
   ChecklistTaskSchema,
@@ -1209,9 +1608,11 @@ var SHARED_VERSION = "0.4.1";
   ConversationRatingSchema,
   DEFAULT_CAPTURE_SETTINGS,
   DEFAULT_PLATFORMS,
+  EMBED_IFRAME_ATTRS,
   EVENT_NAMES,
   ErrorTrackingSettingsSchema,
   EventBatchSchema,
+  FILE_LINK_CLASS,
   FrequencySchema,
   GUIDELY_ID_ATTRIBUTE,
   GUIDE_KINDS,
@@ -1221,12 +1622,31 @@ var SHARED_VERSION = "0.4.1";
   GuideConfigSchema,
   GuideStateUpdateSchema,
   HEATMAP_VIEWPORTS,
+  HOWTO_ACTIONS,
+  HOWTO_STEP_KINDS,
+  HowToAnnotationSchema,
   IdentifyRequestSchema,
+  MAX_ANNOTATIONS,
+  MAX_COLLECTION_DEPTH,
   MAX_MESSAGE_LENGTH,
   MAX_PROPERTY_BYTES,
   MAX_STACK_FRAMES,
+  MEDIA_FILE_MAX_BYTES,
+  MEDIA_FILE_TYPES,
+  MEDIA_IMAGE_MAX_BYTES,
+  MEDIA_IMAGE_TYPES,
+  MEDIA_MAX_BYTES,
+  MEDIA_VIDEO_MAX_BYTES,
+  MEDIA_VIDEO_TYPES,
   MESSAGE_AUTHORS,
+  MessengerPageRequestSchema,
   NETWORK_PLUGIN,
+  NormalizedPointSchema,
+  NormalizedRectSchema,
+  PATH_ID_PATTERN,
+  PDF_BLOCK_CLASS,
+  PDF_MAX_PAGES,
+  PDF_PAGES_CLASS,
   PLACEMENTS,
   PLATFORMS,
   PostMessageSchema,
@@ -1234,6 +1654,7 @@ var SHARED_VERSION = "0.4.1";
   PublishedGuideSchema,
   REPLAY_MAX_COMPRESSED_BYTES,
   REPLAY_MAX_RAW_BYTES,
+  REPLY_TIMES,
   RULE_FIELDS,
   RULE_OPERATORS,
   ReplayChunkSchema,
@@ -1249,6 +1670,7 @@ var SHARED_VERSION = "0.4.1";
   SHARED_VERSION,
   SOURCEMAP_MAX_FILES_PER_UPLOAD,
   SOURCEMAP_MAX_FILE_BYTES,
+  STATUS_LEVELS,
   STEP_TYPES,
   SURVEY_QUESTION_TYPES,
   SdkEventSchema,
@@ -1262,32 +1684,50 @@ var SHARED_VERSION = "0.4.1";
   TRIGGER_TYPES,
   TargetSchema,
   TriggerSchema,
+  VIDEO_ATTRS,
   WS_MAX_MESSAGES_PER_SOCKET,
   WS_MAX_MESSAGE_BYTES,
   clamp,
+  cleanLabel,
   compare,
   compareVersions,
   defaultGuideConfig,
   defaultStep,
+  describeCaptureStep,
   describeRule,
   emptyRuleGroup,
   evaluateRule,
   evaluateRules,
   fingerprintError,
+  firstNameFromTraits,
   fnv1a,
+  foldPathIds,
   getPath,
   guidePlatforms,
   guidelyIdFromSelector,
+  isAllowedEmbedSrc,
+  isArticleListed,
   isChecklistComplete,
+  isFileLink,
+  isMediaContentType,
   isPlainObject,
   isQuestionVisible,
   isRuleGroup,
+  isSafeMediaUrl,
+  isVideoContentType,
   matchUrlPattern,
+  matchesAudiences,
+  mediaKind,
+  mediaMaxBytes,
   normalizeErrorMessage,
   normalizeFrameFile,
+  pageLabel,
+  pageName,
+  pageTerms,
   parseStack,
   randomId,
   resolveCaptureSettings,
+  resourceCenterSections,
   rolloutBucket,
   safeRegExp,
   sanitizeProperties,
@@ -1296,7 +1736,9 @@ var SHARED_VERSION = "0.4.1";
   stripOrigin,
   supportsPlatform,
   templateConfig,
+  toEmbedUrl,
   validateGuideConfig,
+  visibleArticleIds,
   visibleButtons
 });
 //# sourceMappingURL=index.cjs.map