@nordsym/apiclaw 1.0.0

package/dist/webhooks/revenuecat.js

@@ -0,0 +1,119 @@
+// 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';
+/**
+ * Update user subscription status in Convex
+ */
+async function updateConvexUser(update) {
+    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) {
+    const now = Date.now();
+    const expiresAt = event.expiration_at_ms;
+    const isExpired = expiresAt ? expiresAt < now : false;
+    let 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() {
+    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();
+            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 };
+//# sourceMappingURL=revenuecat.js.map

package/dist/webhooks/revenuecat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"revenuecat.js","sourceRoot":"","sources":["../../src/webhooks/revenuecat.ts"],"names":[],"mappings":"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"}

package/docs/revenuecat-setup.md

@@ -0,0 +1,89 @@
+# APIClaw RevenueCat Setup
+
+## Current Status ✅
+
+**Entitlement Created:**
+- ID: `entl34d5186e73`
+- Lookup Key: `pro`
+- Display Name: "APIClaw Pro"
+
+**Project ID:** `0d074df4`
+
+## Required Manual Setup
+
+### 1. Link Stripe Account
+
+Go to RevenueCat Dashboard → Project Settings → Integrations → Stripe
+
+Link your Stripe account to enable web subscriptions.
+
+### 2. Create Stripe Product
+
+After linking Stripe, create:
+- **Product ID:** `apiclaw_pro_monthly`
+- **Price:** $99/month
+- **Description:** APIClaw Pro - 2% transaction fees, priority support
+
+### 3. Attach Product to Entitlement
+
+In RevenueCat Dashboard:
+1. Go to Products
+2. Create product pointing to Stripe product ID
+3. Attach to "pro" entitlement
+
+### 4. Configure Webhook
+
+Add webhook URL in RevenueCat Dashboard → Webhooks:
+
+```
+https://your-api-domain.com/webhooks/revenuecat
+```
+
+Events to enable:
+- INITIAL_PURCHASE
+- RENEWAL
+- CANCELLATION
+- EXPIRATION
+- BILLING_ISSUE
+
+## Environment Variables
+
+```bash
+# Required in .env
+REVENUECAT_SECRET_KEY=sk_TwFjVtmGbrgtULpWgHDYBHiZuQvlK
+CONVEX_URL=https://agile-crane-840.convex.cloud
+```
+
+## API Usage
+
+```typescript
+import { hasProSubscription, getFeePercentage, calculateFee } from './revenuecat';
+
+// Check if user has Pro
+const isPro = await hasProSubscription('user_123');
+
+// Get fee percentage (2% Pro, 5% Free)
+const fee = await getFeePercentage('user_123');
+
+// Calculate fee for transaction
+const { feeAmount, netAmount, isPro } = await calculateFee('user_123', 100);
+// isPro: true → feeAmount: $2, netAmount: $98
+// isPro: false → feeAmount: $5, netAmount: $95
+```
+
+## Pro Benefits
+
+| Feature | Free | Pro ($99/mo) |
+|---------|------|--------------|
+| Transaction Fee | 5% | 2% |
+| Support | Community | Priority |
+| API Calls | Standard | Priority routing |
+| Analytics | Basic | Advanced |
+
+## Break-even Analysis
+
+Monthly API spend for Pro to pay off:
+- Fee savings: 3% per transaction
+- Break-even: $99 / 0.03 = $3,300/month in API spend
+
+If spending >$3.3k/month on APIs → Pro saves money.

package/landing/next-env.d.ts

@@ -0,0 +1,5 @@
+/// <reference types="next" />
+/// <reference types="next/image-types/global" />
+
+// NOTE: This file should not be edited
+// see https://nextjs.org/docs/app/building-your-application/configuring/typescript for more information.

package/landing/next.config.mjs

@@ -0,0 +1,6 @@
+/** @type {import('next').NextConfig} */
+const nextConfig = {
+  output: 'standalone',
+};
+
+export default nextConfig;