@guidelytech/shared 0.2.0 → 0.4.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { RuleGroup, Rule } from './runtime.js';
-export { MAX_PROPERTY_BYTES, RULE_FIELDS, RULE_OPERATORS, RuleField, RuleOperator, SENSITIVE_PROPERTY_PATTERN, SERVER_ASSISTED_FIELDS, TargetingContext, clamp, compare, describeRule, emptyRuleGroup, evaluateRule, evaluateRules, fnv1a, getPath, isPlainObject, isRuleGroup, matchUrlPattern, randomId, rolloutBucket, safeRegExp, sanitizeProperties, slugify, stripOrigin } from './runtime.js';
+export { DEFAULT_PLATFORMS, ExceptionProperties, GUIDELY_ID_ATTRIBUTE, MAX_PROPERTY_BYTES, MAX_STACK_FRAMES, NETWORK_PLUGIN, NetworkPluginPayload, NetworkRequest, NetworkRequestType, PLATFORMS, Platform, RULE_FIELDS, RULE_OPERATORS, RuleField, RuleOperator, SENSITIVE_HEADER_PATTERN, SENSITIVE_PARAM_PATTERN, SENSITIVE_PROPERTY_PATTERN, SERVER_ASSISTED_FIELDS, SOURCEMAP_MAX_FILES_PER_UPLOAD, SOURCEMAP_MAX_FILE_BYTES, ShowWhen, StackFrame, SurveyAnswer, SurveyAnswers, TargetingContext, WS_MAX_MESSAGES_PER_SOCKET, WS_MAX_MESSAGE_BYTES, WebSocketMessage, clamp, compare, compareVersions, describeRule, emptyRuleGroup, evaluateRule, evaluateRules, fingerprintError, fnv1a, getPath, guidePlatforms, guidelyIdFromSelector, isChecklistComplete, isPlainObject, isQuestionVisible, isRuleGroup, matchUrlPattern, normalizeErrorMessage, normalizeFrameFile, parseStack, randomId, rolloutBucket, safeRegExp, sanitizeProperties, screenPath, slugify, stripOrigin, supportsPlatform } from './runtime.js';
 import { z } from 'zod';
 
 declare const RuleSchema: z.ZodType<Rule>;
@@ -13,36 +13,37 @@ declare const STEP_TYPES: readonly ["modal", "tooltip", "popover", "spotlight",
 type StepType = (typeof STEP_TYPES)[number];
 declare const PLACEMENTS: readonly ["top", "top-start", "top-end", "right", "right-start", "right-end", "bottom", "bottom-start", "bottom-end", "left", "left-start", "left-end", "auto"];
 type Placement = (typeof PLACEMENTS)[number];
-declare const SELECTOR_KINDS: readonly ["css", "id", "data-attr", "aria", "text", "xpath"];
+/** `guidely-id` is cross-platform: `data-guidely-id` on web, `GuidelyTarget` / `guidelyTarget()` on mobile. */
+declare const SELECTOR_KINDS: readonly ["css", "id", "data-attr", "aria", "text", "xpath", "guidely-id"];
 declare const SelectorStrategySchema: z.ZodObject<{
-    kind: z.ZodEnum<["css", "id", "data-attr", "aria", "text", "xpath"]>;
+    kind: z.ZodEnum<["css", "id", "data-attr", "aria", "text", "xpath", "guidely-id"]>;
     value: z.ZodString;
     /** Optional human-readable label captured at pick time. */
     label: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     value: string;
-    kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath";
+    kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath" | "guidely-id";
     label?: string | undefined;
 }, {
     value: string;
-    kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath";
+    kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath" | "guidely-id";
     label?: string | undefined;
 }>;
 type SelectorStrategy = z.infer<typeof SelectorStrategySchema>;
 declare const TargetSchema: z.ZodObject<{
     /** Ordered strategies; the first one resolving to exactly one element wins. */
     selectors: z.ZodArray<z.ZodObject<{
-        kind: z.ZodEnum<["css", "id", "data-attr", "aria", "text", "xpath"]>;
+        kind: z.ZodEnum<["css", "id", "data-attr", "aria", "text", "xpath", "guidely-id"]>;
         value: z.ZodString;
         /** Optional human-readable label captured at pick time. */
         label: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         value: string;
-        kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath";
+        kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath" | "guidely-id";
         label?: string | undefined;
     }, {
         value: string;
-        kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath";
+        kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath" | "guidely-id";
         label?: string | undefined;
     }>, "many">;
     /** How long to wait for the element before applying fallback. */
@@ -56,7 +57,7 @@ declare const TargetSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     selectors: {
         value: string;
-        kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath";
+        kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath" | "guidely-id";
         label?: string | undefined;
     }[];
     waitMs: number;
@@ -66,7 +67,7 @@ declare const TargetSchema: z.ZodObject<{
 }, {
     selectors: {
         value: string;
-        kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath";
+        kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath" | "guidely-id";
         label?: string | undefined;
     }[];
     waitMs?: number | undefined;
@@ -149,17 +150,17 @@ declare const StepSchema: z.ZodObject<{
     target: z.ZodOptional<z.ZodObject<{
         /** Ordered strategies; the first one resolving to exactly one element wins. */
         selectors: z.ZodArray<z.ZodObject<{
-            kind: z.ZodEnum<["css", "id", "data-attr", "aria", "text", "xpath"]>;
+            kind: z.ZodEnum<["css", "id", "data-attr", "aria", "text", "xpath", "guidely-id"]>;
             value: z.ZodString;
             /** Optional human-readable label captured at pick time. */
             label: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
             value: string;
-            kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath";
+            kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath" | "guidely-id";
             label?: string | undefined;
         }, {
             value: string;
-            kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath";
+            kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath" | "guidely-id";
             label?: string | undefined;
         }>, "many">;
         /** How long to wait for the element before applying fallback. */
@@ -173,7 +174,7 @@ declare const StepSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         selectors: {
             value: string;
-            kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath";
+            kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath" | "guidely-id";
             label?: string | undefined;
         }[];
         waitMs: number;
@@ -183,7 +184,7 @@ declare const StepSchema: z.ZodObject<{
     }, {
         selectors: {
             value: string;
-            kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath";
+            kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath" | "guidely-id";
             label?: string | undefined;
         }[];
         waitMs?: number | undefined;
@@ -279,7 +280,7 @@ declare const StepSchema: z.ZodObject<{
     target?: {
         selectors: {
             value: string;
-            kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath";
+            kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath" | "guidely-id";
             label?: string | undefined;
         }[];
         waitMs: number;
@@ -315,7 +316,7 @@ declare const StepSchema: z.ZodObject<{
     target?: {
         selectors: {
             value: string;
-            kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath";
+            kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath" | "guidely-id";
             label?: string | undefined;
         }[];
         waitMs?: number | undefined;
@@ -565,11 +566,11 @@ declare const SurveyQuestionSchema: z.ZodObject<{
         value: z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodArray<z.ZodString, "many">]>;
     }, "strip", z.ZodTypeAny, {
         value: string | number | string[];
-        op: "equals" | "gte" | "lte" | "in";
+        op: "equals" | "lte" | "gte" | "in";
         questionId: string;
     }, {
         value: string | number | string[];
-        op: "equals" | "gte" | "lte" | "in";
+        op: "equals" | "lte" | "gte" | "in";
         questionId: string;
     }>>;
 }, "strip", z.ZodTypeAny, {
@@ -588,7 +589,7 @@ declare const SurveyQuestionSchema: z.ZodObject<{
     placeholder?: string | undefined;
     showWhen?: {
         value: string | number | string[];
-        op: "equals" | "gte" | "lte" | "in";
+        op: "equals" | "lte" | "gte" | "in";
         questionId: string;
     } | undefined;
 }, {
@@ -607,7 +608,7 @@ declare const SurveyQuestionSchema: z.ZodObject<{
     placeholder?: string | undefined;
     showWhen?: {
         value: string | number | string[];
-        op: "equals" | "gte" | "lte" | "in";
+        op: "equals" | "lte" | "gte" | "in";
         questionId: string;
     } | undefined;
 }>;
@@ -640,11 +641,11 @@ declare const SurveyConfigSchema: z.ZodObject<{
             value: z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodArray<z.ZodString, "many">]>;
         }, "strip", z.ZodTypeAny, {
             value: string | number | string[];
-            op: "equals" | "gte" | "lte" | "in";
+            op: "equals" | "lte" | "gte" | "in";
             questionId: string;
         }, {
             value: string | number | string[];
-            op: "equals" | "gte" | "lte" | "in";
+            op: "equals" | "lte" | "gte" | "in";
             questionId: string;
         }>>;
     }, "strip", z.ZodTypeAny, {
@@ -663,7 +664,7 @@ declare const SurveyConfigSchema: z.ZodObject<{
         placeholder?: string | undefined;
         showWhen?: {
             value: string | number | string[];
-            op: "equals" | "gte" | "lte" | "in";
+            op: "equals" | "lte" | "gte" | "in";
             questionId: string;
         } | undefined;
     }, {
@@ -682,7 +683,7 @@ declare const SurveyConfigSchema: z.ZodObject<{
         placeholder?: string | undefined;
         showWhen?: {
             value: string | number | string[];
-            op: "equals" | "gte" | "lte" | "in";
+            op: "equals" | "lte" | "gte" | "in";
             questionId: string;
         } | undefined;
     }>, "many">;
@@ -709,7 +710,7 @@ declare const SurveyConfigSchema: z.ZodObject<{
         placeholder?: string | undefined;
         showWhen?: {
             value: string | number | string[];
-            op: "equals" | "gte" | "lte" | "in";
+            op: "equals" | "lte" | "gte" | "in";
             questionId: string;
         } | undefined;
     }[];
@@ -734,7 +735,7 @@ declare const SurveyConfigSchema: z.ZodObject<{
         placeholder?: string | undefined;
         showWhen?: {
             value: string | number | string[];
-            op: "equals" | "gte" | "lte" | "in";
+            op: "equals" | "lte" | "gte" | "in";
             questionId: string;
         } | undefined;
     }[];
@@ -779,17 +780,17 @@ declare const GuideConfigSchema: z.ZodObject<{
         target: z.ZodOptional<z.ZodObject<{
             /** Ordered strategies; the first one resolving to exactly one element wins. */
             selectors: z.ZodArray<z.ZodObject<{
-                kind: z.ZodEnum<["css", "id", "data-attr", "aria", "text", "xpath"]>;
+                kind: z.ZodEnum<["css", "id", "data-attr", "aria", "text", "xpath", "guidely-id"]>;
                 value: z.ZodString;
                 /** Optional human-readable label captured at pick time. */
                 label: z.ZodOptional<z.ZodString>;
             }, "strip", z.ZodTypeAny, {
                 value: string;
-                kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath";
+                kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath" | "guidely-id";
                 label?: string | undefined;
             }, {
                 value: string;
-                kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath";
+                kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath" | "guidely-id";
                 label?: string | undefined;
             }>, "many">;
             /** How long to wait for the element before applying fallback. */
@@ -803,7 +804,7 @@ declare const GuideConfigSchema: z.ZodObject<{
         }, "strip", z.ZodTypeAny, {
             selectors: {
                 value: string;
-                kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath";
+                kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath" | "guidely-id";
                 label?: string | undefined;
             }[];
             waitMs: number;
@@ -813,7 +814,7 @@ declare const GuideConfigSchema: z.ZodObject<{
         }, {
             selectors: {
                 value: string;
-                kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath";
+                kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath" | "guidely-id";
                 label?: string | undefined;
             }[];
             waitMs?: number | undefined;
@@ -909,7 +910,7 @@ declare const GuideConfigSchema: z.ZodObject<{
         target?: {
             selectors: {
                 value: string;
-                kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath";
+                kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath" | "guidely-id";
                 label?: string | undefined;
             }[];
             waitMs: number;
@@ -945,7 +946,7 @@ declare const GuideConfigSchema: z.ZodObject<{
         target?: {
             selectors: {
                 value: string;
-                kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath";
+                kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath" | "guidely-id";
                 label?: string | undefined;
             }[];
             waitMs?: number | undefined;
@@ -1158,11 +1159,11 @@ declare const GuideConfigSchema: z.ZodObject<{
                 value: z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodArray<z.ZodString, "many">]>;
             }, "strip", z.ZodTypeAny, {
                 value: string | number | string[];
-                op: "equals" | "gte" | "lte" | "in";
+                op: "equals" | "lte" | "gte" | "in";
                 questionId: string;
             }, {
                 value: string | number | string[];
-                op: "equals" | "gte" | "lte" | "in";
+                op: "equals" | "lte" | "gte" | "in";
                 questionId: string;
             }>>;
         }, "strip", z.ZodTypeAny, {
@@ -1181,7 +1182,7 @@ declare const GuideConfigSchema: z.ZodObject<{
             placeholder?: string | undefined;
             showWhen?: {
                 value: string | number | string[];
-                op: "equals" | "gte" | "lte" | "in";
+                op: "equals" | "lte" | "gte" | "in";
                 questionId: string;
             } | undefined;
         }, {
@@ -1200,7 +1201,7 @@ declare const GuideConfigSchema: z.ZodObject<{
             placeholder?: string | undefined;
             showWhen?: {
                 value: string | number | string[];
-                op: "equals" | "gte" | "lte" | "in";
+                op: "equals" | "lte" | "gte" | "in";
                 questionId: string;
             } | undefined;
         }>, "many">;
@@ -1227,7 +1228,7 @@ declare const GuideConfigSchema: z.ZodObject<{
             placeholder?: string | undefined;
             showWhen?: {
                 value: string | number | string[];
-                op: "equals" | "gte" | "lte" | "in";
+                op: "equals" | "lte" | "gte" | "in";
                 questionId: string;
             } | undefined;
         }[];
@@ -1252,7 +1253,7 @@ declare const GuideConfigSchema: z.ZodObject<{
             placeholder?: string | undefined;
             showWhen?: {
                 value: string | number | string[];
-                op: "equals" | "gte" | "lte" | "in";
+                op: "equals" | "lte" | "gte" | "in";
                 questionId: string;
             } | undefined;
         }[];
@@ -1262,8 +1263,10 @@ declare const GuideConfigSchema: z.ZodObject<{
         startAt?: string | undefined;
         endAt?: string | undefined;
     }>>;
-    /** Restrict guide to url pattern(s) (applied before trigger). */
+    /** Restrict guide to url pattern(s) (applied before trigger). On mobile these match the screen path `/<Screen>`. */
     urlPatterns: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /** Platforms that receive this guide. Guides created before mobile support are web-only. */
+    platforms: z.ZodDefault<z.ZodArray<z.ZodEnum<["web", "ios", "android"]>, "many">>;
 }, "strip", z.ZodTypeAny, {
     targeting: RuleGroup;
     steps: {
@@ -1303,7 +1306,7 @@ declare const GuideConfigSchema: z.ZodObject<{
         target?: {
             selectors: {
                 value: string;
-                kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath";
+                kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath" | "guidely-id";
                 label?: string | undefined;
             }[];
             waitMs: number;
@@ -1345,6 +1348,7 @@ declare const GuideConfigSchema: z.ZodObject<{
         preset?: string | undefined;
     };
     urlPatterns: string[];
+    platforms: ("web" | "ios" | "android")[];
     checklist?: {
         position: "bottom-left" | "bottom-right";
         tasks: {
@@ -1382,7 +1386,7 @@ declare const GuideConfigSchema: z.ZodObject<{
             placeholder?: string | undefined;
             showWhen?: {
                 value: string | number | string[];
-                op: "equals" | "gte" | "lte" | "in";
+                op: "equals" | "lte" | "gte" | "in";
                 questionId: string;
             } | undefined;
         }[];
@@ -1428,7 +1432,7 @@ declare const GuideConfigSchema: z.ZodObject<{
             placeholder?: string | undefined;
             showWhen?: {
                 value: string | number | string[];
-                op: "equals" | "gte" | "lte" | "in";
+                op: "equals" | "lte" | "gte" | "in";
                 questionId: string;
             } | undefined;
         }[];
@@ -1462,7 +1466,7 @@ declare const GuideConfigSchema: z.ZodObject<{
         target?: {
             selectors: {
                 value: string;
-                kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath";
+                kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath" | "guidely-id";
                 label?: string | undefined;
             }[];
             waitMs?: number | undefined;
@@ -1518,6 +1522,7 @@ declare const GuideConfigSchema: z.ZodObject<{
         animation?: "none" | "fade" | "slide" | undefined;
     } | undefined;
     urlPatterns?: string[] | undefined;
+    platforms?: ("web" | "ios" | "android")[] | undefined;
 }>;
 type GuideConfig = z.infer<typeof GuideConfigSchema>;
 type GuideConfigInput = z.input<typeof GuideConfigSchema>;
@@ -1567,13 +1572,15 @@ declare const ProjectThemeSchema: z.ZodObject<{
     brandName?: string | undefined;
 }>;
 
-declare const EVENT_NAMES: readonly ["guide_viewed", "guide_started", "step_viewed", "step_completed", "guide_completed", "guide_skipped", "guide_dismissed", "guide_abandoned", "checklist_task_completed", "checklist_completed", "checklist_dismissed", "survey_displayed", "survey_submitted", "survey_dismissed", "resource_center_opened", "article_viewed", "messenger_opened", "conversation_started", "conversation_handed_off", "scout_answered", "custom", "page_view", "identify"];
+declare const EVENT_NAMES: readonly ["guide_viewed", "guide_started", "step_viewed", "step_completed", "guide_completed", "guide_skipped", "guide_dismissed", "guide_abandoned", "checklist_task_completed", "checklist_completed", "checklist_dismissed", "survey_displayed", "survey_submitted", "survey_dismissed", "resource_center_opened", "article_viewed", "messenger_opened", "conversation_started", "conversation_handed_off", "scout_answered", "custom", "page_view", "identify", "page_leave", "click", "rage_click", "exception", "heatmap"];
 type EventName = (typeof EVENT_NAMES)[number];
+/** Events the SDK records on its own (page analytics, click autocapture, error tracking). */
+declare const AUTOCAPTURE_EVENTS: readonly ["page_view", "page_leave", "click", "rage_click", "exception", "heatmap"];
 declare const GUIDE_LIFECYCLE_EVENTS: readonly ["guide_viewed", "guide_started", "step_viewed", "step_completed", "guide_completed", "guide_skipped", "guide_dismissed", "guide_abandoned"];
 /** Event as produced by the SDK and accepted by POST /api/v1/sdk/events */
 declare const SdkEventSchema: z.ZodObject<{
     eventId: z.ZodString;
-    name: z.ZodEnum<["guide_viewed", "guide_started", "step_viewed", "step_completed", "guide_completed", "guide_skipped", "guide_dismissed", "guide_abandoned", "checklist_task_completed", "checklist_completed", "checklist_dismissed", "survey_displayed", "survey_submitted", "survey_dismissed", "resource_center_opened", "article_viewed", "messenger_opened", "conversation_started", "conversation_handed_off", "scout_answered", "custom", "page_view", "identify"]>;
+    name: z.ZodEnum<["guide_viewed", "guide_started", "step_viewed", "step_completed", "guide_completed", "guide_skipped", "guide_dismissed", "guide_abandoned", "checklist_task_completed", "checklist_completed", "checklist_dismissed", "survey_displayed", "survey_submitted", "survey_dismissed", "resource_center_opened", "article_viewed", "messenger_opened", "conversation_started", "conversation_handed_off", "scout_answered", "custom", "page_view", "identify", "page_leave", "click", "rage_click", "exception", "heatmap"]>;
     /** For `custom` events: the application-defined name. */
     customName: z.ZodOptional<z.ZodString>;
     occurredAt: z.ZodString;
@@ -1589,7 +1596,7 @@ declare const SdkEventSchema: z.ZodObject<{
     properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, "strip", z.ZodTypeAny, {
     eventId: string;
-    name: "custom" | "guide_completed" | "guide_viewed" | "guide_started" | "step_viewed" | "step_completed" | "guide_skipped" | "guide_dismissed" | "guide_abandoned" | "checklist_task_completed" | "checklist_completed" | "checklist_dismissed" | "survey_displayed" | "survey_submitted" | "survey_dismissed" | "resource_center_opened" | "article_viewed" | "messenger_opened" | "conversation_started" | "conversation_handed_off" | "scout_answered" | "page_view" | "identify";
+    name: "custom" | "click" | "guide_completed" | "guide_viewed" | "guide_started" | "step_viewed" | "step_completed" | "guide_skipped" | "guide_dismissed" | "guide_abandoned" | "checklist_task_completed" | "checklist_completed" | "checklist_dismissed" | "survey_displayed" | "survey_submitted" | "survey_dismissed" | "resource_center_opened" | "article_viewed" | "messenger_opened" | "conversation_started" | "conversation_handed_off" | "scout_answered" | "page_view" | "identify" | "page_leave" | "rage_click" | "exception" | "heatmap";
     occurredAt: string;
     anonymousId: string;
     url?: string | undefined;
@@ -1604,7 +1611,7 @@ declare const SdkEventSchema: z.ZodObject<{
     properties?: Record<string, unknown> | undefined;
 }, {
     eventId: string;
-    name: "custom" | "guide_completed" | "guide_viewed" | "guide_started" | "step_viewed" | "step_completed" | "guide_skipped" | "guide_dismissed" | "guide_abandoned" | "checklist_task_completed" | "checklist_completed" | "checklist_dismissed" | "survey_displayed" | "survey_submitted" | "survey_dismissed" | "resource_center_opened" | "article_viewed" | "messenger_opened" | "conversation_started" | "conversation_handed_off" | "scout_answered" | "page_view" | "identify";
+    name: "custom" | "click" | "guide_completed" | "guide_viewed" | "guide_started" | "step_viewed" | "step_completed" | "guide_skipped" | "guide_dismissed" | "guide_abandoned" | "checklist_task_completed" | "checklist_completed" | "checklist_dismissed" | "survey_displayed" | "survey_submitted" | "survey_dismissed" | "resource_center_opened" | "article_viewed" | "messenger_opened" | "conversation_started" | "conversation_handed_off" | "scout_answered" | "page_view" | "identify" | "page_leave" | "rage_click" | "exception" | "heatmap";
     occurredAt: string;
     anonymousId: string;
     url?: string | undefined;
@@ -1622,7 +1629,7 @@ type SdkEvent = z.infer<typeof SdkEventSchema>;
 declare const EventBatchSchema: z.ZodObject<{
     events: z.ZodArray<z.ZodObject<{
         eventId: z.ZodString;
-        name: z.ZodEnum<["guide_viewed", "guide_started", "step_viewed", "step_completed", "guide_completed", "guide_skipped", "guide_dismissed", "guide_abandoned", "checklist_task_completed", "checklist_completed", "checklist_dismissed", "survey_displayed", "survey_submitted", "survey_dismissed", "resource_center_opened", "article_viewed", "messenger_opened", "conversation_started", "conversation_handed_off", "scout_answered", "custom", "page_view", "identify"]>;
+        name: z.ZodEnum<["guide_viewed", "guide_started", "step_viewed", "step_completed", "guide_completed", "guide_skipped", "guide_dismissed", "guide_abandoned", "checklist_task_completed", "checklist_completed", "checklist_dismissed", "survey_displayed", "survey_submitted", "survey_dismissed", "resource_center_opened", "article_viewed", "messenger_opened", "conversation_started", "conversation_handed_off", "scout_answered", "custom", "page_view", "identify", "page_leave", "click", "rage_click", "exception", "heatmap"]>;
         /** For `custom` events: the application-defined name. */
         customName: z.ZodOptional<z.ZodString>;
         occurredAt: z.ZodString;
@@ -1638,7 +1645,7 @@ declare const EventBatchSchema: z.ZodObject<{
         properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, "strip", z.ZodTypeAny, {
         eventId: string;
-        name: "custom" | "guide_completed" | "guide_viewed" | "guide_started" | "step_viewed" | "step_completed" | "guide_skipped" | "guide_dismissed" | "guide_abandoned" | "checklist_task_completed" | "checklist_completed" | "checklist_dismissed" | "survey_displayed" | "survey_submitted" | "survey_dismissed" | "resource_center_opened" | "article_viewed" | "messenger_opened" | "conversation_started" | "conversation_handed_off" | "scout_answered" | "page_view" | "identify";
+        name: "custom" | "click" | "guide_completed" | "guide_viewed" | "guide_started" | "step_viewed" | "step_completed" | "guide_skipped" | "guide_dismissed" | "guide_abandoned" | "checklist_task_completed" | "checklist_completed" | "checklist_dismissed" | "survey_displayed" | "survey_submitted" | "survey_dismissed" | "resource_center_opened" | "article_viewed" | "messenger_opened" | "conversation_started" | "conversation_handed_off" | "scout_answered" | "page_view" | "identify" | "page_leave" | "rage_click" | "exception" | "heatmap";
         occurredAt: string;
         anonymousId: string;
         url?: string | undefined;
@@ -1653,7 +1660,7 @@ declare const EventBatchSchema: z.ZodObject<{
         properties?: Record<string, unknown> | undefined;
     }, {
         eventId: string;
-        name: "custom" | "guide_completed" | "guide_viewed" | "guide_started" | "step_viewed" | "step_completed" | "guide_skipped" | "guide_dismissed" | "guide_abandoned" | "checklist_task_completed" | "checklist_completed" | "checklist_dismissed" | "survey_displayed" | "survey_submitted" | "survey_dismissed" | "resource_center_opened" | "article_viewed" | "messenger_opened" | "conversation_started" | "conversation_handed_off" | "scout_answered" | "page_view" | "identify";
+        name: "custom" | "click" | "guide_completed" | "guide_viewed" | "guide_started" | "step_viewed" | "step_completed" | "guide_skipped" | "guide_dismissed" | "guide_abandoned" | "checklist_task_completed" | "checklist_completed" | "checklist_dismissed" | "survey_displayed" | "survey_submitted" | "survey_dismissed" | "resource_center_opened" | "article_viewed" | "messenger_opened" | "conversation_started" | "conversation_handed_off" | "scout_answered" | "page_view" | "identify" | "page_leave" | "rage_click" | "exception" | "heatmap";
         occurredAt: string;
         anonymousId: string;
         url?: string | undefined;
@@ -1681,7 +1688,7 @@ declare const EventBatchSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     events: {
         eventId: string;
-        name: "custom" | "guide_completed" | "guide_viewed" | "guide_started" | "step_viewed" | "step_completed" | "guide_skipped" | "guide_dismissed" | "guide_abandoned" | "checklist_task_completed" | "checklist_completed" | "checklist_dismissed" | "survey_displayed" | "survey_submitted" | "survey_dismissed" | "resource_center_opened" | "article_viewed" | "messenger_opened" | "conversation_started" | "conversation_handed_off" | "scout_answered" | "page_view" | "identify";
+        name: "custom" | "click" | "guide_completed" | "guide_viewed" | "guide_started" | "step_viewed" | "step_completed" | "guide_skipped" | "guide_dismissed" | "guide_abandoned" | "checklist_task_completed" | "checklist_completed" | "checklist_dismissed" | "survey_displayed" | "survey_submitted" | "survey_dismissed" | "resource_center_opened" | "article_viewed" | "messenger_opened" | "conversation_started" | "conversation_handed_off" | "scout_answered" | "page_view" | "identify" | "page_leave" | "rage_click" | "exception" | "heatmap";
         occurredAt: string;
         anonymousId: string;
         url?: string | undefined;
@@ -1703,7 +1710,7 @@ declare const EventBatchSchema: z.ZodObject<{
 }, {
     events: {
         eventId: string;
-        name: "custom" | "guide_completed" | "guide_viewed" | "guide_started" | "step_viewed" | "step_completed" | "guide_skipped" | "guide_dismissed" | "guide_abandoned" | "checklist_task_completed" | "checklist_completed" | "checklist_dismissed" | "survey_displayed" | "survey_submitted" | "survey_dismissed" | "resource_center_opened" | "article_viewed" | "messenger_opened" | "conversation_started" | "conversation_handed_off" | "scout_answered" | "page_view" | "identify";
+        name: "custom" | "click" | "guide_completed" | "guide_viewed" | "guide_started" | "step_viewed" | "step_completed" | "guide_skipped" | "guide_dismissed" | "guide_abandoned" | "checklist_task_completed" | "checklist_completed" | "checklist_dismissed" | "survey_displayed" | "survey_submitted" | "survey_dismissed" | "resource_center_opened" | "article_viewed" | "messenger_opened" | "conversation_started" | "conversation_handed_off" | "scout_answered" | "page_view" | "identify" | "page_leave" | "rage_click" | "exception" | "heatmap";
         occurredAt: string;
         anonymousId: string;
         url?: string | undefined;
@@ -1875,6 +1882,257 @@ interface SdkArticlesResponse {
     articles: SdkArticleSummary[];
 }
 
+/**
+ * Product-analytics capture settings. Stored on `Project.settings` (keys `autocapture`,
+ * `errorTracking`, `replay`) and delivered to the SDK in `SdkConfigResponse.settings`. The project
+ * setting turns a capability on; SDK options can only turn it off for one installation.
+ */
+interface AutocaptureSettings {
+    /** `page_view` on load and on every SPA navigation. */
+    pageviews: boolean;
+    /** `page_leave` with visible time on page and scroll depth. */
+    pageLeave: boolean;
+    /** `click` on buttons, links and other interactive elements. */
+    clicks: boolean;
+    /** `rage_click` when the same spot is clicked 3+ times within a second. */
+    rageClicks: boolean;
+    /** Batched click positions on every element (`heatmap` events) for click heatmaps. */
+    heatmaps: boolean;
+    /** Mouse-movement heatmaps: pointer position sampled while it moves, aggregated in the browser into `heatmap` events. */
+    mouseMovement: boolean;
+}
+interface ErrorTrackingSettings {
+    /** Uncaught errors and unhandled promise rejections become `exception` events. */
+    enabled: boolean;
+}
+interface ReplaySettings {
+    enabled: boolean;
+    /** Percentage of sessions recorded (0–100), decided once per session. */
+    sampleRate: number;
+    /** Record console.log/warn/error output into the recording. */
+    recordConsole: boolean;
+    /** Record network requests (method, URL with sensitive query values redacted, status, timing, size). */
+    recordNetwork: boolean;
+    /** Also record request/response headers and text/JSON bodies (redacted, ≤10KB each). Off by default. */
+    recordNetworkPayloads: boolean;
+    /** Mask every text node (inputs are always masked). */
+    maskAllText: boolean;
+    /** Elements replaced by a placeholder box in recordings (in addition to `[data-guidely-block]`). */
+    blockSelectors: string[];
+    /** Days recordings are kept before the worker deletes them. */
+    retentionDays: number;
+}
+interface CaptureSettings {
+    autocapture: AutocaptureSettings;
+    errorTracking: ErrorTrackingSettings;
+    replay: ReplaySettings;
+}
+declare const AutocaptureSettingsSchema: z.ZodObject<{
+    pageviews: z.ZodOptional<z.ZodBoolean>;
+    pageLeave: z.ZodOptional<z.ZodBoolean>;
+    clicks: z.ZodOptional<z.ZodBoolean>;
+    rageClicks: z.ZodOptional<z.ZodBoolean>;
+    heatmaps: z.ZodOptional<z.ZodBoolean>;
+    mouseMovement: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    pageviews?: boolean | undefined;
+    pageLeave?: boolean | undefined;
+    clicks?: boolean | undefined;
+    rageClicks?: boolean | undefined;
+    heatmaps?: boolean | undefined;
+    mouseMovement?: boolean | undefined;
+}, {
+    pageviews?: boolean | undefined;
+    pageLeave?: boolean | undefined;
+    clicks?: boolean | undefined;
+    rageClicks?: boolean | undefined;
+    heatmaps?: boolean | undefined;
+    mouseMovement?: boolean | undefined;
+}>;
+declare const ErrorTrackingSettingsSchema: z.ZodObject<{
+    enabled: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    enabled?: boolean | undefined;
+}, {
+    enabled?: boolean | undefined;
+}>;
+declare const ReplaySettingsSchema: z.ZodObject<{
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    sampleRate: z.ZodOptional<z.ZodNumber>;
+    recordConsole: z.ZodOptional<z.ZodBoolean>;
+    recordNetwork: z.ZodOptional<z.ZodBoolean>;
+    recordNetworkPayloads: z.ZodOptional<z.ZodBoolean>;
+    maskAllText: z.ZodOptional<z.ZodBoolean>;
+    blockSelectors: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    retentionDays: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    enabled?: boolean | undefined;
+    sampleRate?: number | undefined;
+    recordConsole?: boolean | undefined;
+    recordNetwork?: boolean | undefined;
+    recordNetworkPayloads?: boolean | undefined;
+    maskAllText?: boolean | undefined;
+    blockSelectors?: string[] | undefined;
+    retentionDays?: number | undefined;
+}, {
+    enabled?: boolean | undefined;
+    sampleRate?: number | undefined;
+    recordConsole?: boolean | undefined;
+    recordNetwork?: boolean | undefined;
+    recordNetworkPayloads?: boolean | undefined;
+    maskAllText?: boolean | undefined;
+    blockSelectors?: string[] | undefined;
+    retentionDays?: number | undefined;
+}>;
+declare const DEFAULT_CAPTURE_SETTINGS: CaptureSettings;
+/** Fills defaults for whatever a project's stored settings leave out. */
+declare function resolveCaptureSettings(settings: unknown): CaptureSettings;
+/**
+ * One position in a `heatmap` event (`properties.points`). `x`/`y` are page coordinates in CSS
+ * pixels; `s` is a stable selector for the element and `rx`/`ry` the position inside it (0–1), which
+ * lets the dashboard place the point on the element even when layouts differ.
+ *
+ * Mouse movement (`k: "m"`) is sampled at most every 200ms while the pointer moves and binned in the
+ * browser (per element at 0.1 of `rx`/`ry`, else on a 16px page grid); `w` is the number of samples
+ * in the bin, so a minute of movement costs a few dozen points rather than thousands.
+ */
+interface HeatmapPoint {
+    /** `c` click, `r` part of a rage-click burst, `m` mouse movement. */
+    k: "c" | "r" | "m";
+    x: number;
+    y: number;
+    s?: string;
+    rx?: number;
+    ry?: number;
+    /** Weight: samples aggregated into this point (movement only; clicks are 1). */
+    w?: number;
+}
+/** Properties of a `heatmap` event: a batch of clicks on one page (flushed at ~40 points and on page leave). */
+interface HeatmapProperties {
+    path?: string;
+    viewportWidth: number;
+    viewportHeight: number;
+    /** Document scroll height when the batch was sent. */
+    pageHeight: number;
+    points: HeatmapPoint[];
+}
+/** Viewport buckets heatmaps are split by (CSS px of `viewportWidth`). */
+declare const HEATMAP_VIEWPORTS: {
+    readonly mobile: readonly [0, 767];
+    readonly tablet: readonly [768, 1279];
+    readonly desktop: readonly [1280, 100000];
+};
+type HeatmapViewport = keyof typeof HEATMAP_VIEWPORTS;
+/**
+ * One upload of rrweb events for a recording, `POST /api/v1/sdk/replay`. The SDK sends it as JSON,
+ * or gzip-compressed JSON with `?enc=gzip`. A recording is keyed by the SDK session id; every page
+ * load starts a new `windowId` whose uploads are numbered by `seq`.
+ */
+declare const ReplayChunkSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    windowId: z.ZodString;
+    seq: z.ZodNumber;
+    anonymousId: z.ZodString;
+    userId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    /** rrweb `eventWithTime` objects, in order. */
+    events: z.ZodArray<z.ZodObject<{
+        type: z.ZodNumber;
+        timestamp: z.ZodNumber;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        type: z.ZodNumber;
+        timestamp: z.ZodNumber;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        type: z.ZodNumber;
+        timestamp: z.ZodNumber;
+    }, z.ZodTypeAny, "passthrough">>, "many">;
+    url: z.ZodOptional<z.ZodString>;
+    device: z.ZodOptional<z.ZodObject<{
+        type: z.ZodString;
+        browser: z.ZodOptional<z.ZodString>;
+        os: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: string;
+        browser?: string | undefined;
+        os?: string | undefined;
+    }, {
+        type: string;
+        browser?: string | undefined;
+        os?: string | undefined;
+    }>>;
+    viewport: z.ZodOptional<z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        width: number;
+        height: number;
+    }, {
+        width: number;
+        height: number;
+    }>>;
+    sdk: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        version: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        version: string;
+    }, {
+        name: string;
+        version: string;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    anonymousId: string;
+    sessionId: string;
+    events: z.objectOutputType<{
+        type: z.ZodNumber;
+        timestamp: z.ZodNumber;
+    }, z.ZodTypeAny, "passthrough">[];
+    windowId: string;
+    seq: number;
+    url?: string | undefined;
+    userId?: string | null | undefined;
+    sdk?: {
+        name: string;
+        version: string;
+    } | undefined;
+    device?: {
+        type: string;
+        browser?: string | undefined;
+        os?: string | undefined;
+    } | undefined;
+    viewport?: {
+        width: number;
+        height: number;
+    } | undefined;
+}, {
+    anonymousId: string;
+    sessionId: string;
+    events: z.objectInputType<{
+        type: z.ZodNumber;
+        timestamp: z.ZodNumber;
+    }, z.ZodTypeAny, "passthrough">[];
+    windowId: string;
+    seq: number;
+    url?: string | undefined;
+    userId?: string | null | undefined;
+    sdk?: {
+        name: string;
+        version: string;
+    } | undefined;
+    device?: {
+        type: string;
+        browser?: string | undefined;
+        os?: string | undefined;
+    } | undefined;
+    viewport?: {
+        width: number;
+        height: number;
+    } | undefined;
+}>;
+type ReplayChunk = z.infer<typeof ReplayChunkSchema>;
+/** Max upload sizes for one replay chunk (bytes on the wire, and after decompression). */
+declare const REPLAY_MAX_COMPRESSED_BYTES: number;
+declare const REPLAY_MAX_RAW_BYTES: number;
+
 /** A published guide as delivered to the SDK. Draft-only data (author, notes) is never included. */
 interface PublishedGuide {
     id: string;
@@ -1939,6 +2197,11 @@ interface SdkConfigResponse {
         collectUrls: boolean;
         maskSelectors: string[];
         sessionTimeoutMinutes: number;
+        /** Product analytics; absent from servers that predate it (the SDK then captures nothing extra). */
+        autocapture?: AutocaptureSettings;
+        errorTracking?: ErrorTrackingSettings;
+        /** `retentionDays` is server-side only and not sent. */
+        replay?: Omit<ReplaySettings, "retentionDays">;
     };
     generatedAt: string;
 }
@@ -2106,14 +2369,14 @@ declare const AuthoringPickSchema: z.ZodObject<{
         height: z.ZodNumber;
     }, "strip", z.ZodTypeAny, {
         width: number;
+        height: number;
         x: number;
         y: number;
-        height: number;
     }, {
         width: number;
+        height: number;
         x: number;
         y: number;
-        height: number;
     }>>;
 }, "strip", z.ZodTypeAny, {
     selectors: {
@@ -2126,9 +2389,9 @@ declare const AuthoringPickSchema: z.ZodObject<{
     stepId?: string | undefined;
     rect?: {
         width: number;
+        height: number;
         x: number;
         y: number;
-        height: number;
     } | undefined;
 }, {
     selectors: {
@@ -2141,9 +2404,9 @@ declare const AuthoringPickSchema: z.ZodObject<{
     stepId?: string | undefined;
     rect?: {
         width: number;
+        height: number;
         x: number;
         y: number;
-        height: number;
     } | undefined;
 }>;
 type AuthoringPick = z.infer<typeof AuthoringPickSchema>;
@@ -2214,16 +2477,16 @@ declare const PublishedGuideSchema: z.ZodObject<{
             }>, "many">>;
             target: z.ZodOptional<z.ZodObject<{
                 selectors: z.ZodArray<z.ZodObject<{
-                    kind: z.ZodEnum<["css", "id", "data-attr", "aria", "text", "xpath"]>;
+                    kind: z.ZodEnum<["css", "id", "data-attr", "aria", "text", "xpath", "guidely-id"]>;
                     value: z.ZodString;
                     label: z.ZodOptional<z.ZodString>;
                 }, "strip", z.ZodTypeAny, {
                     value: string;
-                    kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath";
+                    kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath" | "guidely-id";
                     label?: string | undefined;
                 }, {
                     value: string;
-                    kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath";
+                    kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath" | "guidely-id";
                     label?: string | undefined;
                 }>, "many">;
                 waitMs: z.ZodDefault<z.ZodNumber>;
@@ -2233,7 +2496,7 @@ declare const PublishedGuideSchema: z.ZodObject<{
             }, "strip", z.ZodTypeAny, {
                 selectors: {
                     value: string;
-                    kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath";
+                    kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath" | "guidely-id";
                     label?: string | undefined;
                 }[];
                 waitMs: number;
@@ -2243,7 +2506,7 @@ declare const PublishedGuideSchema: z.ZodObject<{
             }, {
                 selectors: {
                     value: string;
-                    kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath";
+                    kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath" | "guidely-id";
                     label?: string | undefined;
                 }[];
                 waitMs?: number | undefined;
@@ -2329,7 +2592,7 @@ declare const PublishedGuideSchema: z.ZodObject<{
             target?: {
                 selectors: {
                     value: string;
-                    kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath";
+                    kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath" | "guidely-id";
                     label?: string | undefined;
                 }[];
                 waitMs: number;
@@ -2365,7 +2628,7 @@ declare const PublishedGuideSchema: z.ZodObject<{
             target?: {
                 selectors: {
                     value: string;
-                    kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath";
+                    kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath" | "guidely-id";
                     label?: string | undefined;
                 }[];
                 waitMs?: number | undefined;
@@ -2569,11 +2832,11 @@ declare const PublishedGuideSchema: z.ZodObject<{
                     value: z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodArray<z.ZodString, "many">]>;
                 }, "strip", z.ZodTypeAny, {
                     value: string | number | string[];
-                    op: "equals" | "gte" | "lte" | "in";
+                    op: "equals" | "lte" | "gte" | "in";
                     questionId: string;
                 }, {
                     value: string | number | string[];
-                    op: "equals" | "gte" | "lte" | "in";
+                    op: "equals" | "lte" | "gte" | "in";
                     questionId: string;
                 }>>;
             }, "strip", z.ZodTypeAny, {
@@ -2592,7 +2855,7 @@ declare const PublishedGuideSchema: z.ZodObject<{
                 placeholder?: string | undefined;
                 showWhen?: {
                     value: string | number | string[];
-                    op: "equals" | "gte" | "lte" | "in";
+                    op: "equals" | "lte" | "gte" | "in";
                     questionId: string;
                 } | undefined;
             }, {
@@ -2611,7 +2874,7 @@ declare const PublishedGuideSchema: z.ZodObject<{
                 placeholder?: string | undefined;
                 showWhen?: {
                     value: string | number | string[];
-                    op: "equals" | "gte" | "lte" | "in";
+                    op: "equals" | "lte" | "gte" | "in";
                     questionId: string;
                 } | undefined;
             }>, "many">;
@@ -2638,7 +2901,7 @@ declare const PublishedGuideSchema: z.ZodObject<{
                 placeholder?: string | undefined;
                 showWhen?: {
                     value: string | number | string[];
-                    op: "equals" | "gte" | "lte" | "in";
+                    op: "equals" | "lte" | "gte" | "in";
                     questionId: string;
                 } | undefined;
             }[];
@@ -2663,7 +2926,7 @@ declare const PublishedGuideSchema: z.ZodObject<{
                 placeholder?: string | undefined;
                 showWhen?: {
                     value: string | number | string[];
-                    op: "equals" | "gte" | "lte" | "in";
+                    op: "equals" | "lte" | "gte" | "in";
                     questionId: string;
                 } | undefined;
             }[];
@@ -2674,6 +2937,7 @@ declare const PublishedGuideSchema: z.ZodObject<{
             endAt?: string | undefined;
         }>>;
         urlPatterns: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        platforms: z.ZodDefault<z.ZodArray<z.ZodEnum<["web", "ios", "android"]>, "many">>;
     }, "strip", z.ZodTypeAny, {
         targeting: RuleGroup;
         steps: {
@@ -2713,7 +2977,7 @@ declare const PublishedGuideSchema: z.ZodObject<{
             target?: {
                 selectors: {
                     value: string;
-                    kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath";
+                    kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath" | "guidely-id";
                     label?: string | undefined;
                 }[];
                 waitMs: number;
@@ -2755,6 +3019,7 @@ declare const PublishedGuideSchema: z.ZodObject<{
             preset?: string | undefined;
         };
         urlPatterns: string[];
+        platforms: ("web" | "ios" | "android")[];
         checklist?: {
             position: "bottom-left" | "bottom-right";
             tasks: {
@@ -2792,7 +3057,7 @@ declare const PublishedGuideSchema: z.ZodObject<{
                 placeholder?: string | undefined;
                 showWhen?: {
                     value: string | number | string[];
-                    op: "equals" | "gte" | "lte" | "in";
+                    op: "equals" | "lte" | "gte" | "in";
                     questionId: string;
                 } | undefined;
             }[];
@@ -2838,7 +3103,7 @@ declare const PublishedGuideSchema: z.ZodObject<{
                 placeholder?: string | undefined;
                 showWhen?: {
                     value: string | number | string[];
-                    op: "equals" | "gte" | "lte" | "in";
+                    op: "equals" | "lte" | "gte" | "in";
                     questionId: string;
                 } | undefined;
             }[];
@@ -2872,7 +3137,7 @@ declare const PublishedGuideSchema: z.ZodObject<{
             target?: {
                 selectors: {
                     value: string;
-                    kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath";
+                    kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath" | "guidely-id";
                     label?: string | undefined;
                 }[];
                 waitMs?: number | undefined;
@@ -2928,6 +3193,7 @@ declare const PublishedGuideSchema: z.ZodObject<{
             animation?: "none" | "fade" | "slide" | undefined;
         } | undefined;
         urlPatterns?: string[] | undefined;
+        platforms?: ("web" | "ios" | "android")[] | undefined;
     }>;
     publishedAt: z.ZodString;
 }, "strip", z.ZodTypeAny, {
@@ -2975,7 +3241,7 @@ declare const PublishedGuideSchema: z.ZodObject<{
             target?: {
                 selectors: {
                     value: string;
-                    kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath";
+                    kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath" | "guidely-id";
                     label?: string | undefined;
                 }[];
                 waitMs: number;
@@ -3017,6 +3283,7 @@ declare const PublishedGuideSchema: z.ZodObject<{
             preset?: string | undefined;
         };
         urlPatterns: string[];
+        platforms: ("web" | "ios" | "android")[];
         checklist?: {
             position: "bottom-left" | "bottom-right";
             tasks: {
@@ -3054,7 +3321,7 @@ declare const PublishedGuideSchema: z.ZodObject<{
                 placeholder?: string | undefined;
                 showWhen?: {
                     value: string | number | string[];
-                    op: "equals" | "gte" | "lte" | "in";
+                    op: "equals" | "lte" | "gte" | "in";
                     questionId: string;
                 } | undefined;
             }[];
@@ -3108,7 +3375,7 @@ declare const PublishedGuideSchema: z.ZodObject<{
                 placeholder?: string | undefined;
                 showWhen?: {
                     value: string | number | string[];
-                    op: "equals" | "gte" | "lte" | "in";
+                    op: "equals" | "lte" | "gte" | "in";
                     questionId: string;
                 } | undefined;
             }[];
@@ -3142,7 +3409,7 @@ declare const PublishedGuideSchema: z.ZodObject<{
             target?: {
                 selectors: {
                     value: string;
-                    kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath";
+                    kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath" | "guidely-id";
                     label?: string | undefined;
                 }[];
                 waitMs?: number | undefined;
@@ -3198,6 +3465,7 @@ declare const PublishedGuideSchema: z.ZodObject<{
             animation?: "none" | "fade" | "slide" | undefined;
         } | undefined;
         urlPatterns?: string[] | undefined;
+        platforms?: ("web" | "ios" | "android")[] | undefined;
     };
     publishedAt: string;
 }>;
@@ -3259,7 +3527,7 @@ declare function templateConfig(id: string): {
             target?: {
                 selectors: {
                     value: string;
-                    kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath";
+                    kind: "id" | "css" | "data-attr" | "aria" | "text" | "xpath" | "guidely-id";
                     label?: string | undefined;
                 }[];
                 waitMs: number;
@@ -3301,6 +3569,7 @@ declare function templateConfig(id: string): {
             preset?: string | undefined;
         };
         urlPatterns: string[];
+        platforms: ("web" | "ios" | "android")[];
         checklist?: {
             position: "bottom-left" | "bottom-right";
             tasks: {
@@ -3338,7 +3607,7 @@ declare function templateConfig(id: string): {
                 placeholder?: string | undefined;
                 showWhen?: {
                     value: string | number | string[];
-                    op: "equals" | "gte" | "lte" | "in";
+                    op: "equals" | "lte" | "gte" | "in";
                     questionId: string;
                 } | undefined;
             }[];
@@ -3351,6 +3620,6 @@ declare function templateConfig(id: string): {
 } | null;
 
 declare const SDK_API_VERSION = "v1";
-declare const SHARED_VERSION = "0.2.0";
+declare const SHARED_VERSION = "0.4.0";
 
-export { ADVANCE_ON, type ApiError, type AppSnapshot, type Appearance, AppearanceSchema, type AuthoringPick, AuthoringPickSchema, type AuthoringSessionInfo, BUTTON_ACTIONS, ButtonSchema, type ChecklistConfig, ChecklistConfigSchema, type ChecklistProgressRequest, ChecklistProgressRequestSchema, type ChecklistTask, ChecklistTaskSchema, type ConversationLookupResponse, ConversationLookupSchema, type ConversationMessagesResponse, ConversationRatingSchema, type ConversationStatus, EVENT_NAMES, type EventBatch, EventBatchSchema, type EventName, type FrequencyConfig, FrequencySchema, GUIDE_KINDS, GUIDE_LIFECYCLE_EVENTS, GUIDE_STATUSES, GUIDE_TEMPLATES, type GuideConfig, type GuideConfigInput, GuideConfigSchema, type GuideKind, GuideStateUpdateSchema, type GuideStatus, type GuideStep, type GuideStepInput, type GuideTemplate, type IdentifyRequest, IdentifyRequestSchema, type IdentifyResponse, MAX_MESSAGE_LENGTH, MESSAGE_AUTHORS, type MessageAuthor, type MessengerCitation, type MessengerConfig, type MessengerConversation, type MessengerMessage, type MessengerSuggestedGuide, PLACEMENTS, type Placement, PostMessageSchema, type ProjectTheme, ProjectThemeSchema, type PublishedGuide, PublishedGuideSchema, type ResourceCenterArticle, type ResourceCenterConfig, Rule, RuleGroup, RuleGroupSchema, RuleSchema, SDK_API_VERSION, SELECTOR_KINDS, SHARED_VERSION, STEP_TYPES, SURVEY_QUESTION_TYPES, type ScoutStreamEvent, type SdkArticleSummary, type SdkArticlesResponse, type SdkConfigResponse, type SdkEvent, SdkEventSchema, type SelectorStrategy, SelectorStrategySchema, type StartConversationRequest, type StartConversationResponse, StartConversationSchema, StepBranchSchema, type StepButton, StepSchema, type StepTarget, type StepType, type SurveyConfig, SurveyConfigSchema, type SurveyQuestion, SurveyQuestionSchema, type SurveyResponseRequest, SurveyResponseRequestSchema, TRIGGER_TYPES, TargetSchema, type TriggerConfig, TriggerSchema, type ValidationIssue, defaultGuideConfig, defaultStep, templateConfig, validateGuideConfig, visibleButtons };
+export { ADVANCE_ON, AUTOCAPTURE_EVENTS, type ApiError, type AppSnapshot, type Appearance, AppearanceSchema, type AuthoringPick, AuthoringPickSchema, type AuthoringSessionInfo, type AutocaptureSettings, AutocaptureSettingsSchema, BUTTON_ACTIONS, ButtonSchema, type CaptureSettings, type ChecklistConfig, ChecklistConfigSchema, type ChecklistProgressRequest, ChecklistProgressRequestSchema, type ChecklistTask, ChecklistTaskSchema, type ConversationLookupResponse, ConversationLookupSchema, type ConversationMessagesResponse, ConversationRatingSchema, type ConversationStatus, DEFAULT_CAPTURE_SETTINGS, EVENT_NAMES, type ErrorTrackingSettings, ErrorTrackingSettingsSchema, type EventBatch, EventBatchSchema, type EventName, type FrequencyConfig, FrequencySchema, GUIDE_KINDS, GUIDE_LIFECYCLE_EVENTS, GUIDE_STATUSES, GUIDE_TEMPLATES, type GuideConfig, type GuideConfigInput, GuideConfigSchema, type GuideKind, GuideStateUpdateSchema, type GuideStatus, type GuideStep, type GuideStepInput, type GuideTemplate, HEATMAP_VIEWPORTS, type HeatmapPoint, type HeatmapProperties, type HeatmapViewport, type IdentifyRequest, IdentifyRequestSchema, type IdentifyResponse, MAX_MESSAGE_LENGTH, MESSAGE_AUTHORS, type MessageAuthor, type MessengerCitation, type MessengerConfig, type MessengerConversation, type MessengerMessage, type MessengerSuggestedGuide, PLACEMENTS, type Placement, PostMessageSchema, type ProjectTheme, ProjectThemeSchema, type PublishedGuide, PublishedGuideSchema, REPLAY_MAX_COMPRESSED_BYTES, REPLAY_MAX_RAW_BYTES, type ReplayChunk, ReplayChunkSchema, type ReplaySettings, ReplaySettingsSchema, type ResourceCenterArticle, type ResourceCenterConfig, Rule, RuleGroup, RuleGroupSchema, RuleSchema, SDK_API_VERSION, SELECTOR_KINDS, SHARED_VERSION, STEP_TYPES, SURVEY_QUESTION_TYPES, type ScoutStreamEvent, type SdkArticleSummary, type SdkArticlesResponse, type SdkConfigResponse, type SdkEvent, SdkEventSchema, type SelectorStrategy, SelectorStrategySchema, type StartConversationRequest, type StartConversationResponse, StartConversationSchema, StepBranchSchema, type StepButton, StepSchema, type StepTarget, type StepType, type SurveyConfig, SurveyConfigSchema, type SurveyQuestion, SurveyQuestionSchema, type SurveyResponseRequest, SurveyResponseRequestSchema, TRIGGER_TYPES, TargetSchema, type TriggerConfig, TriggerSchema, type ValidationIssue, defaultGuideConfig, defaultStep, resolveCaptureSettings, templateConfig, validateGuideConfig, visibleButtons };