@syntrologie/runtime-sdk 2.1.0 → 2.2.0-canary.2

package/dist/components/ShadowCanvasOverlay.d.ts

@@ -1,4 +1,4 @@
-import { ReactNode } from 'react';
+import { type ReactNode } from 'react';
 import type { TelemetryClient } from '../telemetry/types';
 import type { TileConfig } from '../types';
 export interface CanvasTheme {
@@ -35,4 +35,4 @@ export interface ShadowCanvasOverlayProps {
     displayMode?: 'standard' | 'focused';
     theme?: Partial<CanvasTheme>;
 }
-export declare function ShadowCanvasOverlay({ isOpen, onToggle, telemetry, launcherLabel, launcherAnimate, launcherAnimationStyle: _launcherAnimationStyle, notificationCount, footerSlot, tiles, isLoading, error, canvasTitle, displayMode, theme: themeOverride, }: 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, theme: themeOverride, }: ShadowCanvasOverlayProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/components/TileCard.d.ts

@@ -1,4 +1,4 @@
-import { CSSProperties } from 'react';
+import { type CSSProperties } from 'react';
 import type { TelemetryClient } from '../telemetry/types';
 import type { TileConfig } from '../types';
 interface TileCardProps {

package/dist/context/ContextManager.d.ts

@@ -8,7 +8,7 @@
  */
 import type { TelemetryClient } from '../telemetry/types';
 import type { RoutesConfig } from '../types';
-import type { RuntimeContext, AnchorState, ContextChangeCallback, Unsubscribe, PageHistoryEntry } from './types';
+import type { AnchorState, ContextChangeCallback, PageHistoryEntry, RuntimeContext, Unsubscribe } from './types';
 export interface ContextManagerOptions {
     /** Telemetry client for session ID */
     telemetry?: TelemetryClient;

package/dist/context/index.d.ts

@@ -1,7 +1,7 @@
 /**
  * Context module exports.
  */
-export * from './types';
-export * from './schema';
-export { ContextManager, createContextManager } from './ContextManager';
 export type { ContextManagerOptions } from './ContextManager';
+export { ContextManager, createContextManager } from './ContextManager';
+export * from './schema';
+export * from './types';

package/dist/decisions/engine.d.ts

@@ -8,7 +8,7 @@ import type { RuntimeContext } from '../context/types';
 import type { EventBus } from '../events/EventBus';
 import type { SessionMetricTracker } from '../metrics/sessionMetrics';
 import type { StateStore } from '../state/StateStore';
-import type { DecisionStrategy, DecisionResult } from './types';
+import type { DecisionResult, DecisionStrategy } from './types';
 /**
  * Options for the decision engine evaluate function.
  */

package/dist/decisions/index.d.ts

@@ -1,9 +1,9 @@
 /**
  * Decisions module exports.
  */
-export * from './types';
-export * from './schema';
-export { evaluate, evaluateSync, createDecisionEngine } from './engine';
 export type { EvaluateOptions } from './engine';
+export { createDecisionEngine, evaluate, evaluateSync } from './engine';
+export * from './schema';
 export { evaluateCondition, evaluateRule, evaluateRuleStrategy } from './strategies/rules';
 export { evaluateScoreStrategy } from './strategies/score';
+export * from './types';

package/dist/decisions/schema.d.ts

@@ -806,6 +806,7 @@ export declare const RuleStrategyZ: z.ZodObject<{
     }>, "many">;
     default: z.ZodUnknown;
 }, "strip", z.ZodTypeAny, {
+    type: "rules";
     rules: {
         conditions: ({
             url: string;
@@ -858,9 +859,9 @@ export declare const RuleStrategyZ: z.ZodObject<{
         })[];
         value?: unknown;
     }[];
-    type: "rules";
     default?: unknown;
 }, {
+    type: "rules";
     rules: {
         conditions: ({
             url: string;
@@ -913,7 +914,6 @@ export declare const RuleStrategyZ: z.ZodObject<{
         })[];
         value?: unknown;
     }[];
-    type: "rules";
     default?: unknown;
 }>;
 export declare const ScoreStrategyZ: z.ZodObject<{
@@ -963,14 +963,14 @@ export declare const ExternalStrategyZ: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     type: "external";
     endpoint: string;
-    default?: unknown;
     timeoutMs?: number | undefined;
+    default?: unknown;
     method?: "GET" | "POST" | undefined;
 }, {
     type: "external";
     endpoint: string;
-    default?: unknown;
     timeoutMs?: number | undefined;
+    default?: unknown;
     method?: "GET" | "POST" | undefined;
 }>;
 export declare const DecisionStrategyZ: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
@@ -1227,6 +1227,7 @@ export declare const DecisionStrategyZ: z.ZodDiscriminatedUnion<"type", [z.ZodOb
     }>, "many">;
     default: z.ZodUnknown;
 }, "strip", z.ZodTypeAny, {
+    type: "rules";
     rules: {
         conditions: ({
             url: string;
@@ -1279,9 +1280,9 @@ export declare const DecisionStrategyZ: z.ZodDiscriminatedUnion<"type", [z.ZodOb
         })[];
         value?: unknown;
     }[];
-    type: "rules";
     default?: unknown;
 }, {
+    type: "rules";
     rules: {
         conditions: ({
             url: string;
@@ -1334,7 +1335,6 @@ export declare const DecisionStrategyZ: z.ZodDiscriminatedUnion<"type", [z.ZodOb
         })[];
         value?: unknown;
     }[];
-    type: "rules";
     default?: unknown;
 }>, z.ZodObject<{
     type: z.ZodLiteral<"score">;
@@ -1381,14 +1381,14 @@ export declare const DecisionStrategyZ: z.ZodDiscriminatedUnion<"type", [z.ZodOb
 }, "strip", z.ZodTypeAny, {
     type: "external";
     endpoint: string;
-    default?: unknown;
     timeoutMs?: number | undefined;
+    default?: unknown;
     method?: "GET" | "POST" | undefined;
 }, {
     type: "external";
     endpoint: string;
-    default?: unknown;
     timeoutMs?: number | undefined;
+    default?: unknown;
     method?: "GET" | "POST" | undefined;
 }>]>;
 export declare const RouteFilterZ: z.ZodObject<{
@@ -1666,6 +1666,7 @@ export declare const ActivationConfigZ: z.ZodObject<{
         }>, "many">;
         default: z.ZodUnknown;
     }, "strip", z.ZodTypeAny, {
+        type: "rules";
         rules: {
             conditions: ({
                 url: string;
@@ -1718,9 +1719,9 @@ export declare const ActivationConfigZ: z.ZodObject<{
             })[];
             value?: unknown;
         }[];
-        type: "rules";
         default?: unknown;
     }, {
+        type: "rules";
         rules: {
             conditions: ({
                 url: string;
@@ -1773,7 +1774,6 @@ export declare const ActivationConfigZ: z.ZodObject<{
             })[];
             value?: unknown;
         }[];
-        type: "rules";
         default?: unknown;
     }>, z.ZodObject<{
         type: z.ZodLiteral<"score">;
@@ -1820,18 +1820,19 @@ export declare const ActivationConfigZ: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         type: "external";
         endpoint: string;
-        default?: unknown;
         timeoutMs?: number | undefined;
+        default?: unknown;
         method?: "GET" | "POST" | undefined;
     }, {
         type: "external";
         endpoint: string;
-        default?: unknown;
         timeoutMs?: number | undefined;
+        default?: unknown;
         method?: "GET" | "POST" | undefined;
     }>]>>;
 }, "strip", z.ZodTypeAny, {
     strategy?: {
+        type: "rules";
         rules: {
             conditions: ({
                 url: string;
@@ -1884,7 +1885,6 @@ export declare const ActivationConfigZ: z.ZodObject<{
             })[];
             value?: unknown;
         }[];
-        type: "rules";
         default?: unknown;
     } | {
         type: "score";
@@ -1901,8 +1901,8 @@ export declare const ActivationConfigZ: z.ZodObject<{
     } | {
         type: "external";
         endpoint: string;
-        default?: unknown;
         timeoutMs?: number | undefined;
+        default?: unknown;
         method?: "GET" | "POST" | undefined;
     } | undefined;
     routes?: {
@@ -1911,6 +1911,7 @@ export declare const ActivationConfigZ: z.ZodObject<{
     } | undefined;
 }, {
     strategy?: {
+        type: "rules";
         rules: {
             conditions: ({
                 url: string;
@@ -1963,7 +1964,6 @@ export declare const ActivationConfigZ: z.ZodObject<{
             })[];
             value?: unknown;
         }[];
-        type: "rules";
         default?: unknown;
     } | {
         type: "score";
@@ -1980,8 +1980,8 @@ export declare const ActivationConfigZ: z.ZodObject<{
     } | {
         type: "external";
         endpoint: string;
-        default?: unknown;
         timeoutMs?: number | undefined;
+        default?: unknown;
         method?: "GET" | "POST" | undefined;
     } | undefined;
     routes?: {
@@ -2093,6 +2093,7 @@ export declare function validateCondition(data: unknown): z.SafeParseReturnType<
  * Validate a DecisionStrategy object.
  */
 export declare function validateStrategy(data: unknown): z.SafeParseReturnType<{
+    type: "rules";
     rules: {
         conditions: ({
             url: string;
@@ -2145,7 +2146,6 @@ export declare function validateStrategy(data: unknown): z.SafeParseReturnType<{
         })[];
         value?: unknown;
     }[];
-    type: "rules";
     default?: unknown;
 } | {
     type: "score";
@@ -2162,10 +2162,11 @@ export declare function validateStrategy(data: unknown): z.SafeParseReturnType<{
 } | {
     type: "external";
     endpoint: string;
-    default?: unknown;
     timeoutMs?: number | undefined;
+    default?: unknown;
     method?: "GET" | "POST" | undefined;
 }, {
+    type: "rules";
     rules: {
         conditions: ({
             url: string;
@@ -2218,7 +2219,6 @@ export declare function validateStrategy(data: unknown): z.SafeParseReturnType<{
         })[];
         value?: unknown;
     }[];
-    type: "rules";
     default?: unknown;
 } | {
     type: "score";
@@ -2235,8 +2235,8 @@ export declare function validateStrategy(data: unknown): z.SafeParseReturnType<{
 } | {
     type: "external";
     endpoint: string;
-    default?: unknown;
     timeoutMs?: number | undefined;
+    default?: unknown;
     method?: "GET" | "POST" | undefined;
 }>;
 /**
@@ -2244,6 +2244,7 @@ export declare function validateStrategy(data: unknown): z.SafeParseReturnType<{
  */
 export declare function validateActivationConfig(data: unknown): z.SafeParseReturnType<{
     strategy?: {
+        type: "rules";
         rules: {
             conditions: ({
                 url: string;
@@ -2296,7 +2297,6 @@ export declare function validateActivationConfig(data: unknown): z.SafeParseRetu
             })[];
             value?: unknown;
         }[];
-        type: "rules";
         default?: unknown;
     } | {
         type: "score";
@@ -2313,8 +2313,8 @@ export declare function validateActivationConfig(data: unknown): z.SafeParseRetu
     } | {
         type: "external";
         endpoint: string;
-        default?: unknown;
         timeoutMs?: number | undefined;
+        default?: unknown;
         method?: "GET" | "POST" | undefined;
     } | undefined;
     routes?: {
@@ -2323,6 +2323,7 @@ export declare function validateActivationConfig(data: unknown): z.SafeParseRetu
     } | undefined;
 }, {
     strategy?: {
+        type: "rules";
         rules: {
             conditions: ({
                 url: string;
@@ -2375,7 +2376,6 @@ export declare function validateActivationConfig(data: unknown): z.SafeParseRetu
             })[];
             value?: unknown;
         }[];
-        type: "rules";
         default?: unknown;
     } | {
         type: "score";
@@ -2392,8 +2392,8 @@ export declare function validateActivationConfig(data: unknown): z.SafeParseRetu
     } | {
         type: "external";
         endpoint: string;
-        default?: unknown;
         timeoutMs?: number | undefined;
+        default?: unknown;
         method?: "GET" | "POST" | undefined;
     } | undefined;
     routes?: {

package/dist/decisions/strategies/rules.d.ts

@@ -3,7 +3,7 @@
  *
  * Evaluates rules in order and returns the value of the first matching rule.
  */
-import type { RuleStrategy, Rule, Condition, DecisionResult, EvaluationContext } from '../types';
+import type { Condition, DecisionResult, EvaluationContext, Rule, RuleStrategy } from '../types';
 /**
  * Evaluate a single condition against the evaluation context.
  */

package/dist/decisions/strategies/score.d.ts

@@ -3,7 +3,7 @@
  *
  * Compares an augmented field value against a threshold.
  */
-import type { ScoreStrategy, DecisionResult, EvaluationContext } from '../types';
+import type { DecisionResult, EvaluationContext, ScoreStrategy } from '../types';
 /**
  * Evaluate a ScoreStrategy and return the result.
  */

package/dist/editorLoader.d.ts

@@ -5,7 +5,7 @@ export interface EditorSource {
 }
 /** Decoded editor_conf payload (passed through to editor SDK). */
 export interface EditorConf {
-    mode: 'editor' | 'audit' | 'demo';
+    mode: 'editor' | 'audit' | 'review' | 'demo';
     audit_session_id?: string;
     [key: string]: unknown;
 }
@@ -24,10 +24,10 @@ export declare const shouldLoadEditor: () => boolean;
  */
 export declare const isAuditMode: () => boolean;
 /**
- * Checks if any SDK mode (editor or audit) should be loaded.
- * Returns the mode type if active, or null if neither.
+ * Checks if any SDK mode (editor, audit, or review) should be loaded.
+ * Returns the mode type if active, or null if none.
  */
-export declare const getActiveSdkMode: () => "editor" | "audit" | null;
+export declare const getActiveSdkMode: () => "editor" | "audit" | "review" | null;
 export interface EditorLoadOptions {
     editorUrl?: string;
     integrity?: string;

package/dist/events/EventAccumulator.d.ts

@@ -6,9 +6,9 @@
  * - Counts stored in StateStore.session (session-scoped)
  * - Subscribers notified on every counter increment
  */
+import type { StateStore } from '../state/StateStore';
 import type { EventBus } from './EventBus';
 import type { NormalizedEvent } from './types';
-import type { StateStore } from '../state/StateStore';
 export interface EventAccumulator {
     /** Register a named counter with a predicate callback. The adaptive provides ALL filtering logic. */
     register(key: string, predicate: (event: NormalizedEvent) => boolean, needsTimestamps?: boolean): void;

package/dist/events/EventBus.d.ts

@@ -6,7 +6,7 @@
  * - Event history for recent event lookups
  * - Filtering by name, pattern, or source
  */
-import type { NormalizedEvent, EventFilter, EventCallback, EventUnsubscribe } from './types';
+import type { EventCallback, EventFilter, EventUnsubscribe, NormalizedEvent } from './types';
 export interface EventBusOptions {
     /** Maximum number of events to keep in history */
     maxHistorySize?: number;

package/dist/events/index.d.ts

@@ -1,11 +1,12 @@
 /**
  * Events module exports.
  */
-export * from './types';
-export * from './schema';
-export { EventBus, createEventBus } from './EventBus';
-export type { EventBusOptions } from './EventBus';
-export { createEventAccumulator } from './EventAccumulator';
 export type { EventAccumulator, EventAccumulatorOptions } from './EventAccumulator';
-export { normalizePostHogEvent, shouldNormalizeEvent, createPostHogNormalizer, } from './normalizers/posthog';
+export { createEventAccumulator } from './EventAccumulator';
+export type { EventBusOptions } from './EventBus';
+export { createEventBus, EventBus } from './EventBus';
 export { CanvasEvents } from './normalizers/canvas';
+export { createPostHogNormalizer, normalizePostHogEvent, shouldNormalizeEvent, } from './normalizers/posthog';
+export { registerConfigPredicates } from './registerConfigPredicates';
+export * from './schema';
+export * from './types';

package/dist/events/registerConfigPredicates.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 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.
+ *
+ * This module extracts that logic so predicates are registered as soon as the
+ * config is loaded, regardless of canvas state.
+ */
+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).
+ */
+export declare function registerConfigPredicates(tiles: TileConfig[], accumulator: EventAccumulator): void;

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

@@ -4,8 +4,8 @@
  * This file is INTERNAL - consumers should only import from experiments/types.ts
  * and use the ExperimentClient interface.
  */
-import { GrowthBook } from '@growthbook/growthbook';
 import type { Context as GrowthBookInitOptions } from '@growthbook/growthbook';
+import { GrowthBook } from '@growthbook/growthbook';
 import type { TileConfig } from '../../types';
 import type { ExperimentClient } from '../types';
 /**

package/dist/experiments/index.d.ts

@@ -1,3 +1,3 @@
-export type { ExperimentClient, SyntroExperimentClient } from './types';
-export { createGrowthBookClient } from './adapters/growthbook';
 export type { GrowthBookAdapterOptions } from './adapters/growthbook';
+export { createGrowthBookClient } from './adapters/growthbook';
+export type { ExperimentClient, SyntroExperimentClient } from './types';

package/dist/experiments/registry.d.ts

@@ -5,7 +5,7 @@
  * This allows the bootstrap module to dynamically create
  * experiment clients based on token configuration.
  */
-import { ExperimentTrackingCallback } from './adapters/growthbook';
+import { type ExperimentTrackingCallback } from './adapters/growthbook';
 import type { ExperimentClient } from './types';
 export interface CreateExperimentClientConfig {
     clientKey: string;

package/dist/fetchers/index.d.ts

@@ -1,3 +1,3 @@
+export { CdnFetcher, type CdnFetcherOptions, createCdnFetcher } from './cdnFetcher';
+export { createExperimentsFetcher, ExperimentsFetcher, type ExperimentsFetcherOptions, } from './experimentsFetcher';
 export type { ConfigFetcher, FetchResult } from './types';
-export { ExperimentsFetcher, createExperimentsFetcher, type ExperimentsFetcherOptions, } from './experimentsFetcher';
-export { CdnFetcher, createCdnFetcher, type CdnFetcherOptions } from './cdnFetcher';

package/dist/hooks/useShadowCanvasConfig.d.ts

@@ -1,6 +1,6 @@
 import type { ExperimentClient } from '../experiments/types';
 import type { SmartCanvasRuntime } from '../runtime';
-import type { CanvasConfigFetcher, TileConfig, CanvasThemeConfig, LauncherConfig, RoutesConfig, ActionStep } from '../types';
+import type { ActionStep, CanvasConfigFetcher, CanvasThemeConfig, LauncherConfig, RoutesConfig, TileConfig } from '../types';
 export interface UseShadowCanvasConfigOptions {
     fetcher: CanvasConfigFetcher;
     pollIntervalMs?: number;

package/dist/hostPatcher/index.d.ts

@@ -1,6 +1,6 @@
-export * from './policy/defaultPolicy';
-export * from './core/types';
 export * from './core/patcher';
 export * from './core/sanitizer';
+export * from './core/types';
+export * from './policy/defaultPolicy';
 export * from './utils/anchors';
 export * from './utils/observer';

package/dist/index.d.ts

@@ -1,35 +1,38 @@
-export * from './version';
-export * from './types';
-export * from './config-validator';
-export * from './telemetry';
-export * from './experiments';
-export * from './hooks/useShadowCanvasConfig';
-export * from './components/TileCard';
+export * from './api';
 export * from './components/ShadowCanvasOverlay';
+export * from './components/TileCard';
 export * from './components/TileWheel';
+export * from './config-validator';
+export * from './configFetcher';
 export * from './controller';
+export * from './experiments';
+export * from './hooks/useShadowCanvasConfig';
+export * from './metrics';
+export * from './overlays/fetcher';
+export * from './overlays/schema';
+export * from './overlays/types';
+export * from './ShadowRootContext';
 export * from './SmartCanvasApp';
 export * from './SmartCanvasElement';
 export * from './SmartCanvasPortal';
-export * from './api';
-export * from './configFetcher';
-export * from './overlays/types';
-export * from './overlays/schema';
-export * from './overlays/fetcher';
-export * from './metrics';
+export * from './telemetry';
+export * from './types';
+export * from './version';
+export * from './actions';
+export * from './apps';
 export * from './context';
+export * from './decisions';
+export * from './events';
 export * from './events';
 export * from './notifications';
+export { RuntimeProvider, useDecision, usePageContext, useRuntime, useRuntimeContext, useRuntimeEvents, useRuntimeState, useSessionContext, useViewportContext, } from './RuntimeProvider';
+export type { RuntimeMode, SmartCanvasRuntime, SmartCanvasRuntimeOptions } from './runtime';
+export { createSmartCanvasRuntime, RUNTIME_VERSION } from './runtime';
+export * from './state';
 export * from './state';
-export * from './decisions';
-export * from './actions';
 export * from './surfaces';
 export * from './widgets';
-export * from './apps';
-export { createSmartCanvasRuntime, RUNTIME_VERSION } from './runtime';
-export type { SmartCanvasRuntime, SmartCanvasRuntimeOptions, RuntimeMode } from './runtime';
-export { RuntimeProvider, useRuntime, useRuntimeContext, usePageContext, useSessionContext, useViewportContext, useRuntimeEvents, useRuntimeState, useDecision, } from './RuntimeProvider';
-export { Syntro } from './bootstrap';
 export type { SyntroInitOptions, SyntroInitResult } from './bootstrap';
-export { encodeToken, decodeToken } from './token';
+export { Syntro } from './bootstrap';
 export type { SyntroTokenPayload } from './token';
+export { decodeToken, encodeToken } from './token';