feat: add shared analytics types, events, consent logic, and i18n strings

packages/shared/src/analytics/consent.ts

@@ -0,0 +1,14 @@
+import type { ConsentState } from "./types.js";
+
+export function shouldShowConsent(consent: ConsentState, serverEnabled: boolean): boolean {
+  if (!serverEnabled) return false;
+  if (consent.analyticsEnabled !== null) return false;
+  if (consent.analyticsConsentShownAt === null) return true;
+  if (consent.analyticsConsentRemindAt === null) return false;
+  return Date.now() >= consent.analyticsConsentRemindAt;
+}
+
+export function isConsentEnabled(consent: ConsentState, serverEnabled: boolean): boolean {
+  if (!serverEnabled) return false;
+  return consent.analyticsEnabled === true;
+}

packages/shared/src/analytics/events.ts

@@ -0,0 +1,38 @@
+export const ANALYTICS_EVENTS = {
+  TOOL_USED: "tool_used",
+  SEARCH: "search",
+  PIPELINE_EXECUTED: "pipeline_executed",
+  AI_BUNDLE_ACTION: "ai_bundle_action",
+} as const;
+
+export type AnalyticsEvent = (typeof ANALYTICS_EVENTS)[keyof typeof ANALYTICS_EVENTS];
+
+export interface ToolUsedProperties {
+  tool_id: string;
+  status: "completed" | "failed";
+  duration_ms: number;
+  category: string;
+  is_ai_tool: boolean;
+  params?: Record<string, string | number | boolean>;
+}
+
+export interface SearchProperties {
+  query: string;
+  results_count: number;
+  clicked_tool_id?: string;
+}
+
+export interface PipelineExecutedProperties {
+  step_count: number;
+  tool_ids: string[];
+  is_batch: boolean;
+  file_count?: number;
+  duration_ms: number;
+  status: "completed" | "failed";
+}
+
+export interface AiBundleActionProperties {
+  bundle_id: string;
+  action: "installed" | "uninstalled";
+  duration_ms: number;
+}

packages/shared/src/analytics/types.ts

@@ -0,0 +1,14 @@
+export interface AnalyticsConfig {
+  enabled: boolean;
+  posthogApiKey: string;
+  posthogHost: string;
+  sentryDsn: string;
+  sampleRate: number;
+  instanceId: string;
+}
+
+export interface ConsentState {
+  analyticsEnabled: boolean | null;
+  analyticsConsentShownAt: number | null;
+  analyticsConsentRemindAt: number | null;
+}