@nordsym/apiclaw 1.3.3 → 1.3.4

package/convex/_generated/api.d.ts

@@ -9,9 +9,11 @@
  */
 
 import type * as analytics from "../analytics.js";
+import type * as billing from "../billing.js";
 import type * as capabilities from "../capabilities.js";
 import type * as credits from "../credits.js";
 import type * as directCall from "../directCall.js";
+import type * as email from "../email.js";
 import type * as http from "../http.js";
 import type * as providers from "../providers.js";
 import type * as purchases from "../purchases.js";
@@ -19,6 +21,7 @@ import type * as ratelimit from "../ratelimit.js";
 import type * as telemetry from "../telemetry.js";
 import type * as usage from "../usage.js";
 import type * as waitlist from "../waitlist.js";
+import type * as workspaces from "../workspaces.js";
 
 import type {
   ApiFromModules,
@@ -28,9 +31,11 @@ import type {
 
 declare const fullApi: ApiFromModules<{
   analytics: typeof analytics;
+  billing: typeof billing;
   capabilities: typeof capabilities;
   credits: typeof credits;
   directCall: typeof directCall;
+  email: typeof email;
   http: typeof http;
   providers: typeof providers;
   purchases: typeof purchases;
@@ -38,6 +43,7 @@ declare const fullApi: ApiFromModules<{
   telemetry: typeof telemetry;
   usage: typeof usage;
   waitlist: typeof waitlist;
+  workspaces: typeof workspaces;
 }>;
 
 /**

package/convex/billing.ts

@@ -0,0 +1,341 @@
+import { v } from "convex/values";
+import { mutation, query, action } from "./_generated/server";
+import { api } from "./_generated/api";
+
+// Tier limits
+const TIER_LIMITS: Record<string, number> = {
+  free: 100,      // 100 API calls/month
+  pro: 10000,     // 10k API calls/month
+  enterprise: -1, // unlimited
+};
+
+// ============================================
+// STRIPE CUSTOMER MANAGEMENT
+// ============================================
+
+// Create Stripe customer for workspace
+export const createStripeCustomer = action({
+  args: {
+    workspaceId: v.id("workspaces"),
+  },
+  handler: async (ctx, args): Promise<{ success: boolean; customerId?: string; error?: string }> => {
+    const stripeSecretKey = process.env.STRIPE_SECRET_KEY;
+    if (!stripeSecretKey) {
+      return { success: false, error: "Stripe not configured" };
+    }
+
+    // Get workspace
+    const workspace = await ctx.runQuery(api.billing.getWorkspace, { 
+      workspaceId: args.workspaceId 
+    });
+    
+    if (!workspace) {
+      return { success: false, error: "Workspace not found" };
+    }
+
+    // Check if already has customer
+    if (workspace.stripeCustomerId) {
+      return { success: true, customerId: workspace.stripeCustomerId };
+    }
+
+    try {
+      // Create Stripe customer
+      const response = await fetch("https://api.stripe.com/v1/customers", {
+        method: "POST",
+        headers: {
+          "Authorization": `Bearer ${stripeSecretKey}`,
+          "Content-Type": "application/x-www-form-urlencoded",
+        },
+        body: new URLSearchParams({
+          email: workspace.email,
+          "metadata[workspaceId]": args.workspaceId,
+          "metadata[source]": "apiclaw",
+        }),
+      });
+
+      const customer = await response.json() as { id: string; error?: { message: string } };
+      
+      if (!response.ok || customer.error) {
+        return { success: false, error: customer.error?.message || "Failed to create customer" };
+      }
+
+      // Save customer ID to workspace
+      await ctx.runMutation(api.billing.saveStripeCustomerId, {
+        workspaceId: args.workspaceId,
+        stripeCustomerId: customer.id,
+      });
+
+      return { success: true, customerId: customer.id };
+    } catch (error) {
+      return { success: false, error: String(error) };
+    }
+  },
+});
+
+// Internal: Save Stripe customer ID to workspace
+export const saveStripeCustomerId = mutation({
+  args: {
+    workspaceId: v.id("workspaces"),
+    stripeCustomerId: v.string(),
+  },
+  handler: async (ctx, args) => {
+    await ctx.db.patch(args.workspaceId, {
+      stripeCustomerId: args.stripeCustomerId,
+      updatedAt: Date.now(),
+    });
+  },
+});
+
+// Query workspace (for actions)
+export const getWorkspace = query({
+  args: {
+    workspaceId: v.id("workspaces"),
+  },
+  handler: async (ctx, args) => {
+    return await ctx.db.get(args.workspaceId);
+  },
+});
+
+// ============================================
+// CHECKOUT SESSION (Add Payment Method)
+// ============================================
+
+// Create checkout session for subscription
+export const createCheckoutSession = action({
+  args: {
+    workspaceId: v.id("workspaces"),
+    successUrl: v.string(),
+    cancelUrl: v.string(),
+  },
+  handler: async (ctx, args): Promise<{ success: boolean; sessionId?: string; url?: string; error?: string }> => {
+    const stripeSecretKey = process.env.STRIPE_SECRET_KEY;
+    if (!stripeSecretKey) {
+      return { success: false, error: "Stripe not configured" };
+    }
+
+    // Get workspace
+    const workspace = await ctx.runQuery(api.billing.getWorkspace, { 
+      workspaceId: args.workspaceId 
+    });
+    
+    if (!workspace) {
+      return { success: false, error: "Workspace not found" };
+    }
+
+    // Create customer if needed
+    let customerId = workspace.stripeCustomerId;
+    if (!customerId) {
+      const result = await ctx.runAction(api.billing.createStripeCustomer, {
+        workspaceId: args.workspaceId,
+      });
+      if (!result.success || !result.customerId) {
+        return { success: false, error: result.error || "Failed to create customer" };
+      }
+      customerId = result.customerId;
+    }
+
+    try {
+      // Create checkout session for Pro subscription
+      // Using the existing APIClaw Pro price
+      const response = await fetch("https://api.stripe.com/v1/checkout/sessions", {
+        method: "POST",
+        headers: {
+          "Authorization": `Bearer ${stripeSecretKey}`,
+          "Content-Type": "application/x-www-form-urlencoded",
+        },
+        body: new URLSearchParams({
+          customer: customerId,
+          mode: "subscription",
+          "line_items[0][price]": "price_1T1OC2RtJYK3aJTqlJZskgtP", // APIClaw Pro $99/month
+          "line_items[0][quantity]": "1",
+          success_url: args.successUrl,
+          cancel_url: args.cancelUrl,
+          "metadata[workspaceId]": args.workspaceId,
+          "metadata[type]": "upgrade_pro",
+        }),
+      });
+
+      const session = await response.json() as { 
+        id: string; 
+        url: string;
+        error?: { message: string } 
+      };
+      
+      if (!response.ok || session.error) {
+        return { success: false, error: session.error?.message || "Failed to create session" };
+      }
+
+      return { 
+        success: true, 
+        sessionId: session.id,
+        url: session.url,
+      };
+    } catch (error) {
+      return { success: false, error: String(error) };
+    }
+  },
+});
+
+// ============================================
+// WORKSPACE UPGRADE
+// ============================================
+
+// Upgrade workspace to paid tier
+export const upgradeWorkspace = mutation({
+  args: {
+    workspaceId: v.id("workspaces"),
+    tier: v.optional(v.string()),
+    stripeSubscriptionId: v.optional(v.string()),
+  },
+  handler: async (ctx, args) => {
+    const workspace = await ctx.db.get(args.workspaceId);
+    if (!workspace) {
+      return { success: false, error: "workspace_not_found" };
+    }
+
+    const newTier = args.tier || "pro";
+    const newLimit = TIER_LIMITS[newTier] || TIER_LIMITS.pro;
+
+    await ctx.db.patch(args.workspaceId, {
+      tier: newTier,
+      usageLimit: newLimit,
+      status: "active",
+      updatedAt: Date.now(),
+    });
+
+    return { 
+      success: true,
+      tier: newTier,
+      usageLimit: newLimit,
+    };
+  },
+});
+
+// Suspend workspace (e.g., payment failed)
+export const suspendWorkspace = mutation({
+  args: {
+    workspaceId: v.id("workspaces"),
+    reason: v.optional(v.string()),
+  },
+  handler: async (ctx, args) => {
+    const workspace = await ctx.db.get(args.workspaceId);
+    if (!workspace) {
+      return { success: false, error: "workspace_not_found" };
+    }
+
+    await ctx.db.patch(args.workspaceId, {
+      status: "suspended",
+      updatedAt: Date.now(),
+    });
+
+    return { success: true };
+  },
+});
+
+// Get workspace by Stripe customer ID (for webhooks)
+export const getWorkspaceByStripeCustomer = query({
+  args: {
+    stripeCustomerId: v.string(),
+  },
+  handler: async (ctx, args) => {
+    return await ctx.db
+      .query("workspaces")
+      .withIndex("by_stripeCustomerId", (q) => q.eq("stripeCustomerId", args.stripeCustomerId))
+      .first();
+  },
+});
+
+// ============================================
+// USAGE REPORTING
+// ============================================
+
+// Report usage to Stripe (for metered billing)
+// Currently APIClaw Pro is flat-rate, but this prepares for metered billing
+export const reportUsage = action({
+  args: {
+    workspaceId: v.id("workspaces"),
+    amount: v.number(),
+    description: v.optional(v.string()),
+  },
+  handler: async (ctx, args): Promise<{ success: boolean; error?: string }> => {
+    // Get workspace
+    const workspace = await ctx.runQuery(api.billing.getWorkspace, { 
+      workspaceId: args.workspaceId 
+    });
+    
+    if (!workspace) {
+      return { success: false, error: "Workspace not found" };
+    }
+
+    // Only track usage for paid tiers
+    if (workspace.tier === "free") {
+      // Free tier just uses incrementUsage in workspaces.ts
+      return { success: true };
+    }
+
+    // For paid tiers, increment the usage counter
+    // Future: Report to Stripe Billing Meter when metered pricing is set up
+    await ctx.runMutation(api.billing.incrementWorkspaceUsage, {
+      workspaceId: args.workspaceId,
+      amount: args.amount,
+    });
+
+    // TODO: When metered pricing is configured, report to Stripe:
+    // await reportToStripeMeter(workspace.stripeCustomerId, args.amount);
+
+    return { success: true };
+  },
+});
+
+// Internal: Increment workspace usage
+export const incrementWorkspaceUsage = mutation({
+  args: {
+    workspaceId: v.id("workspaces"),
+    amount: v.number(),
+  },
+  handler: async (ctx, args) => {
+    const workspace = await ctx.db.get(args.workspaceId);
+    if (!workspace) return;
+
+    await ctx.db.patch(args.workspaceId, {
+      usageCount: workspace.usageCount + args.amount,
+      updatedAt: Date.now(),
+    });
+  },
+});
+
+// ============================================
+// QUERIES
+// ============================================
+
+// Get billing status for workspace
+export const getBillingStatus = query({
+  args: {
+    workspaceId: v.id("workspaces"),
+  },
+  handler: async (ctx, args) => {
+    const workspace = await ctx.db.get(args.workspaceId);
+    if (!workspace) {
+      return null;
+    }
+
+    const usageRemaining = workspace.usageLimit > 0 
+      ? workspace.usageLimit - workspace.usageCount 
+      : -1;
+
+    const usagePercent = workspace.usageLimit > 0
+      ? Math.round((workspace.usageCount / workspace.usageLimit) * 100)
+      : 0;
+
+    return {
+      tier: workspace.tier,
+      status: workspace.status,
+      usageCount: workspace.usageCount,
+      usageLimit: workspace.usageLimit,
+      usageRemaining,
+      usagePercent,
+      hasStripe: !!workspace.stripeCustomerId,
+      email: workspace.email,
+    };
+  },
+});

package/convex/email.ts

@@ -0,0 +1,276 @@
+import { v } from "convex/values";
+import { action, internalAction } from "./_generated/server";
+
+// ============================================
+// EMAIL TEMPLATES
+// ============================================
+
+const EMAIL_FROM = "APIClaw <noreply@apiclaw.nordsym.com>";
+const APP_URL = "https://apiclaw.nordsym.com";
+
+// Base email wrapper
+function wrapEmail(content: string): string {
+  return `
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+</head>
+<body style="margin: 0; padding: 0; background-color: #f5f5f5; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif;">
+  <table width="100%" cellpadding="0" cellspacing="0" style="background-color: #f5f5f5; padding: 40px 20px;">
+    <tr>
+      <td align="center">
+        <table width="100%" cellpadding="0" cellspacing="0" style="max-width: 500px; background-color: #ffffff; border-radius: 12px; overflow: hidden; box-shadow: 0 1px 3px rgba(0,0,0,0.1);">
+          <!-- Header -->
+          <tr>
+            <td style="padding: 32px 32px 24px; text-align: center; border-bottom: 1px solid #f0f0f0;">
+              <span style="font-size: 48px;">🦞</span>
+              <h1 style="margin: 16px 0 0; font-size: 24px; font-weight: 700; color: #0a0a0a;">APIClaw</h1>
+            </td>
+          </tr>
+          <!-- Content -->
+          <tr>
+            <td style="padding: 32px;">
+              ${content}
+            </td>
+          </tr>
+          <!-- Footer -->
+          <tr>
+            <td style="padding: 24px 32px; background-color: #fafafa; border-top: 1px solid #f0f0f0;">
+              <p style="margin: 0; font-size: 12px; color: #737373; text-align: center;">
+                <a href="https://apiclaw.nordsym.com" style="color: #ef4444; text-decoration: none;">APIClaw</a> — The API Layer for AI Agents
+              </p>
+              <p style="margin: 8px 0 0; font-size: 12px; color: #a3a3a3; text-align: center;">
+                © ${new Date().getFullYear()} NordSym. Stockholm, Sweden.
+              </p>
+            </td>
+          </tr>
+        </table>
+      </td>
+    </tr>
+  </table>
+</body>
+</html>`;
+}
+
+// Magic link email template
+function magicLinkEmailTemplate(verifyUrl: string): string {
+  return wrapEmail(`
+    <h2 style="margin: 0 0 16px; font-size: 20px; font-weight: 600; color: #0a0a0a; text-align: center;">
+      An AI Agent Wants to Connect
+    </h2>
+    
+    <p style="margin: 0 0 24px; font-size: 16px; line-height: 1.6; color: #525252; text-align: center;">
+      Click the button below to verify your email and activate your APIClaw workspace. 
+      Your agent will be able to use APIs immediately.
+    </p>
+    
+    <table width="100%" cellpadding="0" cellspacing="0">
+      <tr>
+        <td align="center" style="padding: 8px 0 24px;">
+          <a href="${verifyUrl}" style="display: inline-block; background: #ef4444; color: white; text-decoration: none; padding: 14px 32px; border-radius: 8px; font-weight: 600; font-size: 16px;">
+            Verify Email & Activate
+          </a>
+        </td>
+      </tr>
+    </table>
+    
+    <div style="background: #fef2f2; border-radius: 8px; padding: 16px; margin-bottom: 16px;">
+      <p style="margin: 0; font-size: 14px; color: #991b1b;">
+        <strong>⚡ Free tier:</strong> 100 API calls included. No credit card required.
+      </p>
+    </div>
+    
+    <p style="margin: 0; font-size: 13px; color: #737373; text-align: center;">
+      This link expires in 1 hour. If you didn't request this, ignore this email.
+    </p>
+  `);
+}
+
+// Reminder email template
+function reminderEmailTemplate(verifyUrl: string): string {
+  return wrapEmail(`
+    <h2 style="margin: 0 0 16px; font-size: 20px; font-weight: 600; color: #0a0a0a; text-align: center;">
+      Still Waiting for You 👋
+    </h2>
+    
+    <p style="margin: 0 0 24px; font-size: 16px; line-height: 1.6; color: #525252; text-align: center;">
+      Your AI agent is patiently waiting for you to verify your email. 
+      Click below to activate your workspace and let it get to work!
+    </p>
+    
+    <table width="100%" cellpadding="0" cellspacing="0">
+      <tr>
+        <td align="center" style="padding: 8px 0 24px;">
+          <a href="${verifyUrl}" style="display: inline-block; background: #ef4444; color: white; text-decoration: none; padding: 14px 32px; border-radius: 8px; font-weight: 600; font-size: 16px;">
+            Verify & Get Started
+          </a>
+        </td>
+      </tr>
+    </table>
+    
+    <p style="margin: 0; font-size: 13px; color: #737373; text-align: center;">
+      This link expires in 1 hour.
+    </p>
+  `);
+}
+
+// Limit reached email template
+function limitReachedEmailTemplate(upgradeUrl: string): string {
+  return wrapEmail(`
+    <h2 style="margin: 0 0 16px; font-size: 20px; font-weight: 600; color: #0a0a0a; text-align: center;">
+      Free Tier Limit Reached
+    </h2>
+    
+    <p style="margin: 0 0 24px; font-size: 16px; line-height: 1.6; color: #525252; text-align: center;">
+      Your AI agent has used all 100 free API calls. Add a payment method to continue using APIClaw.
+    </p>
+    
+    <div style="background: #f5f5f5; border-radius: 8px; padding: 20px; margin-bottom: 24px;">
+      <p style="margin: 0 0 8px; font-size: 14px; font-weight: 600; color: #0a0a0a;">Pro Plan — $10/month</p>
+      <ul style="margin: 0; padding: 0 0 0 20px; font-size: 14px; color: #525252; line-height: 1.8;">
+        <li>10,000 API calls/month</li>
+        <li>Priority support</li>
+        <li>Usage analytics</li>
+      </ul>
+    </div>
+    
+    <table width="100%" cellpadding="0" cellspacing="0">
+      <tr>
+        <td align="center" style="padding: 8px 0 24px;">
+          <a href="${upgradeUrl}" style="display: inline-block; background: #ef4444; color: white; text-decoration: none; padding: 14px 32px; border-radius: 8px; font-weight: 600; font-size: 16px;">
+            Upgrade Now
+          </a>
+        </td>
+      </tr>
+    </table>
+    
+    <p style="margin: 0; font-size: 13px; color: #737373; text-align: center;">
+      Questions? Reply to this email.
+    </p>
+  `);
+}
+
+// ============================================
+// EMAIL SENDING ACTIONS
+// ============================================
+
+/**
+ * Send magic link email
+ */
+export const sendMagicLinkEmail = action({
+  args: {
+    email: v.string(),
+    token: v.string(),
+  },
+  handler: async (ctx, args) => {
+    const RESEND_API_KEY = process.env.RESEND_API_KEY;
+    if (!RESEND_API_KEY) {
+      throw new Error("RESEND_API_KEY not configured");
+    }
+
+    const verifyUrl = `${APP_URL}/auth/verify?token=${args.token}`;
+    const html = magicLinkEmailTemplate(verifyUrl);
+
+    const response = await fetch("https://api.resend.com/emails", {
+      method: "POST",
+      headers: {
+        "Authorization": `Bearer ${RESEND_API_KEY}`,
+        "Content-Type": "application/json",
+      },
+      body: JSON.stringify({
+        from: EMAIL_FROM,
+        to: args.email,
+        subject: "🦞 An AI Agent Wants to Connect — Verify Your Email",
+        html,
+      }),
+    });
+
+    if (!response.ok) {
+      const error = await response.text();
+      throw new Error(`Failed to send email: ${error}`);
+    }
+
+    return { success: true };
+  },
+});
+
+/**
+ * Send reminder email
+ */
+export const sendReminderEmail = action({
+  args: {
+    email: v.string(),
+    token: v.string(),
+  },
+  handler: async (ctx, args) => {
+    const RESEND_API_KEY = process.env.RESEND_API_KEY;
+    if (!RESEND_API_KEY) {
+      throw new Error("RESEND_API_KEY not configured");
+    }
+
+    const verifyUrl = `${APP_URL}/auth/verify?token=${args.token}`;
+    const html = reminderEmailTemplate(verifyUrl);
+
+    const response = await fetch("https://api.resend.com/emails", {
+      method: "POST",
+      headers: {
+        "Authorization": `Bearer ${RESEND_API_KEY}`,
+        "Content-Type": "application/json",
+      },
+      body: JSON.stringify({
+        from: EMAIL_FROM,
+        to: args.email,
+        subject: "🦞 Your Agent is Still Waiting — Verify Your Email",
+        html,
+      }),
+    });
+
+    if (!response.ok) {
+      const error = await response.text();
+      throw new Error(`Failed to send email: ${error}`);
+    }
+
+    return { success: true };
+  },
+});
+
+/**
+ * Send limit reached email
+ */
+export const sendLimitReachedEmail = action({
+  args: {
+    email: v.string(),
+  },
+  handler: async (ctx, args) => {
+    const RESEND_API_KEY = process.env.RESEND_API_KEY;
+    if (!RESEND_API_KEY) {
+      throw new Error("RESEND_API_KEY not configured");
+    }
+
+    const upgradeUrl = `${APP_URL}/upgrade`;
+    const html = limitReachedEmailTemplate(upgradeUrl);
+
+    const response = await fetch("https://api.resend.com/emails", {
+      method: "POST",
+      headers: {
+        "Authorization": `Bearer ${RESEND_API_KEY}`,
+        "Content-Type": "application/json",
+      },
+      body: JSON.stringify({
+        from: EMAIL_FROM,
+        to: args.email,
+        subject: "🦞 Free Tier Limit Reached — Upgrade to Continue",
+        html,
+      }),
+    });
+
+    if (!response.ok) {
+      const error = await response.text();
+      throw new Error(`Failed to send email: ${error}`);
+    }
+
+    return { success: true };
+  },
+});