@capivv/mcp-server 0.2.0 → 0.5.1

package/dist/types.d.ts

@@ -52,6 +52,22 @@ export interface Product {
     metadata: Record<string, unknown>;
     created_at: string;
     updated_at: string;
+    /**
+     * Present only when the create call also wrote to the connected store
+     * (App Store Connect / Google Play). Carries the store-side product ID
+     * and the snapped-price audit so the AI can communicate tier deltas.
+     */
+    store_create?: StoreCreateSummary;
+}
+export interface StoreCreateSummary {
+    store: 'apple' | 'google';
+    store_product_id: string;
+    snapped_prices: Array<{
+        currency: string;
+        requested_cents: number;
+        actual_cents: number;
+        price_point_id?: string;
+    }>;
 }
 export interface Entitlement {
     id: string;
@@ -217,4 +233,324 @@ export interface CreateProductRequest {
         amount_cents: number;
         is_default?: boolean;
     }>;
+    /**
+     * V8 Phase A: when true (default) and a store integration is connected
+     * for the app's platform, the API also creates the matching product in
+     * App Store Connect / Google Play. Send false to opt out.
+     */
+    also_create_in_store?: boolean;
+    /** Default product locale for store-side localizations. Defaults to "en-US". */
+    default_locale?: string;
+}
+export interface Paywall {
+    id: string;
+    name: string;
+    identifier: string;
+    paywall_type: string;
+    status: string;
+    template: string | null;
+    total_views: number;
+    total_conversions: number;
+    conversion_rate: number;
+    config: Record<string, unknown>;
+    generated_by?: string | null;
+    created_at: string;
+}
+export interface CreatePaywallRequest {
+    app_id: string;
+    name: string;
+    identifier: string;
+    paywall_type: string;
+}
+export interface UpdatePaywallRequest {
+    name?: string;
+    template?: string;
+    config?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+}
+export interface PaywallStats {
+    total_views: number;
+    total_conversions: number;
+    average_conversion_rate: number;
+}
+export interface Promotion {
+    id: string;
+    name: string;
+    description: string | null;
+    campaign_type: string;
+    status: string;
+    discount_percent: number;
+    starts_at: string;
+    ends_at: string;
+    max_redemptions: number | null;
+    current_redemptions: number;
+    revenue_micros: number;
+    generated_by?: string | null;
+    created_at: string;
+}
+export interface CreatePromotionRequest {
+    name: string;
+    identifier?: string;
+    description?: string;
+    campaign_type: string;
+    discount_percent?: number;
+    starts_at?: string;
+    ends_at?: string;
+    max_redemptions?: number;
+}
+export interface UpdatePromotionRequest {
+    name?: string;
+    description?: string;
+    discount_percent?: number;
+    max_redemptions?: number;
+}
+export interface RescueFlow {
+    id: string;
+    name: string;
+    identifier: string;
+    description: string | null;
+    status: string;
+    priority: number;
+    conditions: Record<string, unknown>;
+    steps: Record<string, unknown>;
+    metadata: Record<string, unknown>;
+    generated_by?: string | null;
+    created_at: string;
+}
+export interface CreateRescueFlowRequest {
+    name: string;
+    identifier: string;
+    description?: string;
+    priority?: number;
+}
+export interface UpdateRescueFlowRequest {
+    name?: string;
+    description?: string;
+    priority?: number;
+    conditions?: Record<string, unknown>;
+    steps?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+}
+export interface RescueStats {
+    total_rescue_attempts: number;
+    successful_rescues: number;
+    rescue_rate: number;
+    total_recovered_revenue_micros: number;
+    total_recovered_revenue_formatted: string;
+}
+export interface PricingStrategy {
+    id: string;
+    app_id: string;
+    name: string;
+    w_ppp?: number;
+    w_bigmac?: number;
+    w_fx_neutral?: number;
+    max_auto_change_pct?: number;
+    max_auto_decrease_pct?: number;
+    excluded_countries?: string[];
+    created_at: string;
+    updated_at: string;
+}
+export interface CreatePricingStrategyRequest {
+    app_id: string;
+    name: string;
+    w_ppp?: number;
+    w_bigmac?: number;
+    w_fx_neutral?: number;
+    tier1_min_aff?: number;
+    tier1_max_aff?: number;
+    tier2_min_aff?: number;
+    tier2_max_aff?: number;
+    tier3_min_aff?: number;
+    tier3_max_aff?: number;
+    tier4_min_aff?: number;
+    tier4_max_aff?: number;
+    anti_arbitrage_floor_factor?: number;
+    max_auto_change_pct?: number;
+    max_auto_decrease_pct?: number;
+    excluded_countries?: string[];
+}
+export interface PricingPreviewResult {
+    [key: string]: unknown;
+}
+export interface PricingRecomputeRequest {
+    product_id?: string;
+    strategy_id?: string;
+    reason?: string;
+}
+export interface PricingRecomputeResult {
+    prices_applied?: number;
+    approval_required?: number;
+    change_request_ids?: string[];
+    skipped?: number;
+    products_processed?: number;
+}
+export interface PricingPushResult {
+    pushed: number;
+    failed: number;
+    skipped: number;
+}
+export interface PricingChangeRequest {
+    id: string;
+    product_id: string;
+    app_id: string;
+    status: string;
+    country_code: string;
+    store: string;
+    currency: string;
+    old_amount_cents: number | null;
+    new_amount_cents: number;
+    delta_pct: number;
+    reason: string;
+    created_at: string;
+}
+export interface SetCountryPriceOverrideRequest {
+    product_id: string;
+    country_code: string;
+    store: string;
+    currency: string;
+    amount_cents: number;
+}
+export interface ExperimentWithVariants {
+    id: string;
+    name: string;
+    description: string | null;
+    status: string;
+    target_metric: string;
+    start_date: string | null;
+    end_date: string | null;
+    confidence_level: number;
+    variants: ExperimentVariant[];
+    generated_by?: string | null;
+    created_at: string;
+}
+export interface ExperimentVariant {
+    id: string;
+    name: string;
+    is_control: boolean;
+    traffic_percent: number;
+    sample_size: number;
+    conversion_count: number;
+    conversion_rate: number | null;
+    uplift_percent: number | null;
+    status: string;
+    p_value: number | null;
+    confidence_level: number | null;
+    confidence_interval_low: number | null;
+    confidence_interval_high: number | null;
+    is_statistically_significant: boolean;
+    recommendation: string | null;
+    z_score: number | null;
+}
+export interface CreateExperimentRequest {
+    name: string;
+    description?: string;
+    target_metric: string;
+    entity_type?: string;
+    entity_id?: string;
+    start_date?: string;
+    end_date?: string;
+    sample_size_target?: number;
+    confidence_level?: number;
+    metadata?: Record<string, unknown>;
+    variants: Array<{
+        name: string;
+        is_control: boolean;
+        traffic_percent: number;
+        config?: Record<string, unknown>;
+    }>;
+}
+export interface UpdateExperimentRequest {
+    name?: string;
+    description?: string;
+    status?: string;
+    target_metric?: string;
+    start_date?: string;
+    end_date?: string;
+    sample_size_target?: number;
+    confidence_level?: number;
+    metadata?: Record<string, unknown>;
+}
+export interface UpdateAppRequest {
+    name?: string;
+    bundle_id?: string;
+    settings?: Record<string, unknown>;
+}
+export interface UpdateEntitlementRequest {
+    identifier?: string;
+    display_name?: string;
+    description?: string;
+}
+export interface UpdateOfferingRequest {
+    display_name?: string;
+    description?: string;
+    is_default?: boolean;
+    packages?: Array<{
+        identifier: string;
+        product_id: string;
+        display_name: string;
+        description?: string;
+        package_type: string;
+        position: number;
+    }>;
+    metadata?: Record<string, unknown>;
+}
+export interface AutopilotRunResult {
+    [key: string]: unknown;
+}
+export interface SyncSuggestion {
+    id: string;
+    suggestion_type: string;
+    status: string;
+    store_product_id: string;
+    store_product_name?: string | null;
+    store_product_type?: string | null;
+    store_price?: string | null;
+    store_group_name?: string | null;
+    store_source: string;
+    product_id?: string | null;
+    diff_details: Record<string, unknown>;
+    resolved_at?: string | null;
+    created_at: string;
+}
+export interface SyncSuggestionsCount {
+    pending: number;
+}
+export interface TriggerSyncResult {
+    triggered: number;
+    message: string;
+}
+export interface IntegrationSummary {
+    provider: string;
+    provider_name: string;
+    status: string;
+    is_connected: boolean;
+    last_sync_at?: string | null;
+    has_error: boolean;
+    error_message?: string | null;
+}
+export interface ConnectAppleIntegrationRequest {
+    issuer_id: string;
+    key_id: string;
+    /** PEM-encoded App Store Connect API private key (.p8 contents). */
+    private_key: string;
+    /** Optional legacy shared secret for verifyReceipt fallback. */
+    shared_secret?: string;
+}
+export interface ConnectAppleIntegrationResult {
+    status: string;
+    app_count: number;
+}
+export interface ConnectGoogleIntegrationRequest {
+    /** Service account JSON key (raw contents, not a file path). */
+    service_account_json: string;
+    package_names: string[];
+}
+export interface ConnectGoogleIntegrationResult {
+    status: string;
+    validated_packages: string[];
+    errors: Array<{
+        package_name: string;
+        error: string;
+    }>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capivv/mcp-server",
-  "version": "0.2.0",
+  "version": "0.5.1",
   "description": "MCP server for managing Capivv subscription platform via AI assistants",
   "type": "module",
   "bin": {