@nordsym/apiclaw 1.0.0

package/src/webhooks/revenuecat.ts

@@ -0,0 +1,187 @@
+// RevenueCat webhook handler for APIClaw
+// Handles subscription lifecycle events and syncs to Convex
+
+import { Hono } from 'hono';
+
+const CONVEX_URL = process.env.CONVEX_URL || 'https://agile-crane-840.convex.cloud';
+
+// RevenueCat webhook event types
+type WebhookEventType = 
+  | 'INITIAL_PURCHASE'
+  | 'RENEWAL'
+  | 'CANCELLATION'
+  | 'UNCANCELLATION'
+  | 'NON_RENEWING_PURCHASE'
+  | 'SUBSCRIPTION_PAUSED'
+  | 'SUBSCRIPTION_EXTENDED'
+  | 'EXPIRATION'
+  | 'BILLING_ISSUE'
+  | 'PRODUCT_CHANGE'
+  | 'TRANSFER';
+
+interface RevenueCatWebhookEvent {
+  api_version: string;
+  event: {
+    type: WebhookEventType;
+    id: string;
+    app_id: string;
+    app_user_id: string;
+    original_app_user_id: string;
+    aliases: string[];
+    product_id: string;
+    entitlement_ids: string[];
+    period_type: string;
+    purchased_at_ms: number;
+    expiration_at_ms: number | null;
+    environment: 'SANDBOX' | 'PRODUCTION';
+    store: string;
+    is_trial_conversion?: boolean;
+    cancel_reason?: string;
+    price_in_purchased_currency?: number;
+    currency?: string;
+  };
+}
+
+interface UserSubscriptionUpdate {
+  userId: string;
+  isPro: boolean;
+  subscriptionStatus: 'active' | 'cancelled' | 'expired' | 'paused' | 'billing_issue';
+  productId: string | null;
+  expiresAt: number | null;
+  updatedAt: number;
+  eventType: WebhookEventType;
+}
+
+/**
+ * Update user subscription status in Convex
+ */
+async function updateConvexUser(update: UserSubscriptionUpdate): Promise<boolean> {
+  try {
+    const response = await fetch(`${CONVEX_URL}/api/mutation`, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+      },
+      body: JSON.stringify({
+        path: 'users:updateSubscription',
+        args: update,
+      }),
+    });
+
+    if (!response.ok) {
+      console.error('Convex update failed:', await response.text());
+      return false;
+    }
+
+    return true;
+  } catch (error) {
+    console.error('Error updating Convex:', error);
+    return false;
+  }
+}
+
+/**
+ * Process webhook event and determine subscription state
+ */
+function processEvent(event: RevenueCatWebhookEvent['event']): UserSubscriptionUpdate {
+  const now = Date.now();
+  const expiresAt = event.expiration_at_ms;
+  const isExpired = expiresAt ? expiresAt < now : false;
+
+  let subscriptionStatus: UserSubscriptionUpdate['subscriptionStatus'] = 'active';
+  let isPro = true;
+
+  switch (event.type) {
+    case 'INITIAL_PURCHASE':
+    case 'RENEWAL':
+    case 'UNCANCELLATION':
+    case 'SUBSCRIPTION_EXTENDED':
+      subscriptionStatus = 'active';
+      isPro = true;
+      break;
+    
+    case 'CANCELLATION':
+      // Still active until expiration
+      subscriptionStatus = 'cancelled';
+      isPro = !isExpired;
+      break;
+    
+    case 'EXPIRATION':
+      subscriptionStatus = 'expired';
+      isPro = false;
+      break;
+    
+    case 'SUBSCRIPTION_PAUSED':
+      subscriptionStatus = 'paused';
+      isPro = false;
+      break;
+    
+    case 'BILLING_ISSUE':
+      subscriptionStatus = 'billing_issue';
+      // Keep Pro until grace period ends
+      isPro = !isExpired;
+      break;
+    
+    case 'PRODUCT_CHANGE':
+    case 'TRANSFER':
+      subscriptionStatus = 'active';
+      isPro = event.entitlement_ids.includes('pro');
+      break;
+    
+    default:
+      isPro = event.entitlement_ids.includes('pro') && !isExpired;
+  }
+
+  return {
+    userId: event.app_user_id,
+    isPro,
+    subscriptionStatus,
+    productId: event.product_id,
+    expiresAt: expiresAt,
+    updatedAt: now,
+    eventType: event.type,
+  };
+}
+
+/**
+ * Create Hono router for webhook handling
+ */
+export function createWebhookRouter(): Hono {
+  const app = new Hono();
+
+  // Health check
+  app.get('/webhooks/revenuecat/health', (c) => {
+    return c.json({ status: 'ok', service: 'revenuecat-webhook' });
+  });
+
+  // RevenueCat webhook endpoint
+  app.post('/webhooks/revenuecat', async (c) => {
+    try {
+      const body = await c.req.json<RevenueCatWebhookEvent>();
+      
+      console.log(`[RevenueCat] Received ${body.event.type} for user ${body.event.app_user_id}`);
+
+      // Process the event
+      const update = processEvent(body.event);
+
+      // Update Convex
+      const success = await updateConvexUser(update);
+
+      if (success) {
+        console.log(`[RevenueCat] Updated user ${update.userId}: isPro=${update.isPro}`);
+        return c.json({ success: true });
+      } else {
+        return c.json({ success: false, error: 'Failed to update database' }, 500);
+      }
+    } catch (error) {
+      console.error('[RevenueCat] Webhook error:', error);
+      return c.json({ success: false, error: 'Internal error' }, 500);
+    }
+  });
+
+  return app;
+}
+
+// Export for testing
+export { processEvent, updateConvexUser };
+export type { RevenueCatWebhookEvent, UserSubscriptionUpdate };

package/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "lib": ["ES2022"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}