@syntrologie/runtime-sdk 2.13.0 → 2.14.0

package/dist/chunk-YLLWLUQX.js

@@ -0,0 +1,241 @@
+var __defProp = Object.defineProperty;
+var __typeError = (msg) => {
+  throw TypeError(msg);
+};
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+var __accessCheck = (obj, member, msg) => member.has(obj) || __typeError("Cannot " + msg);
+var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
+var __privateAdd = (obj, member, value) => member.has(obj) ? __typeError("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
+var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), setter ? setter.call(obj, value) : member.set(obj, value), value);
+
+// src/decisions/schema.ts
+import { z as z2 } from "zod";
+
+// ../sdk-contracts/dist/schemas.js
+import { z } from "zod";
+var AnchorIdZ = z.object({
+  selector: z.string(),
+  route: z.union([z.string(), z.array(z.string())])
+}).strict();
+var COUNTABLE_EVENTS = [
+  // User interactions (from PostHog autocapture normalization)
+  "ui.click",
+  "ui.scroll",
+  "ui.input",
+  "ui.change",
+  "ui.submit",
+  // Behavioral detectors (from event-processor)
+  "ui.hover",
+  "ui.idle",
+  "ui.scroll_thrash",
+  "ui.focus_bounce",
+  // Navigation
+  "nav.page_view",
+  "nav.page_leave",
+  // Derived behavioral signals
+  "behavior.rage_click",
+  "behavior.hesitation",
+  "behavior.confusion"
+];
+var CountableEventZ = z.enum(COUNTABLE_EVENTS).describe("Event name to count. ui.* = user interactions and behavioral detectors, nav.* = page navigation, behavior.* = derived behavioral signals.");
+var SESSION_METRIC_KEYS = ["time_on_page", "page_views", "scroll_depth"];
+var SessionMetricKeyZ = z.enum(SESSION_METRIC_KEYS).describe("Session metric key. time_on_page = seconds on current page, page_views = pages visited this session, scroll_depth = 0-100 percentage.");
+var PageUrlConditionZ = z.object({
+  type: z.literal("page_url"),
+  url: z.string().describe('URL path to match (e.g. "/pricing", "/dashboard")')
+}).describe('Fires when the current page URL matches. Use for page-specific actions. Example: {"type": "page_url", "url": "/pricing"}');
+var RouteConditionZ = z.object({
+  type: z.literal("route"),
+  routeId: z.string().describe("Named route ID from the route filter")
+}).describe("Fires when the current route matches a named route ID.");
+var AnchorVisibleConditionZ = z.object({
+  type: z.literal("anchor_visible"),
+  anchorId: z.string().describe("CSS selector of the anchor element"),
+  state: z.enum(["visible", "present", "absent"]).describe('"visible" = in viewport, "present" = in DOM, "absent" = not in DOM')
+}).describe(`Fires based on a DOM element's visibility state. Example: {"type": "anchor_visible", "anchorId": "#cta-button", "state": "visible"}`);
+var EventOccurredConditionZ = z.object({
+  type: z.literal("event_occurred"),
+  eventName: z.string().describe('Event name (e.g. "ui.click", "$pageview")'),
+  withinMs: z.number().optional().describe("Time window in ms. Omit = any time this session.")
+}).describe('Fires when a specific event has occurred during this session. Example: {"type": "event_occurred", "eventName": "ui.click", "withinMs": 5000}');
+var StateEqualsConditionZ = z.object({
+  type: z.literal("state_equals"),
+  key: z.string().describe("Key in the SDK persistent state store (localStorage). Only valid for keys the host app explicitly sets via syntro.state.set()."),
+  value: z.unknown().describe("Expected value to match against")
+}).describe("Checks the SDK persistent state store (localStorage). ONLY for host-app state set via syntro.state.set() \u2014 NOT for user attributes like region, device, or UTM params (those are handled by segment targeting). Do NOT use this for targeting. If you do not know the valid state keys, do not use this condition type.");
+var ViewportConditionZ = z.object({
+  type: z.literal("viewport"),
+  minWidth: z.number().optional().describe("Minimum viewport width in pixels"),
+  maxWidth: z.number().optional().describe("Maximum viewport width in pixels"),
+  minHeight: z.number().optional().describe("Minimum viewport height in pixels"),
+  maxHeight: z.number().optional().describe("Maximum viewport height in pixels")
+}).describe('Fires based on viewport (screen) size. Use for responsive behavior. Example: {"type": "viewport", "minWidth": 768} \u2014 fires on tablet and larger.');
+var SessionMetricConditionZ = z.object({
+  type: z.literal("session_metric"),
+  key: SessionMetricKeyZ,
+  operator: z.enum(["gte", "lte", "eq", "gt", "lt"]),
+  threshold: z.number().describe("Numeric threshold to compare against")
+}).describe('Fires when a session metric crosses a threshold. Valid keys: "time_on_page" (seconds), "page_views" (count), "scroll_depth" (0-100). Example: {"type": "session_metric", "key": "time_on_page", "operator": "gte", "threshold": 30}');
+var DismissedConditionZ = z.object({
+  type: z.literal("dismissed"),
+  key: z.string().describe("Dismissal key (usually a tile or action ID)"),
+  inverted: z.boolean().optional().describe("When true, fires if NOT dismissed (default behavior)")
+}).describe("Checks if an item has been dismissed by the user. Use with inverted: true to show only if not dismissed.");
+var CooldownActiveConditionZ = z.object({
+  type: z.literal("cooldown_active"),
+  key: z.string().describe("Cooldown key"),
+  inverted: z.boolean().optional().describe("When true, fires if cooldown is NOT active")
+}).describe("Checks if a cooldown timer is currently active. Use to prevent showing the same intervention too frequently.");
+var FrequencyLimitConditionZ = z.object({
+  type: z.literal("frequency_limit"),
+  key: z.string().describe("Frequency counter key"),
+  limit: z.number().describe("Maximum allowed count"),
+  inverted: z.boolean().optional().describe("When true, fires if limit NOT reached")
+}).describe("Checks if a frequency limit has been reached. Use to cap how many times an action fires per session.");
+var MatchOpZ = z.object({
+  equals: z.union([z.string(), z.number(), z.boolean()]).optional(),
+  contains: z.string().optional()
+}).describe("Match operator for counter filters. Exactly one of equals or contains must be specified.");
+var CounterDefZ = z.object({
+  events: z.array(CountableEventZ).min(1).describe("Event names to count. Use values from the countable events enum."),
+  match: z.record(z.string(), MatchOpZ).optional().describe("Property filters. Keys are event prop names or element-chain fields (tag_name, $el_text, attr__*). All entries AND together.")
+}).describe("Defines what events to count. Registered as an accumulator predicate at config-load time.");
+var EventCountConditionZ = z.object({
+  type: z.literal("event_count"),
+  key: z.string().describe("Unique key for this counter (used for accumulator registration)"),
+  operator: z.enum(["gte", "lte", "eq", "gt", "lt"]),
+  count: z.number().int().min(0).describe("Target count threshold"),
+  withinMs: z.number().positive().optional().describe("Time window in ms. Omit = count across entire session."),
+  counter: CounterDefZ.optional().describe("Inline counter definition. Defines what events to count.")
+}).describe('Fires when accumulated event count crosses a threshold. Most powerful trigger type. Example: {"type": "event_count", "key": "pricing-clicks", "operator": "gte", "count": 3, "counter": {"events": ["ui.click"], "match": {"attr__data-cta": {"contains": "pricing"}}}}');
+var ConditionZ = z.discriminatedUnion("type", [
+  PageUrlConditionZ,
+  RouteConditionZ,
+  AnchorVisibleConditionZ,
+  EventOccurredConditionZ,
+  StateEqualsConditionZ,
+  ViewportConditionZ,
+  SessionMetricConditionZ,
+  DismissedConditionZ,
+  CooldownActiveConditionZ,
+  FrequencyLimitConditionZ,
+  EventCountConditionZ
+]);
+var RuleZ = z.object({
+  conditions: z.array(ConditionZ).describe("Array of conditions \u2014 ALL must match (AND logic) for this rule to fire."),
+  value: z.unknown().describe("Value returned when all conditions match. For triggerWhen: true = fire the action.")
+}).describe("A single rule. ALL conditions must match (AND logic). Rules in a strategy are evaluated top-to-bottom \u2014 first rule where all conditions match wins and returns its value.");
+var RuleStrategyZ = z.object({
+  type: z.literal("rules"),
+  rules: z.array(RuleZ).describe("Ordered list of rules. Evaluated top-to-bottom \u2014 first match wins."),
+  default: z.unknown().describe("Fallback value when no rule matches. For triggerWhen: false = do not fire by default.")
+}).describe("Rule-based strategy. Evaluates rules top-to-bottom. First rule where ALL conditions match returns its value. If no rule matches, returns default. For triggerWhen: set value=true on matching rules, default=false.");
+var ScoreStrategyZ = z.object({
+  type: z.literal("score"),
+  field: z.string(),
+  threshold: z.number(),
+  above: z.unknown(),
+  below: z.unknown()
+}).describe("Score-based strategy. Compares a field value against a threshold.");
+var ModelStrategyZ = z.object({
+  type: z.literal("model"),
+  modelId: z.string(),
+  inputs: z.array(z.string()),
+  outputMapping: z.record(z.string(), z.unknown()),
+  default: z.unknown()
+}).describe("ML model strategy. Sends inputs to a model and maps outputs.");
+var ExternalStrategyZ = z.object({
+  type: z.literal("external"),
+  endpoint: z.string(),
+  method: z.enum(["GET", "POST"]).optional(),
+  default: z.unknown(),
+  timeoutMs: z.number().optional()
+}).describe("External API strategy. Calls an endpoint to determine the value.");
+var DecisionStrategyZ = z.discriminatedUnion("type", [
+  RuleStrategyZ,
+  ScoreStrategyZ,
+  ModelStrategyZ,
+  ExternalStrategyZ
+]);
+var TriggerWhenZ = DecisionStrategyZ.nullable().optional();
+var EventScopeZ = z.object({
+  events: z.array(z.string()),
+  urlContains: z.string().optional(),
+  props: z.record(z.union([z.string(), z.number(), z.boolean()])).optional()
+});
+var NotifyZ = z.object({
+  title: z.string().optional(),
+  body: z.string().optional(),
+  icon: z.string().optional()
+}).nullable().optional();
+
+// src/decisions/schema.ts
+var RouteFilterZ = z2.object({
+  include: z2.array(z2.string()).optional().describe(
+    "URL patterns where this tile appears. Supports *, **, :param wildcards. Use sparingly \u2014 mostly to isolate to specific webapp functionality. Omit to appear on all routes."
+  ),
+  exclude: z2.array(z2.string()).optional().describe("URL patterns where this tile should NOT appear. Evaluated before include.")
+});
+var ActivationConfigZ = z2.object({
+  routes: RouteFilterZ,
+  onlyIfPopulated: z2.boolean().optional().describe(
+    "When true, tile is hidden if none of its props.actions[] have an active triggerWhen. Useful for tiles with all-deferred FAQ questions or nav tips. Default: false."
+  )
+});
+function validateCondition(data) {
+  return ConditionZ.safeParse(data);
+}
+function validateStrategy(data) {
+  return DecisionStrategyZ.safeParse(data);
+}
+function validateActivationConfig(data) {
+  return ActivationConfigZ.safeParse(data);
+}
+var decisionSchemas = [
+  { defName: "matchOp", schema: MatchOpZ },
+  { defName: "counterDef", schema: CounterDefZ },
+  { defName: "activationConfig", schema: ActivationConfigZ },
+  { defName: "routeFilter", schema: RouteFilterZ },
+  { defName: "ruleStrategy", schema: RuleStrategyZ },
+  { defName: "scoreStrategy", schema: ScoreStrategyZ },
+  { defName: "modelStrategy", schema: ModelStrategyZ },
+  { defName: "externalStrategy", schema: ExternalStrategyZ },
+  { defName: "rule", schema: RuleZ },
+  { defName: "condition", schema: ConditionZ }
+];
+
+export {
+  __publicField,
+  __privateGet,
+  __privateAdd,
+  __privateSet,
+  PageUrlConditionZ,
+  RouteConditionZ,
+  AnchorVisibleConditionZ,
+  EventOccurredConditionZ,
+  StateEqualsConditionZ,
+  ViewportConditionZ,
+  SessionMetricConditionZ,
+  DismissedConditionZ,
+  CooldownActiveConditionZ,
+  FrequencyLimitConditionZ,
+  MatchOpZ,
+  CounterDefZ,
+  EventCountConditionZ,
+  ConditionZ,
+  RuleZ,
+  RuleStrategyZ,
+  ScoreStrategyZ,
+  ModelStrategyZ,
+  ExternalStrategyZ,
+  DecisionStrategyZ,
+  TriggerWhenZ,
+  RouteFilterZ,
+  ActivationConfigZ,
+  validateCondition,
+  validateStrategy,
+  validateActivationConfig,
+  decisionSchemas
+};
+//# sourceMappingURL=chunk-YLLWLUQX.js.map

package/dist/chunk-YLLWLUQX.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/decisions/schema.ts", "../../sdk-contracts/dist/schemas.js"],
+  "sourcesContent": ["/**\n * Zod schemas for decision strategy validation.\n *\n * Condition and strategy schemas are canonical in @syntrologie/sdk-contracts.\n * This module re-exports them and adds runtime-specific schemas\n * (ActivationConfig, RouteFilter) plus the decisionSchemas array for\n * unified JSON Schema generation.\n */\nimport { z } from 'zod';\n\n// Re-export all condition + strategy schemas from the single source of truth\nexport {\n  AnchorVisibleConditionZ,\n  type ConditionSchema,\n  ConditionZ,\n  CooldownActiveConditionZ,\n  CounterDefZ,\n  type DecisionStrategySchema,\n  DecisionStrategyZ,\n  DismissedConditionZ,\n  EventCountConditionZ,\n  EventOccurredConditionZ,\n  ExternalStrategyZ,\n  FrequencyLimitConditionZ,\n  MatchOpZ,\n  ModelStrategyZ,\n  PageUrlConditionZ,\n  RouteConditionZ,\n  type RuleSchema,\n  RuleStrategyZ,\n  RuleZ,\n  ScoreStrategyZ,\n  SessionMetricConditionZ,\n  StateEqualsConditionZ,\n  TriggerWhenZ,\n  ViewportConditionZ,\n} from '@syntrologie/sdk-contracts';\n\nimport {\n  ConditionZ,\n  CounterDefZ,\n  DecisionStrategyZ,\n  ExternalStrategyZ,\n  MatchOpZ,\n  ModelStrategyZ,\n  RuleStrategyZ,\n  RuleZ,\n  ScoreStrategyZ,\n} from '@syntrologie/sdk-contracts';\n\n// =============================================================================\n// ACTIVATION CONFIG SCHEMA (runtime-specific)\n// =============================================================================\n\nexport const RouteFilterZ = z.object({\n  include: z\n    .array(z.string())\n    .optional()\n    .describe(\n      'URL patterns where this tile appears. Supports *, **, :param wildcards. ' +\n        'Use sparingly \u2014 mostly to isolate to specific webapp functionality. ' +\n        'Omit to appear on all routes.'\n    ),\n  exclude: z\n    .array(z.string())\n    .optional()\n    .describe('URL patterns where this tile should NOT appear. Evaluated before include.'),\n});\n\nexport const ActivationConfigZ = z.object({\n  routes: RouteFilterZ,\n  onlyIfPopulated: z\n    .boolean()\n    .optional()\n    .describe(\n      'When true, tile is hidden if none of its props.actions[] have an active triggerWhen. ' +\n        'Useful for tiles with all-deferred FAQ questions or nav tips. Default: false.'\n    ),\n});\n\n// =============================================================================\n// VALIDATION FUNCTIONS\n// =============================================================================\n\n/**\n * Validate a Condition object.\n */\nexport function validateCondition(data: unknown) {\n  return ConditionZ.safeParse(data);\n}\n\n/**\n * Validate a DecisionStrategy object.\n */\nexport function validateStrategy(data: unknown) {\n  return DecisionStrategyZ.safeParse(data);\n}\n\n/**\n * Validate an ActivationConfig object.\n */\nexport function validateActivationConfig(data: unknown) {\n  return ActivationConfigZ.safeParse(data);\n}\n\n// =============================================================================\n// Export: Array for unified schema generation\n// =============================================================================\n\n/**\n * Decision schemas for unified JSON Schema generation.\n * The generator imports this array and converts each to a JSON Schema $def.\n *\n * Note: `decisionStrategy` is NOT included here \u2014 it's a oneOf wrapper that\n * the generator builds from $refs to the four strategy defs.\n */\nexport const decisionSchemas = [\n  { defName: 'matchOp', schema: MatchOpZ },\n  { defName: 'counterDef', schema: CounterDefZ },\n  { defName: 'activationConfig', schema: ActivationConfigZ },\n  { defName: 'routeFilter', schema: RouteFilterZ },\n  { defName: 'ruleStrategy', schema: RuleStrategyZ },\n  { defName: 'scoreStrategy', schema: ScoreStrategyZ },\n  { defName: 'modelStrategy', schema: ModelStrategyZ },\n  { defName: 'externalStrategy', schema: ExternalStrategyZ },\n  { defName: 'rule', schema: RuleZ },\n  { defName: 'condition', schema: ConditionZ },\n];\n\n// =============================================================================\n// TYPE INFERENCE\n// =============================================================================\n\nexport type ActivationConfigSchema = z.infer<typeof ActivationConfigZ>;\n", "/**\n * Shared Zod schemas for decision strategies, conditions, and event scoping.\n *\n * These are the canonical definitions \u2014 runtime-sdk and all adaptive packages\n * should import from here instead of duplicating.\n */\nimport { z } from 'zod';\n// =============================================================================\n// ANCHOR ID SCHEMA\n// =============================================================================\nexport const AnchorIdZ = z\n    .object({\n    selector: z.string(),\n    route: z.union([z.string(), z.array(z.string())]),\n})\n    .strict();\n// =============================================================================\n// TRIGGER VOCABULARY \u2014 canonical lists of valid event names, metric keys, etc.\n// These flow through to the JSON schema as enums and are used by the LLM prompt.\n// =============================================================================\n/** Events that can be counted in event_count conditions. */\nexport const COUNTABLE_EVENTS = [\n    // User interactions (from PostHog autocapture normalization)\n    'ui.click',\n    'ui.scroll',\n    'ui.input',\n    'ui.change',\n    'ui.submit',\n    // Behavioral detectors (from event-processor)\n    'ui.hover',\n    'ui.idle',\n    'ui.scroll_thrash',\n    'ui.focus_bounce',\n    // Navigation\n    'nav.page_view',\n    'nav.page_leave',\n    // Derived behavioral signals\n    'behavior.rage_click',\n    'behavior.hesitation',\n    'behavior.confusion',\n];\nexport const CountableEventZ = z\n    .enum(COUNTABLE_EVENTS)\n    .describe('Event name to count. ui.* = user interactions and behavioral detectors, nav.* = page navigation, behavior.* = derived behavioral signals.');\n/** Valid session metric keys. */\nexport const SESSION_METRIC_KEYS = ['time_on_page', 'page_views', 'scroll_depth'];\nexport const SessionMetricKeyZ = z\n    .enum(SESSION_METRIC_KEYS)\n    .describe('Session metric key. time_on_page = seconds on current page, page_views = pages visited this session, scroll_depth = 0-100 percentage.');\n/** Element chain match field prefixes for counter filters. */\nexport const ELEMENT_MATCH_FIELDS = ['tag_name', '$el_text'];\n// Note: attr__* is a dynamic prefix (attr__data-id, attr__class, attr__href, etc.)\n// and cannot be enumerated. The match key is either one of ELEMENT_MATCH_FIELDS\n// or starts with \"attr__\".\n// =============================================================================\n// CONDITION SCHEMAS\n// =============================================================================\nexport const PageUrlConditionZ = z\n    .object({\n    type: z.literal('page_url'),\n    url: z.string().describe('URL path to match (e.g. \"/pricing\", \"/dashboard\")'),\n})\n    .describe('Fires when the current page URL matches. Use for page-specific actions. ' +\n    'Example: {\"type\": \"page_url\", \"url\": \"/pricing\"}');\nexport const RouteConditionZ = z\n    .object({\n    type: z.literal('route'),\n    routeId: z.string().describe('Named route ID from the route filter'),\n})\n    .describe('Fires when the current route matches a named route ID.');\nexport const AnchorVisibleConditionZ = z\n    .object({\n    type: z.literal('anchor_visible'),\n    anchorId: z.string().describe('CSS selector of the anchor element'),\n    state: z\n        .enum(['visible', 'present', 'absent'])\n        .describe('\"visible\" = in viewport, \"present\" = in DOM, \"absent\" = not in DOM'),\n})\n    .describe(\"Fires based on a DOM element's visibility state. \" +\n    'Example: {\"type\": \"anchor_visible\", \"anchorId\": \"#cta-button\", \"state\": \"visible\"}');\nexport const EventOccurredConditionZ = z\n    .object({\n    type: z.literal('event_occurred'),\n    eventName: z.string().describe('Event name (e.g. \"ui.click\", \"$pageview\")'),\n    withinMs: z.number().optional().describe('Time window in ms. Omit = any time this session.'),\n})\n    .describe('Fires when a specific event has occurred during this session. ' +\n    'Example: {\"type\": \"event_occurred\", \"eventName\": \"ui.click\", \"withinMs\": 5000}');\nexport const StateEqualsConditionZ = z\n    .object({\n    type: z.literal('state_equals'),\n    key: z\n        .string()\n        .describe('Key in the SDK persistent state store (localStorage). Only valid for keys the host app explicitly sets via syntro.state.set().'),\n    value: z.unknown().describe('Expected value to match against'),\n})\n    .describe('Checks the SDK persistent state store (localStorage). ONLY for host-app state set via syntro.state.set() \u2014 ' +\n    'NOT for user attributes like region, device, or UTM params (those are handled by segment targeting). ' +\n    'Do NOT use this for targeting. If you do not know the valid state keys, do not use this condition type.');\nexport const ViewportConditionZ = z\n    .object({\n    type: z.literal('viewport'),\n    minWidth: z.number().optional().describe('Minimum viewport width in pixels'),\n    maxWidth: z.number().optional().describe('Maximum viewport width in pixels'),\n    minHeight: z.number().optional().describe('Minimum viewport height in pixels'),\n    maxHeight: z.number().optional().describe('Maximum viewport height in pixels'),\n})\n    .describe('Fires based on viewport (screen) size. Use for responsive behavior. ' +\n    'Example: {\"type\": \"viewport\", \"minWidth\": 768} \u2014 fires on tablet and larger.');\nexport const SessionMetricConditionZ = z\n    .object({\n    type: z.literal('session_metric'),\n    key: SessionMetricKeyZ,\n    operator: z.enum(['gte', 'lte', 'eq', 'gt', 'lt']),\n    threshold: z.number().describe('Numeric threshold to compare against'),\n})\n    .describe('Fires when a session metric crosses a threshold. Valid keys: \"time_on_page\" (seconds), ' +\n    '\"page_views\" (count), \"scroll_depth\" (0-100). ' +\n    'Example: {\"type\": \"session_metric\", \"key\": \"time_on_page\", \"operator\": \"gte\", \"threshold\": 30}');\nexport const DismissedConditionZ = z\n    .object({\n    type: z.literal('dismissed'),\n    key: z.string().describe('Dismissal key (usually a tile or action ID)'),\n    inverted: z\n        .boolean()\n        .optional()\n        .describe('When true, fires if NOT dismissed (default behavior)'),\n})\n    .describe('Checks if an item has been dismissed by the user. Use with inverted: true to show only if not dismissed.');\nexport const CooldownActiveConditionZ = z\n    .object({\n    type: z.literal('cooldown_active'),\n    key: z.string().describe('Cooldown key'),\n    inverted: z.boolean().optional().describe('When true, fires if cooldown is NOT active'),\n})\n    .describe('Checks if a cooldown timer is currently active. Use to prevent showing the same intervention too frequently.');\nexport const FrequencyLimitConditionZ = z\n    .object({\n    type: z.literal('frequency_limit'),\n    key: z.string().describe('Frequency counter key'),\n    limit: z.number().describe('Maximum allowed count'),\n    inverted: z.boolean().optional().describe('When true, fires if limit NOT reached'),\n})\n    .describe('Checks if a frequency limit has been reached. Use to cap how many times an action fires per session.');\nexport const MatchOpZ = z\n    .object({\n    equals: z.union([z.string(), z.number(), z.boolean()]).optional(),\n    contains: z.string().optional(),\n})\n    .describe('Match operator for counter filters. Exactly one of equals or contains must be specified.');\nexport const CounterDefZ = z\n    .object({\n    events: z\n        .array(CountableEventZ)\n        .min(1)\n        .describe('Event names to count. Use values from the countable events enum.'),\n    match: z\n        .record(z.string(), MatchOpZ)\n        .optional()\n        .describe('Property filters. Keys are event prop names or element-chain fields ' +\n        '(tag_name, $el_text, attr__*). All entries AND together.'),\n})\n    .describe('Defines what events to count. Registered as an accumulator predicate at config-load time.');\nexport const EventCountConditionZ = z\n    .object({\n    type: z.literal('event_count'),\n    key: z.string().describe('Unique key for this counter (used for accumulator registration)'),\n    operator: z.enum(['gte', 'lte', 'eq', 'gt', 'lt']),\n    count: z.number().int().min(0).describe('Target count threshold'),\n    withinMs: z\n        .number()\n        .positive()\n        .optional()\n        .describe('Time window in ms. Omit = count across entire session.'),\n    counter: CounterDefZ.optional().describe('Inline counter definition. Defines what events to count.'),\n})\n    .describe('Fires when accumulated event count crosses a threshold. Most powerful trigger type. ' +\n    'Example: {\"type\": \"event_count\", \"key\": \"pricing-clicks\", \"operator\": \"gte\", \"count\": 3, ' +\n    '\"counter\": {\"events\": [\"ui.click\"], \"match\": {\"attr__data-cta\": {\"contains\": \"pricing\"}}}}');\nexport const ConditionZ = z.discriminatedUnion('type', [\n    PageUrlConditionZ,\n    RouteConditionZ,\n    AnchorVisibleConditionZ,\n    EventOccurredConditionZ,\n    StateEqualsConditionZ,\n    ViewportConditionZ,\n    SessionMetricConditionZ,\n    DismissedConditionZ,\n    CooldownActiveConditionZ,\n    FrequencyLimitConditionZ,\n    EventCountConditionZ,\n]);\n// =============================================================================\n// STRATEGY SCHEMAS\n// =============================================================================\nexport const RuleZ = z\n    .object({\n    conditions: z\n        .array(ConditionZ)\n        .describe('Array of conditions \u2014 ALL must match (AND logic) for this rule to fire.'),\n    value: z\n        .unknown()\n        .describe('Value returned when all conditions match. For triggerWhen: true = fire the action.'),\n})\n    .describe('A single rule. ALL conditions must match (AND logic). Rules in a strategy are evaluated ' +\n    'top-to-bottom \u2014 first rule where all conditions match wins and returns its value.');\nexport const RuleStrategyZ = z\n    .object({\n    type: z.literal('rules'),\n    rules: z\n        .array(RuleZ)\n        .describe('Ordered list of rules. Evaluated top-to-bottom \u2014 first match wins.'),\n    default: z\n        .unknown()\n        .describe('Fallback value when no rule matches. For triggerWhen: false = do not fire by default.'),\n})\n    .describe('Rule-based strategy. Evaluates rules top-to-bottom. First rule where ALL conditions match ' +\n    'returns its value. If no rule matches, returns default. ' +\n    'For triggerWhen: set value=true on matching rules, default=false.');\nexport const ScoreStrategyZ = z\n    .object({\n    type: z.literal('score'),\n    field: z.string(),\n    threshold: z.number(),\n    above: z.unknown(),\n    below: z.unknown(),\n})\n    .describe('Score-based strategy. Compares a field value against a threshold.');\nexport const ModelStrategyZ = z\n    .object({\n    type: z.literal('model'),\n    modelId: z.string(),\n    inputs: z.array(z.string()),\n    outputMapping: z.record(z.string(), z.unknown()),\n    default: z.unknown(),\n})\n    .describe('ML model strategy. Sends inputs to a model and maps outputs.');\nexport const ExternalStrategyZ = z\n    .object({\n    type: z.literal('external'),\n    endpoint: z.string(),\n    method: z.enum(['GET', 'POST']).optional(),\n    default: z.unknown(),\n    timeoutMs: z.number().optional(),\n})\n    .describe('External API strategy. Calls an endpoint to determine the value.');\nexport const DecisionStrategyZ = z.discriminatedUnion('type', [\n    RuleStrategyZ,\n    ScoreStrategyZ,\n    ModelStrategyZ,\n    ExternalStrategyZ,\n]);\n/** Canonical Zod schema for the optional triggerWhen field on actions and adaptive items. */\nexport const TriggerWhenZ = DecisionStrategyZ.nullable().optional();\n// =============================================================================\n// TRIGGER DOCUMENTATION \u2014 examples and match field docs\n// Exported as constants so the schema generator can inject them into the\n// JSON schema. The Python prompt builder reads them from the schema.\n// =============================================================================\n/** Complete triggerWhen examples showing the full rules wrapper structure. */\nexport const TRIGGER_EXAMPLES = [\n    {\n        name: 'Click count on a specific element',\n        description: 'Fire when user clicks an element with data-id=\"hero-cta\" 2+ times',\n        triggerWhen: {\n            type: 'rules',\n            rules: [\n                {\n                    conditions: [\n                        {\n                            type: 'event_count',\n                            key: 'cta-clicks',\n                            operator: 'gte',\n                            count: 2,\n                            counter: {\n                                events: ['ui.click'],\n                                match: { 'attr__data-id': { equals: 'hero-cta' } },\n                            },\n                        },\n                    ],\n                    value: true,\n                },\n            ],\n            default: false,\n        },\n    },\n    {\n        name: 'Time on page threshold',\n        description: 'Fire after user spends 30+ seconds on the page',\n        triggerWhen: {\n            type: 'rules',\n            rules: [\n                {\n                    conditions: [\n                        {\n                            type: 'session_metric',\n                            key: 'time_on_page',\n                            operator: 'gte',\n                            threshold: 30,\n                        },\n                    ],\n                    value: true,\n                },\n            ],\n            default: false,\n        },\n    },\n    {\n        name: 'Element visible in viewport',\n        description: 'Fire when a DOM element becomes visible',\n        triggerWhen: {\n            type: 'rules',\n            rules: [\n                {\n                    conditions: [\n                        {\n                            type: 'anchor_visible',\n                            anchorId: '#pricing-section',\n                            state: 'visible',\n                        },\n                    ],\n                    value: true,\n                },\n            ],\n            default: false,\n        },\n    },\n    {\n        name: 'No trigger (fire immediately)',\n        description: 'Action fires as soon as the segment matches \u2014 no in-session condition needed',\n        triggerWhen: null,\n    },\n];\n/** Documentation for counter.match field keys. */\nexport const MATCH_FIELD_DOCS = {\n    tag_name: 'HTML tag name (e.g. \"button\", \"a\", \"input\")',\n    $el_text: 'Visible text content of the element',\n    'attr__*': 'HTML attribute prefixed with attr__. Example: attr__data-id matches the data-id attribute, ' +\n        'attr__class matches the class attribute, attr__href matches the href attribute.',\n};\n// =============================================================================\n// EVENT SCOPE SCHEMA\n// =============================================================================\n/** Scopes a widget to specific events/URLs. */\nexport const EventScopeZ = z.object({\n    events: z.array(z.string()),\n    urlContains: z.string().optional(),\n    props: z.record(z.union([z.string(), z.number(), z.boolean()])).optional(),\n});\n// =============================================================================\n// NOTIFY SCHEMA\n// =============================================================================\n/** Toast notification config for triggerWhen transitions. */\nexport const NotifyZ = z\n    .object({\n    title: z.string().optional(),\n    body: z.string().optional(),\n    icon: z.string().optional(),\n})\n    .nullable()\n    .optional();\n"],
+  "mappings": "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",
+  "names": ["z", "z"]
+}

package/dist/components/ShadowCanvasOverlay.d.ts

@@ -6,7 +6,6 @@ export interface ShadowCanvasOverlayProps {
     onToggle: () => void;
     telemetry?: TelemetryClient;
     launcherLabel?: string;
-    launcherIcon?: string;
     launcherAnimate?: boolean;
     launcherAnimationStyle?: 'pulse' | 'bounce' | 'glow';
     notificationCount?: number;
@@ -17,4 +16,4 @@ export interface ShadowCanvasOverlayProps {
     canvasTitle?: string;
     displayMode?: 'standard' | 'focused';
 }
-export declare function ShadowCanvasOverlay({ isOpen, onToggle, telemetry, launcherLabel: _launcherLabel, launcherIcon, launcherAnimate, launcherAnimationStyle: _launcherAnimationStyle, notificationCount: _notificationCount, footerSlot, tiles, isLoading, error, canvasTitle, displayMode, }: ShadowCanvasOverlayProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function ShadowCanvasOverlay({ isOpen, onToggle, telemetry, launcherLabel: _launcherLabel, launcherAnimate, launcherAnimationStyle: _launcherAnimationStyle, notificationCount: _notificationCount, footerSlot, tiles, isLoading, error, canvasTitle, displayMode, }: ShadowCanvasOverlayProps): import("react/jsx-runtime").JSX.Element | null;