@guidelytech/shared 0.2.1 → 0.4.1

package/dist/runtime.d.ts

@@ -15,9 +15,70 @@ declare function stripOrigin(url: string): string;
 /** Safe regexp construction with a length cap to limit ReDoS exposure. */
 declare function safeRegExp(source: string, flags?: string): RegExp | null;
 
+/**
+ * Cross-platform helpers shared by the web SDK, the React Native SDK and (as a reference for) the
+ * native iOS/Android SDKs. Zod-free so it can ship in runtime bundles.
+ */
+/** Platforms a guide can be delivered to. */
+declare const PLATFORMS: readonly ["web", "ios", "android"];
+type Platform = (typeof PLATFORMS)[number];
+/** Guides published before platforms existed have no `platforms` field and are web-only. */
+declare const DEFAULT_PLATFORMS: Platform[];
+/** Platforms a guide config targets (missing field → web only). */
+declare function guidePlatforms(config: {
+    platforms?: readonly string[] | null;
+}): string[];
+declare function supportsPlatform(config: {
+    platforms?: readonly string[] | null;
+}, platform: string): boolean;
+/** Attribute web apps put on elements to share a target id with their mobile apps. */
+declare const GUIDELY_ID_ATTRIBUTE = "data-guidely-id";
+/**
+ * Extracts a Guidely target id from a trigger / advance / checklist value so the same guide works on
+ * web and mobile. Accepts a bare id (`new-deal`), `#new-deal`, or `[data-guidely-id="new-deal"]`
+ * (also `data-testid` / `data-tour`). Returns null for selectors that cannot name a single id.
+ */
+declare function guidelyIdFromSelector(value: string | null | undefined): string | null;
+/**
+ * Mobile SDKs have screens instead of URLs. URL-based features (URL patterns, `url_match` triggers,
+ * multi-page steps, `url_visited` checklist tasks) match against the screen path `/<ScreenName>`.
+ */
+declare function screenPath(screen: string | null | undefined): string;
+/**
+ * Compares dotted version strings numerically (`2.10.0` > `2.9.3`). Non-numeric parts compare as
+ * strings; a missing part counts as 0 (`2.1` == `2.1.0`). Returns -1, 0 or 1, or null when either
+ * side is empty.
+ */
+declare function compareVersions(a: unknown, b: unknown): -1 | 0 | 1 | null;
+
+/**
+ * Pure checklist / survey logic shared by every renderer (web runtime, React Native, and the
+ * reference for the native SDKs). Zod-free; uses structural types so it stays in the runtime entry.
+ */
+type SurveyAnswer = string | number | boolean | string[];
+type SurveyAnswers = Record<string, SurveyAnswer>;
+interface ShowWhen {
+    questionId: string;
+    op: "equals" | "lte" | "gte" | "in";
+    value: string | number | string[];
+}
+/** Evaluates a question's `showWhen` condition against current answers. */
+declare function isQuestionVisible(q: {
+    showWhen?: ShowWhen;
+}, answers: SurveyAnswers): boolean;
+/** Are all required tasks done? */
+declare function isChecklistComplete(config: {
+    tasks: Array<{
+        id: string;
+        required: boolean;
+    }>;
+}, progress: {
+    completedTaskIds: string[];
+}): boolean;
+
 declare const RULE_OPERATORS: readonly ["equals", "not_equals", "contains", "not_contains", "starts_with", "ends_with", "exists", "not_exists", "gt", "gte", "lt", "lte", "in", "not_in", "regex", "is_true", "is_false", "before", "after"];
 type RuleOperator = (typeof RULE_OPERATORS)[number];
-declare const RULE_FIELDS: readonly ["user.attribute", "account.attribute", "user.role", "user.plan", "url.path", "url.full", "url.query", "device.type", "device.browser", "device.os", "visitor.firstVisit", "visitor.returning", "event.seen", "guide.completed", "guide.dismissed", "guide.seen", "checklist.completed", "audience.member", "datetime.now", "datetime.dayOfWeek", "datetime.hour", "rollout.percentage", "environment", "locale"];
+declare const RULE_FIELDS: readonly ["user.attribute", "account.attribute", "user.role", "user.plan", "url.path", "url.full", "url.query", "device.type", "device.browser", "device.os", "visitor.firstVisit", "visitor.returning", "event.seen", "guide.completed", "guide.dismissed", "guide.seen", "checklist.completed", "audience.member", "datetime.now", "datetime.dayOfWeek", "datetime.hour", "rollout.percentage", "environment", "locale", "app.platform", "app.screen", "app.version"];
 type RuleField = (typeof RULE_FIELDS)[number];
 interface Rule {
     id: string;
@@ -61,6 +122,12 @@ interface TargetingContext {
     now: Date;
     environment: string;
     locale?: string;
+    /** `web`, `ios` or `android`. Missing means web. */
+    platform?: string;
+    /** Current screen name (mobile SDKs; set via `screen()`). */
+    screen?: string;
+    /** Host app version (mobile SDKs), e.g. `2.4.1`. */
+    appVersion?: string;
     /** Salt for rollout (guide id). Set per guide before evaluating. */
     rolloutSalt?: string;
 }
@@ -77,4 +144,126 @@ declare const SENSITIVE_PROPERTY_PATTERN: RegExp;
 declare const MAX_PROPERTY_BYTES: number;
 declare function sanitizeProperties(props: Record<string, unknown> | undefined): Record<string, unknown>;
 
-export { MAX_PROPERTY_BYTES, RULE_FIELDS, RULE_OPERATORS, type Rule, type RuleField, type RuleGroup, type RuleOperator, SENSITIVE_PROPERTY_PATTERN, SERVER_ASSISTED_FIELDS, type TargetingContext, clamp, compare, describeRule, emptyRuleGroup, evaluateRule, evaluateRules, fnv1a, getPath, isPlainObject, isRuleGroup, matchUrlPattern, randomId, rolloutBucket, safeRegExp, sanitizeProperties, slugify, stripOrigin };
+/** One parsed stack frame. `file` is the script URL (or path) as the browser reported it. */
+interface StackFrame {
+    fn?: string;
+    file?: string;
+    line?: number;
+    col?: number;
+}
+/** Properties carried by an `exception` event (see `docs/product-analytics.md`). */
+interface ExceptionProperties {
+    type: string;
+    message: string;
+    frames: StackFrame[];
+    /** `onerror` | `unhandledrejection` | `manual` (captureException) | `console`. */
+    source?: string;
+    handled?: boolean;
+    /** App version or commit (SDK option `release`); selects the matching uploaded source maps. */
+    release?: string;
+    /** Set by the server at ingestion; groups occurrences into an issue. */
+    fingerprint?: string;
+}
+declare const MAX_STACK_FRAMES = 30;
+/** Parses `Error.stack` from V8, SpiderMonkey and JavaScriptCore into frames (innermost first). */
+declare function parseStack(stack: string | undefined | null, max?: number): StackFrame[];
+/** Replaces volatile parts of a message (numbers, ids, quoted values) so repeats group together. */
+declare function normalizeErrorMessage(message: string): string;
+/** Strips origin, query, hash and build hashes (`main.3f2a1b9c.js` → `main.js`) from a script URL. */
+declare function normalizeFrameFile(file: string | undefined): string;
+/** Source map upload limits (`POST /api/v1/sourcemaps/upload`). */
+declare const SOURCEMAP_MAX_FILE_BYTES: number;
+declare const SOURCEMAP_MAX_FILES_PER_UPLOAD = 200;
+/**
+ * Stable issue key for an exception: error type + normalised message + the innermost frame that
+ * has a file (path without build hash + function name, or its original source + name when a source
+ * map resolved it). Line/column numbers are left out because they change with every deploy of a
+ * minified bundle.
+ */
+declare function fingerprintError(input: {
+    type?: string;
+    message?: string;
+    frames?: StackFrame[];
+    original?: {
+        source: string;
+        name?: string | null;
+    } | null;
+}): string;
+
+/** rrweb plugin name for network events in recordings (event type 6, `data.plugin`). */
+declare const NETWORK_PLUGIN = "guidely/network@1";
+/** Request kinds, from `fetch`/`XMLHttpRequest` patching or `PerformanceResourceTiming.initiatorType`. */
+type NetworkRequestType = "fetch" | "xhr" | "websocket" | "document" | "script" | "stylesheet" | "image" | "font" | "media" | "beacon" | "other";
+/**
+ * One network request in a recording: the payload of an rrweb plugin event
+ * `{ type: 6, data: { plugin: NETWORK_PLUGIN, payload: NetworkPluginPayload } }`, batched.
+ * Times are epoch milliseconds (same clock as rrweb event timestamps).
+ *
+ * A WebSocket is a request with `type: "websocket"` and `method: "GET"`, emitted when it opens
+ * (`startTime`) and again, with the same `id`, when it closes (`endTime`, `closeCode`, `closeReason`,
+ * totals in `messages`). Its frames are `WebSocketMessage`s referencing that `id`.
+ */
+interface NetworkRequest {
+    /** Stable id within the recording. */
+    id: string;
+    type: NetworkRequestType;
+    method: string;
+    /** Absolute URL; values of sensitive-looking query parameters replaced with `[redacted]`. */
+    url: string;
+    startTime: number;
+    endTime?: number;
+    durationMs?: number;
+    /** HTTP status; 0 for network errors / blocked / aborted. Absent when the browser doesn't expose it. */
+    status?: number;
+    /** Set for failed requests: network error, abort or timeout message. */
+    error?: string;
+    /** Encoded bytes transferred / decoded response size, when known. */
+    transferSize?: number;
+    responseSize?: number;
+    /** Only when `recordNetworkPayloads` is on; sensitive headers are `[redacted]`. */
+    requestHeaders?: Record<string, string>;
+    responseHeaders?: Record<string, string>;
+    /** Text/JSON bodies, ≤10KB, sensitive JSON fields masked; `[binary]` / `[truncated]` markers otherwise. */
+    requestBody?: string;
+    responseBody?: string;
+    /** WebSocket only: negotiated subprotocol, close details, and frame totals (all frames, including ones not recorded). */
+    protocol?: string;
+    closeCode?: number;
+    closeReason?: string;
+    messages?: {
+        sent: number;
+        received: number;
+        sentBytes: number;
+        receivedBytes: number;
+        recorded: number;
+    };
+}
+/** One WebSocket frame. At most `WS_MAX_MESSAGES_PER_SOCKET` are recorded per connection per page load. */
+interface WebSocketMessage {
+    /** The `NetworkRequest.id` of the connection. */
+    socketId: string;
+    dir: "send" | "recv";
+    time: number;
+    /** Bytes (UTF-8 length for text frames). */
+    size: number;
+    binary?: boolean;
+    /** Only with `recordNetworkPayloads`: text ≤ 2KB (JSON with sensitive keys masked), else `[truncated]`; binary frames are `[binary <n> B]`. */
+    data?: string;
+}
+interface NetworkPluginPayload {
+    requests?: NetworkRequest[];
+    messages?: WebSocketMessage[];
+    /** Requests/frames dropped since the previous payload because a cap was reached. */
+    dropped?: {
+        requests?: number;
+        messages?: number;
+    };
+}
+declare const WS_MAX_MESSAGES_PER_SOCKET = 200;
+declare const WS_MAX_MESSAGE_BYTES = 2048;
+/** Header names always replaced with `[redacted]` when payload capture is on. */
+declare const SENSITIVE_HEADER_PATTERN: RegExp;
+/** Query parameter and JSON field names whose values are redacted. */
+declare const SENSITIVE_PARAM_PATTERN: RegExp;
+
+export { DEFAULT_PLATFORMS, type ExceptionProperties, GUIDELY_ID_ATTRIBUTE, MAX_PROPERTY_BYTES, MAX_STACK_FRAMES, NETWORK_PLUGIN, type NetworkPluginPayload, type NetworkRequest, type NetworkRequestType, PLATFORMS, type Platform, RULE_FIELDS, RULE_OPERATORS, type Rule, type RuleField, type RuleGroup, type RuleOperator, SENSITIVE_HEADER_PATTERN, SENSITIVE_PARAM_PATTERN, SENSITIVE_PROPERTY_PATTERN, SERVER_ASSISTED_FIELDS, SOURCEMAP_MAX_FILES_PER_UPLOAD, SOURCEMAP_MAX_FILE_BYTES, type ShowWhen, type StackFrame, type SurveyAnswer, type SurveyAnswers, type TargetingContext, WS_MAX_MESSAGES_PER_SOCKET, WS_MAX_MESSAGE_BYTES, type 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 };

package/dist/runtime.js

@@ -1,49 +1,93 @@
 import {
+  DEFAULT_PLATFORMS,
+  GUIDELY_ID_ATTRIBUTE,
   MAX_PROPERTY_BYTES,
+  MAX_STACK_FRAMES,
+  NETWORK_PLUGIN,
+  PLATFORMS,
   RULE_FIELDS,
   RULE_OPERATORS,
+  SENSITIVE_HEADER_PATTERN,
+  SENSITIVE_PARAM_PATTERN,
   SENSITIVE_PROPERTY_PATTERN,
   SERVER_ASSISTED_FIELDS,
+  SOURCEMAP_MAX_FILES_PER_UPLOAD,
+  SOURCEMAP_MAX_FILE_BYTES,
+  WS_MAX_MESSAGES_PER_SOCKET,
+  WS_MAX_MESSAGE_BYTES,
   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
-} from "./chunk-OFBIZEM5.js";
+  stripOrigin,
+  supportsPlatform
+} from "./chunk-QUKMOTT4.js";
 export {
+  DEFAULT_PLATFORMS,
+  GUIDELY_ID_ATTRIBUTE,
   MAX_PROPERTY_BYTES,
+  MAX_STACK_FRAMES,
+  NETWORK_PLUGIN,
+  PLATFORMS,
   RULE_FIELDS,
   RULE_OPERATORS,
+  SENSITIVE_HEADER_PATTERN,
+  SENSITIVE_PARAM_PATTERN,
   SENSITIVE_PROPERTY_PATTERN,
   SERVER_ASSISTED_FIELDS,
+  SOURCEMAP_MAX_FILES_PER_UPLOAD,
+  SOURCEMAP_MAX_FILE_BYTES,
+  WS_MAX_MESSAGES_PER_SOCKET,
+  WS_MAX_MESSAGE_BYTES,
   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
+  stripOrigin,
+  supportsPlatform
 };
 //# sourceMappingURL=runtime.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guidelytech/shared",
-  "version": "0.2.1",
+  "version": "0.4.1",
   "description": "Shared schemas, types and pure utilities for Guidely",
   "license": "MIT",
   "type": "module",

package/dist/chunk-OFBIZEM5.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/utils.ts","../src/targeting-eval.ts","../src/events-util.ts"],"sourcesContent":["/** FNV-1a 32-bit hash; deterministic across SDK and server for rollout bucketing. */\nexport function fnv1a(input: string): number {\n  let h = 0x811c9dc5;\n  for (let i = 0; i < input.length; i++) {\n    h ^= input.charCodeAt(i);\n    h = Math.imul(h, 0x01000193) >>> 0;\n  }\n  return h >>> 0;\n}\n\n/** Deterministic 0-99 bucket for percentage rollouts. */\nexport function rolloutBucket(subject: string, salt: string): number {\n  return fnv1a(`${salt}:${subject}`) % 100;\n}\n\nexport function slugify(input: string): string {\n  return input\n    .toLowerCase()\n    .trim()\n    .replace(/[^a-z0-9]+/g, \"-\")\n    .replace(/^-+|-+$/g, \"\")\n    .slice(0, 64) || \"untitled\";\n}\n\nconst ALPHABET = \"0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ\";\n/** URL-safe random id. Uses crypto when available, falls back to Math.random (ids are not secrets). */\nexport function randomId(size = 16): string {\n  const g: any = typeof globalThis !== \"undefined\" ? globalThis : {};\n  let bytes: Uint8Array;\n  if (g.crypto && typeof g.crypto.getRandomValues === \"function\") {\n    bytes = new Uint8Array(size);\n    g.crypto.getRandomValues(bytes);\n  } else {\n    bytes = new Uint8Array(size);\n    for (let i = 0; i < size; i++) bytes[i] = Math.floor(Math.random() * 256);\n  }\n  let out = \"\";\n  for (let i = 0; i < size; i++) out += ALPHABET[(bytes[i] as number) % ALPHABET.length];\n  return out;\n}\n\nexport function isPlainObject(v: unknown): v is Record<string, unknown> {\n  return typeof v === \"object\" && v !== null && !Array.isArray(v);\n}\n\n/** Safe nested getter: get(obj, \"account.plan\") */\nexport function getPath(obj: unknown, path: string): unknown {\n  if (!path) return obj;\n  let cur: any = obj;\n  for (const part of path.split(\".\")) {\n    if (cur == null) return undefined;\n    cur = cur[part];\n  }\n  return cur;\n}\n\nexport function clamp(n: number, min: number, max: number): number {\n  return Math.min(max, Math.max(min, n));\n}\n\n/** Glob-style URL pattern match: `*` matches any chars except `/`, `**` matches anything. */\nexport function matchUrlPattern(pattern: string, url: string): boolean {\n  if (!pattern) return true;\n  if (pattern === url) return true;\n  const escaped = pattern\n    .replace(/[.+?^${}()|[\\]\\\\]/g, \"\\\\$&\")\n    .replace(/\\*\\*/g, \"__GLOBSTAR__\")\n    .replace(/\\*/g, \"[^/]*\")\n    .replace(/__GLOBSTAR__/g, \".*\");\n  const re = new RegExp(`^${escaped}$`);\n  return re.test(url) || re.test(stripOrigin(url));\n}\n\nexport function stripOrigin(url: string): string {\n  try {\n    const u = new URL(url);\n    return u.pathname + u.search + u.hash;\n  } catch {\n    return url;\n  }\n}\n\n/** Safe regexp construction with a length cap to limit ReDoS exposure. */\nexport function safeRegExp(source: string, flags = \"i\"): RegExp | null {\n  if (!source || source.length > 200) return null;\n  try {\n    return new RegExp(source, flags);\n  } catch {\n    return null;\n  }\n}\n","/**\n * Zod-free targeting evaluation. Imported by the browser SDK via `@guidelytech/shared/runtime`\n * so the runtime bundle does not pull in zod. Schemas live in ./targeting.ts.\n */\nimport { getPath, matchUrlPattern, rolloutBucket, safeRegExp } from \"./utils\";\n\nexport const RULE_OPERATORS = [\n  \"equals\",\n  \"not_equals\",\n  \"contains\",\n  \"not_contains\",\n  \"starts_with\",\n  \"ends_with\",\n  \"exists\",\n  \"not_exists\",\n  \"gt\",\n  \"gte\",\n  \"lt\",\n  \"lte\",\n  \"in\",\n  \"not_in\",\n  \"regex\",\n  \"is_true\",\n  \"is_false\",\n  \"before\",\n  \"after\",\n] as const;\nexport type RuleOperator = (typeof RULE_OPERATORS)[number];\n\nexport const RULE_FIELDS = [\n  \"user.attribute\",\n  \"account.attribute\",\n  \"user.role\",\n  \"user.plan\",\n  \"url.path\",\n  \"url.full\",\n  \"url.query\",\n  \"device.type\",\n  \"device.browser\",\n  \"device.os\",\n  \"visitor.firstVisit\",\n  \"visitor.returning\",\n  \"event.seen\",\n  \"guide.completed\",\n  \"guide.dismissed\",\n  \"guide.seen\",\n  \"checklist.completed\",\n  \"audience.member\",\n  \"datetime.now\",\n  \"datetime.dayOfWeek\",\n  \"datetime.hour\",\n  \"rollout.percentage\",\n  \"environment\",\n  \"locale\",\n] as const;\nexport type RuleField = (typeof RULE_FIELDS)[number];\n\nexport interface Rule {\n  id: string;\n  field: RuleField;\n  /** For attribute/query/event fields: the attribute key, query param name, event name, guide id... */\n  key?: string;\n  op: RuleOperator;\n  value?: string | number | boolean | string[];\n  /** When true, the rule is negated (exclusion rule). */\n  negate?: boolean;\n}\n\nexport type RuleGroup = {\n  id: string;\n  op: \"and\" | \"or\";\n  rules: Array<Rule | RuleGroup>;\n  negate?: boolean;\n};\n\nexport function isRuleGroup(r: Rule | RuleGroup): r is RuleGroup {\n  return (r as RuleGroup).rules !== undefined;\n}\n\nexport function emptyRuleGroup(id = \"root\"): RuleGroup {\n  return { id, op: \"and\", rules: [] };\n}\n\n/** Everything targeting evaluation can see. Built by the SDK (browser) or the server. */\nexport interface TargetingContext {\n  userId?: string | null;\n  anonymousId: string;\n  userAttributes: Record<string, unknown>;\n  accountAttributes: Record<string, unknown>;\n  url: string;\n  path: string;\n  query: Record<string, string>;\n  device: { type: \"desktop\" | \"tablet\" | \"mobile\"; browser?: string; os?: string };\n  firstVisit: boolean;\n  eventsSeen: Set<string> | string[];\n  completedGuides: Set<string> | string[];\n  dismissedGuides: Set<string> | string[];\n  seenGuides: Set<string> | string[];\n  completedChecklists: Set<string> | string[];\n  audienceIds: Set<string> | string[];\n  now: Date;\n  environment: string;\n  locale?: string;\n  /** Salt for rollout (guide id). Set per guide before evaluating. */\n  rolloutSalt?: string;\n}\n\nfunction has(set: Set<string> | string[] | undefined, v: string): boolean {\n  if (!set) return false;\n  return set instanceof Set ? set.has(v) : set.includes(v);\n}\n\nfunction resolveField(rule: Rule, ctx: TargetingContext): unknown {\n  switch (rule.field) {\n    case \"user.attribute\":\n      return rule.key ? getPath(ctx.userAttributes, rule.key) : undefined;\n    case \"account.attribute\":\n      return rule.key ? getPath(ctx.accountAttributes, rule.key) : undefined;\n    case \"user.role\":\n      return ctx.userAttributes.role;\n    case \"user.plan\":\n      return ctx.userAttributes.plan ?? ctx.accountAttributes.plan;\n    case \"url.path\":\n      return ctx.path;\n    case \"url.full\":\n      return ctx.url;\n    case \"url.query\":\n      return rule.key ? ctx.query[rule.key] : undefined;\n    case \"device.type\":\n      return ctx.device.type;\n    case \"device.browser\":\n      return ctx.device.browser;\n    case \"device.os\":\n      return ctx.device.os;\n    case \"visitor.firstVisit\":\n      return ctx.firstVisit;\n    case \"visitor.returning\":\n      return !ctx.firstVisit;\n    case \"event.seen\":\n      return rule.key ? has(ctx.eventsSeen, rule.key) : false;\n    case \"guide.completed\":\n      return rule.key ? has(ctx.completedGuides, rule.key) : false;\n    case \"guide.dismissed\":\n      return rule.key ? has(ctx.dismissedGuides, rule.key) : false;\n    case \"guide.seen\":\n      return rule.key ? has(ctx.seenGuides, rule.key) : false;\n    case \"checklist.completed\":\n      return rule.key ? has(ctx.completedChecklists, rule.key) : false;\n    case \"audience.member\":\n      return rule.key ? has(ctx.audienceIds, rule.key) : false;\n    case \"datetime.now\":\n      return ctx.now.toISOString();\n    case \"datetime.dayOfWeek\":\n      return ctx.now.getDay();\n    case \"datetime.hour\":\n      return ctx.now.getHours();\n    case \"rollout.percentage\":\n      return rolloutBucket(ctx.userId || ctx.anonymousId, ctx.rolloutSalt || \"guidely\");\n    case \"environment\":\n      return ctx.environment;\n    case \"locale\":\n      return ctx.locale;\n    default:\n      return undefined;\n  }\n}\n\nfunction toNumber(v: unknown): number | null {\n  if (typeof v === \"number\") return v;\n  if (typeof v === \"string\" && v.trim() !== \"\" && !Number.isNaN(Number(v))) return Number(v);\n  if (v instanceof Date) return v.getTime();\n  return null;\n}\n\nfunction toDateMs(v: unknown): number | null {\n  if (v instanceof Date) return v.getTime();\n  if (typeof v === \"string\") {\n    const t = Date.parse(v);\n    return Number.isNaN(t) ? null : t;\n  }\n  if (typeof v === \"number\") return v;\n  return null;\n}\n\nexport function compare(op: RuleOperator, actual: unknown, expected: Rule[\"value\"]): boolean {\n  switch (op) {\n    case \"exists\":\n      return actual !== undefined && actual !== null && actual !== \"\";\n    case \"not_exists\":\n      return actual === undefined || actual === null || actual === \"\";\n    case \"is_true\":\n      return actual === true || actual === \"true\";\n    case \"is_false\":\n      return actual === false || actual === \"false\";\n    case \"equals\":\n      if (typeof actual === \"boolean\") return String(actual) === String(expected);\n      return String(actual ?? \"\") === String(expected ?? \"\");\n    case \"not_equals\":\n      return String(actual ?? \"\") !== String(expected ?? \"\");\n    case \"contains\":\n      return typeof actual === \"string\" && actual.toLowerCase().includes(String(expected ?? \"\").toLowerCase());\n    case \"not_contains\":\n      return !(typeof actual === \"string\" && actual.toLowerCase().includes(String(expected ?? \"\").toLowerCase()));\n    case \"starts_with\":\n      return typeof actual === \"string\" && actual.startsWith(String(expected ?? \"\"));\n    case \"ends_with\":\n      return typeof actual === \"string\" && actual.endsWith(String(expected ?? \"\"));\n    case \"gt\":\n    case \"gte\":\n    case \"lt\":\n    case \"lte\": {\n      const a = toNumber(actual);\n      const b = toNumber(expected);\n      if (a === null || b === null) return false;\n      return op === \"gt\" ? a > b : op === \"gte\" ? a >= b : op === \"lt\" ? a < b : a <= b;\n    }\n    case \"in\": {\n      const list = Array.isArray(expected) ? expected : String(expected ?? \"\").split(\",\").map((s) => s.trim());\n      return list.includes(String(actual ?? \"\"));\n    }\n    case \"not_in\": {\n      const list = Array.isArray(expected) ? expected : String(expected ?? \"\").split(\",\").map((s) => s.trim());\n      return !list.includes(String(actual ?? \"\"));\n    }\n    case \"regex\": {\n      const re = safeRegExp(String(expected ?? \"\"));\n      return !!re && typeof actual === \"string\" && re.test(actual);\n    }\n    case \"before\": {\n      const a = toDateMs(actual);\n      const b = toDateMs(expected);\n      return a !== null && b !== null && a < b;\n    }\n    case \"after\": {\n      const a = toDateMs(actual);\n      const b = toDateMs(expected);\n      return a !== null && b !== null && a > b;\n    }\n    default:\n      return false;\n  }\n}\n\nexport function evaluateRule(rule: Rule, ctx: TargetingContext): boolean {\n  let result: boolean;\n  if (rule.field === \"url.path\" || rule.field === \"url.full\") {\n    const actual = String(resolveField(rule, ctx) ?? \"\");\n    if (rule.op === \"equals\") result = matchUrlPattern(String(rule.value ?? \"\"), actual);\n    else if (rule.op === \"not_equals\") result = !matchUrlPattern(String(rule.value ?? \"\"), actual);\n    else result = compare(rule.op, actual, rule.value);\n  } else {\n    result = compare(rule.op, resolveField(rule, ctx), rule.value);\n  }\n  return rule.negate ? !result : result;\n}\n\n/** Evaluate a rule tree. An empty group matches everyone. */\nexport function evaluateRules(group: RuleGroup | null | undefined, ctx: TargetingContext): boolean {\n  if (!group || group.rules.length === 0) return group?.negate ? false : true;\n  const results = group.rules.map((r) => (isRuleGroup(r) ? evaluateRules(r, ctx) : evaluateRule(r, ctx)));\n  const value = group.op === \"and\" ? results.every(Boolean) : results.some(Boolean);\n  return group.negate ? !value : value;\n}\n\n/** Fields whose evaluation requires server-held data. Used by docs/UI to annotate rules. */\nexport const SERVER_ASSISTED_FIELDS: RuleField[] = [\"audience.member\", \"guide.completed\", \"guide.dismissed\", \"guide.seen\", \"checklist.completed\"];\n\nexport function describeRule(rule: Rule): string {\n  const subject = rule.key ? `${rule.field}[${rule.key}]` : rule.field;\n  const v = Array.isArray(rule.value) ? rule.value.join(\", \") : rule.value === undefined ? \"\" : String(rule.value);\n  return `${rule.negate ? \"NOT \" : \"\"}${subject} ${rule.op.replace(/_/g, \" \")}${v ? ` \"${v}\"` : \"\"}`;\n}\n","/** Reserved property names that are stripped from `properties` to avoid collecting sensitive data. */\nexport const SENSITIVE_PROPERTY_PATTERN = /(password|passwd|secret|token|credit|card|cvv|ssn|iban)/i;\n\nexport const MAX_PROPERTY_BYTES = 8 * 1024;\n\nexport function sanitizeProperties(props: Record<string, unknown> | undefined): Record<string, unknown> {\n  if (!props) return {};\n  const out: Record<string, unknown> = {};\n  let size = 0;\n  for (const [k, v] of Object.entries(props)) {\n    if (SENSITIVE_PROPERTY_PATTERN.test(k)) continue;\n    if (typeof v === \"function\" || typeof v === \"symbol\") continue;\n    const str = typeof v === \"string\" ? v : JSON.stringify(v ?? null);\n    size += k.length + (str?.length ?? 0);\n    if (size > MAX_PROPERTY_BYTES) break;\n    out[k.slice(0, 100)] = typeof v === \"string\" ? v.slice(0, 1000) : v;\n  }\n  return out;\n}\n"],"mappings":";AACO,SAAS,MAAM,OAAuB;AAC3C,MAAI,IAAI;AACR,WAAS,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK;AACrC,SAAK,MAAM,WAAW,CAAC;AACvB,QAAI,KAAK,KAAK,GAAG,QAAU,MAAM;AAAA,EACnC;AACA,SAAO,MAAM;AACf;AAGO,SAAS,cAAc,SAAiB,MAAsB;AACnE,SAAO,MAAM,GAAG,IAAI,IAAI,OAAO,EAAE,IAAI;AACvC;AAEO,SAAS,QAAQ,OAAuB;AAC7C,SAAO,MACJ,YAAY,EACZ,KAAK,EACL,QAAQ,eAAe,GAAG,EAC1B,QAAQ,YAAY,EAAE,EACtB,MAAM,GAAG,EAAE,KAAK;AACrB;AAEA,IAAM,WAAW;AAEV,SAAS,SAAS,OAAO,IAAY;AAC1C,QAAM,IAAS,OAAO,eAAe,cAAc,aAAa,CAAC;AACjE,MAAI;AACJ,MAAI,EAAE,UAAU,OAAO,EAAE,OAAO,oBAAoB,YAAY;AAC9D,YAAQ,IAAI,WAAW,IAAI;AAC3B,MAAE,OAAO,gBAAgB,KAAK;AAAA,EAChC,OAAO;AACL,YAAQ,IAAI,WAAW,IAAI;AAC3B,aAAS,IAAI,GAAG,IAAI,MAAM,IAAK,OAAM,CAAC,IAAI,KAAK,MAAM,KAAK,OAAO,IAAI,GAAG;AAAA,EAC1E;AACA,MAAI,MAAM;AACV,WAAS,IAAI,GAAG,IAAI,MAAM,IAAK,QAAO,SAAU,MAAM,CAAC,IAAe,SAAS,MAAM;AACrF,SAAO;AACT;AAEO,SAAS,cAAc,GAA0C;AACtE,SAAO,OAAO,MAAM,YAAY,MAAM,QAAQ,CAAC,MAAM,QAAQ,CAAC;AAChE;AAGO,SAAS,QAAQ,KAAc,MAAuB;AAC3D,MAAI,CAAC,KAAM,QAAO;AAClB,MAAI,MAAW;AACf,aAAW,QAAQ,KAAK,MAAM,GAAG,GAAG;AAClC,QAAI,OAAO,KAAM,QAAO;AACxB,UAAM,IAAI,IAAI;AAAA,EAChB;AACA,SAAO;AACT;AAEO,SAAS,MAAM,GAAW,KAAa,KAAqB;AACjE,SAAO,KAAK,IAAI,KAAK,KAAK,IAAI,KAAK,CAAC,CAAC;AACvC;AAGO,SAAS,gBAAgB,SAAiB,KAAsB;AACrE,MAAI,CAAC,QAAS,QAAO;AACrB,MAAI,YAAY,IAAK,QAAO;AAC5B,QAAM,UAAU,QACb,QAAQ,sBAAsB,MAAM,EACpC,QAAQ,SAAS,cAAc,EAC/B,QAAQ,OAAO,OAAO,EACtB,QAAQ,iBAAiB,IAAI;AAChC,QAAM,KAAK,IAAI,OAAO,IAAI,OAAO,GAAG;AACpC,SAAO,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,YAAY,GAAG,CAAC;AACjD;AAEO,SAAS,YAAY,KAAqB;AAC/C,MAAI;AACF,UAAM,IAAI,IAAI,IAAI,GAAG;AACrB,WAAO,EAAE,WAAW,EAAE,SAAS,EAAE;AAAA,EACnC,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAGO,SAAS,WAAW,QAAgB,QAAQ,KAAoB;AACrE,MAAI,CAAC,UAAU,OAAO,SAAS,IAAK,QAAO;AAC3C,MAAI;AACF,WAAO,IAAI,OAAO,QAAQ,KAAK;AAAA,EACjC,QAAQ;AACN,WAAO;AAAA,EACT;AACF;;;ACpFO,IAAM,iBAAiB;AAAA,EAC5B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAGO,IAAM,cAAc;AAAA,EACzB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAqBO,SAAS,YAAY,GAAqC;AAC/D,SAAQ,EAAgB,UAAU;AACpC;AAEO,SAAS,eAAe,KAAK,QAAmB;AACrD,SAAO,EAAE,IAAI,IAAI,OAAO,OAAO,CAAC,EAAE;AACpC;AA0BA,SAAS,IAAI,KAAyC,GAAoB;AACxE,MAAI,CAAC,IAAK,QAAO;AACjB,SAAO,eAAe,MAAM,IAAI,IAAI,CAAC,IAAI,IAAI,SAAS,CAAC;AACzD;AAEA,SAAS,aAAa,MAAY,KAAgC;AAChE,UAAQ,KAAK,OAAO;AAAA,IAClB,KAAK;AACH,aAAO,KAAK,MAAM,QAAQ,IAAI,gBAAgB,KAAK,GAAG,IAAI;AAAA,IAC5D,KAAK;AACH,aAAO,KAAK,MAAM,QAAQ,IAAI,mBAAmB,KAAK,GAAG,IAAI;AAAA,IAC/D,KAAK;AACH,aAAO,IAAI,eAAe;AAAA,IAC5B,KAAK;AACH,aAAO,IAAI,eAAe,QAAQ,IAAI,kBAAkB;AAAA,IAC1D,KAAK;AACH,aAAO,IAAI;AAAA,IACb,KAAK;AACH,aAAO,IAAI;AAAA,IACb,KAAK;AACH,aAAO,KAAK,MAAM,IAAI,MAAM,KAAK,GAAG,IAAI;AAAA,IAC1C,KAAK;AACH,aAAO,IAAI,OAAO;AAAA,IACpB,KAAK;AACH,aAAO,IAAI,OAAO;AAAA,IACpB,KAAK;AACH,aAAO,IAAI,OAAO;AAAA,IACpB,KAAK;AACH,aAAO,IAAI;AAAA,IACb,KAAK;AACH,aAAO,CAAC,IAAI;AAAA,IACd,KAAK;AACH,aAAO,KAAK,MAAM,IAAI,IAAI,YAAY,KAAK,GAAG,IAAI;AAAA,IACpD,KAAK;AACH,aAAO,KAAK,MAAM,IAAI,IAAI,iBAAiB,KAAK,GAAG,IAAI;AAAA,IACzD,KAAK;AACH,aAAO,KAAK,MAAM,IAAI,IAAI,iBAAiB,KAAK,GAAG,IAAI;AAAA,IACzD,KAAK;AACH,aAAO,KAAK,MAAM,IAAI,IAAI,YAAY,KAAK,GAAG,IAAI;AAAA,IACpD,KAAK;AACH,aAAO,KAAK,MAAM,IAAI,IAAI,qBAAqB,KAAK,GAAG,IAAI;AAAA,IAC7D,KAAK;AACH,aAAO,KAAK,MAAM,IAAI,IAAI,aAAa,KAAK,GAAG,IAAI;AAAA,IACrD,KAAK;AACH,aAAO,IAAI,IAAI,YAAY;AAAA,IAC7B,KAAK;AACH,aAAO,IAAI,IAAI,OAAO;AAAA,IACxB,KAAK;AACH,aAAO,IAAI,IAAI,SAAS;AAAA,IAC1B,KAAK;AACH,aAAO,cAAc,IAAI,UAAU,IAAI,aAAa,IAAI,eAAe,SAAS;AAAA,IAClF,KAAK;AACH,aAAO,IAAI;AAAA,IACb,KAAK;AACH,aAAO,IAAI;AAAA,IACb;AACE,aAAO;AAAA,EACX;AACF;AAEA,SAAS,SAAS,GAA2B;AAC3C,MAAI,OAAO,MAAM,SAAU,QAAO;AAClC,MAAI,OAAO,MAAM,YAAY,EAAE,KAAK,MAAM,MAAM,CAAC,OAAO,MAAM,OAAO,CAAC,CAAC,EAAG,QAAO,OAAO,CAAC;AACzF,MAAI,aAAa,KAAM,QAAO,EAAE,QAAQ;AACxC,SAAO;AACT;AAEA,SAAS,SAAS,GAA2B;AAC3C,MAAI,aAAa,KAAM,QAAO,EAAE,QAAQ;AACxC,MAAI,OAAO,MAAM,UAAU;AACzB,UAAM,IAAI,KAAK,MAAM,CAAC;AACtB,WAAO,OAAO,MAAM,CAAC,IAAI,OAAO;AAAA,EAClC;AACA,MAAI,OAAO,MAAM,SAAU,QAAO;AAClC,SAAO;AACT;AAEO,SAAS,QAAQ,IAAkB,QAAiB,UAAkC;AAC3F,UAAQ,IAAI;AAAA,IACV,KAAK;AACH,aAAO,WAAW,UAAa,WAAW,QAAQ,WAAW;AAAA,IAC/D,KAAK;AACH,aAAO,WAAW,UAAa,WAAW,QAAQ,WAAW;AAAA,IAC/D,KAAK;AACH,aAAO,WAAW,QAAQ,WAAW;AAAA,IACvC,KAAK;AACH,aAAO,WAAW,SAAS,WAAW;AAAA,IACxC,KAAK;AACH,UAAI,OAAO,WAAW,UAAW,QAAO,OAAO,MAAM,MAAM,OAAO,QAAQ;AAC1E,aAAO,OAAO,UAAU,EAAE,MAAM,OAAO,YAAY,EAAE;AAAA,IACvD,KAAK;AACH,aAAO,OAAO,UAAU,EAAE,MAAM,OAAO,YAAY,EAAE;AAAA,IACvD,KAAK;AACH,aAAO,OAAO,WAAW,YAAY,OAAO,YAAY,EAAE,SAAS,OAAO,YAAY,EAAE,EAAE,YAAY,CAAC;AAAA,IACzG,KAAK;AACH,aAAO,EAAE,OAAO,WAAW,YAAY,OAAO,YAAY,EAAE,SAAS,OAAO,YAAY,EAAE,EAAE,YAAY,CAAC;AAAA,IAC3G,KAAK;AACH,aAAO,OAAO,WAAW,YAAY,OAAO,WAAW,OAAO,YAAY,EAAE,CAAC;AAAA,IAC/E,KAAK;AACH,aAAO,OAAO,WAAW,YAAY,OAAO,SAAS,OAAO,YAAY,EAAE,CAAC;AAAA,IAC7E,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK,OAAO;AACV,YAAM,IAAI,SAAS,MAAM;AACzB,YAAM,IAAI,SAAS,QAAQ;AAC3B,UAAI,MAAM,QAAQ,MAAM,KAAM,QAAO;AACrC,aAAO,OAAO,OAAO,IAAI,IAAI,OAAO,QAAQ,KAAK,IAAI,OAAO,OAAO,IAAI,IAAI,KAAK;AAAA,IAClF;AAAA,IACA,KAAK,MAAM;AACT,YAAM,OAAO,MAAM,QAAQ,QAAQ,IAAI,WAAW,OAAO,YAAY,EAAE,EAAE,MAAM,GAAG,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC;AACvG,aAAO,KAAK,SAAS,OAAO,UAAU,EAAE,CAAC;AAAA,IAC3C;AAAA,IACA,KAAK,UAAU;AACb,YAAM,OAAO,MAAM,QAAQ,QAAQ,IAAI,WAAW,OAAO,YAAY,EAAE,EAAE,MAAM,GAAG,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC;AACvG,aAAO,CAAC,KAAK,SAAS,OAAO,UAAU,EAAE,CAAC;AAAA,IAC5C;AAAA,IACA,KAAK,SAAS;AACZ,YAAM,KAAK,WAAW,OAAO,YAAY,EAAE,CAAC;AAC5C,aAAO,CAAC,CAAC,MAAM,OAAO,WAAW,YAAY,GAAG,KAAK,MAAM;AAAA,IAC7D;AAAA,IACA,KAAK,UAAU;AACb,YAAM,IAAI,SAAS,MAAM;AACzB,YAAM,IAAI,SAAS,QAAQ;AAC3B,aAAO,MAAM,QAAQ,MAAM,QAAQ,IAAI;AAAA,IACzC;AAAA,IACA,KAAK,SAAS;AACZ,YAAM,IAAI,SAAS,MAAM;AACzB,YAAM,IAAI,SAAS,QAAQ;AAC3B,aAAO,MAAM,QAAQ,MAAM,QAAQ,IAAI;AAAA,IACzC;AAAA,IACA;AACE,aAAO;AAAA,EACX;AACF;AAEO,SAAS,aAAa,MAAY,KAAgC;AACvE,MAAI;AACJ,MAAI,KAAK,UAAU,cAAc,KAAK,UAAU,YAAY;AAC1D,UAAM,SAAS,OAAO,aAAa,MAAM,GAAG,KAAK,EAAE;AACnD,QAAI,KAAK,OAAO,SAAU,UAAS,gBAAgB,OAAO,KAAK,SAAS,EAAE,GAAG,MAAM;AAAA,aAC1E,KAAK,OAAO,aAAc,UAAS,CAAC,gBAAgB,OAAO,KAAK,SAAS,EAAE,GAAG,MAAM;AAAA,QACxF,UAAS,QAAQ,KAAK,IAAI,QAAQ,KAAK,KAAK;AAAA,EACnD,OAAO;AACL,aAAS,QAAQ,KAAK,IAAI,aAAa,MAAM,GAAG,GAAG,KAAK,KAAK;AAAA,EAC/D;AACA,SAAO,KAAK,SAAS,CAAC,SAAS;AACjC;AAGO,SAAS,cAAc,OAAqC,KAAgC;AACjG,MAAI,CAAC,SAAS,MAAM,MAAM,WAAW,EAAG,QAAO,OAAO,SAAS,QAAQ;AACvE,QAAM,UAAU,MAAM,MAAM,IAAI,CAAC,MAAO,YAAY,CAAC,IAAI,cAAc,GAAG,GAAG,IAAI,aAAa,GAAG,GAAG,CAAE;AACtG,QAAM,QAAQ,MAAM,OAAO,QAAQ,QAAQ,MAAM,OAAO,IAAI,QAAQ,KAAK,OAAO;AAChF,SAAO,MAAM,SAAS,CAAC,QAAQ;AACjC;AAGO,IAAM,yBAAsC,CAAC,mBAAmB,mBAAmB,mBAAmB,cAAc,qBAAqB;AAEzI,SAAS,aAAa,MAAoB;AAC/C,QAAM,UAAU,KAAK,MAAM,GAAG,KAAK,KAAK,IAAI,KAAK,GAAG,MAAM,KAAK;AAC/D,QAAM,IAAI,MAAM,QAAQ,KAAK,KAAK,IAAI,KAAK,MAAM,KAAK,IAAI,IAAI,KAAK,UAAU,SAAY,KAAK,OAAO,KAAK,KAAK;AAC/G,SAAO,GAAG,KAAK,SAAS,SAAS,EAAE,GAAG,OAAO,IAAI,KAAK,GAAG,QAAQ,MAAM,GAAG,CAAC,GAAG,IAAI,KAAK,CAAC,MAAM,EAAE;AAClG;;;AC9QO,IAAM,6BAA6B;AAEnC,IAAM,qBAAqB,IAAI;AAE/B,SAAS,mBAAmB,OAAqE;AACtG,MAAI,CAAC,MAAO,QAAO,CAAC;AACpB,QAAM,MAA+B,CAAC;AACtC,MAAI,OAAO;AACX,aAAW,CAAC,GAAG,CAAC,KAAK,OAAO,QAAQ,KAAK,GAAG;AAC1C,QAAI,2BAA2B,KAAK,CAAC,EAAG;AACxC,QAAI,OAAO,MAAM,cAAc,OAAO,MAAM,SAAU;AACtD,UAAM,MAAM,OAAO,MAAM,WAAW,IAAI,KAAK,UAAU,KAAK,IAAI;AAChE,YAAQ,EAAE,UAAU,KAAK,UAAU;AACnC,QAAI,OAAO,mBAAoB;AAC/B,QAAI,EAAE,MAAM,GAAG,GAAG,CAAC,IAAI,OAAO,MAAM,WAAW,EAAE,MAAM,GAAG,GAAI,IAAI;AAAA,EACpE;AACA,SAAO;AACT;","names":[]}