drizzle-cube 0.5.5 → 0.5.7

package/dist/client/chunks/{retention-YhT1Oohi.js.map → retention-ChW9jYdy.js.map}

@@ -1 +1 @@
-{"version":3,"file":"retention-YhT1Oohi.js","names":[],"sources":["../../../src/client/types/retention.ts"],"sourcesContent":["/**\n * Retention Analysis Types\n *\n * Types for Retention analysis mode which tracks cohort-based retention over time.\n * Retention analysis measures what percentage of users from each cohort return\n * in subsequent time periods.\n */\n\nimport type { Filter } from '../types'\nimport type { FunnelBindingKey } from './funnel'\n\n// ============================================================================\n// Date Range Types\n// ============================================================================\n\n/**\n * Date range for cohort analysis (REQUIRED)\n * Matches server's RetentionDateRange interface\n */\nexport interface DateRange {\n  /** Start date (inclusive), ISO 8601 format (YYYY-MM-DD) */\n  start: string\n  /** End date (inclusive), ISO 8601 format (YYYY-MM-DD) */\n  end: string\n}\n\n/**\n * Preset date range type\n */\nexport type DateRangePreset =\n  | 'last_30_days'\n  | 'last_3_months'\n  | 'last_6_months'\n  | 'last_12_months'\n  | 'this_year'\n  | 'last_year'\n  | 'custom'\n\n/**\n * Preset date range options for the UI\n */\nexport const RETENTION_DATE_RANGE_PRESETS: { value: DateRangePreset; label: string }[] = [\n  { value: 'last_30_days', label: 'Last 30 days' },\n  { value: 'last_3_months', label: 'Last 3 months' },\n  { value: 'last_6_months', label: 'Last 6 months' },\n  { value: 'last_12_months', label: 'Last 12 months' },\n  { value: 'this_year', label: 'This year' },\n  { value: 'last_year', label: 'Last year' },\n  { value: 'custom', label: 'Custom range' },\n]\n\n/**\n * Default preset for retention date range\n */\nexport const DEFAULT_DATE_RANGE_PRESET: DateRangePreset = 'last_3_months'\n\n/**\n * Calculate date range from a preset value\n * Returns ISO date strings (YYYY-MM-DD)\n */\nexport function getDateRangeFromPreset(preset: DateRangePreset): DateRange {\n  const now = new Date()\n  const today = new Date(now.getFullYear(), now.getMonth(), now.getDate())\n\n  switch (preset) {\n    case 'last_30_days': {\n      const start = new Date(today)\n      start.setDate(start.getDate() - 30)\n      return {\n        start: formatDateToISO(start),\n        end: formatDateToISO(today),\n      }\n    }\n    case 'last_3_months': {\n      // Start of 3 months ago to end of last month\n      const start = new Date(today.getFullYear(), today.getMonth() - 3, 1)\n      const end = new Date(today.getFullYear(), today.getMonth(), 0) // Last day of previous month\n      return {\n        start: formatDateToISO(start),\n        end: formatDateToISO(end),\n      }\n    }\n    case 'last_6_months': {\n      const start = new Date(today.getFullYear(), today.getMonth() - 6, 1)\n      const end = new Date(today.getFullYear(), today.getMonth(), 0)\n      return {\n        start: formatDateToISO(start),\n        end: formatDateToISO(end),\n      }\n    }\n    case 'last_12_months': {\n      const start = new Date(today.getFullYear(), today.getMonth() - 12, 1)\n      const end = new Date(today.getFullYear(), today.getMonth(), 0)\n      return {\n        start: formatDateToISO(start),\n        end: formatDateToISO(end),\n      }\n    }\n    case 'this_year': {\n      const start = new Date(today.getFullYear(), 0, 1)\n      return {\n        start: formatDateToISO(start),\n        end: formatDateToISO(today),\n      }\n    }\n    case 'last_year': {\n      const start = new Date(today.getFullYear() - 1, 0, 1)\n      const end = new Date(today.getFullYear() - 1, 11, 31)\n      return {\n        start: formatDateToISO(start),\n        end: formatDateToISO(end),\n      }\n    }\n    case 'custom':\n    default:\n      // For custom, return last 3 months as fallback\n      return getDateRangeFromPreset('last_3_months')\n  }\n}\n\n/**\n * Format a Date object to ISO date string (YYYY-MM-DD)\n */\nfunction formatDateToISO(date: Date): string {\n  const year = date.getFullYear()\n  const month = String(date.getMonth() + 1).padStart(2, '0')\n  const day = String(date.getDate()).padStart(2, '0')\n  return `${year}-${month}-${day}`\n}\n\n/**\n * Detect which preset a date range matches, if any\n */\nexport function detectDateRangePreset(range: DateRange): DateRangePreset {\n  for (const preset of RETENTION_DATE_RANGE_PRESETS) {\n    if (preset.value === 'custom') continue\n    const presetRange = getDateRangeFromPreset(preset.value)\n    if (presetRange.start === range.start && presetRange.end === range.end) {\n      return preset.value\n    }\n  }\n  return 'custom'\n}\n\n// ============================================================================\n// Server Query Format\n// ============================================================================\n\n/**\n * Server retention query format\n * This is the shape sent to the server for execution\n * Wrapped in { retention: {...} } similar to funnel queries\n */\nexport interface ServerRetentionQuery {\n  retention: RetentionQueryConfig\n}\n\n/**\n * Retention query configuration\n * Contains all parameters needed for server-side retention analysis\n *\n * Simplified Mixpanel-style format:\n * - Single cube and timestamp dimension\n * - Single cohort (date range defines the cohort, not granularity)\n * - Optional breakdown dimension for segmentation\n */\nexport interface RetentionQueryConfig {\n  /**\n   * Single timestamp dimension for the analysis.\n   * String format (e.g., 'Events.timestamp'),\n   * Object format for multi-cube with explicit cube reference.\n   */\n  timeDimension: string | { cube: string; dimension: string }\n\n  /**\n   * Binding key - dimension that links users across events.\n   * This is typically a user ID or other entity identifier.\n   * String for single-cube (e.g., 'Events.userId'),\n   * Array for multi-cube with different column names per cube.\n   */\n  bindingKey: string | { cube: string; dimension: string }[]\n\n  /**\n   * Date range for cohort analysis (REQUIRED).\n   * Users who first performed the cohort action within this range are included.\n   */\n  dateRange: DateRange\n\n  /**\n   * Granularity for viewing retention periods.\n   * Determines how retention periods are measured (day/week/month).\n   */\n  granularity: RetentionGranularity\n\n  /**\n   * Number of periods to calculate (e.g., 12 for 12 weeks).\n   * Period 0 is always the cohort entry period.\n   */\n  periods: number\n\n  /**\n   * Retention type:\n   * - 'classic': User returned exactly in period N (bounded)\n   * - 'rolling': User returned in period N or any later period (unbounded)\n   */\n  retentionType: RetentionType\n\n  /**\n   * Optional filters on cohort entry events.\n   * Applied when identifying which users enter the cohort.\n   */\n  cohortFilters?: Filter | Filter[]\n\n  /**\n   * Optional filters on return activity events.\n   * Applied when checking for user activity in each period.\n   */\n  activityFilters?: Filter | Filter[]\n\n  /**\n   * Optional breakdown dimensions for segmenting the cohort.\n   * When provided, retention is calculated per breakdown value combination.\n   * e.g., [\"Events.country\"] or [\"Events.country\", \"Events.plan\"]\n   */\n  breakdownDimensions?: string[]\n}\n\n// ============================================================================\n// Enums and Unions\n// ============================================================================\n\n/**\n * Supported granularity levels for retention analysis\n */\nexport type RetentionGranularity = 'day' | 'week' | 'month'\n\n/**\n * Retention calculation types\n * - classic: User active exactly in period N\n * - rolling: User active in period N or any later period\n */\nexport type RetentionType = 'classic' | 'rolling'\n\n// ============================================================================\n// Result Types\n// ============================================================================\n\n/**\n * Single retention data point returned from server\n * Results are returned as a flat array; client transforms to matrix if needed\n */\nexport interface RetentionResultRow {\n  /** Period number (0 = cohort entry, 1 = first retention period, etc.) */\n  period: number\n\n  /** Number of users in the cohort */\n  cohortSize: number\n\n  /** Number of users retained in this period */\n  retainedUsers: number\n\n  /** Retention rate as decimal (0-1), e.g., 0.45 for 45% */\n  retentionRate: number\n\n  /** Breakdown value when breakdown dimension is specified (e.g., \"US\", \"UK\") */\n  breakdownValue?: string | null\n}\n\n/**\n * Retention chart data format for visualization\n * Supports both heatmap and line chart modes\n */\nexport interface RetentionChartData {\n  rows: RetentionResultRow[]\n  /** Period numbers (0 to periods) */\n  periods: number[]\n  /** Breakdown values when breakdown dimension is specified */\n  breakdownValues?: string[]\n  /** Summary statistics */\n  summary?: RetentionSummary\n  /** Granularity of retention periods (day/week/month) for period label formatting */\n  granularity?: RetentionGranularity\n  /** Human-readable label extracted from the binding key dimension (e.g., \"userId\" from \"Users.userId\") */\n  bindingKeyLabel?: string\n}\n\n/**\n * Summary statistics for retention analysis\n */\nexport interface RetentionSummary {\n  /** Total unique users in the cohort */\n  totalUsers: number\n  /** Average retention rate across all periods for period 1 */\n  avgPeriod1Retention: number\n  /** Highest retention rate for period 1 */\n  maxPeriod1Retention: number\n  /** Lowest retention rate for period 1 */\n  minPeriod1Retention: number\n  /** Number of breakdown segments (1 if no breakdown) */\n  segmentCount?: number\n}\n\n// ============================================================================\n// Breakdown Types\n// ============================================================================\n\n/**\n * Breakdown item for retention analysis (single dimension)\n * Follows Mixpanel pattern - one breakdown dimension only\n */\nexport interface RetentionBreakdownItem {\n  /** Full dimension name (e.g., \"Events.country\") */\n  field: string\n  /** Display label for the dimension */\n  label?: string\n}\n\n// ============================================================================\n// Slice State (for Zustand store)\n// ============================================================================\n\n/**\n * Retention mode state for the AnalysisBuilder store\n * Simplified Mixpanel-style with single global configuration\n *\n * Key simplifications from previous version:\n * - Single cube for all (no separate cohort/activity cubes)\n * - Single timestamp dimension\n * - Single cohort with breakdown support (no cohort explosion)\n * - Granularity = viewing periods only\n */\nexport interface RetentionSliceState {\n  /** Single cube for retention analysis */\n  retentionCube: string | null\n\n  /** Binding key that identifies entities (reuses funnel binding key type) */\n  retentionBindingKey: FunnelBindingKey | null\n\n  /** Single timestamp dimension for both cohort entry and activity */\n  retentionTimeDimension: string | null\n\n  /** Date range for cohort analysis (REQUIRED) */\n  retentionDateRange: DateRange\n\n  /** Filters that define who enters the cohort */\n  retentionCohortFilters: Filter[]\n\n  /** Filters that define what counts as a return */\n  retentionActivityFilters: Filter[]\n\n  /** Optional breakdown dimensions for segmenting the cohort */\n  retentionBreakdowns: RetentionBreakdownItem[]\n\n  /** Granularity for viewing retention periods (day/week/month) */\n  retentionViewGranularity: RetentionGranularity\n\n  /** Number of periods to analyze (1-52) */\n  retentionPeriods: number\n\n  /** Type of retention calculation */\n  retentionType: RetentionType\n}\n\n/**\n * Retention slice actions for the store\n */\nexport interface RetentionSliceActions {\n  /** Set the single cube for retention analysis */\n  setRetentionCube: (cube: string | null) => void\n  /** Set the retention binding key */\n  setRetentionBindingKey: (key: FunnelBindingKey | null) => void\n  /** Set the single timestamp dimension */\n  setRetentionTimeDimension: (dim: string | null) => void\n  /** Set the date range (REQUIRED) */\n  setRetentionDateRange: (range: DateRange) => void\n  /** Set all cohort filters at once */\n  setRetentionCohortFilters: (filters: Filter[]) => void\n  /** Add a cohort filter */\n  addRetentionCohortFilter: (filter: Filter) => void\n  /** Remove a cohort filter by index */\n  removeRetentionCohortFilter: (index: number) => void\n  /** Update a cohort filter by index */\n  updateRetentionCohortFilter: (index: number, filter: Filter) => void\n  /** Set all activity filters at once */\n  setRetentionActivityFilters: (filters: Filter[]) => void\n  /** Add an activity filter */\n  addRetentionActivityFilter: (filter: Filter) => void\n  /** Remove an activity filter by index */\n  removeRetentionActivityFilter: (index: number) => void\n  /** Update an activity filter by index */\n  updateRetentionActivityFilter: (index: number, filter: Filter) => void\n  /** Set all breakdown dimensions */\n  setRetentionBreakdowns: (breakdowns: RetentionBreakdownItem[]) => void\n  /** Add a breakdown dimension */\n  addRetentionBreakdown: (breakdown: RetentionBreakdownItem) => void\n  /** Remove a breakdown dimension by field name */\n  removeRetentionBreakdown: (field: string) => void\n  /** Set the view granularity */\n  setRetentionViewGranularity: (granularity: RetentionGranularity) => void\n  /** Set the number of periods */\n  setRetentionPeriods: (periods: number) => void\n  /** Set the retention type */\n  setRetentionType: (type: RetentionType) => void\n  /** Check if in retention mode (analysisType === 'retention') */\n  isRetentionMode: () => boolean\n  /** Check if retention mode is properly configured and ready for execution */\n  isRetentionModeEnabled: () => boolean\n  /** Build ServerRetentionQuery from retention state */\n  buildRetentionQuery: () => ServerRetentionQuery | null\n  /** Get validation errors explaining why retention query cannot be built */\n  getRetentionValidation: () => { isValid: boolean; errors: string[]; warnings: string[] }\n}\n\n// ============================================================================\n// Type Guards\n// ============================================================================\n\n/**\n * Type guard to check if data is retention chart data\n */\nexport function isRetentionData(data: unknown): data is RetentionChartData {\n  if (!data || typeof data !== 'object') return false\n  const d = data as Record<string, unknown>\n  return (\n    Array.isArray(d.rows) &&\n    Array.isArray(d.periods)\n  )\n}\n\n/**\n * Type guard to detect server retention query format\n * Used to distinguish { retention: {...} } from CubeQuery, etc.\n */\nexport function isServerRetentionQuery(obj: unknown): obj is ServerRetentionQuery {\n  return (\n    typeof obj === 'object' &&\n    obj !== null &&\n    'retention' in obj &&\n    typeof (obj as { retention: unknown }).retention === 'object'\n  )\n}\n\n/**\n * Type guard for retention result row\n */\nexport function isRetentionResultRow(row: unknown): row is RetentionResultRow {\n  if (!row || typeof row !== 'object') return false\n  const r = row as Record<string, unknown>\n  return (\n    typeof r.cohortPeriod === 'string' &&\n    typeof r.period === 'number' &&\n    typeof r.cohortSize === 'number' &&\n    typeof r.retainedUsers === 'number' &&\n    typeof r.retentionRate === 'number'\n  )\n}\n\n// ============================================================================\n// Default Values\n// ============================================================================\n\n/**\n * Default retention slice state for store initialization\n */\nexport const defaultRetentionSliceState: RetentionSliceState = {\n  retentionCube: null,\n  retentionBindingKey: null,\n  retentionTimeDimension: null,\n  retentionDateRange: getDateRangeFromPreset(DEFAULT_DATE_RANGE_PRESET),\n  retentionCohortFilters: [],\n  retentionActivityFilters: [],\n  retentionBreakdowns: [],\n  retentionViewGranularity: 'week',\n  retentionPeriods: 12,\n  retentionType: 'classic',\n}\n\n/**\n * Minimum and maximum values for retention periods\n */\nexport const RETENTION_MIN_PERIODS = 1\nexport const RETENTION_MAX_PERIODS = 52\n\n/**\n * Available granularity options\n */\nexport const RETENTION_GRANULARITY_OPTIONS: { value: RetentionGranularity; label: string }[] = [\n  { value: 'day', label: 'Daily' },\n  { value: 'week', label: 'Weekly' },\n  { value: 'month', label: 'Monthly' },\n]\n\n/**\n * Available retention type options\n */\nexport const RETENTION_TYPE_OPTIONS: { value: RetentionType; label: string; description: string }[] = [\n  {\n    value: 'classic',\n    label: 'Classic',\n    description: 'User was active in exactly period N',\n  },\n  {\n    value: 'rolling',\n    label: 'Rolling',\n    description: 'User was active in period N or later',\n  },\n]\n"],"mappings":"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"}
+{"version":3,"file":"retention-ChW9jYdy.js","names":[],"sources":["../../../src/client/types/retention.ts"],"sourcesContent":["/**\n * Retention Analysis Types\n *\n * Types for Retention analysis mode which tracks cohort-based retention over time.\n * Retention analysis measures what percentage of users from each cohort return\n * in subsequent time periods.\n */\n\nimport type { Filter } from '../types'\nimport type { FunnelBindingKey } from './funnel'\n\n// ============================================================================\n// Date Range Types\n// ============================================================================\n\n/**\n * Date range for cohort analysis (REQUIRED)\n * Matches server's RetentionDateRange interface\n */\nexport interface DateRange {\n  /** Start date (inclusive), ISO 8601 format (YYYY-MM-DD) */\n  start: string\n  /** End date (inclusive), ISO 8601 format (YYYY-MM-DD) */\n  end: string\n}\n\n/**\n * Preset date range type\n */\nexport type DateRangePreset =\n  | 'last_30_days'\n  | 'last_3_months'\n  | 'last_6_months'\n  | 'last_12_months'\n  | 'this_year'\n  | 'last_year'\n  | 'custom'\n\n/**\n * Preset date range options for the UI\n */\nexport const RETENTION_DATE_RANGE_PRESETS: { value: DateRangePreset; label: string }[] = [\n  { value: 'last_30_days', label: 'Last 30 days' },\n  { value: 'last_3_months', label: 'Last 3 months' },\n  { value: 'last_6_months', label: 'Last 6 months' },\n  { value: 'last_12_months', label: 'Last 12 months' },\n  { value: 'this_year', label: 'This year' },\n  { value: 'last_year', label: 'Last year' },\n  { value: 'custom', label: 'Custom range' },\n]\n\n/**\n * Default preset for retention date range\n */\nexport const DEFAULT_DATE_RANGE_PRESET: DateRangePreset = 'last_3_months'\n\n/**\n * Calculate date range from a preset value\n * Returns ISO date strings (YYYY-MM-DD)\n */\nexport function getDateRangeFromPreset(preset: DateRangePreset): DateRange {\n  const now = new Date()\n  const today = new Date(now.getFullYear(), now.getMonth(), now.getDate())\n\n  switch (preset) {\n    case 'last_30_days': {\n      const start = new Date(today)\n      start.setDate(start.getDate() - 30)\n      return {\n        start: formatDateToISO(start),\n        end: formatDateToISO(today),\n      }\n    }\n    case 'last_3_months': {\n      // Start of 3 months ago to end of last month\n      const start = new Date(today.getFullYear(), today.getMonth() - 3, 1)\n      const end = new Date(today.getFullYear(), today.getMonth(), 0) // Last day of previous month\n      return {\n        start: formatDateToISO(start),\n        end: formatDateToISO(end),\n      }\n    }\n    case 'last_6_months': {\n      const start = new Date(today.getFullYear(), today.getMonth() - 6, 1)\n      const end = new Date(today.getFullYear(), today.getMonth(), 0)\n      return {\n        start: formatDateToISO(start),\n        end: formatDateToISO(end),\n      }\n    }\n    case 'last_12_months': {\n      const start = new Date(today.getFullYear(), today.getMonth() - 12, 1)\n      const end = new Date(today.getFullYear(), today.getMonth(), 0)\n      return {\n        start: formatDateToISO(start),\n        end: formatDateToISO(end),\n      }\n    }\n    case 'this_year': {\n      const start = new Date(today.getFullYear(), 0, 1)\n      return {\n        start: formatDateToISO(start),\n        end: formatDateToISO(today),\n      }\n    }\n    case 'last_year': {\n      const start = new Date(today.getFullYear() - 1, 0, 1)\n      const end = new Date(today.getFullYear() - 1, 11, 31)\n      return {\n        start: formatDateToISO(start),\n        end: formatDateToISO(end),\n      }\n    }\n    case 'custom':\n    default:\n      // For custom, return last 3 months as fallback\n      return getDateRangeFromPreset('last_3_months')\n  }\n}\n\n/**\n * Format a Date object to ISO date string (YYYY-MM-DD)\n */\nfunction formatDateToISO(date: Date): string {\n  const year = date.getFullYear()\n  const month = String(date.getMonth() + 1).padStart(2, '0')\n  const day = String(date.getDate()).padStart(2, '0')\n  return `${year}-${month}-${day}`\n}\n\n/**\n * Detect which preset a date range matches, if any\n */\nexport function detectDateRangePreset(range: DateRange): DateRangePreset {\n  for (const preset of RETENTION_DATE_RANGE_PRESETS) {\n    if (preset.value === 'custom') continue\n    const presetRange = getDateRangeFromPreset(preset.value)\n    if (presetRange.start === range.start && presetRange.end === range.end) {\n      return preset.value\n    }\n  }\n  return 'custom'\n}\n\n// ============================================================================\n// Server Query Format\n// ============================================================================\n\n/**\n * Server retention query format\n * This is the shape sent to the server for execution\n * Wrapped in { retention: {...} } similar to funnel queries\n */\nexport interface ServerRetentionQuery {\n  retention: RetentionQueryConfig\n}\n\n/**\n * Retention query configuration\n * Contains all parameters needed for server-side retention analysis\n *\n * Simplified Mixpanel-style format:\n * - Single cube and timestamp dimension\n * - Single cohort (date range defines the cohort, not granularity)\n * - Optional breakdown dimension for segmentation\n */\nexport interface RetentionQueryConfig {\n  /**\n   * Single timestamp dimension for the analysis.\n   * String format (e.g., 'Events.timestamp'),\n   * Object format for multi-cube with explicit cube reference.\n   */\n  timeDimension: string | { cube: string; dimension: string }\n\n  /**\n   * Binding key - dimension that links users across events.\n   * This is typically a user ID or other entity identifier.\n   * String for single-cube (e.g., 'Events.userId'),\n   * Array for multi-cube with different column names per cube.\n   */\n  bindingKey: string | { cube: string; dimension: string }[]\n\n  /**\n   * Date range for cohort analysis (REQUIRED).\n   * Users who first performed the cohort action within this range are included.\n   */\n  dateRange: DateRange\n\n  /**\n   * Granularity for viewing retention periods.\n   * Determines how retention periods are measured (day/week/month).\n   */\n  granularity: RetentionGranularity\n\n  /**\n   * Number of periods to calculate (e.g., 12 for 12 weeks).\n   * Period 0 is always the cohort entry period.\n   */\n  periods: number\n\n  /**\n   * Retention type:\n   * - 'classic': User returned exactly in period N (bounded)\n   * - 'rolling': User returned in period N or any later period (unbounded)\n   */\n  retentionType: RetentionType\n\n  /**\n   * Optional filters on cohort entry events.\n   * Applied when identifying which users enter the cohort.\n   */\n  cohortFilters?: Filter | Filter[]\n\n  /**\n   * Optional filters on return activity events.\n   * Applied when checking for user activity in each period.\n   */\n  activityFilters?: Filter | Filter[]\n\n  /**\n   * Optional breakdown dimensions for segmenting the cohort.\n   * When provided, retention is calculated per breakdown value combination.\n   * e.g., [\"Events.country\"] or [\"Events.country\", \"Events.plan\"]\n   */\n  breakdownDimensions?: string[]\n}\n\n// ============================================================================\n// Enums and Unions\n// ============================================================================\n\n/**\n * Supported granularity levels for retention analysis\n */\nexport type RetentionGranularity = 'day' | 'week' | 'month'\n\n/**\n * Retention calculation types\n * - classic: User active exactly in period N\n * - rolling: User active in period N or any later period\n */\nexport type RetentionType = 'classic' | 'rolling'\n\n// ============================================================================\n// Result Types\n// ============================================================================\n\n/**\n * Single retention data point returned from server\n * Results are returned as a flat array; client transforms to matrix if needed\n */\nexport interface RetentionResultRow {\n  /** Period number (0 = cohort entry, 1 = first retention period, etc.) */\n  period: number\n\n  /** Number of users in the cohort */\n  cohortSize: number\n\n  /** Number of users retained in this period */\n  retainedUsers: number\n\n  /** Retention rate as decimal (0-1), e.g., 0.45 for 45% */\n  retentionRate: number\n\n  /** Breakdown value when breakdown dimension is specified (e.g., \"US\", \"UK\") */\n  breakdownValue?: string | null\n}\n\n/**\n * Retention chart data format for visualization\n * Supports both heatmap and line chart modes\n */\nexport interface RetentionChartData {\n  rows: RetentionResultRow[]\n  /** Period numbers (0 to periods) */\n  periods: number[]\n  /** Breakdown values when breakdown dimension is specified */\n  breakdownValues?: string[]\n  /** Summary statistics */\n  summary?: RetentionSummary\n  /** Granularity of retention periods (day/week/month) for period label formatting */\n  granularity?: RetentionGranularity\n  /** Human-readable label extracted from the binding key dimension (e.g., \"userId\" from \"Users.userId\") */\n  bindingKeyLabel?: string\n}\n\n/**\n * Summary statistics for retention analysis\n */\nexport interface RetentionSummary {\n  /** Total unique users in the cohort */\n  totalUsers: number\n  /** Average retention rate across all periods for period 1 */\n  avgPeriod1Retention: number\n  /** Highest retention rate for period 1 */\n  maxPeriod1Retention: number\n  /** Lowest retention rate for period 1 */\n  minPeriod1Retention: number\n  /** Number of breakdown segments (1 if no breakdown) */\n  segmentCount?: number\n}\n\n// ============================================================================\n// Breakdown Types\n// ============================================================================\n\n/**\n * Breakdown item for retention analysis (single dimension)\n * Follows Mixpanel pattern - one breakdown dimension only\n */\nexport interface RetentionBreakdownItem {\n  /** Full dimension name (e.g., \"Events.country\") */\n  field: string\n  /** Display label for the dimension */\n  label?: string\n}\n\n// ============================================================================\n// Slice State (for Zustand store)\n// ============================================================================\n\n/**\n * Retention mode state for the AnalysisBuilder store\n * Simplified Mixpanel-style with single global configuration\n *\n * Key simplifications from previous version:\n * - Single cube for all (no separate cohort/activity cubes)\n * - Single timestamp dimension\n * - Single cohort with breakdown support (no cohort explosion)\n * - Granularity = viewing periods only\n */\nexport interface RetentionSliceState {\n  /** Single cube for retention analysis */\n  retentionCube: string | null\n\n  /** Binding key that identifies entities (reuses funnel binding key type) */\n  retentionBindingKey: FunnelBindingKey | null\n\n  /** Single timestamp dimension for both cohort entry and activity */\n  retentionTimeDimension: string | null\n\n  /** Date range for cohort analysis (REQUIRED) */\n  retentionDateRange: DateRange\n\n  /** Filters that define who enters the cohort */\n  retentionCohortFilters: Filter[]\n\n  /** Filters that define what counts as a return */\n  retentionActivityFilters: Filter[]\n\n  /** Optional breakdown dimensions for segmenting the cohort */\n  retentionBreakdowns: RetentionBreakdownItem[]\n\n  /** Granularity for viewing retention periods (day/week/month) */\n  retentionViewGranularity: RetentionGranularity\n\n  /** Number of periods to analyze (1-52) */\n  retentionPeriods: number\n\n  /** Type of retention calculation */\n  retentionType: RetentionType\n}\n\n/**\n * Retention slice actions for the store\n */\nexport interface RetentionSliceActions {\n  /** Set the single cube for retention analysis */\n  setRetentionCube: (cube: string | null) => void\n  /** Set the retention binding key */\n  setRetentionBindingKey: (key: FunnelBindingKey | null) => void\n  /** Set the single timestamp dimension */\n  setRetentionTimeDimension: (dim: string | null) => void\n  /** Set the date range (REQUIRED) */\n  setRetentionDateRange: (range: DateRange) => void\n  /** Set all cohort filters at once */\n  setRetentionCohortFilters: (filters: Filter[]) => void\n  /** Add a cohort filter */\n  addRetentionCohortFilter: (filter: Filter) => void\n  /** Remove a cohort filter by index */\n  removeRetentionCohortFilter: (index: number) => void\n  /** Update a cohort filter by index */\n  updateRetentionCohortFilter: (index: number, filter: Filter) => void\n  /** Set all activity filters at once */\n  setRetentionActivityFilters: (filters: Filter[]) => void\n  /** Add an activity filter */\n  addRetentionActivityFilter: (filter: Filter) => void\n  /** Remove an activity filter by index */\n  removeRetentionActivityFilter: (index: number) => void\n  /** Update an activity filter by index */\n  updateRetentionActivityFilter: (index: number, filter: Filter) => void\n  /** Set all breakdown dimensions */\n  setRetentionBreakdowns: (breakdowns: RetentionBreakdownItem[]) => void\n  /** Add a breakdown dimension */\n  addRetentionBreakdown: (breakdown: RetentionBreakdownItem) => void\n  /** Remove a breakdown dimension by field name */\n  removeRetentionBreakdown: (field: string) => void\n  /** Set the view granularity */\n  setRetentionViewGranularity: (granularity: RetentionGranularity) => void\n  /** Set the number of periods */\n  setRetentionPeriods: (periods: number) => void\n  /** Set the retention type */\n  setRetentionType: (type: RetentionType) => void\n  /** Check if in retention mode (analysisType === 'retention') */\n  isRetentionMode: () => boolean\n  /** Check if retention mode is properly configured and ready for execution */\n  isRetentionModeEnabled: () => boolean\n  /** Build ServerRetentionQuery from retention state */\n  buildRetentionQuery: () => ServerRetentionQuery | null\n  /** Get validation errors explaining why retention query cannot be built */\n  getRetentionValidation: () => { isValid: boolean; errors: string[]; warnings: string[] }\n}\n\n// ============================================================================\n// Type Guards\n// ============================================================================\n\n/**\n * Type guard to check if data is retention chart data\n */\nexport function isRetentionData(data: unknown): data is RetentionChartData {\n  if (!data || typeof data !== 'object') return false\n  const d = data as Record<string, unknown>\n  return (\n    Array.isArray(d.rows) &&\n    Array.isArray(d.periods)\n  )\n}\n\n/**\n * Type guard to detect server retention query format\n * Used to distinguish { retention: {...} } from CubeQuery, etc.\n */\nexport function isServerRetentionQuery(obj: unknown): obj is ServerRetentionQuery {\n  return (\n    typeof obj === 'object' &&\n    obj !== null &&\n    'retention' in obj &&\n    typeof (obj as { retention: unknown }).retention === 'object'\n  )\n}\n\n/**\n * Type guard for retention result row\n */\nexport function isRetentionResultRow(row: unknown): row is RetentionResultRow {\n  if (!row || typeof row !== 'object') return false\n  const r = row as Record<string, unknown>\n  return (\n    typeof r.cohortPeriod === 'string' &&\n    typeof r.period === 'number' &&\n    typeof r.cohortSize === 'number' &&\n    typeof r.retainedUsers === 'number' &&\n    typeof r.retentionRate === 'number'\n  )\n}\n\n// ============================================================================\n// Default Values\n// ============================================================================\n\n/**\n * Default retention slice state for store initialization\n */\nexport const defaultRetentionSliceState: RetentionSliceState = {\n  retentionCube: null,\n  retentionBindingKey: null,\n  retentionTimeDimension: null,\n  retentionDateRange: getDateRangeFromPreset(DEFAULT_DATE_RANGE_PRESET),\n  retentionCohortFilters: [],\n  retentionActivityFilters: [],\n  retentionBreakdowns: [],\n  retentionViewGranularity: 'week',\n  retentionPeriods: 12,\n  retentionType: 'classic',\n}\n\n/**\n * Minimum and maximum values for retention periods\n */\nexport const RETENTION_MIN_PERIODS = 1\nexport const RETENTION_MAX_PERIODS = 52\n\n/**\n * Available granularity options\n */\nexport const RETENTION_GRANULARITY_OPTIONS: { value: RetentionGranularity; label: string }[] = [\n  { value: 'day', label: 'Daily' },\n  { value: 'week', label: 'Weekly' },\n  { value: 'month', label: 'Monthly' },\n]\n\n/**\n * Available retention type options\n */\nexport const RETENTION_TYPE_OPTIONS: { value: RetentionType; label: string; description: string }[] = [\n  {\n    value: 'classic',\n    label: 'Classic',\n    description: 'User was active in exactly period N',\n  },\n  {\n    value: 'rolling',\n    label: 'Rolling',\n    description: 'User was active in period N or later',\n  },\n]\n"],"mappings":"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"}

package/dist/client/chunks/{rolldown-runtime-CCl2IeXn.js → rolldown-runtime-CWhphoD1.js}

@@ -1,5 +1,5 @@
 //#region \0rolldown/runtime.js
-var e = Object.create, t = Object.defineProperty, n = Object.getOwnPropertyDescriptor, r = Object.getOwnPropertyNames, i = Object.getPrototypeOf, a = Object.prototype.hasOwnProperty, o = (e, t) => () => (t || e((t = { exports: {} }).exports, t), t.exports), s = (e, n) => {
+var e = Object.create, t = Object.defineProperty, n = Object.getOwnPropertyDescriptor, r = Object.getOwnPropertyNames, i = Object.getPrototypeOf, a = Object.prototype.hasOwnProperty, o = (e, t) => () => (t || (e((t = { exports: {} }).exports, t), e = null), t.exports), s = (e, n) => {
 	let r = {};
 	for (var i in e) t(r, i, {
 		get: e[i],