@codeguide/core 0.0.6 → 0.0.8

package/dist/services/subscriptions/subscription-service.d.ts

@@ -0,0 +1,103 @@
+import { BaseService } from '../base/base-service';
+import { CurrentSubscriptionResponse, UserSubscriptionsResponse, CancelSubscriptionRequest, CancelSubscriptionResponse } from '../../types';
+export declare class SubscriptionService extends BaseService {
+    constructor(config: any);
+    /**
+     * Get the currently active subscription for the authenticated user
+     * GET /subscriptions/current
+     */
+    getCurrentSubscription(): Promise<CurrentSubscriptionResponse>;
+    /**
+     * Get all subscriptions (active and historical) for the authenticated user
+     * GET /subscriptions/
+     */
+    getAllSubscriptions(): Promise<UserSubscriptionsResponse>;
+    /**
+     * Cancel subscription but keep it active until the end of the current billing period
+     * POST /subscriptions/{subscription_id}/cancel
+     */
+    cancelSubscription(subscriptionId: string, request: CancelSubscriptionRequest): Promise<CancelSubscriptionResponse>;
+    /**
+     * Get subscription details by ID
+     * GET /subscriptions/{subscription_id}
+     */
+    getSubscriptionById(subscriptionId: string): Promise<{
+        status: string;
+        data: {
+            subscription: any;
+            product: any;
+            price: any;
+        };
+    }>;
+    /**
+     * Reactivate a canceled subscription (if supported by API)
+     * POST /subscriptions/{subscription_id}/reactivate
+     */
+    reactivateSubscription(subscriptionId: string): Promise<{
+        status: string;
+        message: string;
+        data: any;
+    }>;
+    /**
+     * Update subscription quantity or other parameters
+     * PUT /subscriptions/{subscription_id}
+     */
+    updateSubscription(subscriptionId: string, updates: {
+        quantity?: number;
+        metadata?: Record<string, any>;
+    }): Promise<{
+        status: string;
+        data: any;
+    }>;
+    /**
+     * Get subscription usage statistics (if supported by API)
+     * GET /subscriptions/{subscription_id}/usage
+     */
+    getSubscriptionUsage(subscriptionId: string): Promise<{
+        status: string;
+        data: {
+            current_usage: number;
+            limit: number;
+            period_start: string;
+            period_end: string;
+            usage_breakdown?: Array<{
+                feature: string;
+                used: number;
+                limit: number;
+            }>;
+        };
+    }>;
+    /**
+     * Get upcoming invoice for subscription
+     * GET /subscriptions/{subscription_id}/upcoming-invoice
+     */
+    getUpcomingInvoice(subscriptionId: string): Promise<{
+        status: string;
+        data: {
+            amount: number;
+            currency: string;
+            date: string;
+            line_items: Array<{
+                description: string;
+                amount: number;
+                currency: string;
+            }>;
+        };
+    }>;
+    /**
+     * Get subscription history and payments
+     * GET /subscriptions/{subscription_id}/history
+     */
+    getSubscriptionHistory(subscriptionId: string): Promise<{
+        status: string;
+        data: Array<{
+            id: string;
+            type: 'payment' | 'invoice' | 'refund';
+            amount: number;
+            currency: string;
+            status: string;
+            created: string;
+            description?: string;
+        }>;
+    }>;
+}

package/dist/services/subscriptions/subscription-service.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SubscriptionService = void 0;
+const base_service_1 = require("../base/base-service");
+class SubscriptionService extends base_service_1.BaseService {
+    constructor(config) {
+        super(config);
+    }
+    /**
+     * Get the currently active subscription for the authenticated user
+     * GET /subscriptions/current
+     */
+    async getCurrentSubscription() {
+        return this.get('/subscriptions/current');
+    }
+    /**
+     * Get all subscriptions (active and historical) for the authenticated user
+     * GET /subscriptions/
+     */
+    async getAllSubscriptions() {
+        return this.get('/subscriptions/');
+    }
+    /**
+     * Cancel subscription but keep it active until the end of the current billing period
+     * POST /subscriptions/{subscription_id}/cancel
+     */
+    async cancelSubscription(subscriptionId, request) {
+        return this.post(`/subscriptions/${subscriptionId}/cancel`, request);
+    }
+    /**
+     * Get subscription details by ID
+     * GET /subscriptions/{subscription_id}
+     */
+    async getSubscriptionById(subscriptionId) {
+        return this.get(`/subscriptions/${subscriptionId}`);
+    }
+    /**
+     * Reactivate a canceled subscription (if supported by API)
+     * POST /subscriptions/{subscription_id}/reactivate
+     */
+    async reactivateSubscription(subscriptionId) {
+        return this.post(`/subscriptions/${subscriptionId}/reactivate`, {});
+    }
+    /**
+     * Update subscription quantity or other parameters
+     * PUT /subscriptions/{subscription_id}
+     */
+    async updateSubscription(subscriptionId, updates) {
+        return this.put(`/subscriptions/${subscriptionId}`, updates);
+    }
+    /**
+     * Get subscription usage statistics (if supported by API)
+     * GET /subscriptions/{subscription_id}/usage
+     */
+    async getSubscriptionUsage(subscriptionId) {
+        return this.get(`/subscriptions/${subscriptionId}/usage`);
+    }
+    /**
+     * Get upcoming invoice for subscription
+     * GET /subscriptions/{subscription_id}/upcoming-invoice
+     */
+    async getUpcomingInvoice(subscriptionId) {
+        return this.get(`/subscriptions/${subscriptionId}/upcoming-invoice`);
+    }
+    /**
+     * Get subscription history and payments
+     * GET /subscriptions/{subscription_id}/history
+     */
+    async getSubscriptionHistory(subscriptionId) {
+        return this.get(`/subscriptions/${subscriptionId}/history`);
+    }
+}
+exports.SubscriptionService = SubscriptionService;

package/dist/types.d.ts

@@ -42,31 +42,111 @@ export interface CodeGuideOptions {
 }
 export interface ApiKey {
     id: string;
+    key: string;
+    user_id: string;
     name: string;
-    prefix: string;
     created_at: string;
-    last_used?: string;
+    expires_at?: string;
     is_active: boolean;
-    usage_count?: number;
+    metadata?: Record<string, any>;
+}
+export interface ApiKeyListResponse {
+    status: string;
+    data: ApiKey[];
 }
 export interface CreateApiKeyRequest {
     name: string;
 }
 export interface CreateApiKeyResponse {
-    api_key: string;
+    status: string;
+    data: {
+        api_key: string;
+        id: string;
+        name: string;
+        created_at: string;
+        expires_at?: string;
+        is_active: boolean;
+        metadata?: Record<string, any>;
+    };
+    message?: string;
+}
+export interface ApiKeyPermissionResponse {
+    status: string;
+    data: {
+        can_create: boolean;
+        reason?: string;
+        current_keys_count?: number;
+        max_keys_allowed?: number;
+    };
+}
+export interface ApiKeyResponse {
+    status: string;
+    data: ApiKey;
+}
+export interface RevokeApiKeyResponse {
+    status: string;
+    message: string;
+    revoked_key_id?: string;
+}
+export interface Subscription {
     id: string;
+    user_id: string;
+    status: 'active' | 'canceled' | 'past_due' | 'unpaid' | 'trialing' | 'incomplete' | 'incomplete_expired';
+    metadata: Record<string, any>;
+    price_id: string;
+    quantity: number;
+    cancel_at_period_end: boolean;
+    created: string;
+    current_period_start: string;
+    current_period_end: string;
+    ended_at?: string | null;
+    cancel_at?: string | null;
+    canceled_at?: string | null;
+    trial_start?: string | null;
+    trial_end?: string | null;
+    org_id?: string | null;
+}
+export interface Product {
+    id: string;
+    active: boolean;
     name: string;
-    prefix: string;
-    created_at: string;
-    message: string;
+    description: string;
+    image: string;
+    metadata: Record<string, any>;
+    marketing_features: string[];
+    live_mode: boolean;
+    is_team_plan: boolean;
+}
+export interface Price {
+    id: string;
+    product_id: string;
+    active: boolean;
+    description: string;
+    unit_amount: number;
+    currency: string;
+    type: 'recurring' | 'one_time';
+    interval: 'day' | 'week' | 'month' | 'year';
+    interval_count: number;
+    trial_period_days?: number | null;
+    metadata?: Record<string, any> | null;
 }
-export interface ApiKeyPermission {
-    can_create: boolean;
-    reason?: string;
-    current_keys_count?: number;
-    max_keys_allowed?: number;
+export interface CurrentSubscriptionResponse {
+    status: string;
+    data: {
+        subscription: Subscription;
+        product: Product;
+        price: Price;
+    };
 }
-export interface RevokeApiKeyResponse {
+export interface UserSubscriptionsResponse {
+    status: string;
+    data: Subscription[];
+}
+export interface CancelSubscriptionRequest {
+    cancel_at_period_end: boolean;
+}
+export interface CancelSubscriptionResponse {
+    status: string;
     message: string;
-    revoked_key_id: string;
+    data: Subscription;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codeguide/core",
-  "version": "0.0.6",
+  "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

@@ -14,6 +14,8 @@ export { UsageService } from './usage'
 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'
@@ -22,3 +24,5 @@ export * from './usage'
 export * from './repository-analysis'
 export * from './tasks'
 export * from './api-key-enhanced'
+export * from './subscriptions'
+export * from './cancellation-funnel'

package/services/subscriptions/index.ts

@@ -0,0 +1 @@
+export { SubscriptionService } from './subscription-service'