@syntrologie/runtime-sdk 2.10.0 → 2.12.0

package/dist/telemetry/adapters/posthog.d.ts

@@ -32,10 +32,12 @@ export interface PostHogAdapterOptions {
      */
     sessionRecording?: boolean;
     /**
-     * Enable pageview capture.
-     * @default true
+     * Pageview capture mode.
+     * - true: capture only on initial page load
+     * - 'history_change': auto-capture on SPA navigation (pushState/replaceState)
+     * @default "history_change"
      */
-    capturePageview?: boolean;
+    capturePageview?: boolean | 'history_change';
     /**
      * Enable page leave capture.
      * @default true
@@ -71,6 +73,18 @@ export interface PostHogAdapterOptions {
      * @default false
      */
     requireExplicitConsent?: boolean;
+    /**
+     * Enable behavioral signal detection (hesitation, rage click, etc.)
+     * Pass `true` for defaults, or a partial DetectorConfig to customize thresholds.
+     * @default false
+     */
+    behavioralSignals?: boolean | Record<string, number>;
+    /**
+     * Callback for raw rrweb events from session recording.
+     * Called with each rrweb eventWithTime before PostHog processes it.
+     * Used by the event processor for behavioral signal detection.
+     */
+    onRRWebEvent?: (event: Record<string, unknown>) => void;
 }
 interface CanvasAnalyticsPayload extends Properties {
     rectangleId?: string;
@@ -84,13 +98,25 @@ export declare class PostHogAdapter implements TelemetryClient {
     private client?;
     private featureFlagsCallback?;
     private captureCallback?;
-    private consentUnsub?;
+    private rrwebCallback?;
     constructor(options?: PostHogAdapterOptions);
     /**
      * Initialize the PostHog client. Called immediately (no consent gate)
      * or deferred (when consent gate grants).
      */
     private initPostHog;
+    /**
+     * Set up rrweb event interception on PostHog's session recording.
+     *
+     * PostHog lazy-loads the rrweb recorder. The SessionRecording wrapper has
+     * an `onRRwebEmit` method, but rrweb delivers events directly to the
+     * lazy-loaded recorder instance's `onRRwebEmit`, bypassing the wrapper.
+     * We must find and patch the recorder instance, not the wrapper.
+     *
+     * The recorder instance is stored on a minified property of SessionRecording.
+     * We detect it by looking for an object with both `onRRwebEmit` and `start` methods.
+     */
+    private setupRRWebIntercept;
     /**
      * Get all feature flags from PostHog.
      * Used to extract segment membership flags (in_segment_*).

package/dist/test/setup.d.ts

@@ -0,0 +1 @@
+import '@testing-library/jest-dom/vitest';

package/dist/token.d.ts

@@ -20,6 +20,8 @@ export interface SyntroTokenPayload {
     f?: string;
     /** Fetcher-specific options (e.g., configId for cdn fetcher) */
     o?: Record<string, string>;
+    /** Geo worker URL (e.g., "https://dev-geo.syntrologie.com" for dev) */
+    g?: string;
     /** Debug mode - enables console logging (default: false) */
     d?: boolean;
 }

package/dist/version.d.ts

@@ -10,4 +10,4 @@
  *
  * @since 2.0.0
  */
-export declare const SDK_VERSION = "2.10.0";
+export declare const SDK_VERSION = "2.12.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@syntrologie/runtime-sdk",
-  "version": "2.10.0",
+  "version": "2.12.0",
   "description": "Syntrologie Runtime SDK for web experimentation and analytics",
   "license": "Proprietary",
   "private": false,
@@ -61,21 +61,16 @@
     "validate-config": "node ./scripts/validate-config.mjs",
     "typecheck": "tsc --noEmit -p tsconfig.build.json",
     "test": "vitest run",
-    "prepublishOnly": "npm run clean && npm run build"
+    "strip-internal-deps": "node ./scripts/strip-internal-deps.mjs",
+    "prepublishOnly": "npm run clean && npm run build && npm run strip-internal-deps"
   },
   "dependencies": {
-    "@floating-ui/dom": "^1.7.5",
+    "@floating-ui/dom": "1.7.5",
     "@growthbook/growthbook": "~1.6.2",
-    "@growthbook/growthbook-react": "^1.6.4",
-    "@syntrologie/adapt-chatbot": "2.10.0",
-    "@syntrologie/adapt-content": "2.10.0",
-    "@syntrologie/adapt-faq": "2.10.0",
-    "@syntrologie/adapt-gamification": "2.10.0",
-    "@syntrologie/adapt-nav": "2.10.0",
-    "@syntrologie/adapt-overlays": "2.10.0",
-    "lucide-react": "^0.576.0",
-    "posthog-js": "~1.302.2",
-    "zod": "^3.25.76"
+    "@growthbook/growthbook-react": "1.6.4",
+    "lucide-react": "0.576.0",
+    "posthog-js": "1.341.0",
+    "zod": "3.25.76"
   },
   "peerDependencies": {
     "react": ">=18.0.0",
@@ -86,21 +81,21 @@
     "@semantic-release/github": "~12.0.3",
     "@semantic-release/npm": "~13.1.3",
     "@syntro/design-system": "*",
-    "@testing-library/dom": "^10.4.1",
-    "@testing-library/jest-dom": "^6.9.1",
-    "@testing-library/react": "^16.3.2",
-    "@types/node": "^22.19.7",
-    "@types/react": "^19.2.0",
-    "@types/react-dom": "^19.2.0",
-    "ajv": "^8.18.0",
-    "ajv-formats": "^3.0.1",
-    "esbuild": "^0.27.2",
-    "jsdom": "^26.1.0",
-    "react": "^19.2.0",
-    "react-dom": "^19.2.0",
+    "@testing-library/dom": "10.4.1",
+    "@testing-library/jest-dom": "6.9.1",
+    "@testing-library/react": "16.3.2",
+    "@types/node": "22.19.7",
+    "@types/react": "19.2.14",
+    "@types/react-dom": "19.2.3",
+    "ajv": "8.18.0",
+    "ajv-formats": "3.0.1",
+    "esbuild": "0.27.2",
+    "jsdom": "26.1.0",
+    "react": "19.2.1",
+    "react-dom": "19.2.1",
     "semantic-release": "~25.0.3",
-    "typescript": "^5.9.3",
-    "vitest": "^4.0.18",
-    "zod-to-json-schema": "^3.25.1"
+    "typescript": "5.9.3",
+    "vitest": "4.0.18",
+    "zod-to-json-schema": "3.25.1"
   }
 }

package/schema/canvas-config.schema.json

@@ -9337,7 +9337,7 @@
       "properties": {
         "kind": {
           "type": "string",
-          "const": "core:tour"
+          "const": "overlays:tour"
         },
         "tourId": {
           "type": "string"

package/scripts/syntroReactPlugin.mjs

@@ -71,6 +71,9 @@ export const syntroReactPlugin = {
             export function useReducer() { return _R().useReducer.apply(null, arguments); }
             export function useLayoutEffect() { return _R().useLayoutEffect.apply(null, arguments); }
             export function useId() { return _R().useId.apply(null, arguments); }
+            export function useSyncExternalStore() { return _R().useSyncExternalStore.apply(null, arguments); }
+            export function useDebugValue() { return _R().useDebugValue.apply(null, arguments); }
+            export function useInsertionEffect() { return _R().useInsertionEffect.apply(null, arguments); }
 
             // Creation APIs — lazy function wrappers
             export function createElement() { return _R().createElement.apply(null, arguments); }

package/scripts/validate-config.mjs

@@ -119,6 +119,29 @@ if (semanticErrors.length > 0) {
   process.exit(1);
 }
 
+// --- Semantic check: tiles with notifications must have actions ---
+// Notifications reference content (FAQ items, nav tips) that lives in
+// tile.props.actions. Without actions, notifications have nothing to show.
+for (const tile of config.tiles ?? []) {
+  const notifications = tile.notifications ?? [];
+  if (notifications.length === 0) continue;
+
+  const actions = tile.props?.actions ?? [];
+  if (actions.length === 0) {
+    semanticErrors.push(
+      `Tile "${tile.id}": has ${notifications.length} notification(s) but no actions.\n` +
+        `    Notifications reference tile content (FAQ items, nav tips) defined in tile.props.actions.\n` +
+        `    Add actions to the tile, or remove the notifications.`
+    );
+  }
+}
+
+if (semanticErrors.length > 0) {
+  console.error(`\n\u274C ${semanticErrors.length} semantic error(s):`);
+  for (const e of semanticErrors) console.error(`  - ${e}`);
+  process.exit(1);
+}
+
 // --- Semantic check: anchorId.route must include at least one concrete route ---
 // Wildcards allowed by canvas-config.schema.json anchorId.route;
 // update here if the schema adds new glob patterns.
@@ -241,6 +264,25 @@ for (const { path, url } of pageUrlHits) {
   }
 }
 
+// Hidden insertHtml without a triggerWhen is dead HTML — the SDK has no way to show it.
+// The LLM sometimes generates `display:none` elements expecting a trigger type (e.g.,
+// exit-intent) that doesn't exist in the SDK. Without triggerWhen, the element is
+// injected hidden and stays hidden forever.
+for (const [i, action] of (config.actions ?? []).entries()) {
+  if (action.kind !== 'content:insertHtml') continue;
+  if (action.triggerWhen) continue;
+  const html = action.html ?? '';
+  if (!/display\s*:\s*none/i.test(html)) continue;
+
+  const label = action.label ? ` (label: "${action.label}")` : '';
+  warnings.push(
+    `actions[${i}]${label}: content:insertHtml injects hidden HTML (display:none) with no triggerWhen.\n` +
+      `    This element will be inserted into the DOM but never shown — the SDK has no mechanism to reveal it.\n` +
+      `    Either add a triggerWhen with a valid condition (e.g., event_count, session_metric) to control visibility,\n` +
+      `    or remove display:none to show it immediately.`
+  );
+}
+
 if (warnings.length > 0) {
   console.warn(`\n\u26A0\uFE0F  ${warnings.length} design warning(s):`);
   for (const w of warnings) console.warn(`  - ${w}`);