@hanzo/event 0.2.0

package/LICENSE.md

@@ -0,0 +1,21 @@
+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.

package/README.md

@@ -0,0 +1,67 @@
+# @hanzo/event
+
+Tiny, batched product-analytics capture client for Hanzo surfaces. Emits
+`pageview` / `event` / `identify` / `group` to **Hanzo Cloud** — never to a
+third-party or to `insights-capture` directly. Cloud (`/v1/analytics` +
+`/v1/tracker`) is the one front door and fans out to the insights/datastore
+warehouse.
+
+- **Batched** with a size + interval flush, and **beacon-on-unload**
+  (`sendBeacon` for cookie apps, `fetch(keepalive)` for token apps).
+- **First-touch attribution**: UTM + referrer + `refCode` are parsed once and
+  persisted, then attached to every event.
+- **Cohorts**: `signupWeek`, `channel`, `refCode` ride each event.
+- **Tenant-safe**: the client NEVER sends an org/tenant — Cloud stamps it from
+  the validated session.
+- **SSR-safe**: importing on the server is a no-op; it only acts in the browser.
+
+## Core (framework-agnostic)
+
+```ts
+import { createAnalytics, EVENTS } from '@hanzo/event'
+
+// Cookie/session apps (console, admin): same-origin, no token.
+const analytics = createAnalytics({ product: 'console' })
+
+// Token apps (app, site): give the cloud host + a bearer getter.
+const analytics = createAnalytics({
+  product: 'app',
+  host: 'https://api.hanzo.ai',
+  getToken: () => localStorage.getItem('hanzo_access_token') ?? undefined,
+})
+
+analytics.pageview()
+analytics.identify('user-42')
+analytics.capture(EVENTS.SIGNUP_COMPLETED, { plan: 'pro' })
+analytics.capture(EVENTS.ORDER_COMPLETED, { kind: 'plan' }, { productId: 'plan_pro', revenue: 49, quantity: 1, currency: 'usd' })
+```
+
+## React
+
+```tsx
+'use client'
+import { AnalyticsProvider, useAnalytics, usePageview } from '@hanzo/event/react'
+import { usePathname } from 'next/navigation'
+
+export function Providers({ children }) {
+  return <AnalyticsProvider config={{ product: 'console' }}>{children}</AnalyticsProvider>
+}
+
+function RouteTracker() {
+  usePageview(usePathname()) // one pageview per navigation
+  return null
+}
+
+function UpgradeButton() {
+  const a = useAnalytics()
+  return <button onClick={() => a.capture(EVENTS.PLAN_CLICKED, { plan: 'pro' })}>Upgrade</button>
+}
+```
+
+## Goals & cohorts
+
+`GOALS` and `COHORTS` (see `goals.ts`) are the shared, machine-readable insights
+spec: **Signup** (funnel view→submit→verify→first-action), **Sale** (a
+`order_completed` with `kind=plan`), and **Upgrade Intent** (`plan_clicked`,
+funnel from `pricing_viewed`). Cohort fields map to the `signup_week`,
+`channel`, and `ref_code` columns of `hanzo.events`.

package/dist/core-DDGwms7M.d.cts

@@ -0,0 +1,157 @@
+/** The event kinds — the closed set the server understands. An error is just
+ *  another event on the one stream (lensed to the error-tracking view). */
+type EventKind = 'pageview' | 'event' | 'identify' | 'group' | 'error';
+/** A captured exception. Carried on a `type:'error'` event; the server lenses it
+ *  into the error-tracking view (sentry.hanzo.ai). */
+interface Exception {
+    /** Constructor/class name, e.g. "TypeError". */
+    type?: string;
+    /** The error message. */
+    message: string;
+    /** Stack trace when available. */
+    stack?: string;
+    /** false = an unhandled/global error (window.onerror, unhandledrejection);
+     *  true = a caught error the app chose to report. Defaults true. */
+    handled?: boolean;
+}
+/** First-touch marketing attribution, parsed once and persisted. */
+interface Attribution {
+    utm: {
+        source?: string;
+        medium?: string;
+        campaign?: string;
+        term?: string;
+        content?: string;
+    };
+    referrer?: string;
+    refCode?: string;
+    /** Derived acquisition channel: direct | organic | paid | social | referral. */
+    channel?: string;
+}
+/** Cohort dimensions carried on every event once known (see goals.ts COHORTS). */
+interface Cohort {
+    /** ISO week the person first signed up, e.g. "2026-W28". */
+    signupWeek?: string;
+    channel?: string;
+    refCode?: string;
+}
+/** One event as sent on the wire. tenant/org is NEVER set here — the server
+ *  stamps it from the validated session. */
+interface WireEvent {
+    messageId: string;
+    type: EventKind;
+    event?: string;
+    timestamp: string;
+    distinctId?: string;
+    anonymousId?: string;
+    personId?: string;
+    sessionId?: string;
+    product?: string;
+    url?: string;
+    path?: string;
+    referrer?: string;
+    utm?: Attribution['utm'];
+    refCode?: string;
+    channel?: string;
+    groupId?: string;
+    signupWeek?: string;
+    productId?: string;
+    quantity?: number;
+    revenue?: number;
+    currency?: string;
+    /** Set on `type:'error'` events — the captured exception. */
+    error?: Exception;
+    properties?: Record<string, unknown>;
+    library?: string;
+    libraryVersion?: string;
+}
+/** Injectable transports — overridden in tests; default in core.ts uses fetch. */
+interface Transport {
+    /** Durable POST usable during page unload (fetch keepalive / sendBeacon). */
+    send(url: string, body: string, opts: {
+        beacon: boolean;
+        token?: string;
+    }): void;
+}
+interface AnalyticsConfig {
+    /** Cloud base URL. Same-origin ("") for cookie-auth apps (console/admin);
+     *  e.g. "https://api.hanzo.ai" for bearer apps (app/site). */
+    host?: string;
+    /** Emitting surface: console | chat | app | site | admin. */
+    product: string;
+    /** Bearer token provider for token-auth apps. Omit for cookie/session apps
+     *  (the client then relies on same-origin credentials). */
+    getToken?: () => string | undefined | null;
+    /** Max events buffered before an automatic flush. */
+    batchSize?: number;
+    /** Auto-flush cadence in ms. */
+    flushIntervalMs?: number;
+    /** Turn the client off entirely (e.g. opt-out / DNT). Defaults to enabled. */
+    enabled?: boolean;
+    /** Auto-capture unhandled errors + promise rejections (window.onerror,
+     *  unhandledrejection) as error events. Browser-only. Defaults to enabled —
+     *  this is what makes the client a drop-in @sentry replacement. */
+    captureErrors?: boolean;
+    /** Override the transport (tests). */
+    transport?: Transport;
+    /** Debug logging. */
+    debug?: boolean;
+}
+
+declare const VERSION = "0.2.0";
+declare class Analytics {
+    private cfg;
+    private transport;
+    private queue;
+    private timer;
+    private personId?;
+    private attribution;
+    private cohort;
+    private started;
+    constructor(config: AnalyticsConfig);
+    /** init is idempotent and browser-only for its side effects: capture first-touch
+     *  attribution, hydrate cohort, and register the unload flush. Safe to call from
+     *  a React effect on every render. */
+    init(): void;
+    /** identify binds the current visitor to a stable person id (post-login). */
+    identify(personId: string, traits?: Record<string, unknown>): void;
+    /** group associates the visitor with an org/team (analytics grouping, not the
+     *  server tenant — the server still derives tenant from the session). */
+    group(groupId: string, traits?: Record<string, unknown>): void;
+    /** pageview records a $pageview for the current (or given) location. */
+    pageview(path?: string, properties?: Record<string, unknown>): void;
+    /** capture records a named product event with optional properties. Commerce
+     *  fields (productId/quantity/revenue/currency) may be passed for order events. */
+    capture(event: string, properties?: Record<string, unknown>, commerce?: Pick<WireEvent, 'productId' | 'quantity' | 'revenue' | 'currency'>): void;
+    /** track is an alias of capture (Segment familiarity). */
+    track: (event: string, properties?: Record<string, unknown>, commerce?: Pick<WireEvent, "productId" | "quantity" | "revenue" | "currency">) => void;
+    /** captureError records an exception as a first-class error event — the ONE
+     *  error path (subsumes @sentry). A caught error, an unhandled rejection, or a
+     *  manual report all become a type:'error' event on the same stream, lensed to
+     *  the error-tracking view server-side. Never throws back into the app; errors
+     *  are higher-signal than pageviews, so it flushes promptly (a crash may unload
+     *  the page moments later). */
+    captureError(err: unknown, context?: {
+        handled?: boolean;
+        properties?: Record<string, unknown>;
+    }): void;
+    /** captureException — @sentry-familiar alias of captureError. */
+    captureException: (err: unknown, context?: {
+        handled?: boolean;
+        properties?: Record<string, unknown>;
+    }) => void;
+    /** setCohort persists cohort dimensions (e.g. signupWeek at signup) so they ride
+     *  every subsequent event. */
+    setCohort(patch: Cohort): void;
+    /** flush drains the buffer to the server as one batch. beacon=true uses the
+     *  unload-safe path. */
+    flush(beacon?: boolean): void;
+    private enqueue;
+    private build;
+    private schedule;
+    private clearTimer;
+}
+/** createAnalytics builds a client instance. Most apps use one shared instance. */
+declare function createAnalytics(config: AnalyticsConfig): Analytics;
+
+export { type Attribution as A, type Cohort as C, type EventKind as E, type Transport as T, VERSION as V, type WireEvent as W, Analytics as a, type AnalyticsConfig as b, type Exception as c, createAnalytics as d };

package/dist/core-DDGwms7M.d.ts

@@ -0,0 +1,157 @@
+/** The event kinds — the closed set the server understands. An error is just
+ *  another event on the one stream (lensed to the error-tracking view). */
+type EventKind = 'pageview' | 'event' | 'identify' | 'group' | 'error';
+/** A captured exception. Carried on a `type:'error'` event; the server lenses it
+ *  into the error-tracking view (sentry.hanzo.ai). */
+interface Exception {
+    /** Constructor/class name, e.g. "TypeError". */
+    type?: string;
+    /** The error message. */
+    message: string;
+    /** Stack trace when available. */
+    stack?: string;
+    /** false = an unhandled/global error (window.onerror, unhandledrejection);
+     *  true = a caught error the app chose to report. Defaults true. */
+    handled?: boolean;
+}
+/** First-touch marketing attribution, parsed once and persisted. */
+interface Attribution {
+    utm: {
+        source?: string;
+        medium?: string;
+        campaign?: string;
+        term?: string;
+        content?: string;
+    };
+    referrer?: string;
+    refCode?: string;
+    /** Derived acquisition channel: direct | organic | paid | social | referral. */
+    channel?: string;
+}
+/** Cohort dimensions carried on every event once known (see goals.ts COHORTS). */
+interface Cohort {
+    /** ISO week the person first signed up, e.g. "2026-W28". */
+    signupWeek?: string;
+    channel?: string;
+    refCode?: string;
+}
+/** One event as sent on the wire. tenant/org is NEVER set here — the server
+ *  stamps it from the validated session. */
+interface WireEvent {
+    messageId: string;
+    type: EventKind;
+    event?: string;
+    timestamp: string;
+    distinctId?: string;
+    anonymousId?: string;
+    personId?: string;
+    sessionId?: string;
+    product?: string;
+    url?: string;
+    path?: string;
+    referrer?: string;
+    utm?: Attribution['utm'];
+    refCode?: string;
+    channel?: string;
+    groupId?: string;
+    signupWeek?: string;
+    productId?: string;
+    quantity?: number;
+    revenue?: number;
+    currency?: string;
+    /** Set on `type:'error'` events — the captured exception. */
+    error?: Exception;
+    properties?: Record<string, unknown>;
+    library?: string;
+    libraryVersion?: string;
+}
+/** Injectable transports — overridden in tests; default in core.ts uses fetch. */
+interface Transport {
+    /** Durable POST usable during page unload (fetch keepalive / sendBeacon). */
+    send(url: string, body: string, opts: {
+        beacon: boolean;
+        token?: string;
+    }): void;
+}
+interface AnalyticsConfig {
+    /** Cloud base URL. Same-origin ("") for cookie-auth apps (console/admin);
+     *  e.g. "https://api.hanzo.ai" for bearer apps (app/site). */
+    host?: string;
+    /** Emitting surface: console | chat | app | site | admin. */
+    product: string;
+    /** Bearer token provider for token-auth apps. Omit for cookie/session apps
+     *  (the client then relies on same-origin credentials). */
+    getToken?: () => string | undefined | null;
+    /** Max events buffered before an automatic flush. */
+    batchSize?: number;
+    /** Auto-flush cadence in ms. */
+    flushIntervalMs?: number;
+    /** Turn the client off entirely (e.g. opt-out / DNT). Defaults to enabled. */
+    enabled?: boolean;
+    /** Auto-capture unhandled errors + promise rejections (window.onerror,
+     *  unhandledrejection) as error events. Browser-only. Defaults to enabled —
+     *  this is what makes the client a drop-in @sentry replacement. */
+    captureErrors?: boolean;
+    /** Override the transport (tests). */
+    transport?: Transport;
+    /** Debug logging. */
+    debug?: boolean;
+}
+
+declare const VERSION = "0.2.0";
+declare class Analytics {
+    private cfg;
+    private transport;
+    private queue;
+    private timer;
+    private personId?;
+    private attribution;
+    private cohort;
+    private started;
+    constructor(config: AnalyticsConfig);
+    /** init is idempotent and browser-only for its side effects: capture first-touch
+     *  attribution, hydrate cohort, and register the unload flush. Safe to call from
+     *  a React effect on every render. */
+    init(): void;
+    /** identify binds the current visitor to a stable person id (post-login). */
+    identify(personId: string, traits?: Record<string, unknown>): void;
+    /** group associates the visitor with an org/team (analytics grouping, not the
+     *  server tenant — the server still derives tenant from the session). */
+    group(groupId: string, traits?: Record<string, unknown>): void;
+    /** pageview records a $pageview for the current (or given) location. */
+    pageview(path?: string, properties?: Record<string, unknown>): void;
+    /** capture records a named product event with optional properties. Commerce
+     *  fields (productId/quantity/revenue/currency) may be passed for order events. */
+    capture(event: string, properties?: Record<string, unknown>, commerce?: Pick<WireEvent, 'productId' | 'quantity' | 'revenue' | 'currency'>): void;
+    /** track is an alias of capture (Segment familiarity). */
+    track: (event: string, properties?: Record<string, unknown>, commerce?: Pick<WireEvent, "productId" | "quantity" | "revenue" | "currency">) => void;
+    /** captureError records an exception as a first-class error event — the ONE
+     *  error path (subsumes @sentry). A caught error, an unhandled rejection, or a
+     *  manual report all become a type:'error' event on the same stream, lensed to
+     *  the error-tracking view server-side. Never throws back into the app; errors
+     *  are higher-signal than pageviews, so it flushes promptly (a crash may unload
+     *  the page moments later). */
+    captureError(err: unknown, context?: {
+        handled?: boolean;
+        properties?: Record<string, unknown>;
+    }): void;
+    /** captureException — @sentry-familiar alias of captureError. */
+    captureException: (err: unknown, context?: {
+        handled?: boolean;
+        properties?: Record<string, unknown>;
+    }) => void;
+    /** setCohort persists cohort dimensions (e.g. signupWeek at signup) so they ride
+     *  every subsequent event. */
+    setCohort(patch: Cohort): void;
+    /** flush drains the buffer to the server as one batch. beacon=true uses the
+     *  unload-safe path. */
+    flush(beacon?: boolean): void;
+    private enqueue;
+    private build;
+    private schedule;
+    private clearTimer;
+}
+/** createAnalytics builds a client instance. Most apps use one shared instance. */
+declare function createAnalytics(config: AnalyticsConfig): Analytics;
+
+export { type Attribution as A, type Cohort as C, type EventKind as E, type Transport as T, VERSION as V, type WireEvent as W, Analytics as a, type AnalyticsConfig as b, type Exception as c, createAnalytics as d };

package/dist/index.d.cts

@@ -0,0 +1,72 @@
+import { C as Cohort, A as Attribution } from './core-DDGwms7M.cjs';
+export { a as Analytics, b as AnalyticsConfig, E as EventKind, c as Exception, T as Transport, V as VERSION, W as WireEvent, d as createAnalytics } from './core-DDGwms7M.cjs';
+
+/** Read the persisted first-touch attribution. */
+declare function getFirstTouch(): Attribution | undefined;
+/** Read persisted cohort dimensions. */
+declare function getCohort(): Cohort | undefined;
+
+declare const EVENTS: {
+    readonly SIGNUP_VIEWED: "signup_viewed";
+    readonly SIGNUP_SUBMITTED: "signup_submitted";
+    readonly SIGNUP_VERIFIED: "signup_verified";
+    readonly SIGNUP_COMPLETED: "signup_completed";
+    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 DEPLOY_STARTED: "deploy_started";
+    readonly PROJECT_CREATED: "project_created";
+    readonly AGENT_CREATED: "agent_created";
+    readonly CHAT_STARTED: "chat_started";
+    readonly CHAT_MESSAGE_SENT: "chat_message_sent";
+    readonly TASK_STARTED: "task_started";
+    readonly TASK_COMPLETED: "task_completed";
+};
+type EventName = (typeof EVENTS)[keyof typeof EVENTS];
+/** The reserved event name a pageview is stored under (server + read lens). */
+declare const PAGEVIEW = "$pageview";
+
+interface GoalDef {
+    /** Human label shown in Insights. */
+    label: string;
+    /** The event whose occurrence counts as the goal conversion. */
+    event: string;
+    /** Optional ordered funnel leading to the goal (for funnel insights). */
+    funnel?: string[];
+    /** Optional property equality filter that qualifies the conversion. */
+    filter?: {
+        property: string;
+        equals: string;
+    };
+}
+declare const GOALS: Record<'signup' | 'sale' | 'upgradeIntent', GoalDef>;
+interface CohortDef {
+    /** The hanzo.events column the cohort dimension maps to. */
+    field: string;
+    label: string;
+}
+declare const COHORTS: Record<'signupWeek' | 'channel' | 'refCode', CohortDef>;
+
+/** parseAttribution reads UTM params + ref/refCode from a query string and pairs
+ *  them with the referrer. `search` is a location.search value ("?utm_source=…"). */
+declare function parseAttribution(search: string, referrer: string): Attribution;
+/** deriveChannel classifies the visit: paid | referral | social | organic | direct. */
+declare function deriveChannel(a: Attribution): string;
+/** hostOf extracts a bare lowercase host from a URL; "" when unparseable. */
+declare function hostOf(raw?: string): string;
+/** hasAttribution reports whether anything was captured (so we don't persist an
+ *  empty first-touch that would shadow a later real one). */
+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, Cohort, type CohortDef, EVENTS, type EventName, GOALS, type GoalDef, PAGEVIEW, deriveChannel, getCohort, getFirstTouch, hasAttribution, hostOf, isoWeek, parseAttribution };

package/dist/index.d.ts

@@ -0,0 +1,72 @@
+import { C as Cohort, A as Attribution } from './core-DDGwms7M.js';
+export { a as Analytics, b as AnalyticsConfig, E as EventKind, c as Exception, T as Transport, V as VERSION, W as WireEvent, d as createAnalytics } from './core-DDGwms7M.js';
+
+/** Read the persisted first-touch attribution. */
+declare function getFirstTouch(): Attribution | undefined;
+/** Read persisted cohort dimensions. */
+declare function getCohort(): Cohort | undefined;
+
+declare const EVENTS: {
+    readonly SIGNUP_VIEWED: "signup_viewed";
+    readonly SIGNUP_SUBMITTED: "signup_submitted";
+    readonly SIGNUP_VERIFIED: "signup_verified";
+    readonly SIGNUP_COMPLETED: "signup_completed";
+    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 DEPLOY_STARTED: "deploy_started";
+    readonly PROJECT_CREATED: "project_created";
+    readonly AGENT_CREATED: "agent_created";
+    readonly CHAT_STARTED: "chat_started";
+    readonly CHAT_MESSAGE_SENT: "chat_message_sent";
+    readonly TASK_STARTED: "task_started";
+    readonly TASK_COMPLETED: "task_completed";
+};
+type EventName = (typeof EVENTS)[keyof typeof EVENTS];
+/** The reserved event name a pageview is stored under (server + read lens). */
+declare const PAGEVIEW = "$pageview";
+
+interface GoalDef {
+    /** Human label shown in Insights. */
+    label: string;
+    /** The event whose occurrence counts as the goal conversion. */
+    event: string;
+    /** Optional ordered funnel leading to the goal (for funnel insights). */
+    funnel?: string[];
+    /** Optional property equality filter that qualifies the conversion. */
+    filter?: {
+        property: string;
+        equals: string;
+    };
+}
+declare const GOALS: Record<'signup' | 'sale' | 'upgradeIntent', GoalDef>;
+interface CohortDef {
+    /** The hanzo.events column the cohort dimension maps to. */
+    field: string;
+    label: string;
+}
+declare const COHORTS: Record<'signupWeek' | 'channel' | 'refCode', CohortDef>;
+
+/** parseAttribution reads UTM params + ref/refCode from a query string and pairs
+ *  them with the referrer. `search` is a location.search value ("?utm_source=…"). */
+declare function parseAttribution(search: string, referrer: string): Attribution;
+/** deriveChannel classifies the visit: paid | referral | social | organic | direct. */
+declare function deriveChannel(a: Attribution): string;
+/** hostOf extracts a bare lowercase host from a URL; "" when unparseable. */
+declare function hostOf(raw?: string): string;
+/** hasAttribution reports whether anything was captured (so we don't persist an
+ *  empty first-touch that would shadow a later real one). */
+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, Cohort, type CohortDef, EVENTS, type EventName, GOALS, type GoalDef, PAGEVIEW, deriveChannel, getCohort, getFirstTouch, hasAttribution, hostOf, isoWeek, parseAttribution };