@guidelytech/shared 0.8.0 → 0.9.0

package/dist/index.cjs

@@ -22,6 +22,7 @@ var index_exports = {};
 __export(index_exports, {
   ADVANCE_ON: () => ADVANCE_ON,
   ANNOTATION_COLORS: () => ANNOTATION_COLORS,
+  ARTICLE_VISIBILITIES: () => ARTICLE_VISIBILITIES,
   AUTOCAPTURE_EVENTS: () => AUTOCAPTURE_EVENTS,
   AppearanceSchema: () => AppearanceSchema,
   AuthoringPickSchema: () => AuthoringPickSchema,
@@ -30,6 +31,9 @@ __export(index_exports, {
   ButtonSchema: () => ButtonSchema,
   CAPTURE_PARAM: () => CAPTURE_PARAM,
   CAPTURE_SCREENSHOT_MAX_BYTES: () => CAPTURE_SCREENSHOT_MAX_BYTES,
+  COMPLAINT_EVENTS: () => COMPLAINT_EVENTS,
+  COMPLAINT_FIELD_TYPES: () => COMPLAINT_FIELD_TYPES,
+  COMPLAINT_STATUSES: () => COMPLAINT_STATUSES,
   CaptureStepSchema: () => CaptureStepSchema,
   CapturedElementSchema: () => CapturedElementSchema,
   ChecklistConfigSchema: () => ChecklistConfigSchema,
@@ -44,12 +48,14 @@ __export(index_exports, {
   ErrorTrackingSettingsSchema: () => ErrorTrackingSettingsSchema,
   EventBatchSchema: () => EventBatchSchema,
   FILE_LINK_CLASS: () => FILE_LINK_CLASS,
+  FileComplaintSchema: () => FileComplaintSchema,
   FrequencySchema: () => FrequencySchema,
   GUIDELY_ID_ATTRIBUTE: () => GUIDELY_ID_ATTRIBUTE,
   GUIDE_KINDS: () => GUIDE_KINDS,
   GUIDE_LIFECYCLE_EVENTS: () => GUIDE_LIFECYCLE_EVENTS,
   GUIDE_STATUSES: () => GUIDE_STATUSES,
   GUIDE_TEMPLATES: () => GUIDE_TEMPLATES,
+  GUIDE_VISIBILITIES: () => GUIDE_VISIBILITIES,
   GuideConfigSchema: () => GuideConfigSchema,
   GuideStateUpdateSchema: () => GuideStateUpdateSchema,
   HEATMAP_VIEWPORTS: () => HEATMAP_VIEWPORTS,
@@ -57,8 +63,14 @@ __export(index_exports, {
   HOWTO_STEP_KINDS: () => HOWTO_STEP_KINDS,
   HowToAnnotationSchema: () => HowToAnnotationSchema,
   IdentifyRequestSchema: () => IdentifyRequestSchema,
+  LOGGED_IN_AUDIENCE: () => LOGGED_IN_AUDIENCE,
   MAX_ANNOTATIONS: () => MAX_ANNOTATIONS,
   MAX_COLLECTION_DEPTH: () => MAX_COLLECTION_DEPTH,
+  MAX_COMPLAINT_ANSWER_LENGTH: () => MAX_COMPLAINT_ANSWER_LENGTH,
+  MAX_COMPLAINT_ATTACHMENT_BYTES: () => MAX_COMPLAINT_ATTACHMENT_BYTES,
+  MAX_COMPLAINT_CHOICES: () => MAX_COMPLAINT_CHOICES,
+  MAX_COMPLAINT_FIELDS: () => MAX_COMPLAINT_FIELDS,
+  MAX_COMPLAINT_LENGTH: () => MAX_COMPLAINT_LENGTH,
   MAX_MESSAGE_LENGTH: () => MAX_MESSAGE_LENGTH,
   MAX_PROPERTY_BYTES: () => MAX_PROPERTY_BYTES,
   MAX_STACK_FRAMES: () => MAX_STACK_FRAMES,
@@ -99,6 +111,8 @@ __export(index_exports, {
   SENSITIVE_PROPERTY_PATTERN: () => SENSITIVE_PROPERTY_PATTERN,
   SERVER_ASSISTED_FIELDS: () => SERVER_ASSISTED_FIELDS,
   SHARED_VERSION: () => SHARED_VERSION,
+  SHOW_ME_CLASS: () => SHOW_ME_CLASS,
+  SHOW_ME_HREF_PREFIX: () => SHOW_ME_HREF_PREFIX,
   SOURCEMAP_MAX_FILES_PER_UPLOAD: () => SOURCEMAP_MAX_FILES_PER_UPLOAD,
   SOURCEMAP_MAX_FILE_BYTES: () => SOURCEMAP_MAX_FILE_BYTES,
   STATUS_LEVELS: () => STATUS_LEVELS,
@@ -122,6 +136,7 @@ __export(index_exports, {
   cleanLabel: () => cleanLabel,
   compare: () => compare,
   compareVersions: () => compareVersions,
+  complaintReference: () => complaintReference,
   defaultGuideConfig: () => defaultGuideConfig,
   defaultStep: () => defaultStep,
   describeCaptureStep: () => describeCaptureStep,
@@ -136,6 +151,7 @@ __export(index_exports, {
   getPath: () => getPath,
   guidePlatforms: () => guidePlatforms,
   guidelyIdFromSelector: () => guidelyIdFromSelector,
+  hasVideoMedia: () => hasVideoMedia,
   isAllowedEmbedSrc: () => isAllowedEmbedSrc,
   isArticleListed: () => isArticleListed,
   isChecklistComplete: () => isChecklistComplete,
@@ -148,6 +164,7 @@ __export(index_exports, {
   isVideoContentType: () => isVideoContentType,
   matchUrlPattern: () => matchUrlPattern,
   matchesAudiences: () => matchesAudiences,
+  matchesHelpQuery: () => matchesHelpQuery,
   mediaKind: () => mediaKind,
   mediaMaxBytes: () => mediaMaxBytes,
   normalizeErrorMessage: () => normalizeErrorMessage,
@@ -163,6 +180,10 @@ __export(index_exports, {
   safeRegExp: () => safeRegExp,
   sanitizeProperties: () => sanitizeProperties,
   screenPath: () => screenPath,
+  servedArticleAudiences: () => servedArticleAudiences,
+  showMeHref: () => showMeHref,
+  showMeKeyFromHref: () => showMeKeyFromHref,
+  showMeKeys: () => showMeKeys,
   slugify: () => slugify,
   stripOrigin: () => stripOrigin,
   supportsPlatform: () => supportsPlatform,
@@ -170,7 +191,9 @@ __export(index_exports, {
   toEmbedUrl: () => toEmbedUrl,
   validateGuideConfig: () => validateGuideConfig,
   visibleArticleIds: () => visibleArticleIds,
-  visibleButtons: () => visibleButtons
+  visibleButtons: () => visibleButtons,
+  visitorAudiences: () => visitorAudiences,
+  withVisibility: () => withVisibility
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -345,6 +368,7 @@ var RULE_FIELDS = [
   "account.attribute",
   "user.role",
   "user.plan",
+  "user.identified",
   "url.path",
   "url.full",
   "url.query",
@@ -389,6 +413,8 @@ function resolveField(rule, ctx) {
       return ctx.userAttributes.role;
     case "user.plan":
       return ctx.userAttributes.plan ?? ctx.accountAttributes.plan;
+    case "user.identified":
+      return !!ctx.userId;
     case "url.path":
       return ctx.path;
     case "url.full":
@@ -535,6 +561,11 @@ function evaluateRules(group, ctx) {
   return group.negate ? !value : value;
 }
 var SERVER_ASSISTED_FIELDS = ["audience.member", "guide.completed", "guide.dismissed", "guide.seen", "checklist.completed"];
+var GUIDE_VISIBILITIES = ["everyone", "identified", "anonymous"];
+function withVisibility(targeting, visibility) {
+  if (!visibility || visibility === "everyone") return targeting;
+  return { id: "visibility", op: "and", rules: [{ id: "visibility-rule", field: "user.identified", op: visibility === "identified" ? "is_true" : "is_false" }, targeting] };
+}
 function describeRule(rule) {
   const subject = rule.key ? `${rule.field}[${rule.key}]` : rule.field;
   const v = Array.isArray(rule.value) ? rule.value.join(", ") : rule.value === void 0 ? "" : String(rule.value);
@@ -684,7 +715,7 @@ var ChecklistTaskSchema = import_zod2.z.object({
   required: import_zod2.z.boolean().default(true)
 });
 var ChecklistConfigSchema = import_zod2.z.object({
-  tasks: import_zod2.z.array(ChecklistTaskSchema).min(1).max(30),
+  tasks: import_zod2.z.array(ChecklistTaskSchema).min(1),
   ordered: import_zod2.z.boolean().default(false),
   launcherLabel: import_zod2.z.string().max(60).default("Getting started"),
   position: import_zod2.z.enum(["bottom-right", "bottom-left"]).default("bottom-right"),
@@ -718,6 +749,8 @@ var SurveyConfigSchema = import_zod2.z.object({
 });
 var GuideConfigSchema = import_zod2.z.object({
   steps: import_zod2.z.array(StepSchema).max(50).default([]),
+  /** Everyone, only identified (logged-in) users, or only anonymous visitors; applied on top of `targeting`. */
+  visibility: import_zod2.z.enum(GUIDE_VISIBILITIES).default("everyone"),
   targeting: RuleGroupSchema.default(() => emptyRuleGroup()),
   trigger: TriggerSchema.default({}),
   frequency: FrequencySchema.default({}),
@@ -1018,19 +1051,53 @@ var ConversationRatingSchema = import_zod5.z.object({
   comment: import_zod5.z.string().max(1e3).optional()
 });
 
-// src/capture.ts
+// src/complaints.ts
 var import_zod6 = require("zod");
-var AutocaptureSettingsSchema = import_zod6.z.object({ pageviews: import_zod6.z.boolean(), pageLeave: import_zod6.z.boolean(), clicks: import_zod6.z.boolean(), rageClicks: import_zod6.z.boolean(), heatmaps: import_zod6.z.boolean(), mouseMovement: import_zod6.z.boolean() }).partial();
-var ErrorTrackingSettingsSchema = import_zod6.z.object({ enabled: import_zod6.z.boolean() }).partial();
-var ReplaySettingsSchema = import_zod6.z.object({
-  enabled: import_zod6.z.boolean(),
-  sampleRate: import_zod6.z.number().int().min(0).max(100),
-  recordConsole: import_zod6.z.boolean(),
-  recordNetwork: import_zod6.z.boolean(),
-  recordNetworkPayloads: import_zod6.z.boolean(),
-  maskAllText: import_zod6.z.boolean(),
-  blockSelectors: import_zod6.z.array(import_zod6.z.string().min(1).max(200)).max(50),
-  retentionDays: import_zod6.z.number().int().min(1).max(365)
+
+// src/complaints-limits.ts
+var COMPLAINT_STATUSES = ["open", "in_review", "resolved"];
+var COMPLAINT_EVENTS = ["complaint.filed", "complaint.status_changed", "complaint.replied", "complaint.resolved"];
+var COMPLAINT_FIELD_TYPES = ["text", "choice"];
+var MAX_COMPLAINT_FIELDS = 8;
+var MAX_COMPLAINT_CHOICES = 12;
+var MAX_COMPLAINT_LENGTH = 4e3;
+var MAX_COMPLAINT_ANSWER_LENGTH = 500;
+var MAX_COMPLAINT_ATTACHMENT_BYTES = 2 * 1024 * 1024;
+var complaintReference = (number) => `CMP-${number}`;
+
+// src/complaints.ts
+var FileComplaintSchema = import_zod6.z.object({
+  anonymousId: import_zod6.z.string().min(1).max(128),
+  userId: import_zod6.z.string().max(256).optional().nullable(),
+  categoryId: import_zod6.z.string().min(1).max(64),
+  description: import_zod6.z.string().trim().min(1).max(MAX_COMPLAINT_LENGTH),
+  /** Answers to the category's extra questions, by field id. */
+  answers: import_zod6.z.record(import_zod6.z.string().max(64), import_zod6.z.string().trim().max(MAX_COMPLAINT_ANSWER_LENGTH)).default({}),
+  /** Required from visitors the app hasn't identified. */
+  email: import_zod6.z.string().trim().toLowerCase().email().max(254).optional().nullable(),
+  pageUrl: import_zod6.z.string().max(2e3).optional(),
+  /** File it in this conversation (send its token in `X-Guidely-Conversation`); otherwise a new one is started. */
+  conversationId: import_zod6.z.string().min(1).max(64).optional().nullable(),
+  /** One screenshot, base64-encoded (png, jpeg, webp or gif). */
+  attachment: import_zod6.z.object({
+    fileName: import_zod6.z.string().trim().min(1).max(200),
+    data: import_zod6.z.string().max(Math.ceil(MAX_COMPLAINT_ATTACHMENT_BYTES * 4 / 3) + 4)
+  }).optional().nullable()
+});
+
+// src/capture.ts
+var import_zod7 = require("zod");
+var AutocaptureSettingsSchema = import_zod7.z.object({ pageviews: import_zod7.z.boolean(), pageLeave: import_zod7.z.boolean(), clicks: import_zod7.z.boolean(), rageClicks: import_zod7.z.boolean(), heatmaps: import_zod7.z.boolean(), mouseMovement: import_zod7.z.boolean() }).partial();
+var ErrorTrackingSettingsSchema = import_zod7.z.object({ enabled: import_zod7.z.boolean() }).partial();
+var ReplaySettingsSchema = import_zod7.z.object({
+  enabled: import_zod7.z.boolean(),
+  sampleRate: import_zod7.z.number().int().min(0).max(100),
+  recordConsole: import_zod7.z.boolean(),
+  recordNetwork: import_zod7.z.boolean(),
+  recordNetworkPayloads: import_zod7.z.boolean(),
+  maskAllText: import_zod7.z.boolean(),
+  blockSelectors: import_zod7.z.array(import_zod7.z.string().min(1).max(200)).max(50),
+  retentionDays: import_zod7.z.number().int().min(1).max(365)
 }).partial();
 var DEFAULT_CAPTURE_SETTINGS = {
   autocapture: { pageviews: true, pageLeave: true, clicks: true, rageClicks: true, heatmaps: true, mouseMovement: true },
@@ -1051,18 +1118,18 @@ function resolveCaptureSettings(settings) {
   };
 }
 var HEATMAP_VIEWPORTS = { mobile: [0, 767], tablet: [768, 1279], desktop: [1280, 1e5] };
-var ReplayChunkSchema = import_zod6.z.object({
-  sessionId: import_zod6.z.string().min(1).max(128),
-  windowId: import_zod6.z.string().min(1).max(64),
-  seq: import_zod6.z.number().int().min(0).max(1e6),
-  anonymousId: import_zod6.z.string().min(1).max(128),
-  userId: import_zod6.z.string().max(256).optional().nullable(),
+var ReplayChunkSchema = import_zod7.z.object({
+  sessionId: import_zod7.z.string().min(1).max(128),
+  windowId: import_zod7.z.string().min(1).max(64),
+  seq: import_zod7.z.number().int().min(0).max(1e6),
+  anonymousId: import_zod7.z.string().min(1).max(128),
+  userId: import_zod7.z.string().max(256).optional().nullable(),
   /** rrweb `eventWithTime` objects, in order. */
-  events: import_zod6.z.array(import_zod6.z.object({ type: import_zod6.z.number().int(), timestamp: import_zod6.z.number() }).passthrough()).min(1).max(5e4),
-  url: import_zod6.z.string().max(2e3).optional(),
-  device: import_zod6.z.object({ type: import_zod6.z.string().max(20), browser: import_zod6.z.string().max(40).optional(), os: import_zod6.z.string().max(40).optional() }).optional(),
-  viewport: import_zod6.z.object({ width: import_zod6.z.number().int().min(0).max(1e5), height: import_zod6.z.number().int().min(0).max(1e5) }).optional(),
-  sdk: import_zod6.z.object({ name: import_zod6.z.string().max(60), version: import_zod6.z.string().max(30) }).optional()
+  events: import_zod7.z.array(import_zod7.z.object({ type: import_zod7.z.number().int(), timestamp: import_zod7.z.number() }).passthrough()).min(1).max(5e4),
+  url: import_zod7.z.string().max(2e3).optional(),
+  device: import_zod7.z.object({ type: import_zod7.z.string().max(20), browser: import_zod7.z.string().max(40).optional(), os: import_zod7.z.string().max(40).optional() }).optional(),
+  viewport: import_zod7.z.object({ width: import_zod7.z.number().int().min(0).max(1e5), height: import_zod7.z.number().int().min(0).max(1e5) }).optional(),
+  sdk: import_zod7.z.object({ name: import_zod7.z.string().max(60), version: import_zod7.z.string().max(30) }).optional()
 });
 var REPLAY_MAX_COMPRESSED_BYTES = 2 * 1024 * 1024;
 var REPLAY_MAX_RAW_BYTES = 16 * 1024 * 1024;
@@ -1433,12 +1500,51 @@ function isArticleListed(collections, article, member) {
   }
   return true;
 }
+var ARTICLE_VISIBILITIES = ["everyone", "identified"];
+var LOGGED_IN_AUDIENCE = "$identified";
+function servedArticleAudiences(audienceIds, visibility) {
+  return visibility === "identified" && audienceIds.length === 0 ? [LOGGED_IN_AUDIENCE] : [...audienceIds];
+}
+function visitorAudiences(audienceIds, identified) {
+  const ids = audienceIds.filter((id) => id !== LOGGED_IN_AUDIENCE);
+  return identified ? [...ids, LOGGED_IN_AUDIENCE] : ids;
+}
 function visibleArticleIds(collections, articles, member) {
   return new Set(resourceCenterSections(collections, articles, member).flatMap((s) => s.articles.map((a) => a.id)));
 }
+var SHOW_ME_CLASS = "gd-show-me";
+var SHOW_ME_HREF_PREFIX = "#guidely-show-me:";
+var SHOW_ME_KEY = /^[A-Za-z0-9_-]{1,64}$/;
+function showMeHref(guideKey) {
+  return `${SHOW_ME_HREF_PREFIX}${guideKey}`;
+}
+function showMeKeyFromHref(href) {
+  if (!href || !href.startsWith(SHOW_ME_HREF_PREFIX)) return null;
+  const key = href.slice(SHOW_ME_HREF_PREFIX.length);
+  return SHOW_ME_KEY.test(key) ? key : null;
+}
+function showMeKeys(html) {
+  const out = [];
+  for (const m of (html ?? "").matchAll(/href="#guidely-show-me:([A-Za-z0-9_-]{1,64})"/g)) if (!out.includes(m[1])) out.push(m[1]);
+  return out.slice(0, 10);
+}
+function hasVideoMedia(html) {
+  return /<(video|iframe)\b/i.test(html ?? "");
+}
+var words = (s) => s.toLowerCase().match(/[\p{L}\p{N}]+/gu) ?? [];
+function matchesHelpQuery(text, query) {
+  const q = query.trim().toLowerCase();
+  if (!q) return true;
+  const hay = text.toLowerCase();
+  if (hay.includes(q)) return true;
+  const terms = words(q);
+  if (!terms.length) return false;
+  const have = words(hay);
+  return terms.every((t) => have.some((w) => w.startsWith(t) || t.length > 3 && t.endsWith("s") && w.startsWith(t.slice(0, -1))));
+}
 
 // src/howto.ts
-var import_zod7 = require("zod");
+var import_zod8 = require("zod");
 
 // src/howto-limits.ts
 var CAPTURE_PARAM = "guidely_capture";
@@ -1447,36 +1553,36 @@ var CAPTURE_SCREENSHOT_MAX_BYTES = 8 * 1024 * 1024;
 // src/howto.ts
 var HOWTO_STEP_KINDS = ["action", "text", "heading", "tip", "alert"];
 var HOWTO_ACTIONS = ["click", "type", "select", "navigate"];
-var NormalizedRectSchema = import_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 NormalizedRectSchema = import_zod8.z.object({
+  x: import_zod8.z.number().min(0).max(1),
+  y: import_zod8.z.number().min(0).max(1),
+  width: import_zod8.z.number().min(0).max(1),
+  height: import_zod8.z.number().min(0).max(1)
 });
-var CapturedElementSchema = import_zod7.z.object({
+var CapturedElementSchema = import_zod8.z.object({
   /** Visible name: aria-label, associated label, text, placeholder, alt or title. */
-  label: import_zod7.z.string().max(200).default(""),
+  label: import_zod8.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("")
+  role: import_zod8.z.string().max(40).default("element"),
+  tag: import_zod8.z.string().max(40).default("")
 });
-var CaptureStepSchema = import_zod7.z.object({
+var CaptureStepSchema = import_zod8.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(""),
+  clientId: import_zod8.z.string().min(1).max(64),
+  action: import_zod8.z.enum(HOWTO_ACTIONS),
+  url: import_zod8.z.string().max(2e3),
+  pageTitle: import_zod8.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),
+  value: import_zod8.z.string().max(200).optional(),
+  valueRedacted: import_zod8.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([]),
+  selectors: import_zod8.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()
+  redactions: import_zod8.z.number().int().min(0).max(1e3).default(0),
+  occurredAt: import_zod8.z.string().datetime().optional()
 });
 function quoted(s) {
   const t = (s ?? "").replace(/\s+/g, " ").trim();
@@ -1490,8 +1596,8 @@ function cleanLabel(label) {
 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) : "";
+  const words2 = decodeURIComponent(segment).replace(/[-_+]+/g, " ").trim();
+  return words2 ? words2.charAt(0).toUpperCase() + words2.slice(1) : "";
 }
 function pageName(url, pageTitle) {
   const title = (pageTitle ?? "").replace(/\s+/g, " ").trim();
@@ -1547,17 +1653,17 @@ function hostAndPath(url) {
     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 NormalizedPointSchema = import_zod8.z.object({ x: import_zod8.z.number().min(0).max(1), y: import_zod8.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 HowToAnnotationSchema = import_zod8.z.discriminatedUnion("type", [
+  import_zod8.z.object({ id: import_zod8.z.string().min(1).max(32), type: import_zod8.z.literal("arrow"), from: NormalizedPointSchema, to: NormalizedPointSchema, color: import_zod8.z.enum(ANNOTATION_COLORS).default("brand") }),
+  import_zod8.z.object({ id: import_zod8.z.string().min(1).max(32), type: import_zod8.z.literal("text"), at: NormalizedPointSchema, text: import_zod8.z.string().trim().min(1).max(120), color: import_zod8.z.enum(ANNOTATION_COLORS).default("brand") }),
+  import_zod8.z.object({ id: import_zod8.z.string().min(1).max(32), type: import_zod8.z.literal("box"), rect: NormalizedRectSchema, color: import_zod8.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,})(?=/|$)";
+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");
 }
@@ -1567,15 +1673,15 @@ function segmentsOf(path) {
   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);
+  const words2 = segmentsOf(path).flatMap((s) => s.split(/[-_.+\s]+/).filter((w) => w.length > 1 && /[a-z]/.test(w)));
+  return [...new Set(words2)].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(" ");
+  const words2 = last.split(/[-_.+\s]+/).filter(Boolean);
+  if (!words2.length) return null;
+  const label = words2.join(" ");
   return label.charAt(0).toUpperCase() + label.slice(1);
 }
 function firstNameFromTraits(traits) {
@@ -1588,11 +1694,12 @@ function firstNameFromTraits(traits) {
 
 // src/index.ts
 var SDK_API_VERSION = "v1";
-var SHARED_VERSION = "0.8.0";
+var SHARED_VERSION = "0.9.0";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ADVANCE_ON,
   ANNOTATION_COLORS,
+  ARTICLE_VISIBILITIES,
   AUTOCAPTURE_EVENTS,
   AppearanceSchema,
   AuthoringPickSchema,
@@ -1601,6 +1708,9 @@ var SHARED_VERSION = "0.8.0";
   ButtonSchema,
   CAPTURE_PARAM,
   CAPTURE_SCREENSHOT_MAX_BYTES,
+  COMPLAINT_EVENTS,
+  COMPLAINT_FIELD_TYPES,
+  COMPLAINT_STATUSES,
   CaptureStepSchema,
   CapturedElementSchema,
   ChecklistConfigSchema,
@@ -1615,12 +1725,14 @@ var SHARED_VERSION = "0.8.0";
   ErrorTrackingSettingsSchema,
   EventBatchSchema,
   FILE_LINK_CLASS,
+  FileComplaintSchema,
   FrequencySchema,
   GUIDELY_ID_ATTRIBUTE,
   GUIDE_KINDS,
   GUIDE_LIFECYCLE_EVENTS,
   GUIDE_STATUSES,
   GUIDE_TEMPLATES,
+  GUIDE_VISIBILITIES,
   GuideConfigSchema,
   GuideStateUpdateSchema,
   HEATMAP_VIEWPORTS,
@@ -1628,8 +1740,14 @@ var SHARED_VERSION = "0.8.0";
   HOWTO_STEP_KINDS,
   HowToAnnotationSchema,
   IdentifyRequestSchema,
+  LOGGED_IN_AUDIENCE,
   MAX_ANNOTATIONS,
   MAX_COLLECTION_DEPTH,
+  MAX_COMPLAINT_ANSWER_LENGTH,
+  MAX_COMPLAINT_ATTACHMENT_BYTES,
+  MAX_COMPLAINT_CHOICES,
+  MAX_COMPLAINT_FIELDS,
+  MAX_COMPLAINT_LENGTH,
   MAX_MESSAGE_LENGTH,
   MAX_PROPERTY_BYTES,
   MAX_STACK_FRAMES,
@@ -1670,6 +1788,8 @@ var SHARED_VERSION = "0.8.0";
   SENSITIVE_PROPERTY_PATTERN,
   SERVER_ASSISTED_FIELDS,
   SHARED_VERSION,
+  SHOW_ME_CLASS,
+  SHOW_ME_HREF_PREFIX,
   SOURCEMAP_MAX_FILES_PER_UPLOAD,
   SOURCEMAP_MAX_FILE_BYTES,
   STATUS_LEVELS,
@@ -1693,6 +1813,7 @@ var SHARED_VERSION = "0.8.0";
   cleanLabel,
   compare,
   compareVersions,
+  complaintReference,
   defaultGuideConfig,
   defaultStep,
   describeCaptureStep,
@@ -1707,6 +1828,7 @@ var SHARED_VERSION = "0.8.0";
   getPath,
   guidePlatforms,
   guidelyIdFromSelector,
+  hasVideoMedia,
   isAllowedEmbedSrc,
   isArticleListed,
   isChecklistComplete,
@@ -1719,6 +1841,7 @@ var SHARED_VERSION = "0.8.0";
   isVideoContentType,
   matchUrlPattern,
   matchesAudiences,
+  matchesHelpQuery,
   mediaKind,
   mediaMaxBytes,
   normalizeErrorMessage,
@@ -1734,6 +1857,10 @@ var SHARED_VERSION = "0.8.0";
   safeRegExp,
   sanitizeProperties,
   screenPath,
+  servedArticleAudiences,
+  showMeHref,
+  showMeKeyFromHref,
+  showMeKeys,
   slugify,
   stripOrigin,
   supportsPlatform,
@@ -1741,6 +1868,8 @@ var SHARED_VERSION = "0.8.0";
   toEmbedUrl,
   validateGuideConfig,
   visibleArticleIds,
-  visibleButtons
+  visibleButtons,
+  visitorAudiences,
+  withVisibility
 });
 //# sourceMappingURL=index.cjs.map