@hanzo/event 0.3.21 → 0.3.23

package/dist/index.d.cts

@@ -1,12 +1,14 @@
 import { C as Cohort, A as Attribution, S as SentryEvent, D as Dsn, a as CaptureErrorOptions, b as SentryFrame, E as ExceptionEntry, c as SentryLevel, d as ExceptionProperties } from './core-CHLpJy51.cjs';
 export { e as Analytics, f as AnalyticsConfig, g as EventKind, h as Exception, i as ExceptionFrame, T as Transport, W as WireEvent, j as createAnalytics } from './core-CHLpJy51.cjs';
+import { FunnelId } from '@hanzo/events';
+export { EVENTS, EXCEPTION, EventName, FUNNELS, FunnelDef, FunnelId, FunnelStep, PAGEVIEW, PRODUCTS, ProductId, eventsOf } from '@hanzo/events';
 
 /** Read the persisted first-touch attribution. */
 declare function getFirstTouch(): Attribution | undefined;
 /** Read persisted cohort dimensions. */
 declare function getCohort(): Cohort | undefined;
 
-declare const VERSION = "0.3.21";
+declare const VERSION = "0.3.23";
 
 /**
  * parseDsn parses "https://<version>:<hmac>@<host>/v1/sentry/<projectId>" into its
@@ -128,56 +130,6 @@ declare function scrubPII(s: string): string;
  *  first: unbounded text is a denial-of-service surface, not just a size problem. */
 declare function scrubText(s: string | undefined, capturePII?: boolean): string;
 
-declare const EVENTS: {
-    readonly SIGNUP_VIEWED: "signup_viewed";
-    readonly SIGNUP_SUBMITTED: "signup_submitted";
-    readonly SIGNUP_VERIFIED: "signup_verified";
-    readonly 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. */
-    readonly 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. */
-    readonly FIRST_ACTION: "first_action";
-    readonly WAITLIST_JOINED: "waitlist_joined";
-    readonly WAITLIST_SHARED: "waitlist_shared";
-    readonly REFERRAL_USED: "referral_used";
-    readonly REFERRAL_CLAIMED: "referral_claimed";
-    readonly PRICING_VIEWED: "pricing_viewed";
-    readonly PLAN_CLICKED: "plan_clicked";
-    readonly CHECKOUT_STARTED: "checkout_started";
-    readonly ORDER_COMPLETED: "order_completed";
-    readonly FEATURE_USED: "feature_used";
-    readonly API_KEY_CREATED: "api_key_created";
-    readonly APP_CREATED: "app_created";
-    readonly PROJECT_CREATED: "project_created";
-    readonly AGENT_CREATED: "agent_created";
-    readonly CHAT_STARTED: "chat_started";
-    readonly 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). */
-    readonly MODEL_SWITCHED: "model_switched";
-    readonly TASK_STARTED: "task_started";
-    readonly TASK_COMPLETED: "task_completed";
-    readonly 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. */
-    readonly GENERATION_COMPLETED: "generation_completed";
-    readonly GENERATION_FAILED: "generation_failed";
-    readonly DEPLOY_STARTED: "deploy_started";
-    readonly DEPLOY_SUCCEEDED: "deploy_succeeded";
-    readonly DEPLOY_FAILED: "deploy_failed";
-};
-type EventName = (typeof EVENTS)[keyof typeof EVENTS];
-/** The reserved event name a pageview is stored under (server + read lens). */
-declare const PAGEVIEW = "$pageview";
-/** The reserved name every captured exception is emitted under. Error Tracking
- *  reads exactly this name; an exception emitted under its own message instead
- *  makes every distinct message a permanent entry in the event taxonomy. */
-declare const EXCEPTION = "$exception";
-
 /**
  * digest is a stable 32-hex-char (128-bit) content hash, computed synchronously.
  *
@@ -227,96 +179,6 @@ declare function exceptionProperties(err: unknown, opts: {
     level?: SentryLevel;
 }): ExceptionProperties;
 
-/** The emitting surfaces — the closed set of `AnalyticsConfig.product` values.
- *  `product` is on every event, so a funnel scopes by product instead of every
- *  surface prefixing its event names. */
-declare const PRODUCTS: readonly ["site", "app", "chat", "console", "admin", "cloud"];
-type ProductId = (typeof PRODUCTS)[number];
-interface FunnelStep {
-    /** An EVENTS value (or PAGEVIEW). */
-    event: string;
-    /** Human label for the Insights step. */
-    label: string;
-    /** Property equality that qualifies the step, e.g. first_action{action:'api_call'}. */
-    where?: {
-        property: string;
-        equals: string;
-    };
-}
-interface FunnelDef {
-    label: string;
-    /** Surface(s) the steps are emitted from — matched against the `product` field. */
-    products: ProductId[];
-    /**
-     * How steps are joined:
-     *  • 'person'    — steps join on distinctId (one browser, or one logged-in
-     *                  person across surfaces). The normal case.
-     *  • 'aggregate' — steps are emitted on DIFFERENT origins by a LOGGED-OUT
-     *                  visitor, so there is no shared id: hanzo.ai, hanzo.app and
-     *                  hanzo.chat each mint their own anonymousId in their own
-     *                  storage. Read these as step-over-step COUNTS, never as a
-     *                  per-person conversion. Honest by construction.
-     */
-    join: 'person' | 'aggregate';
-    steps: FunnelStep[];
-}
-declare const FUNNELS: {
-    /** hanzo.ai: land → sign up. IAM hosts the form, so `signup_submitted` is the
-     *  redirect INTO IAM and `signup_completed` is the return at /auth/callback. */
-    readonly signup: {
-        readonly label: "Signup";
-        readonly products: ["site"];
-        readonly join: "person";
-        readonly steps: [FunnelStep, FunnelStep, FunnelStep, FunnelStep, FunnelStep];
-    };
-    /** The developer activation path: an account is worth nothing until a key has
-     *  made a call. `first_action{action:'api_call'}` is emitted SERVER-SIDE by
-     *  Cloud on an org's first successful /v1 request — a browser cannot see it. */
-    readonly apiActivation: {
-        readonly label: "API activation";
-        readonly products: ["site", "cloud"];
-        readonly join: "person";
-        readonly steps: [FunnelStep, FunnelStep, FunnelStep];
-    };
-    /** Upgrade intent → revenue. `order_completed{kind:'plan'}` is the Sale goal. */
-    readonly upgrade: {
-        readonly label: "Upgrade";
-        readonly products: ["site", "app", "console"];
-        readonly join: "person";
-        readonly steps: [FunnelStep, FunnelStep, FunnelStep, FunnelStep];
-    };
-    /** hanzo.app: describe → build → deploy → live URL. The whole product thesis
-     *  in five steps; `deploy_succeeded` is the moment a live URL exists. */
-    readonly appShip: {
-        readonly label: "Describe → ship";
-        readonly products: ["app"];
-        readonly join: "person";
-        readonly steps: [FunnelStep, FunnelStep, FunnelStep, FunnelStep, FunnelStep];
-    };
-    /** hanzo.chat: visit → first message → answer. `generation_completed` is what
-     *  separates "typed something" from "got value". */
-    readonly chatEngage: {
-        readonly label: "Chat engagement";
-        readonly products: ["chat"];
-        readonly join: "person";
-        readonly steps: [FunnelStep, FunnelStep, FunnelStep, FunnelStep];
-    };
-    /** The cross-surface handoff: the hanzo.ai composer forwards its prompt to
-     *  hanzo.chat. Two origins, two anonymousIds — so this is an AGGREGATE funnel.
-     *  The join is the `referrerProduct` property hanzo.chat reads off `?hz_ref=`,
-     *  which makes the drop-off measurable without any cross-domain identity. */
-    readonly siteToChat: {
-        readonly label: "Site → Chat handoff";
-        readonly products: ["site", "chat"];
-        readonly join: "aggregate";
-        readonly steps: [FunnelStep, FunnelStep, FunnelStep];
-    };
-};
-type FunnelId = keyof typeof FUNNELS;
-/** eventsOf flattens a funnel to its ordered event names — what a goal's `funnel`
- *  field carries, so the steps are defined exactly once (here). */
-declare function eventsOf(id: FunnelId): string[];
-
 interface GoalDef {
     /** Human label shown in Insights. */
     label: string;
@@ -353,4 +215,4 @@ declare function hasAttribution(a: Attribution): boolean;
 /** isoWeek returns the ISO-8601 week label, e.g. "2026-W28". */
 declare function isoWeek(d: Date): string;
 
-export { Attribution, COHORTS, CaptureErrorOptions, Cohort, type CohortDef, Dsn, EVENTS, EXCEPTION, type ErrorIdentity, type EventName, ExceptionEntry, ExceptionProperties, FUNNELS, type FunnelDef, type FunnelId, type FunnelStep, GOALS, type GoalDef, PAGEVIEW, PRODUCTS, PRODUCT_PROJECT, type ProductId, SentryEvent, SentryFrame, SentryLevel, VERSION, buildEnvelope, buildSentryEvent, deriveChannel, digest, dsnForProduct, eventsOf, exceptionEntry, exceptionProperties, fingerprint, framesFromStack, getCohort, getFirstTouch, hasAttribution, hostOf, isoWeek, parseAttribution, parseDsn, redactSecrets, scrubPII, scrubText, hzUuidv7 as uuidv7, uuidv7Time };
+export { Attribution, COHORTS, CaptureErrorOptions, Cohort, type CohortDef, Dsn, type ErrorIdentity, ExceptionEntry, ExceptionProperties, GOALS, type GoalDef, PRODUCT_PROJECT, SentryEvent, SentryFrame, SentryLevel, VERSION, buildEnvelope, buildSentryEvent, deriveChannel, digest, dsnForProduct, exceptionEntry, exceptionProperties, fingerprint, framesFromStack, getCohort, getFirstTouch, hasAttribution, hostOf, isoWeek, parseAttribution, parseDsn, redactSecrets, scrubPII, scrubText, hzUuidv7 as uuidv7, uuidv7Time };

package/dist/index.d.ts

@@ -1,12 +1,14 @@
 import { C as Cohort, A as Attribution, S as SentryEvent, D as Dsn, a as CaptureErrorOptions, b as SentryFrame, E as ExceptionEntry, c as SentryLevel, d as ExceptionProperties } from './core-CHLpJy51.js';
 export { e as Analytics, f as AnalyticsConfig, g as EventKind, h as Exception, i as ExceptionFrame, T as Transport, W as WireEvent, j as createAnalytics } from './core-CHLpJy51.js';
+import { FunnelId } from '@hanzo/events';
+export { EVENTS, EXCEPTION, EventName, FUNNELS, FunnelDef, FunnelId, FunnelStep, PAGEVIEW, PRODUCTS, ProductId, eventsOf } from '@hanzo/events';
 
 /** Read the persisted first-touch attribution. */
 declare function getFirstTouch(): Attribution | undefined;
 /** Read persisted cohort dimensions. */
 declare function getCohort(): Cohort | undefined;
 
-declare const VERSION = "0.3.21";
+declare const VERSION = "0.3.23";
 
 /**
  * parseDsn parses "https://<version>:<hmac>@<host>/v1/sentry/<projectId>" into its
@@ -128,56 +130,6 @@ declare function scrubPII(s: string): string;
  *  first: unbounded text is a denial-of-service surface, not just a size problem. */
 declare function scrubText(s: string | undefined, capturePII?: boolean): string;
 
-declare const EVENTS: {
-    readonly SIGNUP_VIEWED: "signup_viewed";
-    readonly SIGNUP_SUBMITTED: "signup_submitted";
-    readonly SIGNUP_VERIFIED: "signup_verified";
-    readonly 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. */
-    readonly 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. */
-    readonly FIRST_ACTION: "first_action";
-    readonly WAITLIST_JOINED: "waitlist_joined";
-    readonly WAITLIST_SHARED: "waitlist_shared";
-    readonly REFERRAL_USED: "referral_used";
-    readonly REFERRAL_CLAIMED: "referral_claimed";
-    readonly PRICING_VIEWED: "pricing_viewed";
-    readonly PLAN_CLICKED: "plan_clicked";
-    readonly CHECKOUT_STARTED: "checkout_started";
-    readonly ORDER_COMPLETED: "order_completed";
-    readonly FEATURE_USED: "feature_used";
-    readonly API_KEY_CREATED: "api_key_created";
-    readonly APP_CREATED: "app_created";
-    readonly PROJECT_CREATED: "project_created";
-    readonly AGENT_CREATED: "agent_created";
-    readonly CHAT_STARTED: "chat_started";
-    readonly 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). */
-    readonly MODEL_SWITCHED: "model_switched";
-    readonly TASK_STARTED: "task_started";
-    readonly TASK_COMPLETED: "task_completed";
-    readonly 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. */
-    readonly GENERATION_COMPLETED: "generation_completed";
-    readonly GENERATION_FAILED: "generation_failed";
-    readonly DEPLOY_STARTED: "deploy_started";
-    readonly DEPLOY_SUCCEEDED: "deploy_succeeded";
-    readonly DEPLOY_FAILED: "deploy_failed";
-};
-type EventName = (typeof EVENTS)[keyof typeof EVENTS];
-/** The reserved event name a pageview is stored under (server + read lens). */
-declare const PAGEVIEW = "$pageview";
-/** The reserved name every captured exception is emitted under. Error Tracking
- *  reads exactly this name; an exception emitted under its own message instead
- *  makes every distinct message a permanent entry in the event taxonomy. */
-declare const EXCEPTION = "$exception";
-
 /**
  * digest is a stable 32-hex-char (128-bit) content hash, computed synchronously.
  *
@@ -227,96 +179,6 @@ declare function exceptionProperties(err: unknown, opts: {
     level?: SentryLevel;
 }): ExceptionProperties;
 
-/** The emitting surfaces — the closed set of `AnalyticsConfig.product` values.
- *  `product` is on every event, so a funnel scopes by product instead of every
- *  surface prefixing its event names. */
-declare const PRODUCTS: readonly ["site", "app", "chat", "console", "admin", "cloud"];
-type ProductId = (typeof PRODUCTS)[number];
-interface FunnelStep {
-    /** An EVENTS value (or PAGEVIEW). */
-    event: string;
-    /** Human label for the Insights step. */
-    label: string;
-    /** Property equality that qualifies the step, e.g. first_action{action:'api_call'}. */
-    where?: {
-        property: string;
-        equals: string;
-    };
-}
-interface FunnelDef {
-    label: string;
-    /** Surface(s) the steps are emitted from — matched against the `product` field. */
-    products: ProductId[];
-    /**
-     * How steps are joined:
-     *  • 'person'    — steps join on distinctId (one browser, or one logged-in
-     *                  person across surfaces). The normal case.
-     *  • 'aggregate' — steps are emitted on DIFFERENT origins by a LOGGED-OUT
-     *                  visitor, so there is no shared id: hanzo.ai, hanzo.app and
-     *                  hanzo.chat each mint their own anonymousId in their own
-     *                  storage. Read these as step-over-step COUNTS, never as a
-     *                  per-person conversion. Honest by construction.
-     */
-    join: 'person' | 'aggregate';
-    steps: FunnelStep[];
-}
-declare const FUNNELS: {
-    /** hanzo.ai: land → sign up. IAM hosts the form, so `signup_submitted` is the
-     *  redirect INTO IAM and `signup_completed` is the return at /auth/callback. */
-    readonly signup: {
-        readonly label: "Signup";
-        readonly products: ["site"];
-        readonly join: "person";
-        readonly steps: [FunnelStep, FunnelStep, FunnelStep, FunnelStep, FunnelStep];
-    };
-    /** The developer activation path: an account is worth nothing until a key has
-     *  made a call. `first_action{action:'api_call'}` is emitted SERVER-SIDE by
-     *  Cloud on an org's first successful /v1 request — a browser cannot see it. */
-    readonly apiActivation: {
-        readonly label: "API activation";
-        readonly products: ["site", "cloud"];
-        readonly join: "person";
-        readonly steps: [FunnelStep, FunnelStep, FunnelStep];
-    };
-    /** Upgrade intent → revenue. `order_completed{kind:'plan'}` is the Sale goal. */
-    readonly upgrade: {
-        readonly label: "Upgrade";
-        readonly products: ["site", "app", "console"];
-        readonly join: "person";
-        readonly steps: [FunnelStep, FunnelStep, FunnelStep, FunnelStep];
-    };
-    /** hanzo.app: describe → build → deploy → live URL. The whole product thesis
-     *  in five steps; `deploy_succeeded` is the moment a live URL exists. */
-    readonly appShip: {
-        readonly label: "Describe → ship";
-        readonly products: ["app"];
-        readonly join: "person";
-        readonly steps: [FunnelStep, FunnelStep, FunnelStep, FunnelStep, FunnelStep];
-    };
-    /** hanzo.chat: visit → first message → answer. `generation_completed` is what
-     *  separates "typed something" from "got value". */
-    readonly chatEngage: {
-        readonly label: "Chat engagement";
-        readonly products: ["chat"];
-        readonly join: "person";
-        readonly steps: [FunnelStep, FunnelStep, FunnelStep, FunnelStep];
-    };
-    /** The cross-surface handoff: the hanzo.ai composer forwards its prompt to
-     *  hanzo.chat. Two origins, two anonymousIds — so this is an AGGREGATE funnel.
-     *  The join is the `referrerProduct` property hanzo.chat reads off `?hz_ref=`,
-     *  which makes the drop-off measurable without any cross-domain identity. */
-    readonly siteToChat: {
-        readonly label: "Site → Chat handoff";
-        readonly products: ["site", "chat"];
-        readonly join: "aggregate";
-        readonly steps: [FunnelStep, FunnelStep, FunnelStep];
-    };
-};
-type FunnelId = keyof typeof FUNNELS;
-/** eventsOf flattens a funnel to its ordered event names — what a goal's `funnel`
- *  field carries, so the steps are defined exactly once (here). */
-declare function eventsOf(id: FunnelId): string[];
-
 interface GoalDef {
     /** Human label shown in Insights. */
     label: string;
@@ -353,4 +215,4 @@ declare function hasAttribution(a: Attribution): boolean;
 /** isoWeek returns the ISO-8601 week label, e.g. "2026-W28". */
 declare function isoWeek(d: Date): string;
 
-export { Attribution, COHORTS, CaptureErrorOptions, Cohort, type CohortDef, Dsn, EVENTS, EXCEPTION, type ErrorIdentity, type EventName, ExceptionEntry, ExceptionProperties, FUNNELS, type FunnelDef, type FunnelId, type FunnelStep, GOALS, type GoalDef, PAGEVIEW, PRODUCTS, PRODUCT_PROJECT, type ProductId, SentryEvent, SentryFrame, SentryLevel, VERSION, buildEnvelope, buildSentryEvent, deriveChannel, digest, dsnForProduct, eventsOf, exceptionEntry, exceptionProperties, fingerprint, framesFromStack, getCohort, getFirstTouch, hasAttribution, hostOf, isoWeek, parseAttribution, parseDsn, redactSecrets, scrubPII, scrubText, hzUuidv7 as uuidv7, uuidv7Time };
+export { Attribution, COHORTS, CaptureErrorOptions, Cohort, type CohortDef, Dsn, type ErrorIdentity, ExceptionEntry, ExceptionProperties, GOALS, type GoalDef, PRODUCT_PROJECT, SentryEvent, SentryFrame, SentryLevel, VERSION, buildEnvelope, buildSentryEvent, deriveChannel, digest, dsnForProduct, exceptionEntry, exceptionProperties, fingerprint, framesFromStack, getCohort, getFirstTouch, hasAttribution, hostOf, isoWeek, parseAttribution, parseDsn, redactSecrets, scrubPII, scrubText, hzUuidv7 as uuidv7, uuidv7Time };