Event schema

import type { TrackInput } from "@waniwani/sdk";

type TrackEvent = {
  event: EventType;                     // required, one of the built-in names
  properties?: Record<string, unknown>; // typed per event name
  meta?: Record<string, unknown>;       // MCP request _meta
  metadata?: Record<string, unknown>;   // free-form metadata on the envelope
  sessionId?: string;                   // explicit override, usually omit
  traceId?: string;
  requestId?: string;
  correlationId?: string;
  externalUserId?: string;
  eventId?: string;                     // supply your own id (idempotency)
  timestamp?: string | Date;            // defaults to now
  source?: string;                      // defaults to "@waniwani/sdk"
};

import type {
  ToolCalledProperties,
  QuoteSucceededProperties,
  LinkClickedProperties,
  PurchaseCompletedProperties,
  PriceShownProperties,
  PricesComparedProperties,
  OptionSelectedProperties,
  LeadQualifiedProperties,
  ConvertedProperties,
} from "@waniwani/sdk";

interface ToolCalledProperties {
  name?: string;
  type?: "pricing" | "product_info" | "availability" | "support" | "other";
  /** Retrieval traces for kb.search() calls made inside this tool handler. */
  kbSearch?: KbSearchTrace[];
}

interface QuoteSucceededProperties {
  amount?: number;
  currency?: string;
}

interface LinkClickedProperties {
  url?: string;
}

interface PurchaseCompletedProperties {
  amount?: number;
  currency?: string;
}

interface PriceShownProperties {
  amount: number;
  currency: string;
  itemId?: string;
  label?: string;
}

interface PricesComparedProperties {
  options: Array<{ id: string; amount: number; currency: string }>;
}

interface OptionSelectedProperties {
  id: string;
  amount: number;
  currency: string;
}

interface LeadQualifiedProperties {
  /** Your own lead id (e.g. the record id your CRM returns). The strongest dedup key. */
  externalId?: string;
  /** The lead's email, if known. */
  email?: string;
  /** The lead's name, if known. */
  name?: string;
  /** Acquisition source of the lead (e.g. "newsletter"). */
  source?: string;
}

interface ConvertedProperties {
  amount: number;
  currency: string;
  /** When the conversion actually happened, for backdated off-platform sales. */
  occurredAt?: string;
}