@waniwani/sdk 0.14.0 → 0.14.1

package/dist/mcp/index.d.ts

@@ -62,7 +62,28 @@ interface KbClient {
     sources(): Promise<KbSource[]>;
 }
 
-type EventType = "session.started" | "tool.called" | "quote.requested" | "quote.succeeded" | "quote.failed" | "link.clicked" | "purchase.completed" | "widget_render" | "widget_click" | "widget_link_click" | "widget_error" | "widget_scroll" | "widget_form_field" | "widget_form_submit" | "user.identified" | "price_shown" | "prices_compared" | "option_selected" | "lead" | "converted";
+type EventType = "session.started" | "page.viewed" | "tool.called" | "quote.requested" | "quote.succeeded" | "quote.failed" | "link.clicked" | "purchase.completed" | "widget_render" | "widget_click" | "widget_link_click" | "widget_error" | "widget_scroll" | "widget_form_field" | "widget_form_submit" | "user.identified" | "price_shown" | "prices_compared" | "option_selected" | "lead" | "converted";
+/**
+ * Properties for `page.viewed` — emitted once when the chat widget initializes
+ * on a host page (the top of the funnel). Attributed to the anonymous
+ * `visitorId` (mapped to `externalUserId`), never to a session: a page view
+ * must not create a session, otherwise sessions would equal page views and the
+ * "landed → started a conversation" funnel collapses.
+ */
+interface PageViewedProperties {
+    /** Full URL of the host page the widget loaded on. */
+    url?: string;
+    /** Referrer of the host page, if any. */
+    referrer?: string;
+    /** Embed mode the widget initialized in. */
+    mode?: "inline" | "floating";
+    /** Resolved device type from the visitor context. */
+    deviceType?: "mobile" | "tablet" | "desktop";
+    /** Primary browser language (BCP-47). */
+    language?: string;
+    /** IANA timezone of the visitor. */
+    timezone?: string;
+}
 interface ToolCalledProperties {
     name?: string;
     type?: "pricing" | "product_info" | "availability" | "support" | "other";
@@ -137,6 +158,9 @@ interface BaseTrackEvent extends TrackingContext {
 }
 type TrackEvent = ({
     event: "session.started";
+} & BaseTrackEvent) | ({
+    event: "page.viewed";
+    properties?: PageViewedProperties;
 } & BaseTrackEvent) | ({
     event: "tool.called";
     properties?: ToolCalledProperties;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@waniwani/sdk",
-  "version": "0.14.0",
+  "version": "0.14.1",
   "description": "MCP distribution SDK. Build sales funnels, lead generation, booking, and quote apps on top of your MCP server. Event tracking, flows, widgets, knowledge base.",
   "type": "module",
   "exports": {