@codeguide/core 0.0.7 → 0.0.8

package/codeguide.ts

@@ -14,6 +14,7 @@ import {
   TaskService,
   ApiKeyEnhancedService,
   SubscriptionService,
+  CancellationFunnelService,
 } from './services'
 import { APIServiceConfig, CodeGuideOptions } from './types'
 
@@ -25,6 +26,7 @@ export class CodeGuide {
   public tasks: TaskService
   public apiKeyEnhanced: ApiKeyEnhancedService
   public subscription: SubscriptionService
+  public cancellationFunnel: CancellationFunnelService
   private options: CodeGuideOptions
 
   constructor(config: APIServiceConfig, options: CodeGuideOptions = {}) {
@@ -38,6 +40,7 @@ export class CodeGuide {
     this.tasks = new TaskService(config)
     this.apiKeyEnhanced = new ApiKeyEnhancedService(config)
     this.subscription = new SubscriptionService(config)
+    this.cancellationFunnel = new CancellationFunnelService(config)
   }
 
   // Convenience method for backward compatibility

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codeguide/core",
-  "version": "0.0.7",
+  "version": "0.0.8",
   "description": "Core package for code guidance with programmatic API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/services/cancellation-funnel/cancellation-funnel-service.ts

@@ -0,0 +1,239 @@
+import { BaseService } from '../base/base-service'
+import {
+  CancellationFunnelInitiateRequest,
+  CancellationFunnelInitiateResponse,
+  CancellationFunnelPauseOfferRequest,
+  CancellationFunnelPauseOfferResponse,
+  CancellationFunnelSurveyRequest,
+  CancellationFunnelSurveyResponse,
+} from '../../types'
+
+export class CancellationFunnelService extends BaseService {
+  constructor(config: any) {
+    super(config)
+  }
+
+  /**
+   * Initiate Cancellation Flow
+   * POST /cancellation-funnel/initiate
+   */
+  async initiateCancellation(
+    request: CancellationFunnelInitiateRequest
+  ): Promise<CancellationFunnelInitiateResponse> {
+    return this.post<CancellationFunnelInitiateResponse>(
+      '/cancellation-funnel/initiate',
+      request
+    )
+  }
+
+  /**
+   * Log Pause Offer Response
+   * POST /cancellation-funnel/pause-offer
+   */
+  async logPauseOfferResponse(
+    request: CancellationFunnelPauseOfferRequest
+  ): Promise<CancellationFunnelPauseOfferResponse> {
+    return this.post<CancellationFunnelPauseOfferResponse>(
+      '/cancellation-funnel/pause-offer',
+      request
+    )
+  }
+
+  /**
+   * Log Survey Response
+   * POST /cancellation-funnel/survey
+   */
+  async logSurveyResponse(
+    request: CancellationFunnelSurveyRequest
+  ): Promise<CancellationFunnelSurveyResponse> {
+    return this.post<CancellationFunnelSurveyResponse>(
+      '/cancellation-funnel/survey',
+      request
+    )
+  }
+
+  /**
+   * Get Cancellation Funnel Status
+   * GET /cancellation-funnel/{subscription_id}/status
+   */
+  async getCancellationFunnelStatus(
+    subscriptionId: string
+  ): Promise<{
+    status: string
+    data: {
+      funnel_id: string
+      subscription_id: string
+      current_step: string
+      initiated_at: string
+      pause_offer_response?: {
+        action: 'accepted' | 'declined'
+        pause_duration_months?: number
+        responded_at: string
+      }
+      survey_response?: {
+        reason: string
+        feedback?: string
+        competitor_name?: string
+        submitted_at: string
+      }
+      is_completed: boolean
+      completed_at?: string
+    }
+  }> {
+    return this.get(`/cancellation-funnel/${subscriptionId}/status`)
+  }
+
+  /**
+   * Get Available Cancellation Offers
+   * GET /cancellation-funnel/{subscription_id}/offers
+   */
+  async getAvailableOffers(
+    subscriptionId: string
+  ): Promise<{
+    status: string
+    data: {
+      subscription_id: string
+      available_offers: Array<{
+        type: 'pause' | 'discount' | 'downgrade' | 'feature_change'
+        title: string
+        description: string
+        details?: Record<string, any>
+        valid_until?: string
+      }>
+      eligibility_check: {
+        is_eligible: boolean
+        reasons?: string[]
+      }
+    }
+  }> {
+    return this.get(`/cancellation-funnel/${subscriptionId}/offers`)
+  }
+
+  /**
+   * Complete Cancellation Funnel
+   * POST /cancellation-funnel/{subscription_id}/complete
+   */
+  async completeCancellationFunnel(
+    subscriptionId: string,
+    finalAction: 'cancel' | 'retain'
+  ): Promise<{
+    status: string
+    message: string
+    data: {
+      funnel_id: string
+      subscription_id: string
+      final_action: 'cancel' | 'retain'
+      completed_at: string
+      outcome: {
+        subscription_cancelled: boolean
+        effective_date?: string
+        retention_action?: string
+      }
+    }
+  }> {
+    return this.post(`/cancellation-funnel/${subscriptionId}/complete`, {
+      final_action,
+    })
+  }
+
+  /**
+   * Get Cancellation Reasons (for survey dropdown)
+   * GET /cancellation-funnel/reasons
+   */
+  async getCancellationReasons(): Promise<{
+    status: string
+    data: Array<{
+      id: string
+      label: string
+      description: string
+      requires_feedback: boolean
+      requires_competitor: boolean
+      category: 'pricing' | 'features' | 'usability' | 'support' | 'other'
+    }>
+  }> {
+    return this.get('/cancellation-funnel/reasons')
+  }
+
+  /**
+   * Save Funnel Progress (for multi-step funnels)
+   * PUT /cancellation-funnel/{subscription_id}/progress
+   */
+  async saveFunnelProgress(
+    subscriptionId: string,
+    progress: {
+      current_step: string
+      step_data?: Record<string, any>
+      completed_steps: string[]
+    }
+  ): Promise<{
+    status: string
+    message: string
+    data: {
+      funnel_id: string
+      subscription_id: string
+      progress: {
+        current_step: string
+        step_data?: Record<string, any>
+        completed_steps: string[]
+        last_updated: string
+      }
+    }
+  }> {
+    return this.put(`/cancellation-funnel/${subscriptionId}/progress`, progress)
+  }
+
+  /**
+   * Skip Funnel Step (for optional steps)
+   * POST /cancellation-funnel/{subscription_id}/skip-step
+   */
+  async skipFunnelStep(
+    subscriptionId: string,
+    stepToSkip: string
+  ): Promise<{
+    status: string
+    message: string
+    data: {
+      funnel_id: string
+      subscription_id: string
+      skipped_step: string
+      next_step: string
+      progress_updated_at: string
+    }
+  }> {
+    return this.post(`/cancellation-funnel/${subscriptionId}/skip-step`, {
+      step_to_skip: stepToSkip,
+    })
+  }
+
+  /**
+   * Get Retention Offers (based on cancellation reason)
+   * GET /cancellation-funnel/{subscription_id}/retention-offers
+   */
+  async getRetentionOffers(
+    subscriptionId: string,
+    reason?: string
+  ): Promise<{
+    status: string
+    data: {
+      subscription_id: string
+      cancellation_reason?: string
+      retention_offers: Array<{
+        id: string
+        type: 'discount' | 'upgrade' | 'extension' | 'feature_unlock'
+        title: string
+        description: string
+        value: {
+          amount?: number
+          percentage?: number
+          duration?: string
+          features?: string[]
+        }
+        expiration_date?: string
+        auto_apply: boolean
+      }>
+    }
+  }> {
+    const params = reason ? `?reason=${encodeURIComponent(reason)}` : ''
+    return this.get(`/cancellation-funnel/${subscriptionId}/retention-offers${params}`)
+  }
+}

package/services/cancellation-funnel/index.ts

@@ -0,0 +1 @@
+export { CancellationFunnelService } from './cancellation-funnel-service'

package/services/index.ts

@@ -15,6 +15,7 @@ export { RepositoryAnalysisService } from './repository-analysis'
 export { TaskService } from './tasks'
 export { ApiKeyEnhancedService } from './api-key-enhanced'
 export { SubscriptionService } from './subscriptions'
+export { CancellationFunnelService } from './cancellation-funnel'
 
 // Re-export all types for convenience
 export * from './generation'
@@ -24,3 +25,4 @@ export * from './repository-analysis'
 export * from './tasks'
 export * from './api-key-enhanced'
 export * from './subscriptions'
+export * from './cancellation-funnel'

package/types.ts

@@ -176,3 +176,65 @@ export interface CancelSubscriptionResponse {
   message: string
   data: Subscription
 }
+
+// Cancellation Funnel Types
+export interface CancellationFunnelInitiateRequest {
+  subscription_id: string
+}
+
+export interface CancellationFunnelInitiateResponse {
+  status: string
+  message: string
+  data: {
+    funnel_id: string
+    subscription_id: string
+    current_step: 'initiated'
+    created_at: string
+    available_offers: string[]
+  }
+}
+
+export interface CancellationFunnelPauseOfferRequest {
+  subscription_id: string
+  action: 'accepted' | 'declined'
+  pause_duration_months?: number
+}
+
+export interface CancellationFunnelPauseOfferResponse {
+  status: string
+  message: string
+  data: {
+    funnel_id: string
+    subscription_id: string
+    pause_offer: {
+      action: 'accepted' | 'declined'
+      pause_duration_months?: number
+      pause_start_date?: string
+      pause_end_date?: string
+    }
+    next_step: string
+  }
+}
+
+export interface CancellationFunnelSurveyRequest {
+  subscription_id: string
+  reason: string
+  feedback?: string
+  competitor_name?: string
+}
+
+export interface CancellationFunnelSurveyResponse {
+  status: string
+  message: string
+  data: {
+    funnel_id: string
+    subscription_id: string
+    survey_response: {
+      reason: string
+      feedback?: string
+      competitor_name?: string
+      submitted_at: string
+    }
+    next_step: string
+  }
+}