@capivv/mcp-server 0.5.11 → 0.5.13

package/dist/client.d.ts

@@ -1,5 +1,5 @@
 import type { Config } from './config.js';
-import type { App, Product, Entitlement, Offering, Rule, Experiment, ExperimentSummary, AnalyticsOverview, OnboardingResponse, ImportPreviewResponse, CreateAppRequest, CreateEntitlementRequest, CreateProductRequest, CreateOfferingRequest, CreateRuleRequest, ValidateRuleRequest, ValidateRuleResponse, WhoamiResponse, ApiKeyUsageResponse, Paywall, CreatePaywallRequest, UpdatePaywallRequest, PaywallStats, Promotion, CreatePromotionRequest, UpdatePromotionRequest, RescueFlow, CreateRescueFlowRequest, UpdateRescueFlowRequest, RescueStats, PricingStrategy, CreatePricingStrategyRequest, PricingPreviewResult, PricingRecomputeRequest, PricingRecomputeResult, PricingPushResult, PricingChangeRequest, SetCountryPriceOverrideRequest, ExperimentWithVariants, CreateExperimentRequest, UpdateExperimentRequest, UpdateAppRequest, UpdateEntitlementRequest, UpdateOfferingRequest, AutopilotRunResult, SyncSuggestion, SyncSuggestionsCount, TriggerSyncResult, IntegrationSummary, ConnectAppleIntegrationRequest, ConnectAppleIntegrationResult, ConnectGoogleIntegrationRequest, ConnectGoogleIntegrationResult, SetSubscriptionReviewScreenshotRequest, SetSubscriptionReviewScreenshotResult, SubscriptionStateInfo, TouchSubscriptionResult, ProbeSubmissionRequest, ProbeSubmissionResult, SetAppPrivacyUrlRequest, SetAppPrivacyUrlResult, SetIapReviewScreenshotRequest, SetIapReviewScreenshotResult, IapStateInfo } from './types.js';
+import type { App, Product, Entitlement, Offering, Rule, Experiment, ExperimentSummary, AnalyticsOverview, OnboardingResponse, ImportPreviewResponse, CreateAppRequest, CreateEntitlementRequest, CreateProductRequest, CreateOfferingRequest, CreateRuleRequest, ValidateRuleRequest, ValidateRuleResponse, WhoamiResponse, ApiKeyUsageResponse, Paywall, CreatePaywallRequest, UpdatePaywallRequest, PaywallStats, Promotion, CreatePromotionRequest, UpdatePromotionRequest, RescueFlow, CreateRescueFlowRequest, UpdateRescueFlowRequest, RescueStats, PricingStrategy, CreatePricingStrategyRequest, PricingPreviewResult, PricingRecomputeRequest, PricingRecomputeResult, PricingPushResult, PricingChangeRequest, SetCountryPriceOverrideRequest, ExperimentWithVariants, CreateExperimentRequest, UpdateExperimentRequest, UpdateAppRequest, UpdateEntitlementRequest, UpdateOfferingRequest, AutopilotRunResult, SyncSuggestion, SyncSuggestionsCount, TriggerSyncResult, IntegrationSummary, ConnectAppleIntegrationRequest, ConnectAppleIntegrationResult, ConnectGoogleIntegrationRequest, ConnectGoogleIntegrationResult, SetSubscriptionReviewScreenshotRequest, SetSubscriptionReviewScreenshotResult, SubscriptionStateInfo, TouchSubscriptionResult, ProbeSubmissionRequest, ProbeSubmissionResult, SetAppPrivacyUrlRequest, SetAppPrivacyUrlResult, SetIapReviewScreenshotRequest, SetIapReviewScreenshotResult, IapStateInfo, ListAppleSubscriptionsResult, ListAppleIapsResult, DeleteAppleResult } from './types.js';
 export declare class ApiError extends Error {
     status: number;
     code: string;
@@ -98,4 +98,8 @@ export declare class CapivvClient {
     setAppPrivacyUrl(req: SetAppPrivacyUrlRequest): Promise<SetAppPrivacyUrlResult>;
     setIapReviewScreenshot(req: SetIapReviewScreenshotRequest): Promise<SetIapReviewScreenshotResult>;
     getIapState(appleIapId: string): Promise<IapStateInfo>;
+    listAppleSubscriptions(appId: string): Promise<ListAppleSubscriptionsResult>;
+    listAppleIaps(appId: string): Promise<ListAppleIapsResult>;
+    deleteAppleSubscription(appleSubscriptionId: string): Promise<DeleteAppleResult>;
+    deleteAppleIap(appleIapId: string): Promise<DeleteAppleResult>;
 }

package/dist/client.js

@@ -365,4 +365,17 @@ export class CapivvClient {
     async getIapState(appleIapId) {
         return this.get(`/dashboard/iap/${encodeURIComponent(appleIapId)}/state`);
     }
+    // ---- V0.5.12 — Orphan recovery ----
+    async listAppleSubscriptions(appId) {
+        return this.get(`/dashboard/apps/${encodeURIComponent(appId)}/apple/subscriptions`);
+    }
+    async listAppleIaps(appId) {
+        return this.get(`/dashboard/apps/${encodeURIComponent(appId)}/apple/iaps`);
+    }
+    async deleteAppleSubscription(appleSubscriptionId) {
+        return this.delete(`/dashboard/subscriptions/${encodeURIComponent(appleSubscriptionId)}`);
+    }
+    async deleteAppleIap(appleIapId) {
+        return this.delete(`/dashboard/iap/${encodeURIComponent(appleIapId)}`);
+    }
 }

package/dist/tools/delete-apple-iap.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { CapivvClient } from '../client.js';
+export declare function registerDeleteAppleIapTool(server: McpServer, client: CapivvClient): void;

package/dist/tools/delete-apple-iap.js

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+export function registerDeleteAppleIapTool(server, client) {
+    server.tool('capivv_delete_apple_iap', [
+        "Delete an in-app purchase from App Store Connect. Use this to clean up orphans left by a failed capivv_create_product.",
+        '',
+        "**Destructive.** Apple returns 204 on delete and 404 on already-deleted (treated as success).",
+        '',
+        "**Apple productID cooldown — important.** Apple holds the deleted productId reserved for ~90 days. After deleting, recreating with the SAME productId will 409 DUPLICATE until the cooldown expires. If you need to recreate immediately, use a new productId (e.g. append `_v2`) — the alternative is waiting 90 days.",
+        '',
+        'Get apple_iap_id from capivv_list_apple_iaps or App Store Connect.',
+    ].join(' '), {
+        apple_iap_id: z
+            .string()
+            .describe('Apple in-app purchase ID (e.g. "6765812345") — NOT the Capivv product UUID.'),
+    }, async ({ apple_iap_id }) => {
+        const result = await client.deleteAppleIap(apple_iap_id);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    });
+}

package/dist/tools/delete-apple-subscription.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { CapivvClient } from '../client.js';
+export declare function registerDeleteAppleSubscriptionTool(server: McpServer, client: CapivvClient): void;

package/dist/tools/delete-apple-subscription.js

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+export function registerDeleteAppleSubscriptionTool(server, client) {
+    server.tool('capivv_delete_apple_subscription', [
+        "Delete a subscription from App Store Connect. Use this to clean up orphans left by a failed capivv_create_product (where Apple created the resource but Capivv rolled back).",
+        '',
+        "**Destructive.** Apple's API returns 204 on delete and 404 on already-deleted (treated as success). Once deleted the subscription is gone from ASC.",
+        '',
+        "**Apple productID cooldown — important.** Apple holds the deleted productId reserved for ~90 days. After deleting, recreating with the SAME productId will 409 DUPLICATE until the cooldown expires. If you need to recreate immediately, use a new productId (e.g. append `_v2`) — the alternative is waiting 90 days.",
+        '',
+        'Get apple_subscription_id from capivv_list_apple_subscriptions or App Store Connect.',
+    ].join(' '), {
+        apple_subscription_id: z
+            .string()
+            .describe('Apple subscription ID (e.g. "6764778053") — NOT the Capivv product UUID.'),
+    }, async ({ apple_subscription_id }) => {
+        const result = await client.deleteAppleSubscription(apple_subscription_id);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    });
+}

package/dist/tools/index.js

@@ -79,6 +79,10 @@ import { registerProbeSubmissionTool } from './probe-submission.js';
 import { registerSetAppPrivacyUrlTool } from './set-app-privacy-url.js';
 import { registerSetIapReviewScreenshotTool } from './set-iap-review-screenshot.js';
 import { registerGetIapStateTool } from './get-iap-state.js';
+import { registerListAppleSubscriptionsTool } from './list-apple-subscriptions.js';
+import { registerListAppleIapsTool } from './list-apple-iaps.js';
+import { registerDeleteAppleSubscriptionTool } from './delete-apple-subscription.js';
+import { registerDeleteAppleIapTool } from './delete-apple-iap.js';
 export function registerAllTools(server, client) {
     // Identity — call this first to verify which workspace you're connected to
     registerWhoamiTool(server, client);
@@ -201,4 +205,12 @@ export function registerAllTools(server, client) {
     registerSetIapReviewScreenshotTool(server, client);
     // V0.5.11 — IAP state probe (mirror of get_subscription_state).
     registerGetIapStateTool(server, client);
+    // V0.5.12 — orphan recovery (list/delete on the Apple side for
+    // both subs and IAPs). Pairs with capivv_create_product's roll-back
+    // path: when ASC creates the resource but Capivv side rolls back,
+    // these tools let the agent find and clean up the leftover.
+    registerListAppleSubscriptionsTool(server, client);
+    registerListAppleIapsTool(server, client);
+    registerDeleteAppleSubscriptionTool(server, client);
+    registerDeleteAppleIapTool(server, client);
 }

package/dist/tools/list-apple-iaps.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { CapivvClient } from '../client.js';
+export declare function registerListAppleIapsTool(server: McpServer, client: CapivvClient): void;

package/dist/tools/list-apple-iaps.js

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+export function registerListAppleIapsTool(server, client) {
+    server.tool('capivv_list_apple_iaps', [
+        "List every in-app purchase (consumable / non-consumable) on the connected Apple App Store Connect account for a Capivv app.",
+        '',
+        "Returns Apple iap_id, productId, name, lifecycle state, and inAppPurchaseType for each. Use this to spot orphan IAPs Apple created during a failed capivv_create_product (so you can delete them with capivv_delete_apple_iap, or recover them with capivv_create_product + skip_store_write=true).",
+    ].join(' '), {
+        app_id: z.string().describe('Capivv app UUID.'),
+    }, async ({ app_id }) => {
+        const result = await client.listAppleIaps(app_id);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    });
+}

package/dist/tools/list-apple-subscriptions.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { CapivvClient } from '../client.js';
+export declare function registerListAppleSubscriptionsTool(server: McpServer, client: CapivvClient): void;

package/dist/tools/list-apple-subscriptions.js

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+export function registerListAppleSubscriptionsTool(server, client) {
+    server.tool('capivv_list_apple_subscriptions', [
+        "List every subscription on the connected Apple App Store Connect account for a Capivv app.",
+        '',
+        'Returns Apple subscription_id, productId, name, and lifecycle state for each — enough to spot orphans left by failed capivv_create_product attempts (e.g. a subscription Apple created but Capivv rolled back). Pair with capivv_delete_apple_subscription to clean orphans up.',
+    ].join(' '), {
+        app_id: z.string().describe('Capivv app UUID.'),
+    }, async ({ app_id }) => {
+        const result = await client.listAppleSubscriptions(app_id);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    });
+}

package/dist/types.d.ts

@@ -660,3 +660,15 @@ export interface IapStateInfo {
     /** "CONSUMABLE" / "NON_CONSUMABLE". */
     in_app_purchase_type: string | null;
 }
+export interface ListAppleSubscriptionsResult {
+    bundle_id: string;
+    subscriptions: SubscriptionStateInfo[];
+}
+export interface ListAppleIapsResult {
+    bundle_id: string;
+    iaps: IapStateInfo[];
+}
+export interface DeleteAppleResult {
+    deleted: boolean;
+    apple_id: string;
+}

package/package.json

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