@hanzo/event 0.3.21 → 0.3.22

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@hanzo/event",
-  "version": "0.3.21",
-  "description": "Hanzo Event — the ONE telemetry client. Emits pageview/event/identify/group to the Hanzo Cloud event stream (POST /v1/event), AND reports errors to Sentry as real Sentry envelopes — the error plane needs a DSN, without one nothing reaches Sentry. First-touch attribution, beacon-on-unload, auto error capture, client-side secret/PII scrubbing, a shared event + goal vocabulary. Subsumes @sentry.",
+  "version": "0.3.22",
+  "description": "Hanzo Event \u2014 the ONE telemetry client. Emits pageview/event/identify/group to the Hanzo Cloud event stream (POST /v1/event), AND reports errors to Sentry as real Sentry envelopes \u2014 the error plane needs a DSN, without one nothing reaches Sentry. First-touch attribution, beacon-on-unload, auto error capture, client-side secret/PII scrubbing, a shared event + goal vocabulary. Subsumes @sentry.",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public",
@@ -37,6 +37,13 @@
     "funnel",
     "hanzo"
   ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
   "exports": {
     ".": {
       "import": {
@@ -75,11 +82,7 @@
     "typescript": "^5.9.3",
     "vitest": "^4.1.0"
   },
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
-    "test": "vitest run",
-    "typecheck": "tsc --noEmit",
-    "clean": "rm -rf dist"
+  "dependencies": {
+    "@hanzo/events": "^0.2.0"
   }
-}
+}

package/src/events.ts

@@ -1,76 +1,21 @@
-// The ONE product-analytics vocabulary. Every Hanzo surface emits these exact
-// names so funnels, goals, and cohorts line up across console/chat/app/site/admin.
-// Pageviews use the reserved "$pageview" name (emitted by analytics.pageview()),
-// matching the server read lens.
-//
-// Naming is a closed convention, not a style preference (see TAXONOMY.md):
-//   • snake_case, `<object>_<verb-in-past-tense>` — signup_completed, plan_clicked.
-//   • Names are CONSTANTS, never interpolated. A dimension (framework, model,
-//     plan, source) is a PROPERTY, never part of the name. `deploy_succeeded`
-//     with {framework:'static'} — never `deploy_static_succeeded`.
-//   • One name per user-visible moment, shared by every surface. The surface is
-//     already on the wire as `product`, so a name is never product-prefixed.
-
-export const 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',
-} as const
-
-export type EventName = (typeof EVENTS)[keyof typeof EVENTS]
-
-/** The reserved event name a pageview is stored under (server + read lens). */
-export 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. */
-export const EXCEPTION = '$exception'
+/**
+ * The vocabulary, re-exported from where it is now defined.
+ *
+ * These names used to be declared here. They moved to @hanzo/events — the
+ * plural package is the catalog (many events, what each means, what each
+ * carries), this one is the client (one call sends one event). Splitting them
+ * that way is what lets the ingest door read the same catalog: the door is Go
+ * and cannot import TypeScript, so @hanzo/events also ships the data as JSON,
+ * and there is still exactly one definition.
+ *
+ * Nothing about the API moved. Every existing import keeps working, the names
+ * and their values are unchanged, and `pkgs/events/test/catalog.mjs` fails the
+ * build if a name and its meaning ever disagree.
+ *
+ * The naming convention lives with the names, in @hanzo/events and TAXONOMY.md:
+ * snake_case `<object>_<verb-past>`, a dimension is a PROPERTY and never part
+ * of the name, one name per user-visible moment shared by every surface.
+ */
+
+export { EVENTS, PAGEVIEW, EXCEPTION } from '@hanzo/events'
+export type { EventName } from '@hanzo/events'

package/LICENSE.md

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2023 hanzo
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.