@syntrologie/adapt-chatbot 2.8.0-canary.43 → 2.8.0-canary.430

package/dist/observer/__tests__/observer-enrich.test.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Tests for the observer's per-observation `enrich` hook.
+ *
+ * The chat-bar uses this hook to attach normalized product identity (from the
+ * ACTIVE platform adapter) to click observations before they're queued for the
+ * observation POST. The observer itself stays platform-neutral — it just
+ * applies whatever transform it's given, AFTER matchEvent, BEFORE queueing.
+ */
+export {};
+//# sourceMappingURL=observer-enrich.test.d.ts.map

package/dist/observer/__tests__/observer-enrich.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observer-enrich.test.d.ts","sourceRoot":"","sources":["../../../src/observer/__tests__/observer-enrich.test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/observer/__tests__/observer-isolation.test.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Isolation tests for the observer.
+ *
+ * The observer must never include host-page PII in observation text.
+ * PostHog autocapture strips sensitive properties from $elements before
+ * delivery, but we add a belt-and-suspenders check here against text
+ * fields that look like emails, phones, or credit-card patterns.
+ *
+ * If this test ever fails, the templates in allowlist.ts have regressed
+ * — fix there, not by suppressing this test.
+ */
+export {};
+//# sourceMappingURL=observer-isolation.test.d.ts.map

package/dist/observer/__tests__/observer-isolation.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observer-isolation.test.d.ts","sourceRoot":"","sources":["../../../src/observer/__tests__/observer-isolation.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/dist/observer/__tests__/queue.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=queue.test.d.ts.map

package/dist/observer/__tests__/queue.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.test.d.ts","sourceRoot":"","sources":["../../../src/observer/__tests__/queue.test.ts"],"names":[],"mappings":""}

package/dist/observer/__tests__/transport.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=transport.test.d.ts.map

package/dist/observer/__tests__/transport.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.test.d.ts","sourceRoot":"","sources":["../../../src/observer/__tests__/transport.test.ts"],"names":[],"mappings":""}

package/dist/observer/allowlist.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Pure mapping from raw PostHog events to ObservationEvents.
+ *
+ * One function: matchEvent(raw, opts) → ObservationEvent | null. Null means
+ * "drop, not significant." This module is the single source of truth for what
+ * the chat agent sees on the in-session timeline; the SDK observer never
+ * forwards anything matchEvent returns null for.
+ *
+ * Kept dependency-free (no DOM access, no PostHog SDK imports) so the
+ * Vitest unit tests run without any browser shim.
+ */
+import type { ObservationEvent as ObservationEventContract } from '@syntrologie/runtime-contracts';
+/** The templated event kinds (nav/click/form/rage/…) — the backend enum. */
+export type ObservationKind = ObservationEventContract['kind'];
+/** One templated host-page event — the SDK↔backend wire contract. */
+export type ObservationEvent = ObservationEventContract;
+/** Shape of a raw event reaching matchEvent. Loose by design — PostHog's
+ *  event shape evolves, and we want matchEvent to be resilient to extra
+ *  properties. */
+export interface RawEvent {
+    event: string;
+    timestamp: number;
+    properties: Record<string, unknown>;
+}
+export interface MatchOptions {
+    /** Workspace-configured custom event names to forward as kind="custom". */
+    observableEvents?: readonly string[];
+}
+export declare function matchEvent(raw: RawEvent, opts?: MatchOptions): ObservationEvent | null;
+//# sourceMappingURL=allowlist.d.ts.map

package/dist/observer/allowlist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"allowlist.d.ts","sourceRoot":"","sources":["../../src/observer/allowlist.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,OAAO,KAAK,EAAE,gBAAgB,IAAI,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAEnG,4EAA4E;AAC5E,MAAM,MAAM,eAAe,GAAG,wBAAwB,CAAC,MAAM,CAAC,CAAC;AAE/D,qEAAqE;AACrE,MAAM,MAAM,gBAAgB,GAAG,wBAAwB,CAAC;AAExD;;kBAEkB;AAClB,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,YAAY;IAC3B,2EAA2E;IAC3E,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AA0ED,wBAAgB,UAAU,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,GAAE,YAAiB,GAAG,gBAAgB,GAAG,IAAI,CA4I1F"}

package/dist/observer/bus-translate.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Runtime-bus → observer translation.
+ *
+ * On hosts where `window.posthog` isn't exposed as a global, the observer's
+ * PostHog auto-attach is a no-op; instead the chat-bar subscribes to the
+ * SYNTRO runtime event bus and forwards events into the observer's allowlist.
+ *
+ * The catch: bus events have already been NORMALIZED by the event-processor
+ * (see `packages/event-processor/src/normalizers/posthog.ts`). The raw PostHog
+ * `$`-prefixed properties `matchEvent` reads (`$event_type`, `$elements`,
+ * `$element_tag_name`, `$pathname`, `$current_url`) were renamed to
+ * (`—dropped—`, `elements`, `tagName`, `pathname`, `url`) and the click/submit
+ * distinction moved from `$event_type` into the normalized event `name`
+ * (`ui.click` / `ui.submit`). This function re-derives the raw shape so
+ * `matchEvent` — the single source of truth, also fed directly by the
+ * `window.posthog`-global path — stays untouched.
+ */
+import type { RawEvent } from './allowlist';
+/** A normalized event as it arrives on the SYNTRO runtime bus. */
+export interface BusEvent {
+    ts?: number;
+    name?: string;
+    source?: string;
+    props?: Record<string, unknown> & {
+        originalEvent?: string;
+    };
+}
+/**
+ * Translate one bus event into the `RawEvent` the observer allowlist expects,
+ * or null to drop it.
+ */
+export declare function busEventToRawEvent(e: BusEvent): RawEvent | null;
+//# sourceMappingURL=bus-translate.d.ts.map

package/dist/observer/bus-translate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bus-translate.d.ts","sourceRoot":"","sources":["../../src/observer/bus-translate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,kEAAkE;AAClE,MAAM,WAAW,QAAQ;IACvB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;QAAE,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9D;AAoBD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,IAAI,CAyB/D"}

package/dist/observer/index.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Observer entry point.
+ *
+ * startObserver wires the four pieces — allowlist filter + queue +
+ * transport + PostHog subscription — into a single lifecycle controlled
+ * via the returned handle. The handle is reference-counted: multiple
+ * call sites (e.g. multiple chatbot widgets on the same page) share
+ * one observer.
+ *
+ * Idempotent: calling startObserver twice with equivalent options
+ * returns the same instance. Calling stop() decrements the ref count;
+ * the observer tears down only when the count reaches zero.
+ */
+import { type ObservationEvent, type RawEvent } from './allowlist';
+import { type ObserverStats } from './queue';
+import { type Transport } from './transport';
+export interface StartObserverOptions {
+    url: string;
+    token: () => string;
+    getDistinctId: () => string | null;
+    getSessionId: () => string | null;
+    observableEvents?: readonly string[];
+    /**
+     * Optional per-observation enrichment applied AFTER matchEvent, BEFORE the
+     * observation is queued for POST. Given the matched observation plus the raw
+     * event (element chain intact), returns a possibly-augmented observation —
+     * e.g. attaching normalized product identity from the active platform
+     * adapter. Kept as a generic transform so the observer stays platform-neutral.
+     */
+    enrich?: (ev: ObservationEvent, raw: RawEvent) => ObservationEvent;
+    /** Test seam: override fetch/timer behavior by injecting a custom transport. */
+    transport?: Transport;
+}
+export interface ObserverHandle {
+    stop(): void;
+    stats(): ObserverStats;
+    /** Test seam: ingest a raw event directly without depending on PostHog being loaded. */
+    ingest(raw: RawEvent): void;
+    flushNow(): Promise<void>;
+}
+export declare function startObserver(opts: StartObserverOptions): ObserverHandle;
+/** Test-only: reset module singleton state. */
+export declare function _resetObserverForTests(): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/observer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/observer/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAc,KAAK,gBAAgB,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,SAAS,CAAC;AAC5D,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAE9D,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IACnC,YAAY,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IAClC,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,gBAAgB,EAAE,GAAG,EAAE,QAAQ,KAAK,gBAAgB,CAAC;IACnE,gFAAgF;IAChF,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,IAAI,IAAI,CAAC;IACb,KAAK,IAAI,aAAa,CAAC;IACvB,wFAAwF;IACxF,MAAM,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC5B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AA2DD,wBAAgB,aAAa,CAAC,IAAI,EAAE,oBAAoB,GAAG,cAAc,CAqCxE;AAsCD,+CAA+C;AAC/C,wBAAgB,sBAAsB,IAAI,IAAI,CAK7C"}

package/dist/observer/queue.d.ts

@@ -0,0 +1,63 @@
+/**
+ * In-memory batching queue for ObservationEvents.
+ *
+ * Holds events until either a size threshold or a time interval triggers
+ * a flush. The flush function is injected so transport choice (fetch vs.
+ * sendBeacon) and auth wiring stay out of this module.
+ *
+ * Backoff strategy: pure exponential, starting at 1s and capping at 30s
+ * (1s → 2s → 4s → 8s → 16s → 30s). Reset on first successful flush.
+ * Jitter is intentionally omitted — the observer queue is per-client, so
+ * thundering-herd at recovery is not a meaningful risk, and deterministic
+ * timing keeps unit tests fast and stable. A "permanent" failure (4xx
+ * marked by the caller) disables the queue entirely — no further flushes
+ * are attempted; lastError is exposed via stats().
+ */
+import type { ObservationEvent } from './allowlist';
+export interface FlushError extends Error {
+    /** When true, the queue stops trying forever. Set by transport for 4xx. */
+    permanent?: boolean;
+}
+export interface ObserverQueueOptions {
+    batchSize: number;
+    flushIntervalMs: number;
+    queueCap: number;
+    flush: (batch: ObservationEvent[]) => Promise<void>;
+    backoffStartMs?: number;
+    backoffCapMs?: number;
+}
+export interface ObserverStats {
+    queued: number;
+    sent: number;
+    dropped: number;
+    lastError: string | null;
+    disabled: boolean;
+}
+export declare class ObserverQueue {
+    private readonly _opts;
+    private readonly _buffer;
+    private _sent;
+    private _dropped;
+    private _lastError;
+    private _disabled;
+    private _intervalTimer;
+    private _backoffTimer;
+    private _currentBackoffMs;
+    private _inFlight;
+    constructor(opts: ObserverQueueOptions);
+    push(event: ObservationEvent): void;
+    flushNow(): Promise<void>;
+    /**
+     * Synchronously hand the newest backend-sized batch to an unload-safe sender.
+     * Returns false when the sender rejected delivery and restores the batch so
+     * the caller can fall back to fetch({ keepalive: true }).
+     */
+    flushOnPageHide(send: (batch: ObservationEvent[]) => boolean): boolean;
+    stats(): ObserverStats;
+    private _scheduleImmediate;
+    private _scheduleInterval;
+    private _clearInterval;
+    private _flush;
+    private _scheduleBackoff;
+}
+//# sourceMappingURL=queue.d.ts.map

package/dist/observer/queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../src/observer/queue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,MAAM,WAAW,UAAW,SAAQ,KAAK;IACvC,2EAA2E;IAC3E,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,CAAC,KAAK,EAAE,gBAAgB,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiC;IACvD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;IAClD,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,aAAa,CAA8C;IACnE,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,SAAS,CAAS;gBAEd,IAAI,EAAE,oBAAoB;IAQtC,IAAI,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI;IAe7B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAK/B;;;;OAIG;IACH,eAAe,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,gBAAgB,EAAE,KAAK,OAAO,GAAG,OAAO;IAkBtE,KAAK,IAAI,aAAa;IAUtB,OAAO,CAAC,kBAAkB;IAM1B,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,cAAc;YAOR,MAAM;IA0BpB,OAAO,CAAC,gBAAgB;CAazB"}

package/dist/observer/transport.d.ts

@@ -0,0 +1,27 @@
+/**
+ * HTTP transport for the observer queue.
+ *
+ * Two send paths:
+ *   - send(batch) — async fetch. Used for normal flushes. Throws on
+ *     non-2xx; sets the FlushError.permanent flag for 4xx so the queue
+ *     stops trying.
+ *   - sendBeacon(batch) — fire-and-forget via navigator.sendBeacon.
+ *     Used on `pagehide` so the last batch survives navigation. No
+ *     error path — beacon failure is invisible by design.
+ *
+ * Auth: same syn_ Bearer token mechanism as /stream. The token is read
+ * via a getter so SDK tokens that rotate live get refreshed naturally.
+ */
+import type { ObservationEvent } from './allowlist';
+export interface TransportOptions {
+    url: string;
+    token: () => string;
+    getDistinctId: () => string | null;
+    getSessionId: () => string | null;
+}
+export interface Transport {
+    send(batch: ObservationEvent[]): Promise<void>;
+    sendBeacon(batch: ObservationEvent[]): boolean;
+}
+export declare function createTransport(opts: TransportOptions): Transport;
+//# sourceMappingURL=transport.d.ts.map

package/dist/observer/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/observer/transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IACnC,YAAY,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,KAAK,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,UAAU,CAAC,KAAK,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC;CAChD;AAsBD,wBAAgB,eAAe,CAAC,IAAI,EAAE,gBAAgB,GAAG,SAAS,CA4CjE"}

package/dist/runtime-lit.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Adaptive Chatbot - Runtime Module (Lit)
+ *
+ * Now identical to the default runtime since there is no React path.
+ * Kept for backward compatibility with existing import paths.
+ */
+export { runtime, runtime as default } from './runtime';
+//# sourceMappingURL=runtime-lit.d.ts.map

package/dist/runtime-lit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-lit.d.ts","sourceRoot":"","sources":["../src/runtime-lit.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,WAAW,CAAC"}

package/dist/runtime.d.ts

@@ -2,16 +2,23 @@
  * Adaptive Chatbot - Runtime Module
  *
  * Runtime manifest for the AI chat assistant adaptive.
- * This is a widget-based adaptive with no action executors.
+ * Uses @syntrologie/chat for the UI — no React dependency.
+ *
+ * Chat surfaces are config-driven: customers reference the chat-bar
+ * widget id (`adaptive-chatbot:chat-bar`) from `slots.drawer.lid` (to
+ * replace the launcher FAB) or any other slot's `lid` / tile slot. The
+ * adaptive no longer auto-registers a canvas lid renderer.
  */
+import './AdaptiveChatBar';
+import './AdaptiveChatTrail';
+export { ElementInstanceStore, TileHandler } from './elements';
+export { getElementInstanceStore, setElementInstanceStore } from './elements/store-singleton';
 export declare const runtime: {
     id: string;
     version: string;
     name: string;
     description: string;
-    /** No action executors — chatbot uses existing action kinds via applyBatch */
     executors: never[];
-    /** Widget definitions for the runtime's WidgetRegistry */
     widgets: {
         id: string;
         component: {

package/dist/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,eAAO,MAAM,OAAO;;;;;IAMlB,8EAA8E;;IAG9E,0DAA0D;;;;;;;;;;;;CAY3D,CAAC;AAEF,eAAe,OAAO,CAAC"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,mBAAmB,CAAC;AAC3B,OAAO,qBAAqB,CAAC;AAW7B,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAE9F,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;CA4EnB,CAAC;AAEF,eAAe,OAAO,CAAC"}