@syntrologie/runtime-sdk 2.8.0-canary.191 → 2.8.0-canary.192

package/dist/context/schema.d.ts

@@ -74,13 +74,13 @@ export declare const BoundingBoxZ: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     x: number;
     y: number;
-    w: number;
     h: number;
+    w: number;
 }, {
     x: number;
     y: number;
-    w: number;
     h: number;
+    w: number;
 }>;
 export declare const AnchorStateZ: z.ZodObject<{
     anchorId: z.ZodString;
@@ -94,13 +94,13 @@ export declare const AnchorStateZ: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         x: number;
         y: number;
-        w: number;
         h: number;
+        w: number;
     }, {
         x: number;
         y: number;
-        w: number;
         h: number;
+        w: number;
     }>>;
 }, "strip", z.ZodTypeAny, {
     present: boolean;
@@ -109,8 +109,8 @@ export declare const AnchorStateZ: z.ZodObject<{
     boundingBox?: {
         x: number;
         y: number;
-        w: number;
         h: number;
+        w: number;
     } | undefined;
 }, {
     present: boolean;
@@ -119,8 +119,8 @@ export declare const AnchorStateZ: z.ZodObject<{
     boundingBox?: {
         x: number;
         y: number;
-        w: number;
         h: number;
+        w: number;
     } | undefined;
 }>;
 export declare const AugmentationZ: z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodNumber, z.ZodString, z.ZodBoolean, z.ZodUndefined]>>;
@@ -191,13 +191,13 @@ export declare const RuntimeContextZ: z.ZodObject<{
         }, "strip", z.ZodTypeAny, {
             x: number;
             y: number;
-            w: number;
             h: number;
+            w: number;
         }, {
             x: number;
             y: number;
-            w: number;
             h: number;
+            w: number;
         }>>;
     }, "strip", z.ZodTypeAny, {
         present: boolean;
@@ -206,8 +206,8 @@ export declare const RuntimeContextZ: z.ZodObject<{
         boundingBox?: {
             x: number;
             y: number;
-            w: number;
             h: number;
+            w: number;
         } | undefined;
     }, {
         present: boolean;
@@ -216,8 +216,8 @@ export declare const RuntimeContextZ: z.ZodObject<{
         boundingBox?: {
             x: number;
             y: number;
-            w: number;
             h: number;
+            w: number;
         } | undefined;
     }>, "many">>;
     augmented: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodNumber, z.ZodString, z.ZodBoolean, z.ZodUndefined]>>>;
@@ -247,8 +247,8 @@ export declare const RuntimeContextZ: z.ZodObject<{
         boundingBox?: {
             x: number;
             y: number;
-            w: number;
             h: number;
+            w: number;
         } | undefined;
     }[] | undefined;
     augmented?: Record<string, string | number | boolean | undefined> | undefined;
@@ -278,8 +278,8 @@ export declare const RuntimeContextZ: z.ZodObject<{
         boundingBox?: {
             x: number;
             y: number;
-            w: number;
             h: number;
+            w: number;
         } | undefined;
     }[] | undefined;
     augmented?: Record<string, string | number | boolean | undefined> | undefined;
@@ -313,8 +313,8 @@ export declare function validateRuntimeContext(data: unknown): z.SafeParseReturn
         boundingBox?: {
             x: number;
             y: number;
-            w: number;
             h: number;
+            w: number;
         } | undefined;
     }[] | undefined;
     augmented?: Record<string, string | number | boolean | undefined> | undefined;
@@ -344,8 +344,8 @@ export declare function validateRuntimeContext(data: unknown): z.SafeParseReturn
         boundingBox?: {
             x: number;
             y: number;
-            w: number;
             h: number;
+            w: number;
         } | undefined;
     }[] | undefined;
     augmented?: Record<string, string | number | boolean | undefined> | undefined;

package/dist/index.js

@@ -9576,8 +9576,231 @@ function error(prefix, message, data) {
   }
 }
 
+// src/observability/healthReporter.ts
+var HealthReporter = class {
+  constructor(config) {
+    this.config = config;
+    __publicField(this, "resource");
+    __publicField(this, "flushIntervalMs");
+    __publicField(this, "counters", /* @__PURE__ */ new Map());
+    __publicField(this, "histograms", /* @__PURE__ */ new Map());
+    __publicField(this, "windowStartMs", Date.now());
+    __publicField(this, "timer", null);
+    __publicField(this, "pagehideHandler", null);
+    __publicField(this, "runtime", null);
+    var _a3;
+    this.resource = config.resource;
+    this.flushIntervalMs = (_a3 = config.flushIntervalMs) != null ? _a3 : 6e4;
+  }
+  /**
+   * Bind runtime-derived attribute resolvers. Called after the canvas/telemetry
+   * are fully initialized. Must never throw — resolvers are wrapped in
+   * null-safe access at flush time.
+   */
+  bindRuntime(binding) {
+    this.runtime = binding;
+  }
+  increment(signal, by = 1) {
+    var _a3;
+    this.counters.set(signal, ((_a3 = this.counters.get(signal)) != null ? _a3 : 0) + by);
+  }
+  /**
+   * @internal — exposed for test inspection only. Mid-window state is intentionally
+   * unstable; consumers should subscribe to flush payloads instead.
+   */
+  snapshotCounters() {
+    const out = {};
+    for (const [k2, v2] of this.counters) out[k2] = v2;
+    return out;
+  }
+  recordHistogram(signal, valueMs) {
+    var _a3;
+    const arr = (_a3 = this.histograms.get(signal)) != null ? _a3 : [];
+    arr.push(valueMs);
+    this.histograms.set(signal, arr);
+  }
+  /**
+   * @internal — exposed for test inspection only. Mid-window state is intentionally
+   * unstable; consumers should subscribe to flush payloads instead.
+   */
+  snapshotHistograms() {
+    const out = {};
+    for (const [k2, samples] of this.histograms) {
+      if (samples.length === 0) continue;
+      const sorted = [...samples].sort((a, b2) => a - b2);
+      out[k2] = {
+        count: sorted.length,
+        p50: percentile(sorted, 0.5),
+        p95: percentile(sorted, 0.95)
+      };
+    }
+    return out;
+  }
+  async flush() {
+    var _a3, _b, _c, _d, _e2, _f, _g, _h;
+    const counters = this.snapshotCounters();
+    const histograms = this.snapshotHistograms();
+    const hasData = Object.keys(counters).length > 0 || Object.keys(histograms).length > 0;
+    if (!hasData) return;
+    let surface = null;
+    let sessionId = "";
+    try {
+      surface = (_b = (_a3 = this.runtime) == null ? void 0 : _a3.getSurface()) != null ? _b : null;
+    } catch {
+    }
+    try {
+      sessionId = (_d = (_c = this.runtime) == null ? void 0 : _c.getSessionId()) != null ? _d : "";
+    } catch {
+    }
+    const payload = {
+      resource: {
+        ...this.resource,
+        sessionId,
+        surfaceType: (_e2 = surface == null ? void 0 : surface.type) != null ? _e2 : "unknown",
+        surfaceHost: (_f = surface == null ? void 0 : surface.host) != null ? _f : "unknown",
+        surfaceDevice: (_g = surface == null ? void 0 : surface.device) != null ? _g : "unknown",
+        surfaceMode: (_h = surface == null ? void 0 : surface.mode) != null ? _h : "unknown"
+      },
+      windowSeconds: Math.max(1, Math.round((Date.now() - this.windowStartMs) / 1e3)),
+      windowStartUnixMs: this.windowStartMs,
+      counters,
+      histograms
+    };
+    this.counters.clear();
+    this.histograms.clear();
+    this.windowStartMs = Date.now();
+    try {
+      await this.config.emit(payload);
+    } catch {
+    }
+  }
+  start() {
+    if (this.timer !== null) return;
+    this.timer = setInterval(() => {
+      void this.flush();
+    }, this.flushIntervalMs);
+    if (typeof window !== "undefined") {
+      this.pagehideHandler = () => {
+        void this.flush();
+      };
+      window.addEventListener("pagehide", this.pagehideHandler);
+    }
+  }
+  stop() {
+    if (this.timer !== null) {
+      clearInterval(this.timer);
+      this.timer = null;
+    }
+    if (this.pagehideHandler !== null && typeof window !== "undefined") {
+      window.removeEventListener("pagehide", this.pagehideHandler);
+      this.pagehideHandler = null;
+    }
+  }
+};
+function percentile(sortedAsc, q2) {
+  if (sortedAsc.length === 0) return 0;
+  const pos = (sortedAsc.length - 1) * q2;
+  const lo = Math.floor(pos);
+  const hi = Math.ceil(pos);
+  if (lo === hi) return sortedAsc[lo];
+  return sortedAsc[lo] + (sortedAsc[hi] - sortedAsc[lo]) * (pos - lo);
+}
+var singleton = null;
+function initHealthReporter(config) {
+  singleton == null ? void 0 : singleton.stop();
+  singleton = new HealthReporter(config);
+  singleton.start();
+  return singleton;
+}
+function getHealthReporter() {
+  return singleton;
+}
+
+// src/observability/otlpEmitter.ts
+var stringAttr = (key, value) => ({ key, value: { stringValue: value } });
+var intAttr = (key, value) => ({
+  key,
+  value: { intValue: Math.round(value) }
+});
+var doubleAttr = (key, value) => ({ key, value: { doubleValue: value } });
+function buildOtlpPayload(flush) {
+  const { resource, counters, histograms, windowSeconds, windowStartUnixMs } = flush;
+  const resourceAttrs = [
+    stringAttr("service.name", resource.serviceName),
+    stringAttr("service.version", resource.serviceVersion),
+    stringAttr("syntro.posthog_key", resource.posthogKey),
+    stringAttr("syntro.session_id", resource.sessionId),
+    stringAttr("syntro.surface_type", resource.surfaceType),
+    stringAttr("syntro.surface_host", resource.surfaceHost),
+    stringAttr("syntro.surface_device", resource.surfaceDevice),
+    stringAttr("syntro.surface_mode", resource.surfaceMode),
+    stringAttr("syntro.host_origin", resource.hostOrigin)
+  ];
+  const recordAttrs = [intAttr("window_seconds", windowSeconds)];
+  for (const [k2, v2] of Object.entries(counters)) {
+    if (v2 !== void 0) recordAttrs.push(intAttr(k2, v2));
+  }
+  for (const [k2, h] of Object.entries(histograms)) {
+    if (h === void 0) continue;
+    recordAttrs.push(intAttr(`${k2}_count`, h.count));
+    recordAttrs.push(doubleAttr(`${k2}_p50`, h.p50));
+    recordAttrs.push(doubleAttr(`${k2}_p95`, h.p95));
+  }
+  const nowNano = `${Date.now()}000000`;
+  const startNano = `${windowStartUnixMs}000000`;
+  return {
+    resourceLogs: [
+      {
+        resource: { attributes: resourceAttrs },
+        scopeLogs: [
+          {
+            scope: { name: "syntro.sdk.health" },
+            logRecords: [
+              {
+                timeUnixNano: startNano,
+                observedTimeUnixNano: nowNano,
+                severityText: "INFO",
+                body: { stringValue: "sdk_health_window" },
+                attributes: recordAttrs
+              }
+            ]
+          }
+        ]
+      }
+    ]
+  };
+}
+function createOtlpEmitter(cfg) {
+  var _a3;
+  const fetchImpl = (_a3 = cfg.fetchImpl) != null ? _a3 : fetch;
+  return async (flush) => {
+    const body = JSON.stringify(buildOtlpPayload(flush));
+    const post = () => fetchImpl(cfg.endpoint, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body,
+      keepalive: true,
+      mode: "cors"
+    });
+    try {
+      const resp = await post();
+      if (!resp.ok && resp.status >= 500) {
+        try {
+          await post();
+        } catch {
+        }
+      }
+    } catch {
+      try {
+        await post();
+      } catch {
+      }
+    }
+  };
+}
+
 // src/version.ts
-var SDK_VERSION = "2.8.0-canary.191";
+var SDK_VERSION = "2.8.0-canary.192";
 
 // src/types.ts
 var SDK_SCHEMA_VERSION = "2.0";
@@ -9696,7 +9919,7 @@ var createCanvasConfigFetcher = ({
   variantFlagPrefix,
   sdkVersion
 }) => async () => {
-  var _a3, _b;
+  var _a3, _b, _c, _d, _e2, _f;
   if (experiments && configFeatureKey) {
     const directConfig = (_a3 = experiments.getFeatureValue) == null ? void 0 : _a3.call(experiments, configFeatureKey, null);
     if (directConfig && typeof directConfig === "object") {
@@ -9735,6 +9958,8 @@ var createCanvasConfigFetcher = ({
     throw new Error(`SmartCanvas: config URI not allowed: ${uri}`);
   }
   const effectiveCredentials = credentials != null ? credentials : isSameOrigin2(uri) ? "include" : "omit";
+  const fetchStart = performance.now();
+  let errorAlreadyCounted = false;
   try {
     const response = await fetch(uri, {
       credentials: effectiveCredentials,
@@ -9744,15 +9969,23 @@ var createCanvasConfigFetcher = ({
       }
     });
     if (!response.ok) {
+      (_c = getHealthReporter()) == null ? void 0 : _c.increment("flag_fetch_errors");
+      errorAlreadyCounted = true;
       throw new Error(`SmartCanvas: failed to fetch config (${response.status})`);
     }
     const config = await response.json();
+    const latencyMs = performance.now() - fetchStart;
+    (_d = getHealthReporter()) == null ? void 0 : _d.increment("flag_fetch_count");
+    (_e2 = getHealthReporter()) == null ? void 0 : _e2.recordHistogram("flag_fetch_latency_ms", latencyMs);
     debug("SmartCanvas Config", "Fetched config from URI", config);
     if (sdkVersion) {
       cacheConfig(config, sdkVersion);
     }
     return config;
   } catch (error2) {
+    if (!errorAlreadyCounted) {
+      (_f = getHealthReporter()) == null ? void 0 : _f.increment("flag_fetch_errors");
+    }
     if (sdkVersion) {
       const cached = getCachedConfig(sdkVersion);
       if (cached) {
@@ -17965,7 +18198,7 @@ function createTelemetryClient(provider, config) {
 
 // src/bootstrap-runtime.ts
 async function _initCore(options) {
-  var _a3, _b, _c, _d, _e2, _f, _g, _h, _i, _j, _k, _l;
+  var _a3, _b, _c, _d, _e2, _f, _g, _h, _i, _j, _k, _l, _m, _n;
   initLogger();
   debug("Syntro Bootstrap", "====== INIT ======");
   debug("Syntro Bootstrap", "Options:", {
@@ -18027,13 +18260,30 @@ async function _initCore(options) {
   } else {
     debug("Syntro Bootstrap", `\u2713 No token, but ${sdkMode} mode - proceeding`);
   }
+  if (payload != null && payload.obd !== true) {
+    try {
+      const otlpEndpoint = (_b = payload.obe) != null ? _b : "https://telemetry.syntrologie.com/sdk-otel/v1/logs";
+      initHealthReporter({
+        resource: {
+          serviceName: "syntro-runtime-sdk",
+          serviceVersion: SDK_VERSION,
+          // PostHog project SDK key — canonical workspace identifier for ops.
+          // Telemetry lives in PostHog, so its primary key is the right join column.
+          posthogKey: (_c = payload.t) != null ? _c : "",
+          hostOrigin: typeof window !== "undefined" ? window.location.origin : ""
+        },
+        emit: createOtlpEmitter({ endpoint: otlpEndpoint })
+      });
+    } catch {
+    }
+  }
   const experimentHost = getEnvVar("NEXT_PUBLIC_SYNTRO_EXPERIMENT_HOST") || getEnvVar("VITE_SYNTRO_EXPERIMENT_HOST") || (payload == null ? void 0 : payload.eh);
   const telemetryHost = getEnvVar("NEXT_PUBLIC_SYNTRO_TELEMETRY_HOST") || getEnvVar("VITE_SYNTRO_TELEMETRY_HOST") || (payload == null ? void 0 : payload.th);
-  const editorUrl = getEnvVar("NEXT_PUBLIC_SYNTRO_EDITOR_URL") || getEnvVar("VITE_SYNTRO_EDITOR_URL") || ((_b = options.canvas) == null ? void 0 : _b.editorUrl);
+  const editorUrl = getEnvVar("NEXT_PUBLIC_SYNTRO_EDITOR_URL") || getEnvVar("VITE_SYNTRO_EDITOR_URL") || ((_d = options.canvas) == null ? void 0 : _d.editorUrl);
   const geoHost = (payload == null ? void 0 : payload.g) || getEnvVar("NEXT_PUBLIC_SYNTRO_GEO_HOST") || getEnvVar("VITE_SYNTRO_GEO_HOST") || GEO_DEFAULT_HOST;
   const cachedSegmentAttrs = loadCachedSegmentAttributes();
   const browserMetadata = collectBrowserMetadata();
-  const appSignalsInit = (_c = options.appSignalsInit) != null ? _c : {};
+  const appSignalsInit = (_e2 = options.appSignalsInit) != null ? _e2 : {};
   const phaseOneAttrs = { ...browserMetadata, ...cachedSegmentAttrs, ...appSignalsInit };
   debug("Syntro Bootstrap", "Phase 1: Browser metadata:", browserMetadata);
   debug("Syntro Bootstrap", "Phase 1: Cached segment attributes:", cachedSegmentAttrs);
@@ -18177,7 +18427,7 @@ async function _initCore(options) {
     });
     console.log(`[Syntro Bootstrap] Telemetry client created (${provider}) with EventBus wiring`);
     if (Object.keys(appSignalsInit).length > 0) {
-      (_d = telemetry.track) == null ? void 0 : _d.call(telemetry, "app_signals_init", appSignalsInit);
+      (_f = telemetry.track) == null ? void 0 : _f.call(telemetry, "app_signals_init", appSignalsInit);
       debug("Syntro Bootstrap", "Tracked app signals event:", appSignalsInit);
     }
     const telemetryForCapture = telemetry;
@@ -18235,7 +18485,7 @@ async function _initCore(options) {
     if ((platformAdapter == null ? void 0 : platformAdapter.name) === "shopify" && telemetryHost) {
       try {
         shopifyPixelBridge = new ShopifyPixelBridge({
-          distinctId: (_f = (_e2 = telemetry.getDistinctId) == null ? void 0 : _e2.call(telemetry)) != null ? _f : "",
+          distinctId: (_h = (_g = telemetry.getDistinctId) == null ? void 0 : _g.call(telemetry)) != null ? _h : "",
           telemetryHost,
           telemetryKey: payload.t
         });
@@ -18323,7 +18573,7 @@ async function _initCore(options) {
       debug("Syntro Bootstrap", "auto-load of adaptive-mcp failed (non-fatal):", err);
     });
   }
-  const registeredApps = (_i = (_h = (_g = runtime5.apps).list) == null ? void 0 : _h.call(_g)) != null ? _i : [];
+  const registeredApps = (_k = (_j = (_i = runtime5.apps).list) == null ? void 0 : _j.call(_i)) != null ? _k : [];
   console.log(
     `[DIAG] Activation loop: ${registeredApps.length} apps in registry:`,
     registeredApps.map((a) => `${a.manifest.id}(${a.state})`).join(", ")
@@ -18354,13 +18604,13 @@ async function _initCore(options) {
   if (experiments && Object.keys(geoData).length > 0) {
     const mergedAttrs = { ...browserMetadata, ...geoData, ...appSignalsInit };
     debug("Syntro Bootstrap", "Merging geo data into GrowthBook attributes:", geoData);
-    (_j = experiments.setAttributes) == null ? void 0 : _j.call(experiments, mergedAttrs);
+    (_l = experiments.setAttributes) == null ? void 0 : _l.call(experiments, mergedAttrs);
   }
   const mcpHost = await mcpPromise;
   if (mcpHost && experiments) {
     browserMetadata.surface_type = "mcp-app";
     browserMetadata.surface_host = mcpHost.name;
-    (_k = experiments.setAttributes) == null ? void 0 : _k.call(experiments, { ...browserMetadata, ...geoData });
+    (_m = experiments.setAttributes) == null ? void 0 : _m.call(experiments, { ...browserMetadata, ...geoData });
     runtime5.context.setSurfaceType("mcp-app");
     runtime5.context.setSurfaceHost(mcpHost.name);
     debug("Syntro Bootstrap", "MCP App detected:", mcpHost.name);
@@ -18369,7 +18619,7 @@ async function _initCore(options) {
   if (options.fetcher) {
     baseFetcher = options.fetcher;
   } else if (payload == null ? void 0 : payload.f) {
-    const configFetcher = createConfigFetcher(payload.f, (_l = payload.o) != null ? _l : {});
+    const configFetcher = createConfigFetcher(payload.f, (_n = payload.o) != null ? _n : {});
     baseFetcher = async () => {
       var _a4;
       const result = await configFetcher.fetch();
@@ -18383,7 +18633,7 @@ async function _initCore(options) {
   }
   const warnedAppFailures = /* @__PURE__ */ new Set();
   const appLoadingFetcher = baseFetcher ? async () => {
-    var _a4, _b2, _c2, _d2, _e3, _f2, _g2, _h2, _i2, _j2, _k2, _l2, _m;
+    var _a4, _b2, _c2, _d2, _e3, _f2, _g2, _h2, _i2, _j2, _k2, _l2, _m2;
     const config = await baseFetcher();
     const tileCount = (_b2 = (_a4 = config.tiles) == null ? void 0 : _a4.length) != null ? _b2 : 0;
     const actionCount = (_d2 = (_c2 = config.actions) == null ? void 0 : _c2.length) != null ? _d2 : 0;
@@ -18416,7 +18666,7 @@ async function _initCore(options) {
       `actions=${(_j2 = (_i2 = config.actions) == null ? void 0 : _i2.length) != null ? _j2 : 0},`,
       `theme=${(_l2 = (_k2 = config.theme) == null ? void 0 : _k2.name) != null ? _l2 : "none"}`
     );
-    if (((_m = config.actions) == null ? void 0 : _m.length) > 0) {
+    if (((_m2 = config.actions) == null ? void 0 : _m2.length) > 0) {
       console.log(
         "[Syntro Bootstrap] Actions in config:",
         config.actions.map(
@@ -18509,19 +18759,47 @@ async function _initCore(options) {
       originalSetOverrideFetcher(wrappedFetcher);
     };
   }
+  const healthReporter = getHealthReporter();
+  if (healthReporter !== null) {
+    try {
+      const boundTelemetry = telemetry;
+      const boundRuntime = runtime5;
+      healthReporter.bindRuntime({
+        getSessionId: () => {
+          var _a4, _b2;
+          try {
+            return (_b2 = (_a4 = boundTelemetry == null ? void 0 : boundTelemetry.getSessionId) == null ? void 0 : _a4.call(boundTelemetry)) != null ? _b2 : "";
+          } catch {
+            return "";
+          }
+        },
+        getSurface: () => {
+          try {
+            const surface = boundRuntime.context.get().surface;
+            return surface ? { ...surface } : null;
+          } catch {
+            return null;
+          }
+        }
+      });
+    } catch {
+    }
+  }
+  healthReporter == null ? void 0 : healthReporter.increment("bootstrap_ok");
   return { canvas, runtime: runtime5, experiments, telemetry, sessionMetrics, appLoader };
 }
 
 // src/bootstrap.ts
 async function init(options) {
-  var _a3;
+  var _a3, _b;
   try {
     return await _initCore(options);
   } catch (err) {
     const message = err instanceof Error ? err.message : String(err);
     console.warn("[Syntrologie] SDK initialization failed:", message);
+    (_a3 = getHealthReporter()) == null ? void 0 : _a3.increment("bootstrap_errors");
     if (typeof document !== "undefined") {
-      (_a3 = document.getElementById("syntrologie-anti-flicker")) == null ? void 0 : _a3.remove();
+      (_b = document.getElementById("syntrologie-anti-flicker")) == null ? void 0 : _b.remove();
     }
     return void 0;
   }