vibefast-cli 0.7.0 → 0.7.2

package/2/apps/native/src/features/onboarding/services/onboarding-analytics.ts

@@ -1,432 +0,0 @@
-import type { AnalyticsService } from '@/core/analytics';
-
-/**
- * Onboarding step configuration for analytics tracking
- */
-export type OnboardingStepConfig = {
-  id: string;
-  name: string;
-  index: number;
-  isOptional?: boolean;
-  category?: string; // e.g., 'intro', 'personalization', 'setup'
-};
-
-/**
- * Onboarding flow configuration for analytics
- */
-export type OnboardingFlowConfig = {
-  flowId: string;
-  flowName: string;
-  version?: string;
-  steps: OnboardingStepConfig[];
-  variant?: string; // For A/B testing different flows
-};
-
-/**
- * Onboarding step interaction types
- */
-export type OnboardingStepAction =
-  | 'viewed'
-  | 'completed'
-  | 'skipped'
-  | 'retried'
-  | 'back_navigation'
-  | 'help_accessed';
-
-/**
- * Onboarding session data for tracking user journey
- */
-export type OnboardingSession = {
-  sessionId: string;
-  flowConfig: OnboardingFlowConfig;
-  startTime: number;
-  currentStepIndex: number;
-  completedSteps: string[];
-  skippedSteps: string[];
-  userType?: 'new' | 'returning' | 'migrated';
-};
-
-/**
- * Analytics events for onboarding tracking
- */
-export const OnboardingAnalyticsEvents = {
-  // Flow-level events
-  FLOW_STARTED: 'onboarding_flow_started',
-  FLOW_COMPLETED: 'onboarding_flow_completed',
-  FLOW_ABANDONED: 'onboarding_flow_abandoned',
-  FLOW_RESUMED: 'onboarding_flow_resumed',
-
-  // Step-level events
-  STEP_VIEWED: 'onboarding_step_viewed',
-  STEP_COMPLETED: 'onboarding_step_completed',
-  STEP_SKIPPED: 'onboarding_step_skipped',
-  STEP_RETRIED: 'onboarding_step_retried',
-  STEP_HELP_ACCESSED: 'onboarding_step_help_accessed',
-
-  // Navigation events
-  NAVIGATION_BACK: 'onboarding_navigation_back',
-  NAVIGATION_FORWARD: 'onboarding_navigation_forward',
-} as const;
-
-/**
- * Service for tracking onboarding analytics with automatic step discovery
- * and scalable event tracking that adapts to any onboarding flow configuration.
- */
-export class OnboardingAnalyticsService {
-  private analytics: AnalyticsService;
-  private currentSession: OnboardingSession | null = null;
-  private stepStartTimes: Map<string, number> = new Map();
-
-  constructor(analyticsService: AnalyticsService) {
-    this.analytics = analyticsService;
-  }
-
-  /**
-   * Start tracking an onboarding flow
-   */
-  async startFlow(
-    flowConfig: OnboardingFlowConfig,
-    userType?: 'new' | 'returning' | 'migrated',
-  ): Promise<string> {
-    const sessionId = `onboarding_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
-
-    this.currentSession = {
-      sessionId,
-      flowConfig,
-      startTime: Date.now(),
-      currentStepIndex: 0,
-      completedSteps: [],
-      skippedSteps: [],
-      userType,
-    };
-
-    await this.analytics.track(OnboardingAnalyticsEvents.FLOW_STARTED, {
-      session_id: sessionId,
-      flow_id: flowConfig.flowId,
-      flow_name: flowConfig.flowName,
-      flow_version: flowConfig.version || '1.0',
-      flow_variant: flowConfig.variant,
-      total_steps: flowConfig.steps.length,
-      user_type: userType || 'unknown',
-      optional_steps_count: flowConfig.steps.filter((step) => step.isOptional)
-        .length,
-      step_categories: [
-        ...new Set(
-          flowConfig.steps.map((step) => step.category).filter(Boolean),
-        ),
-      ].join(','),
-    });
-
-    return sessionId;
-  }
-
-  /**
-   * Track when a user views a specific onboarding step
-   */
-  async trackStepViewed(
-    stepId: string,
-    additionalProperties?: Record<string, any>,
-  ): Promise<void> {
-    if (!this.currentSession) {
-      console.warn('[OnboardingAnalytics] No active session for step viewed');
-      return;
-    }
-
-    const step = this.currentSession.flowConfig.steps.find(
-      (s) => s.id === stepId,
-    );
-    if (!step) {
-      console.warn(
-        `[OnboardingAnalytics] Step ${stepId} not found in flow configuration`,
-      );
-      return;
-    }
-
-    // Update session state
-    this.currentSession.currentStepIndex = step.index;
-    this.stepStartTimes.set(stepId, Date.now());
-
-    await this.analytics.track(OnboardingAnalyticsEvents.STEP_VIEWED, {
-      session_id: this.currentSession.sessionId,
-      flow_id: this.currentSession.flowConfig.flowId,
-      step_id: stepId,
-      step_name: step.name,
-      step_index: step.index,
-      step_category: step.category,
-      is_optional: step.isOptional || false,
-      session_duration_ms: Date.now() - this.currentSession.startTime,
-      is_first_step: step.index === 0,
-      is_last_step:
-        step.index === this.currentSession.flowConfig.steps.length - 1,
-      ...additionalProperties,
-    });
-  }
-
-  /**
-   * Track when a user completes a specific onboarding step
-   */
-  async trackStepCompleted(
-    stepId: string,
-    additionalProperties?: Record<string, any>,
-  ): Promise<void> {
-    if (!this.currentSession) {
-      console.warn(
-        '[OnboardingAnalytics] No active session for step completion',
-      );
-      return;
-    }
-
-    const step = this.currentSession.flowConfig.steps.find(
-      (s) => s.id === stepId,
-    );
-    if (!step) {
-      console.warn(
-        `[OnboardingAnalytics] Step ${stepId} not found in flow configuration`,
-      );
-      return;
-    }
-
-    // Calculate step duration
-    const stepStartTime = this.stepStartTimes.get(stepId);
-    const stepDuration = stepStartTime ? Date.now() - stepStartTime : 0;
-
-    // Update session state
-    this.currentSession.completedSteps.push(stepId);
-
-    await this.analytics.track(OnboardingAnalyticsEvents.STEP_COMPLETED, {
-      session_id: this.currentSession.sessionId,
-      flow_id: this.currentSession.flowConfig.flowId,
-      step_id: stepId,
-      step_name: step.name,
-      step_index: step.index,
-      step_category: step.category,
-      is_optional: step.isOptional || false,
-      step_duration_ms: stepDuration,
-      session_duration_ms: Date.now() - this.currentSession.startTime,
-      completion_rate:
-        this.currentSession.completedSteps.length /
-        this.currentSession.flowConfig.steps.length,
-      is_last_step:
-        step.index === this.currentSession.flowConfig.steps.length - 1,
-      ...additionalProperties,
-    });
-
-    // Check if this was the last step
-    if (step.index === this.currentSession.flowConfig.steps.length - 1) {
-      await this.trackFlowCompleted();
-    }
-  }
-
-  /**
-   * Track when a user skips a step
-   */
-  async trackStepSkipped(
-    stepId: string,
-    reason?: string,
-    additionalProperties?: Record<string, any>,
-  ): Promise<void> {
-    if (!this.currentSession) {
-      console.warn('[OnboardingAnalytics] No active session for step skip');
-      return;
-    }
-
-    const step = this.currentSession.flowConfig.steps.find(
-      (s) => s.id === stepId,
-    );
-    if (!step) {
-      console.warn(
-        `[OnboardingAnalytics] Step ${stepId} not found in flow configuration`,
-      );
-      return;
-    }
-
-    // Update session state
-    this.currentSession.skippedSteps.push(stepId);
-
-    await this.analytics.track(OnboardingAnalyticsEvents.STEP_SKIPPED, {
-      session_id: this.currentSession.sessionId,
-      flow_id: this.currentSession.flowConfig.flowId,
-      step_id: stepId,
-      step_name: step.name,
-      step_index: step.index,
-      step_category: step.category,
-      is_optional: step.isOptional || false,
-      skip_reason: reason || 'user_choice',
-      session_duration_ms: Date.now() - this.currentSession.startTime,
-      ...additionalProperties,
-    });
-  }
-
-  /**
-   * Track step retry attempts
-   */
-  async trackStepRetried(
-    stepId: string,
-    attempt: number,
-    additionalProperties?: Record<string, any>,
-  ): Promise<void> {
-    if (!this.currentSession) return;
-
-    const step = this.currentSession.flowConfig.steps.find(
-      (s) => s.id === stepId,
-    );
-    if (!step) return;
-
-    await this.analytics.track(OnboardingAnalyticsEvents.STEP_RETRIED, {
-      session_id: this.currentSession.sessionId,
-      flow_id: this.currentSession.flowConfig.flowId,
-      step_id: stepId,
-      step_name: step.name,
-      step_index: step.index,
-      attempt_number: attempt,
-      ...additionalProperties,
-    });
-  }
-
-  /**
-   * Track when user accesses help during onboarding
-   */
-  async trackStepHelpAccessed(
-    stepId: string,
-    helpType?: string,
-    additionalProperties?: Record<string, any>,
-  ): Promise<void> {
-    if (!this.currentSession) return;
-
-    const step = this.currentSession.flowConfig.steps.find(
-      (s) => s.id === stepId,
-    );
-    if (!step) return;
-
-    await this.analytics.track(OnboardingAnalyticsEvents.STEP_HELP_ACCESSED, {
-      session_id: this.currentSession.sessionId,
-      flow_id: this.currentSession.flowConfig.flowId,
-      step_id: stepId,
-      step_name: step.name,
-      step_index: step.index,
-      help_type: helpType || 'general',
-      ...additionalProperties,
-    });
-  }
-
-  /**
-   * Track navigation events (back/forward)
-   */
-  async trackNavigation(
-    direction: 'back' | 'forward',
-    fromStepId: string,
-    toStepId: string,
-  ): Promise<void> {
-    if (!this.currentSession) return;
-
-    const event =
-      direction === 'back'
-        ? OnboardingAnalyticsEvents.NAVIGATION_BACK
-        : OnboardingAnalyticsEvents.NAVIGATION_FORWARD;
-
-    await this.analytics.track(event, {
-      session_id: this.currentSession.sessionId,
-      flow_id: this.currentSession.flowConfig.flowId,
-      from_step_id: fromStepId,
-      to_step_id: toStepId,
-      direction,
-      session_duration_ms: Date.now() - this.currentSession.startTime,
-    });
-  }
-
-  /**
-   * Track successful flow completion
-   */
-  async trackFlowCompleted(): Promise<void> {
-    if (!this.currentSession) return;
-
-    const totalDuration = Date.now() - this.currentSession.startTime;
-    const totalSteps = this.currentSession.flowConfig.steps.length;
-    const completedSteps = this.currentSession.completedSteps.length;
-    const skippedSteps = this.currentSession.skippedSteps.length;
-
-    await this.analytics.track(OnboardingAnalyticsEvents.FLOW_COMPLETED, {
-      session_id: this.currentSession.sessionId,
-      flow_id: this.currentSession.flowConfig.flowId,
-      flow_name: this.currentSession.flowConfig.flowName,
-      flow_version: this.currentSession.flowConfig.version || '1.0',
-      flow_variant: this.currentSession.flowConfig.variant,
-      total_duration_ms: totalDuration,
-      total_steps: totalSteps,
-      completed_steps: completedSteps,
-      skipped_steps: skippedSteps,
-      completion_rate: completedSteps / totalSteps,
-      skip_rate: skippedSteps / totalSteps,
-      user_type: this.currentSession.userType,
-      completed_step_ids: this.currentSession.completedSteps.join(','),
-      skipped_step_ids: this.currentSession.skippedSteps.join(','),
-    });
-
-    // Clear session
-    this.currentSession = null;
-    this.stepStartTimes.clear();
-  }
-
-  /**
-   * Track flow abandonment
-   */
-  async trackFlowAbandoned(reason?: string): Promise<void> {
-    if (!this.currentSession) return;
-
-    const totalDuration = Date.now() - this.currentSession.startTime;
-    const currentStep =
-      this.currentSession.flowConfig.steps[
-        this.currentSession.currentStepIndex
-      ];
-
-    await this.analytics.track(OnboardingAnalyticsEvents.FLOW_ABANDONED, {
-      session_id: this.currentSession.sessionId,
-      flow_id: this.currentSession.flowConfig.flowId,
-      flow_name: this.currentSession.flowConfig.flowName,
-      abandon_reason: reason || 'unknown',
-      last_step_id: currentStep?.id,
-      last_step_index: this.currentSession.currentStepIndex,
-      session_duration_ms: totalDuration,
-      completed_steps: this.currentSession.completedSteps.length,
-      completion_rate_at_abandon:
-        this.currentSession.completedSteps.length /
-        this.currentSession.flowConfig.steps.length,
-      completed_step_ids: this.currentSession.completedSteps.join(','),
-      skipped_step_ids: this.currentSession.skippedSteps.join(','),
-    });
-
-    // Clear session
-    this.currentSession = null;
-    this.stepStartTimes.clear();
-  }
-
-  /**
-   * Get current session information
-   */
-  getCurrentSession(): OnboardingSession | null {
-    return this.currentSession;
-  }
-
-  /**
-   * Get flow progress analytics
-   */
-  getFlowProgress(): {
-    totalSteps: number;
-    currentStep: number;
-    completedSteps: number;
-    skippedSteps: number;
-    completionRate: number;
-  } | null {
-    if (!this.currentSession) return null;
-
-    return {
-      totalSteps: this.currentSession.flowConfig.steps.length,
-      currentStep: this.currentSession.currentStepIndex,
-      completedSteps: this.currentSession.completedSteps.length,
-      skippedSteps: this.currentSession.skippedSteps.length,
-      completionRate:
-        this.currentSession.completedSteps.length /
-        this.currentSession.flowConfig.steps.length,
-    };
-  }
-}

package/2/apps/native/src/features/payments/README.md

@@ -1,200 +0,0 @@
-# Payments Feature - RevenueCat Integration
-
-This feature provides a complete RevenueCat integration for handling in-app purchases and subscriptions in your React Native Expo app.
-
-## Features
-
-- ✅ RevenueCat SDK initialization on app startup
-- ✅ Automatic user authentication sync with RevenueCat
-- ✅ Product offerings fetching
-- ✅ Purchase handling (subscriptions and consumable products)
-- ✅ Subscription status checking
-- ✅ Purchase restoration
-- ✅ Complete TypeScript support
-- ✅ Comprehensive error handling
-- ✅ Testing utilities
-
-## Setup
-
-### 1. Environment Variables
-
-Make sure your RevenueCat API keys are configured in your `.env.local` file:
-
-```env
-REVENUECAT_API_KEY_APPLE=your_apple_key_here
-REVENUECAT_API_KEY_GOOGLE=your_google_key_here
-```
-
-### 2. Automatic Initialization
-
-The `PaymentInitializer` component is already added to your app's root layout and will:
-
-- Initialize RevenueCat SDK on app startup
-- Automatically set user ID when users log in
-- Handle user logout from RevenueCat
-
-No additional setup required!
-
-## Usage
-
-### Checking User Entitlements
-
-Use the `useEntitlement` hook to check if a user has access to premium features:
-
-```tsx
-import { useEntitlement } from '@/features/payments';
-
-export const PremiumFeature = () => {
-  const { isEntitled, isLoading, error } = useEntitlement('premium');
-
-  if (isLoading) {
-    return <Text>Checking subscription...</Text>;
-  }
-
-  if (error) {
-    return <Text>Error: {error}</Text>;
-  }
-
-  if (!isEntitled) {
-    return <PaywallScreen />;
-  }
-
-  return <PremiumContent />;
-};
-```
-
-### Fetching Product Offerings
-
-```tsx
-import { RevenueCatAdapter } from '@/features/payments';
-
-const paymentService = new RevenueCatAdapter();
-
-// Fetch available products
-const offerings = await paymentService.fetchProductOfferings('remote');
-console.log('Available products:', offerings);
-```
-
-### Making Purchases
-
-```tsx
-import { RevenueCatAdapter } from '@/features/payments';
-
-const paymentService = new RevenueCatAdapter();
-
-// Purchase a subscription
-const result = await paymentService.purchaseProduct('premium_monthly');
-
-if (result.success) {
-  console.log('Purchase successful!');
-  // Handle successful purchase
-} else {
-  console.log('Purchase failed:', result.error);
-  // Handle error
-}
-```
-
-### Handling Consumable Products (Credits)
-
-For consumable products like credits, provide a callback to record the purchase:
-
-```tsx
-const result = await paymentService.purchaseProduct(
-  'credits_100',
-  undefined, // offering identifier (optional)
-  async ({ productId, quantity }) => {
-    // Record the credit purchase in your backend
-    await recordCreditPurchase(productId, quantity);
-  },
-);
-```
-
-### Restoring Purchases
-
-```tsx
-const result = await paymentService.restorePurchases();
-
-if (result.success) {
-  console.log('Restored entitlements:', result.restoredEntitlements);
-} else {
-  console.log('Restore failed:', result.error);
-}
-```
-
-## Architecture
-
-### Components
-
-- **`PaymentInitializer`** - Handles SDK initialization and user auth sync
-- **`useEntitlement`** - Hook for checking subscription status
-
-### Services
-
-- **`RevenueCatAdapter`** - Main service implementing the PaymentService interface
-- **`PaymentService`** - Core interface defined in `@/core/payments`
-
-### Key Features
-
-1. **Modular Design** - Uses adapter pattern for easy swapping of payment providers
-2. **Type Safety** - Full TypeScript support with proper types
-3. **Error Handling** - Graceful error handling with logging
-4. **Testing** - Comprehensive test coverage
-5. **Platform Support** - Works on both iOS and Android
-
-## Error Handling
-
-The integration includes comprehensive error handling:
-
-- SDK initialization failures won't crash the app
-- Purchase errors are returned as structured responses
-- All errors are logged for debugging
-- Network issues are handled gracefully
-
-## Testing
-
-Run the payment feature tests:
-
-```bash
-npm test src/features/payments
-```
-
-## Configuration
-
-### Product ID Patterns
-
-For consumable products (credits), the adapter automatically detects quantities based on product ID patterns:
-
-- `credits_100` → 100 credits
-- `100_credits` → 100 credits
-- `credit_50` → 50 credits
-
-### Entitlement IDs
-
-Make sure your entitlement identifiers in RevenueCat match what you use in the `useEntitlement` hook.
-
-## Troubleshooting
-
-### Common Issues
-
-1. **SDK Not Initialized Error**
-   - Ensure API keys are set in environment variables
-   - Check that `PaymentInitializer` is included in app root
-
-2. **Purchase Failures**
-   - Verify product IDs match your RevenueCat configuration
-   - Check that offerings are properly configured in RevenueCat dashboard
-
-3. **Entitlement Not Found**
-   - Ensure entitlement ID matches your RevenueCat configuration
-   - Check that user is properly logged in
-
-### Debug Logging
-
-In development mode, debug logs are automatically enabled. Check your console for detailed RevenueCat logs.
-
-## Next Steps
-
-1. Configure your products in the RevenueCat dashboard
-2. Set up your entitlements and offerings
-3. Test purchases in sandbox mode
-4. Implement your paywall UI using the provided hooks and services