@syntrologie/runtime-sdk 2.4.1 → 2.6.0-canary.1

package/dist/decisions/schema.js

@@ -3,12 +3,14 @@ import {
   AnchorVisibleConditionZ,
   ConditionZ,
   CooldownActiveConditionZ,
+  CounterDefZ,
   DecisionStrategyZ,
   DismissedConditionZ,
   EventCountConditionZ,
   EventOccurredConditionZ,
   ExternalStrategyZ,
   FrequencyLimitConditionZ,
+  MatchOpZ,
   ModelStrategyZ,
   PageUrlConditionZ,
   RouteConditionZ,
@@ -18,23 +20,26 @@ import {
   ScoreStrategyZ,
   SessionMetricConditionZ,
   StateEqualsConditionZ,
+  TriggerWhenZ,
   ViewportConditionZ,
   decisionSchemas,
   validateActivationConfig,
   validateCondition,
   validateStrategy
-} from "../chunk-4NYS7GAW.js";
+} from "../chunk-BU4Z6PD7.js";
 export {
   ActivationConfigZ,
   AnchorVisibleConditionZ,
   ConditionZ,
   CooldownActiveConditionZ,
+  CounterDefZ,
   DecisionStrategyZ,
   DismissedConditionZ,
   EventCountConditionZ,
   EventOccurredConditionZ,
   ExternalStrategyZ,
   FrequencyLimitConditionZ,
+  MatchOpZ,
   ModelStrategyZ,
   PageUrlConditionZ,
   RouteConditionZ,
@@ -44,6 +49,7 @@ export {
   ScoreStrategyZ,
   SessionMetricConditionZ,
   StateEqualsConditionZ,
+  TriggerWhenZ,
   ViewportConditionZ,
   decisionSchemas,
   validateActivationConfig,

package/dist/decisions/types.d.ts

@@ -110,6 +110,25 @@ export interface FrequencyLimitCondition {
     /** Invert the condition (true if limit NOT reached) */
     inverted?: boolean;
 }
+/**
+ * Match operator for counter filters.
+ * Exactly one of `equals` or `contains` must be specified.
+ */
+export interface MatchOp {
+    equals?: string | number | boolean;
+    contains?: string;
+}
+/**
+ * Defines what events to count for an event_count condition.
+ * Registered as an accumulator predicate at config-load time.
+ */
+export interface CounterDef {
+    /** Event names to listen for (e.g., ["ui.click"]). ALL other filters AND with this. */
+    events: string[];
+    /** Prop-based filters. Keys are event prop names OR element-chain fields
+     *  (tag_name, $el_text, attr__*). All entries AND together. */
+    match?: Record<string, MatchOp>;
+}
 /**
  * Condition that checks accumulated event counts.
  * Used for behavior triggers like "visited /pricing 3+ times".
@@ -125,6 +144,9 @@ export interface EventCountCondition {
     count: number;
     /** Only count events within this time window (ms). Omit = session lifetime. */
     withinMs?: number;
+    /** Inline counter definition. Defines what events to count.
+     *  If omitted, predicate is pass-through (counts all events). */
+    counter?: CounterDef;
 }
 /**
  * Union of all condition types.
@@ -234,8 +256,8 @@ export interface RouteFilter {
 export interface ActivationConfig {
     /** Route-based filtering */
     routes?: RouteFilter;
-    /** Decision strategy for conditional rendering */
-    strategy?: DecisionStrategy<boolean>;
+    /** When true, tile is hidden if none of its props.actions[] have an active triggerWhen. Default: false. */
+    onlyIfPopulated?: boolean;
 }
 /**
  * Extended context for strategy evaluation.

package/dist/events/registerConfigPredicates.d.ts

@@ -1,19 +1,16 @@
 /**
  * Register accumulator predicates from tile configs at config-load time.
  *
- * Previously, predicate registration lived inside FAQWidget's useEffect —
- * meaning predicates were only active when the widget was mounted (canvas open).
- * On multi-page apps with `defaultOpen: false`, the canvas stays closed after
- * navigation, the widget never mounts, and clicks go uncounted.
+ * Scans all triggerWhen conditions (in tile actions and top-level actions)
+ * for event_count conditions with a `counter` definition. For each, builds
+ * a predicate and registers it with the accumulator.
  *
- * This module extracts that logic so predicates are registered as soon as the
- * config is loaded, regardless of canvas state.
+ * Safe to call multiple times — accumulator.register() is idempotent.
  */
 import type { TileConfig } from '../types';
 import type { EventAccumulator } from './EventAccumulator';
 /**
- * Scan tile configs for scope + showWhen event_count conditions and register
- * accumulator predicates. Safe to call multiple times — accumulator.register()
- * is idempotent (skips if key already registered).
+ * Scan tile configs and top-level actions for event_count conditions
+ * and register accumulator predicates from their counter definitions.
  */
-export declare function registerConfigPredicates(tiles: TileConfig[], accumulator: EventAccumulator): void;
+export declare function registerConfigPredicates(tiles: TileConfig[], accumulator: EventAccumulator, actions?: unknown[]): void;

package/dist/events/schema.d.ts

@@ -10,15 +10,15 @@ export declare const NormalizedEventZ: z.ZodObject<{
     props: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     schemaVersion: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    source: "posthog" | "canvas" | "derived";
-    name: string;
     schemaVersion: string;
+    source: "canvas" | "posthog" | "derived";
+    name: string;
     ts: number;
     props?: Record<string, unknown> | undefined;
 }, {
-    source: "posthog" | "canvas" | "derived";
-    name: string;
     schemaVersion: string;
+    source: "canvas" | "posthog" | "derived";
+    name: string;
     ts: number;
     props?: Record<string, unknown> | undefined;
 }>;
@@ -29,25 +29,25 @@ export declare const EventFilterZ: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     names?: string[] | undefined;
     patterns?: string[] | undefined;
-    sources?: ("posthog" | "canvas" | "derived")[] | undefined;
+    sources?: ("canvas" | "posthog" | "derived")[] | undefined;
 }, {
     names?: string[] | undefined;
     patterns?: string[] | undefined;
-    sources?: ("posthog" | "canvas" | "derived")[] | undefined;
+    sources?: ("canvas" | "posthog" | "derived")[] | undefined;
 }>;
 /**
  * Validate a NormalizedEvent object.
  */
 export declare function validateNormalizedEvent(data: unknown): z.SafeParseReturnType<{
-    source: "posthog" | "canvas" | "derived";
-    name: string;
     schemaVersion: string;
+    source: "canvas" | "posthog" | "derived";
+    name: string;
     ts: number;
     props?: Record<string, unknown> | undefined;
 }, {
-    source: "posthog" | "canvas" | "derived";
-    name: string;
     schemaVersion: string;
+    source: "canvas" | "posthog" | "derived";
+    name: string;
     ts: number;
     props?: Record<string, unknown> | undefined;
 }>;
@@ -57,11 +57,11 @@ export declare function validateNormalizedEvent(data: unknown): z.SafeParseRetur
 export declare function validateEventFilter(data: unknown): z.SafeParseReturnType<{
     names?: string[] | undefined;
     patterns?: string[] | undefined;
-    sources?: ("posthog" | "canvas" | "derived")[] | undefined;
+    sources?: ("canvas" | "posthog" | "derived")[] | undefined;
 }, {
     names?: string[] | undefined;
     patterns?: string[] | undefined;
-    sources?: ("posthog" | "canvas" | "derived")[] | undefined;
+    sources?: ("canvas" | "posthog" | "derived")[] | undefined;
 }>;
 /**
  * Type inference from Zod schema.

package/dist/experiments/adapters/growthbook.d.ts

@@ -43,6 +43,7 @@ export interface GrowthBookAdapterOptions extends GrowthBookInitOptions {
  */
 export declare class GrowthBookAdapter implements ExperimentClient {
     private readonly gb;
+    private readonly featureListeners;
     constructor(options?: GrowthBookAdapterOptions);
     /**
      * Access to the underlying GrowthBook instance.
@@ -55,6 +56,7 @@ export declare class GrowthBookAdapter implements ExperimentClient {
     getFeatureValue<T>(key: string, fallback: T): T;
     getAllFeatures(): Record<string, unknown>;
     shouldRenderRectangle(_tile: TileConfig): boolean;
+    onFeaturesChanged(callback: () => void): () => void;
 }
 /**
  * Create an ExperimentClient backed by GrowthBook.

package/dist/experiments/types.d.ts

@@ -32,6 +32,13 @@ export interface ExperimentClient {
      * Returns a map of feature key -> feature value.
      */
     getAllFeatures?(): Record<string, unknown>;
+    /**
+     * Subscribe to feature flag value changes.
+     * Called when the underlying provider receives updated feature values
+     * (e.g., via streaming, webhook, or manual refresh).
+     * Returns an unsubscribe function.
+     */
+    onFeaturesChanged?(callback: () => void): () => void;
 }
 /**
  * @deprecated Use ExperimentClient instead

package/dist/hooks/useShadowCanvasConfig.d.ts

@@ -3,13 +3,15 @@ import type { SmartCanvasRuntime } from '../runtime';
 import type { ActionStep, CanvasConfigFetcher, CanvasThemeConfig, LauncherConfig, TileConfig } from '../types';
 export interface UseShadowCanvasConfigOptions {
     fetcher: CanvasConfigFetcher;
-    pollIntervalMs?: number;
     /** @deprecated Use runtime instead */
     experiments?: ExperimentClient;
     /** v2 Runtime for activation-based filtering */
     runtime?: SmartCanvasRuntime;
-    /** Current pathname — triggers re-filter when URL changes (route-based activation) */
-    pathname?: string;
+    /** Current page URL — triggers re-filter when URL changes (route-based activation).
+     *  Full URL (not just pathname) so hash-based routing also triggers re-filter. */
+    pageUrl?: string;
+    /** Polling interval in milliseconds. Set to 0 or omit to disable polling. */
+    pollIntervalMs?: number;
 }
 export interface ShadowCanvasConfigState {
     tiles: TileConfig[];
@@ -26,4 +28,4 @@ export interface ShadowCanvasConfigState {
     /** Launcher button configuration */
     launcher?: LauncherConfig;
 }
-export declare function useShadowCanvasConfig({ fetcher, pollIntervalMs, experiments, runtime, pathname, }: UseShadowCanvasConfigOptions): ShadowCanvasConfigState;
+export declare function useShadowCanvasConfig({ fetcher, experiments, runtime, pageUrl, pollIntervalMs, }: UseShadowCanvasConfigOptions): ShadowCanvasConfigState;

package/dist/index.d.ts

@@ -20,6 +20,7 @@ export * from './telemetry';
 export * from './types';
 export * from './version';
 export * from './actions';
+export * from './anchor';
 export * from './apps';
 export * from './context';
 export * from './decisions';