@codeguide/core 0.0.8 → 0.0.9

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.8",
+  "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

@@ -132,7 +132,7 @@ export class CancellationFunnelService extends BaseService {
     }
   }> {
     return this.post(`/cancellation-funnel/${subscriptionId}/complete`, {
-      final_action,
+      final_action: finalAction,
     })
   }