@hanzo/event 0.3.20 → 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.",
@@ -82,70 +84,13 @@ var PRODUCT_PROJECT = Object.freeze({
   site: "019f9b1e-5785-7359-ad0b-f75db8e58c99"
   // hanzo.ai (marketing; product `site`)
 });
-function dsnForProduct(product) {
-  if (!product) return void 0;
+function dsnForProduct(product, key) {
+  if (!product || !key) return void 0;
   const projectId = PRODUCT_PROJECT[product];
   if (!projectId) return void 0;
-  return `https://${HANZO_PUBLISHABLE_KEY}@api.hanzo.ai/v1/sentry/${projectId}`;
-}
-var HANZO_PUBLISHABLE_KEY = "pk-live-c88649f1085fb6ad441d8a0072933a9b";
-function defaultPublishableKey(host) {
-  return host === void 0 || host === "https://api.hanzo.ai" ? HANZO_PUBLISHABLE_KEY : void 0;
+  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]";
@@ -374,7 +319,7 @@ function uuidv7Time(id) {
 }
 
 // src/version.ts
-var VERSION = "0.3.20";
+var VERSION = "0.3.21";
 
 // src/sentry.ts
 var MAX_FRAMES = 50;
@@ -825,27 +770,24 @@ var Analytics = class {
       enabled: true,
       captureErrors: true,
       ...config,
-      // The publishable key resolves the SAME way the DSN below does, and now
-      // ends the SAME way too — in a baked default, so declaring nothing is
-      // enough. Most specific first:
+      // The publishable key resolves from ONE live source, never a literal baked
+      // beside the code. Most specific first:
       //   1. an explicit `ingestKey` in config;
       //   2. NEXT_PUBLIC_PUBLISHABLE_KEY, the inlined build-time env the fleet
-      //      carries end to end (KMS `deploy/PUBLISHABLE_KEY` -> the PUBLISHABLE_KEY
-      //      build-arg -> the NEXT_PUBLIC_ prefix Next inlines);
-      //   3. the hanzo org key baked in `dsn.ts`, on the hanzo cloud only.
+      //      carries end to end — KMS `deploy/PUBLISHABLE_KEY` -> the PUBLISHABLE_KEY
+      //      build-arg -> the NEXT_PUBLIC_ prefix Next inlines.
       //
-      // (3) is why this is `publishable_key for all`: a hanzo surface that passes
-      // no key in code and inlines no env still emits attributed, exactly as
-      // declaring `product` is enough for the DSN. Without it that surface sent
-      // its beacons to `$public` — which drops every track/identify/group and
-      // still answers 200 — silent in the page and invisible until you read the
-      // warehouse and find the host missing entirely. A white-label surface on
-      // its own cloud (a non-default host) gets no default, so the org this
-      // attributes to is never the wrong one.
-      ingestKey: config.ingestKey ?? readEnv("NEXT_PUBLIC_PUBLISHABLE_KEY") ?? defaultPublishableKey(config.host ?? DEFAULT_HOST)
+      // A surface that provides neither has no key, and its anonymous traffic
+      // files under `$public` (which drops track/identify/group and answers 200);
+      // the fix is to give it the KMS-sourced env, not to hardcode the org key
+      // here. The key is a credential-class value: its home is KMS, and the ONE
+      // build reads it from there.
+      ingestKey: config.ingestKey ?? readEnv("NEXT_PUBLIC_PUBLISHABLE_KEY")
     };
     this.transport = config.transport ?? new DefaultTransport();
-    this.dsn = parseDsn(config.dsn ?? readEnvDsn() ?? dsnForProduct(this.cfg.product));
+    this.dsn = parseDsn(
+      config.dsn ?? readEnvDsn() ?? dsnForProduct(this.cfg.product, this.cfg.ingestKey)
+    );
   }
   /** errorPlaneEnabled reports whether captured exceptions can actually reach the
    *  error host. False means a DSN was never configured — the documented
@@ -900,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. */
@@ -933,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,
@@ -1103,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
@@ -1118,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"
       })
@@ -1132,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
@@ -1145,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
@@ -1159,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
@@ -1174,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")
     ]
   }
 };
@@ -1195,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" }
@@ -1210,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")
   },
@@ -1218,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")
   }
@@ -1250,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;