@codeguide/core 0.0.7 → 0.0.9

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/dist/codeguide.d.ts

@@ -1,4 +1,4 @@
-import { GenerationService, ProjectService, UsageService, RepositoryAnalysisService, TaskService, ApiKeyEnhancedService, SubscriptionService } from './services';
+import { GenerationService, ProjectService, UsageService, RepositoryAnalysisService, TaskService, ApiKeyEnhancedService, SubscriptionService, CancellationFunnelService } from './services';
 import { APIServiceConfig, CodeGuideOptions } from './types';
 export declare class CodeGuide {
     generation: GenerationService;
@@ -8,6 +8,7 @@ export declare class CodeGuide {
     tasks: TaskService;
     apiKeyEnhanced: ApiKeyEnhancedService;
     subscription: SubscriptionService;
+    cancellationFunnel: CancellationFunnelService;
     private options;
     constructor(config: APIServiceConfig, options?: CodeGuideOptions);
     getGuidance(prompt: string): Promise<any>;

package/dist/codeguide.js

@@ -23,6 +23,7 @@ class CodeGuide {
         this.tasks = new services_1.TaskService(config);
         this.apiKeyEnhanced = new services_1.ApiKeyEnhancedService(config);
         this.subscription = new services_1.SubscriptionService(config);
+        this.cancellationFunnel = new services_1.CancellationFunnelService(config);
     }
     // Convenience method for backward compatibility
     async getGuidance(prompt) {

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

@@ -0,0 +1,163 @@
+import { BaseService } from '../base/base-service';
+import { CancellationFunnelInitiateRequest, CancellationFunnelInitiateResponse, CancellationFunnelPauseOfferRequest, CancellationFunnelPauseOfferResponse, CancellationFunnelSurveyRequest, CancellationFunnelSurveyResponse } from '../../types';
+export declare class CancellationFunnelService extends BaseService {
+    constructor(config: any);
+    /**
+     * Initiate Cancellation Flow
+     * POST /cancellation-funnel/initiate
+     */
+    initiateCancellation(request: CancellationFunnelInitiateRequest): Promise<CancellationFunnelInitiateResponse>;
+    /**
+     * Log Pause Offer Response
+     * POST /cancellation-funnel/pause-offer
+     */
+    logPauseOfferResponse(request: CancellationFunnelPauseOfferRequest): Promise<CancellationFunnelPauseOfferResponse>;
+    /**
+     * Log Survey Response
+     * POST /cancellation-funnel/survey
+     */
+    logSurveyResponse(request: CancellationFunnelSurveyRequest): Promise<CancellationFunnelSurveyResponse>;
+    /**
+     * Get Cancellation Funnel Status
+     * GET /cancellation-funnel/{subscription_id}/status
+     */
+    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;
+        };
+    }>;
+    /**
+     * Get Available Cancellation Offers
+     * GET /cancellation-funnel/{subscription_id}/offers
+     */
+    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[];
+            };
+        };
+    }>;
+    /**
+     * Complete Cancellation Funnel
+     * POST /cancellation-funnel/{subscription_id}/complete
+     */
+    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;
+            };
+        };
+    }>;
+    /**
+     * Get Cancellation Reasons (for survey dropdown)
+     * GET /cancellation-funnel/reasons
+     */
+    getCancellationReasons(): Promise<{
+        status: string;
+        data: Array<{
+            id: string;
+            label: string;
+            description: string;
+            requires_feedback: boolean;
+            requires_competitor: boolean;
+            category: 'pricing' | 'features' | 'usability' | 'support' | 'other';
+        }>;
+    }>;
+    /**
+     * Save Funnel Progress (for multi-step funnels)
+     * PUT /cancellation-funnel/{subscription_id}/progress
+     */
+    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;
+            };
+        };
+    }>;
+    /**
+     * Skip Funnel Step (for optional steps)
+     * POST /cancellation-funnel/{subscription_id}/skip-step
+     */
+    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;
+        };
+    }>;
+    /**
+     * Get Retention Offers (based on cancellation reason)
+     * GET /cancellation-funnel/{subscription_id}/retention-offers
+     */
+    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;
+            }>;
+        };
+    }>;
+}

package/dist/services/cancellation-funnel/cancellation-funnel-service.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CancellationFunnelService = void 0;
+const base_service_1 = require("../base/base-service");
+class CancellationFunnelService extends base_service_1.BaseService {
+    constructor(config) {
+        super(config);
+    }
+    /**
+     * Initiate Cancellation Flow
+     * POST /cancellation-funnel/initiate
+     */
+    async initiateCancellation(request) {
+        return this.post('/cancellation-funnel/initiate', request);
+    }
+    /**
+     * Log Pause Offer Response
+     * POST /cancellation-funnel/pause-offer
+     */
+    async logPauseOfferResponse(request) {
+        return this.post('/cancellation-funnel/pause-offer', request);
+    }
+    /**
+     * Log Survey Response
+     * POST /cancellation-funnel/survey
+     */
+    async logSurveyResponse(request) {
+        return this.post('/cancellation-funnel/survey', request);
+    }
+    /**
+     * Get Cancellation Funnel Status
+     * GET /cancellation-funnel/{subscription_id}/status
+     */
+    async getCancellationFunnelStatus(subscriptionId) {
+        return this.get(`/cancellation-funnel/${subscriptionId}/status`);
+    }
+    /**
+     * Get Available Cancellation Offers
+     * GET /cancellation-funnel/{subscription_id}/offers
+     */
+    async getAvailableOffers(subscriptionId) {
+        return this.get(`/cancellation-funnel/${subscriptionId}/offers`);
+    }
+    /**
+     * Complete Cancellation Funnel
+     * POST /cancellation-funnel/{subscription_id}/complete
+     */
+    async completeCancellationFunnel(subscriptionId, finalAction) {
+        return this.post(`/cancellation-funnel/${subscriptionId}/complete`, {
+            final_action: finalAction,
+        });
+    }
+    /**
+     * Get Cancellation Reasons (for survey dropdown)
+     * GET /cancellation-funnel/reasons
+     */
+    async getCancellationReasons() {
+        return this.get('/cancellation-funnel/reasons');
+    }
+    /**
+     * Save Funnel Progress (for multi-step funnels)
+     * PUT /cancellation-funnel/{subscription_id}/progress
+     */
+    async saveFunnelProgress(subscriptionId, progress) {
+        return this.put(`/cancellation-funnel/${subscriptionId}/progress`, progress);
+    }
+    /**
+     * Skip Funnel Step (for optional steps)
+     * POST /cancellation-funnel/{subscription_id}/skip-step
+     */
+    async skipFunnelStep(subscriptionId, stepToSkip) {
+        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, reason) {
+        const params = reason ? `?reason=${encodeURIComponent(reason)}` : '';
+        return this.get(`/cancellation-funnel/${subscriptionId}/retention-offers${params}`);
+    }
+}
+exports.CancellationFunnelService = CancellationFunnelService;

package/dist/services/cancellation-funnel/index.d.ts

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

package/dist/services/cancellation-funnel/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CancellationFunnelService = void 0;
+var cancellation_funnel_service_1 = require("./cancellation-funnel-service");
+Object.defineProperty(exports, "CancellationFunnelService", { enumerable: true, get: function () { return cancellation_funnel_service_1.CancellationFunnelService; } });

package/dist/services/index.d.ts

@@ -6,6 +6,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';
 export * from './generation';
 export * from './projects';
 export * from './usage';
@@ -13,3 +14,4 @@ export * from './repository-analysis';
 export * from './tasks';
 export * from './api-key-enhanced';
 export * from './subscriptions';
+export * from './cancellation-funnel';

package/dist/services/index.js

@@ -17,7 +17,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SubscriptionService = exports.ApiKeyEnhancedService = exports.TaskService = exports.RepositoryAnalysisService = exports.UsageService = exports.ProjectService = exports.GenerationService = exports.BaseService = void 0;
+exports.CancellationFunnelService = exports.SubscriptionService = exports.ApiKeyEnhancedService = exports.TaskService = exports.RepositoryAnalysisService = exports.UsageService = exports.ProjectService = exports.GenerationService = exports.BaseService = void 0;
 const dotenv_1 = __importDefault(require("dotenv"));
 const path_1 = __importDefault(require("path"));
 // Load environment variables from project root
@@ -41,6 +41,8 @@ var api_key_enhanced_1 = require("./api-key-enhanced");
 Object.defineProperty(exports, "ApiKeyEnhancedService", { enumerable: true, get: function () { return api_key_enhanced_1.ApiKeyEnhancedService; } });
 var subscriptions_1 = require("./subscriptions");
 Object.defineProperty(exports, "SubscriptionService", { enumerable: true, get: function () { return subscriptions_1.SubscriptionService; } });
+var cancellation_funnel_1 = require("./cancellation-funnel");
+Object.defineProperty(exports, "CancellationFunnelService", { enumerable: true, get: function () { return cancellation_funnel_1.CancellationFunnelService; } });
 // Re-export all types for convenience
 __exportStar(require("./generation"), exports);
 __exportStar(require("./projects"), exports);
@@ -49,3 +51,4 @@ __exportStar(require("./repository-analysis"), exports);
 __exportStar(require("./tasks"), exports);
 __exportStar(require("./api-key-enhanced"), exports);
 __exportStar(require("./subscriptions"), exports);
+__exportStar(require("./cancellation-funnel"), exports);

package/dist/types.d.ts

@@ -150,3 +150,58 @@ export interface CancelSubscriptionResponse {
     message: string;
     data: Subscription;
 }
+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;
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codeguide/core",
-  "version": "0.0.7",
+  "version": "0.0.9",
   "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: finalAction,
+    })
+  }
+
+  /**
+   * 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
+  }
+}