@hanzo/event 0.3.21 → 0.3.22

package/dist/index.cjs

@@ -1,5 +1,7 @@
 'use strict';
 
+var events = require('@hanzo/events');
+
 // src/attribution.ts
 var SOCIAL_HOSTS = [
   "facebook.",
@@ -89,59 +91,6 @@ function dsnForProduct(product, key) {
   return `https://${key}@api.hanzo.ai/v1/sentry/${projectId}`;
 }
 
-// src/events.ts
-var EVENTS = {
-  // Signup funnel: view -> submit -> verify -> completed -> first action.
-  SIGNUP_VIEWED: "signup_viewed",
-  SIGNUP_SUBMITTED: "signup_submitted",
-  SIGNUP_VERIFIED: "signup_verified",
-  SIGNUP_COMPLETED: "signup_completed",
-  /** A RETURNING user authenticated — the non-signup half of the IAM callback.
-   *  Keeping it distinct is what stops returning logins from inflating signups. */
-  LOGIN_COMPLETED: "login_completed",
-  /** Activation: the first moment of real value. ONE event for every product —
-   *  the product-specific moment is the `action` property (api_call, app_live,
-   *  chat_reply), never a new event name. */
-  FIRST_ACTION: "first_action",
-  // Waitlist + referral.
-  WAITLIST_JOINED: "waitlist_joined",
-  WAITLIST_SHARED: "waitlist_shared",
-  REFERRAL_USED: "referral_used",
-  REFERRAL_CLAIMED: "referral_claimed",
-  // Upgrade-intent + purchase.
-  PRICING_VIEWED: "pricing_viewed",
-  PLAN_CLICKED: "plan_clicked",
-  CHECKOUT_STARTED: "checkout_started",
-  ORDER_COMPLETED: "order_completed",
-  // Feature usage — generic + the common key surfaces across products.
-  FEATURE_USED: "feature_used",
-  API_KEY_CREATED: "api_key_created",
-  APP_CREATED: "app_created",
-  PROJECT_CREATED: "project_created",
-  AGENT_CREATED: "agent_created",
-  CHAT_STARTED: "chat_started",
-  CHAT_MESSAGE_SENT: "chat_message_sent",
-  /** The user switched model/endpoint — the single strongest quality signal a
-   *  chat surface emits (a switch usually follows a bad answer). */
-  MODEL_SWITCHED: "model_switched",
-  TASK_STARTED: "task_started",
-  TASK_COMPLETED: "task_completed",
-  // Build → ship. `build_*` is a MODEL producing an artifact; `deploy_*` is that
-  // artifact going live. Intent (build_started) is never the same event as the
-  // artifact existing (app_created) — conflating them makes the funnel lie.
-  BUILD_STARTED: "build_started",
-  /** A model finished producing an artifact (an app build, a chat reply, an agent
-   *  run). Carries `durationMs` — the outcome event owns its own duration, so no
-   *  paired start event is needed. */
-  GENERATION_COMPLETED: "generation_completed",
-  GENERATION_FAILED: "generation_failed",
-  DEPLOY_STARTED: "deploy_started",
-  DEPLOY_SUCCEEDED: "deploy_succeeded",
-  DEPLOY_FAILED: "deploy_failed"
-};
-var PAGEVIEW = "$pageview";
-var EXCEPTION = "$exception";
-
 // src/scrub.ts
 var REDACTED = "[redacted]";
 var EMAIL_MARK = "[email]";
@@ -893,7 +842,7 @@ var Analytics = class {
   /** pageview records a $pageview for the current (or given) location. */
   pageview(path, properties) {
     const p = path ?? (isBrowser() ? window.location.pathname : void 0);
-    this.enqueue("pageview", PAGEVIEW, { path: p, properties });
+    this.enqueue("pageview", events.PAGEVIEW, { path: p, properties });
   }
   /** capture records a named product event with optional properties. Commerce
    *  fields (productId/quantity/revenue/currency) may be passed for order events. */
@@ -926,7 +875,7 @@ var Analytics = class {
         const handled = context?.handled ?? true;
         const ex = normalizeError2(err);
         ex.handled = handled;
-        this.enqueue("event", EXCEPTION, {
+        this.enqueue("event", events.EXCEPTION, {
           error: ex,
           properties: {
             ...context?.properties,
@@ -1096,11 +1045,11 @@ var FUNNELS = {
     products: ["site"],
     join: "person",
     steps: [
-      s(PAGEVIEW, "Landed"),
-      s(EVENTS.SIGNUP_VIEWED, "Opened signup"),
-      s(EVENTS.SIGNUP_SUBMITTED, "Redirected to Hanzo ID"),
-      s(EVENTS.SIGNUP_COMPLETED, "Account created"),
-      s(EVENTS.FIRST_ACTION, "First action")
+      s(events.PAGEVIEW, "Landed"),
+      s(events.EVENTS.SIGNUP_VIEWED, "Opened signup"),
+      s(events.EVENTS.SIGNUP_SUBMITTED, "Redirected to Hanzo ID"),
+      s(events.EVENTS.SIGNUP_COMPLETED, "Account created"),
+      s(events.EVENTS.FIRST_ACTION, "First action")
     ]
   },
   /** The developer activation path: an account is worth nothing until a key has
@@ -1111,9 +1060,9 @@ var FUNNELS = {
     products: ["site", "cloud"],
     join: "person",
     steps: [
-      s(EVENTS.SIGNUP_COMPLETED, "Account created"),
-      s(EVENTS.API_KEY_CREATED, "Key minted"),
-      s(EVENTS.FIRST_ACTION, "First successful API call", {
+      s(events.EVENTS.SIGNUP_COMPLETED, "Account created"),
+      s(events.EVENTS.API_KEY_CREATED, "Key minted"),
+      s(events.EVENTS.FIRST_ACTION, "First successful API call", {
         property: "action",
         equals: "api_call"
       })
@@ -1125,10 +1074,10 @@ var FUNNELS = {
     products: ["site", "app", "console"],
     join: "person",
     steps: [
-      s(EVENTS.PRICING_VIEWED, "Viewed pricing"),
-      s(EVENTS.PLAN_CLICKED, "Chose a plan"),
-      s(EVENTS.CHECKOUT_STARTED, "Started checkout"),
-      s(EVENTS.ORDER_COMPLETED, "Paid")
+      s(events.EVENTS.PRICING_VIEWED, "Viewed pricing"),
+      s(events.EVENTS.PLAN_CLICKED, "Chose a plan"),
+      s(events.EVENTS.CHECKOUT_STARTED, "Started checkout"),
+      s(events.EVENTS.ORDER_COMPLETED, "Paid")
     ]
   },
   /** hanzo.app: describe → build → deploy → live URL. The whole product thesis
@@ -1138,11 +1087,11 @@ var FUNNELS = {
     products: ["app"],
     join: "person",
     steps: [
-      s(PAGEVIEW, "Landed"),
-      s(EVENTS.BUILD_STARTED, "Described an app"),
-      s(EVENTS.GENERATION_COMPLETED, "Got a working build"),
-      s(EVENTS.DEPLOY_STARTED, "Hit publish"),
-      s(EVENTS.DEPLOY_SUCCEEDED, "Live URL")
+      s(events.PAGEVIEW, "Landed"),
+      s(events.EVENTS.BUILD_STARTED, "Described an app"),
+      s(events.EVENTS.GENERATION_COMPLETED, "Got a working build"),
+      s(events.EVENTS.DEPLOY_STARTED, "Hit publish"),
+      s(events.EVENTS.DEPLOY_SUCCEEDED, "Live URL")
     ]
   },
   /** hanzo.chat: visit → first message → answer. `generation_completed` is what
@@ -1152,10 +1101,10 @@ var FUNNELS = {
     products: ["chat"],
     join: "person",
     steps: [
-      s(PAGEVIEW, "Landed"),
-      s(EVENTS.CHAT_STARTED, "Started a conversation"),
-      s(EVENTS.CHAT_MESSAGE_SENT, "Sent a message"),
-      s(EVENTS.GENERATION_COMPLETED, "Got an answer")
+      s(events.PAGEVIEW, "Landed"),
+      s(events.EVENTS.CHAT_STARTED, "Started a conversation"),
+      s(events.EVENTS.CHAT_MESSAGE_SENT, "Sent a message"),
+      s(events.EVENTS.GENERATION_COMPLETED, "Got an answer")
     ]
   },
   /** The cross-surface handoff: the hanzo.ai composer forwards its prompt to
@@ -1167,15 +1116,15 @@ var FUNNELS = {
     products: ["site", "chat"],
     join: "aggregate",
     steps: [
-      s(EVENTS.CHAT_STARTED, "Submitted the hanzo.ai composer", {
+      s(events.EVENTS.CHAT_STARTED, "Submitted the hanzo.ai composer", {
         property: "source",
         equals: "composer"
       }),
-      s(EVENTS.CHAT_STARTED, "Landed in hanzo.chat", {
+      s(events.EVENTS.CHAT_STARTED, "Landed in hanzo.chat", {
         property: "referrerProduct",
         equals: "site"
       }),
-      s(EVENTS.GENERATION_COMPLETED, "Got an answer")
+      s(events.EVENTS.GENERATION_COMPLETED, "Got an answer")
     ]
   }
 };
@@ -1188,14 +1137,14 @@ var GOALS = {
   // Signup: the conversion is signup_completed, along the site signup funnel.
   signup: {
     label: "Signup",
-    event: EVENTS.SIGNUP_COMPLETED,
+    event: events.EVENTS.SIGNUP_COMPLETED,
     funnelId: "signup",
     funnel: eventsOf("signup")
   },
   // Sale: a completed order qualified as a plan purchase (kind=plan).
   sale: {
     label: "Sale",
-    event: EVENTS.ORDER_COMPLETED,
+    event: events.EVENTS.ORDER_COMPLETED,
     funnelId: "upgrade",
     funnel: eventsOf("upgrade"),
     filter: { property: "kind", equals: "plan" }
@@ -1203,7 +1152,7 @@ var GOALS = {
   // Upgrade intent: a plan click; pricing_viewed is the top of its funnel.
   upgradeIntent: {
     label: "Upgrade Intent",
-    event: EVENTS.PLAN_CLICKED,
+    event: events.EVENTS.PLAN_CLICKED,
     funnelId: "upgrade",
     funnel: eventsOf("upgrade")
   },
@@ -1211,7 +1160,7 @@ var GOALS = {
   // valuable thing (a successful API call, a live app, a chat answer).
   activation: {
     label: "Activation",
-    event: EVENTS.FIRST_ACTION,
+    event: events.EVENTS.FIRST_ACTION,
     funnelId: "apiActivation",
     funnel: eventsOf("apiActivation")
   }
@@ -1243,13 +1192,22 @@ var COHORTS = {
  * reformat of one copy is a diff against the other.
  */
 
+Object.defineProperty(exports, "EVENTS", {
+  enumerable: true,
+  get: function () { return events.EVENTS; }
+});
+Object.defineProperty(exports, "EXCEPTION", {
+  enumerable: true,
+  get: function () { return events.EXCEPTION; }
+});
+Object.defineProperty(exports, "PAGEVIEW", {
+  enumerable: true,
+  get: function () { return events.PAGEVIEW; }
+});
 exports.Analytics = Analytics;
 exports.COHORTS = COHORTS;
-exports.EVENTS = EVENTS;
-exports.EXCEPTION = EXCEPTION;
 exports.FUNNELS = FUNNELS;
 exports.GOALS = GOALS;
-exports.PAGEVIEW = PAGEVIEW;
 exports.PRODUCTS = PRODUCTS;
 exports.PRODUCT_PROJECT = PRODUCT_PROJECT;
 exports.VERSION = VERSION;