@nordsym/apiclaw 1.7.2 → 1.7.4

package/convex/updateAPIStatus.js

@@ -0,0 +1,40 @@
+import { mutation } from "./_generated/server";
+/**
+ * Update providerAPIs status to reflect actual Direct Call status
+ * Run: npx convex run updateAPIStatus:update
+ */
+export const update = mutation({
+    args: {},
+    handler: async (ctx) => {
+        const providerId = "k97cvcvadnyz8x8m4we7xqmh1s83p0ph"; // APILayer
+        const apis = await ctx.db
+            .query("providerAPIs")
+            .withIndex("by_providerId", (q) => q.eq("providerId", providerId))
+            .collect();
+        // APIs that are blocked by subscription tier
+        const blocked = ["Number Verification API", "World News API", "Image Crop API", "Form API"];
+        // PDF Layer is rate limited
+        const rateLimited = ["PDF Layer"];
+        let updated = 0;
+        for (const api of apis) {
+            let newStatus = "approved"; // default = live
+            let hasDirectCall = true;
+            if (blocked.includes(api.name)) {
+                newStatus = "blocked";
+                hasDirectCall = false;
+            }
+            else if (rateLimited.includes(api.name)) {
+                newStatus = "rate_limited";
+            }
+            if (api.status !== newStatus || api.hasDirectCall !== hasDirectCall) {
+                await ctx.db.patch(api._id, {
+                    status: newStatus,
+                    hasDirectCall,
+                });
+                updated++;
+            }
+        }
+        return { success: true, updated, total: apis.length };
+    },
+});
+//# sourceMappingURL=updateAPIStatus.js.map

package/convex/updateAPIStatus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"updateAPIStatus.js","sourceRoot":"","sources":["updateAPIStatus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C;;;GAGG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,QAAQ,CAAC;IAC7B,IAAI,EAAE,EAAE;IACR,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QACrB,MAAM,UAAU,GAAG,kCAAyC,CAAC,CAAC,WAAW;QAEzE,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,EAAE;aACtB,KAAK,CAAC,cAAc,CAAC;aACrB,SAAS,CAAC,eAAe,EAAE,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;aACtE,OAAO,EAAE,CAAC;QAEb,6CAA6C;QAC7C,MAAM,OAAO,GAAG,CAAC,yBAAyB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,UAAU,CAAC,CAAC;QAC5F,4BAA4B;QAC5B,MAAM,WAAW,GAAG,CAAC,WAAW,CAAC,CAAC;QAElC,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,SAAS,GAAG,UAAU,CAAC,CAAC,iBAAiB;YAC7C,IAAI,aAAa,GAAG,IAAI,CAAC;YAEzB,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC/B,SAAS,GAAG,SAAS,CAAC;gBACtB,aAAa,GAAG,KAAK,CAAC;YACxB,CAAC;iBAAM,IAAI,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC1C,SAAS,GAAG,cAAc,CAAC;YAC7B,CAAC;YAED,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,GAAG,CAAC,aAAa,KAAK,aAAa,EAAE,CAAC;gBACpE,MAAM,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE;oBAC1B,MAAM,EAAE,SAAS;oBACjB,aAAa;iBACd,CAAC,CAAC;gBACH,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;IACxD,CAAC;CACF,CAAC,CAAC"}

package/convex/updateAPIStatus.ts

@@ -0,0 +1,45 @@
+import { mutation } from "./_generated/server";
+
+/**
+ * Update providerAPIs status to reflect actual Direct Call status
+ * Run: npx convex run updateAPIStatus:update
+ */
+export const update = mutation({
+  args: {},
+  handler: async (ctx) => {
+    const providerId = "k97cvcvadnyz8x8m4we7xqmh1s83p0ph" as any; // APILayer
+
+    const apis = await ctx.db
+      .query("providerAPIs")
+      .withIndex("by_providerId", (q: any) => q.eq("providerId", providerId))
+      .collect();
+
+    // APIs that are blocked by subscription tier
+    const blocked = ["Number Verification API", "World News API", "Image Crop API", "Form API"];
+    // PDF Layer is rate limited
+    const rateLimited = ["PDF Layer"];
+
+    let updated = 0;
+    for (const api of apis) {
+      let newStatus = "approved"; // default = live
+      let hasDirectCall = true;
+
+      if (blocked.includes(api.name)) {
+        newStatus = "blocked";
+        hasDirectCall = false;
+      } else if (rateLimited.includes(api.name)) {
+        newStatus = "rate_limited";
+      }
+
+      if (api.status !== newStatus || api.hasDirectCall !== hasDirectCall) {
+        await ctx.db.patch(api._id, {
+          status: newStatus,
+          hasDirectCall,
+        });
+        updated++;
+      }
+    }
+
+    return { success: true, updated, total: apis.length };
+  },
+});

package/convex/usage.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Log an API call usage
+ */
+export declare const logUsage: any;
+/**
+ * Get user usage stats for rate limiting
+ * Returns counts for last minute and last day
+ */
+export declare const getUserUsage: any;
+/**
+ * Get provider usage stats for analytics
+ */
+export declare const getProviderUsage: any;
+/**
+ * Get Direct Call specific usage stats
+ */
+export declare const getDirectCallUsage: any;
+/**
+ * Get recent usage logs (for dashboard/debugging)
+ */
+export declare const getRecentLogs: any;
+/**
+ * Check if user is within rate limits
+ * Returns { allowed: boolean, reason?: string }
+ */
+export declare const checkRateLimit: any;
+//# sourceMappingURL=usage.d.ts.map

package/convex/usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["usage.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,eAAO,MAAM,QAAQ,KAwBnB,CAAC;AAMH;;;GAGG;AACH,eAAO,MAAM,YAAY,KA8BvB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,gBAAgB,KA6D3B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,kBAAkB,KAgC7B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,aAAa,KAgCxB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,cAAc,KAuCzB,CAAC"}

package/convex/usage.js

@@ -0,0 +1,229 @@
+import { v } from "convex/values";
+import { mutation, query } from "./_generated/server";
+// ============================================
+// MUTATIONS
+// ============================================
+/**
+ * Log an API call usage
+ */
+export const logUsage = mutation({
+    args: {
+        userId: v.string(),
+        providerId: v.id("providers"),
+        directCallId: v.id("providerDirectCall"),
+        actionName: v.string(),
+        success: v.boolean(),
+        latencyMs: v.number(),
+        creditsUsed: v.number(),
+        errorMessage: v.optional(v.string()),
+    },
+    handler: async (ctx, args) => {
+        return await ctx.db.insert("usageLog", {
+            userId: args.userId,
+            providerId: args.providerId,
+            directCallId: args.directCallId,
+            actionName: args.actionName,
+            timestamp: Date.now(),
+            success: args.success,
+            latencyMs: args.latencyMs,
+            creditsUsed: args.creditsUsed,
+            errorMessage: args.errorMessage,
+        });
+    },
+});
+// ============================================
+// QUERIES
+// ============================================
+/**
+ * Get user usage stats for rate limiting
+ * Returns counts for last minute and last day
+ */
+export const getUserUsage = query({
+    args: {
+        userId: v.string(),
+        providerId: v.id("providers"),
+    },
+    handler: async (ctx, args) => {
+        const now = Date.now();
+        const oneMinuteAgo = now - 60 * 1000;
+        const oneDayAgo = now - 24 * 60 * 60 * 1000;
+        // Get all usage for this user + provider in the last 24h
+        const recentUsage = await ctx.db
+            .query("usageLog")
+            .withIndex("by_userId_providerId", (q) => q.eq("userId", args.userId).eq("providerId", args.providerId))
+            .filter((q) => q.gte(q.field("timestamp"), oneDayAgo))
+            .collect();
+        // Calculate counts
+        const minuteCount = recentUsage.filter((u) => u.timestamp >= oneMinuteAgo).length;
+        const dayCount = recentUsage.length;
+        const totalCredits = recentUsage.reduce((sum, u) => sum + u.creditsUsed, 0);
+        return {
+            minute: minuteCount,
+            day: dayCount,
+            totalCreditsUsed: totalCredits,
+        };
+    },
+});
+/**
+ * Get provider usage stats for analytics
+ */
+export const getProviderUsage = query({
+    args: {
+        providerId: v.id("providers"),
+        periodDays: v.optional(v.number()), // default 30
+    },
+    handler: async (ctx, args) => {
+        const periodDays = args.periodDays ?? 30;
+        const now = Date.now();
+        const periodStart = now - periodDays * 24 * 60 * 60 * 1000;
+        const usage = await ctx.db
+            .query("usageLog")
+            .withIndex("by_providerId", (q) => q.eq("providerId", args.providerId))
+            .filter((q) => q.gte(q.field("timestamp"), periodStart))
+            .collect();
+        // Aggregate stats
+        const totalCalls = usage.length;
+        const successfulCalls = usage.filter((u) => u.success).length;
+        const failedCalls = totalCalls - successfulCalls;
+        const totalCredits = usage.reduce((sum, u) => sum + u.creditsUsed, 0);
+        const totalLatency = usage.reduce((sum, u) => sum + u.latencyMs, 0);
+        const avgLatency = totalCalls > 0 ? Math.round(totalLatency / totalCalls) : 0;
+        // Group by action
+        const byAction = {};
+        for (const u of usage) {
+            if (!byAction[u.actionName]) {
+                byAction[u.actionName] = { calls: 0, credits: 0 };
+            }
+            byAction[u.actionName].calls++;
+            byAction[u.actionName].credits += u.creditsUsed;
+        }
+        // Group by day for chart
+        const byDay = {};
+        for (const u of usage) {
+            const day = new Date(u.timestamp).toISOString().split("T")[0];
+            if (!byDay[day]) {
+                byDay[day] = { calls: 0, credits: 0 };
+            }
+            byDay[day].calls++;
+            byDay[day].credits += u.creditsUsed;
+        }
+        // Unique users
+        const uniqueUsers = new Set(usage.map((u) => u.userId)).size;
+        return {
+            periodDays,
+            totalCalls,
+            successfulCalls,
+            failedCalls,
+            successRate: totalCalls > 0 ? (successfulCalls / totalCalls) * 100 : 0,
+            totalCredits,
+            avgLatencyMs: avgLatency,
+            uniqueUsers,
+            byAction,
+            byDay,
+        };
+    },
+});
+/**
+ * Get Direct Call specific usage stats
+ */
+export const getDirectCallUsage = query({
+    args: {
+        directCallId: v.id("providerDirectCall"),
+        periodDays: v.optional(v.number()),
+    },
+    handler: async (ctx, args) => {
+        const periodDays = args.periodDays ?? 30;
+        const now = Date.now();
+        const periodStart = now - periodDays * 24 * 60 * 60 * 1000;
+        const usage = await ctx.db
+            .query("usageLog")
+            .withIndex("by_directCallId", (q) => q.eq("directCallId", args.directCallId))
+            .filter((q) => q.gte(q.field("timestamp"), periodStart))
+            .collect();
+        const totalCalls = usage.length;
+        const successfulCalls = usage.filter((u) => u.success).length;
+        const totalCredits = usage.reduce((sum, u) => sum + u.creditsUsed, 0);
+        const totalLatency = usage.reduce((sum, u) => sum + u.latencyMs, 0);
+        return {
+            periodDays,
+            totalCalls,
+            successfulCalls,
+            failedCalls: totalCalls - successfulCalls,
+            successRate: totalCalls > 0 ? (successfulCalls / totalCalls) * 100 : 0,
+            totalCredits,
+            avgLatencyMs: totalCalls > 0 ? Math.round(totalLatency / totalCalls) : 0,
+            uniqueUsers: new Set(usage.map((u) => u.userId)).size,
+        };
+    },
+});
+/**
+ * Get recent usage logs (for dashboard/debugging)
+ */
+export const getRecentLogs = query({
+    args: {
+        providerId: v.optional(v.id("providers")),
+        directCallId: v.optional(v.id("providerDirectCall")),
+        limit: v.optional(v.number()),
+    },
+    handler: async (ctx, args) => {
+        const limit = args.limit ?? 50;
+        const { directCallId, providerId } = args;
+        if (directCallId !== undefined) {
+            return await ctx.db
+                .query("usageLog")
+                .withIndex("by_directCallId", (q) => q.eq("directCallId", directCallId))
+                .order("desc")
+                .take(limit);
+        }
+        if (providerId !== undefined) {
+            return await ctx.db
+                .query("usageLog")
+                .withIndex("by_providerId", (q) => q.eq("providerId", providerId))
+                .order("desc")
+                .take(limit);
+        }
+        return await ctx.db
+            .query("usageLog")
+            .withIndex("by_timestamp")
+            .order("desc")
+            .take(limit);
+    },
+});
+/**
+ * Check if user is within rate limits
+ * Returns { allowed: boolean, reason?: string }
+ */
+export const checkRateLimit = query({
+    args: {
+        userId: v.string(),
+        providerId: v.id("providers"),
+        rateLimitPerUser: v.number(),
+        rateLimitPerDay: v.number(),
+    },
+    handler: async (ctx, args) => {
+        const now = Date.now();
+        const oneMinuteAgo = now - 60 * 1000;
+        const oneDayAgo = now - 24 * 60 * 60 * 1000;
+        const recentUsage = await ctx.db
+            .query("usageLog")
+            .withIndex("by_userId_providerId", (q) => q.eq("userId", args.userId).eq("providerId", args.providerId))
+            .filter((q) => q.gte(q.field("timestamp"), oneDayAgo))
+            .collect();
+        const minuteCount = recentUsage.filter((u) => u.timestamp >= oneMinuteAgo).length;
+        const dayCount = recentUsage.length;
+        if (minuteCount >= args.rateLimitPerUser) {
+            return {
+                allowed: false,
+                reason: `Rate limit exceeded: ${minuteCount}/${args.rateLimitPerUser} requests per minute`,
+            };
+        }
+        if (dayCount >= args.rateLimitPerDay) {
+            return {
+                allowed: false,
+                reason: `Daily limit exceeded: ${dayCount}/${args.rateLimitPerDay} requests per day`,
+            };
+        }
+        return { allowed: true };
+    },
+});
+//# sourceMappingURL=usage.js.map

package/convex/usage.js.map

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

package/convex/usage.ts

@@ -0,0 +1,260 @@
+import { v } from "convex/values";
+import { mutation, query } from "./_generated/server";
+
+// ============================================
+// MUTATIONS
+// ============================================
+
+/**
+ * Log an API call usage
+ */
+export const logUsage = mutation({
+  args: {
+    userId: v.string(),
+    providerId: v.id("providers"),
+    directCallId: v.id("providerDirectCall"),
+    actionName: v.string(),
+    success: v.boolean(),
+    latencyMs: v.number(),
+    creditsUsed: v.number(),
+    errorMessage: v.optional(v.string()),
+  },
+  handler: async (ctx, args) => {
+    return await ctx.db.insert("usageLog", {
+      userId: args.userId,
+      providerId: args.providerId,
+      directCallId: args.directCallId,
+      actionName: args.actionName,
+      timestamp: Date.now(),
+      success: args.success,
+      latencyMs: args.latencyMs,
+      creditsUsed: args.creditsUsed,
+      errorMessage: args.errorMessage,
+    });
+  },
+});
+
+// ============================================
+// QUERIES
+// ============================================
+
+/**
+ * Get user usage stats for rate limiting
+ * Returns counts for last minute and last day
+ */
+export const getUserUsage = query({
+  args: {
+    userId: v.string(),
+    providerId: v.id("providers"),
+  },
+  handler: async (ctx, args) => {
+    const now = Date.now();
+    const oneMinuteAgo = now - 60 * 1000;
+    const oneDayAgo = now - 24 * 60 * 60 * 1000;
+
+    // Get all usage for this user + provider in the last 24h
+    const recentUsage = await ctx.db
+      .query("usageLog")
+      .withIndex("by_userId_providerId", (q) =>
+        q.eq("userId", args.userId).eq("providerId", args.providerId)
+      )
+      .filter((q) => q.gte(q.field("timestamp"), oneDayAgo))
+      .collect();
+
+    // Calculate counts
+    const minuteCount = recentUsage.filter((u) => u.timestamp >= oneMinuteAgo).length;
+    const dayCount = recentUsage.length;
+    const totalCredits = recentUsage.reduce((sum, u) => sum + u.creditsUsed, 0);
+
+    return {
+      minute: minuteCount,
+      day: dayCount,
+      totalCreditsUsed: totalCredits,
+    };
+  },
+});
+
+/**
+ * Get provider usage stats for analytics
+ */
+export const getProviderUsage = query({
+  args: {
+    providerId: v.id("providers"),
+    periodDays: v.optional(v.number()), // default 30
+  },
+  handler: async (ctx, args) => {
+    const periodDays = args.periodDays ?? 30;
+    const now = Date.now();
+    const periodStart = now - periodDays * 24 * 60 * 60 * 1000;
+
+    const usage = await ctx.db
+      .query("usageLog")
+      .withIndex("by_providerId", (q) => q.eq("providerId", args.providerId))
+      .filter((q) => q.gte(q.field("timestamp"), periodStart))
+      .collect();
+
+    // Aggregate stats
+    const totalCalls = usage.length;
+    const successfulCalls = usage.filter((u) => u.success).length;
+    const failedCalls = totalCalls - successfulCalls;
+    const totalCredits = usage.reduce((sum, u) => sum + u.creditsUsed, 0);
+    const totalLatency = usage.reduce((sum, u) => sum + u.latencyMs, 0);
+    const avgLatency = totalCalls > 0 ? Math.round(totalLatency / totalCalls) : 0;
+
+    // Group by action
+    const byAction: Record<string, { calls: number; credits: number }> = {};
+    for (const u of usage) {
+      if (!byAction[u.actionName]) {
+        byAction[u.actionName] = { calls: 0, credits: 0 };
+      }
+      byAction[u.actionName].calls++;
+      byAction[u.actionName].credits += u.creditsUsed;
+    }
+
+    // Group by day for chart
+    const byDay: Record<string, { calls: number; credits: number }> = {};
+    for (const u of usage) {
+      const day = new Date(u.timestamp).toISOString().split("T")[0];
+      if (!byDay[day]) {
+        byDay[day] = { calls: 0, credits: 0 };
+      }
+      byDay[day].calls++;
+      byDay[day].credits += u.creditsUsed;
+    }
+
+    // Unique users
+    const uniqueUsers = new Set(usage.map((u) => u.userId)).size;
+
+    return {
+      periodDays,
+      totalCalls,
+      successfulCalls,
+      failedCalls,
+      successRate: totalCalls > 0 ? (successfulCalls / totalCalls) * 100 : 0,
+      totalCredits,
+      avgLatencyMs: avgLatency,
+      uniqueUsers,
+      byAction,
+      byDay,
+    };
+  },
+});
+
+/**
+ * Get Direct Call specific usage stats
+ */
+export const getDirectCallUsage = query({
+  args: {
+    directCallId: v.id("providerDirectCall"),
+    periodDays: v.optional(v.number()),
+  },
+  handler: async (ctx, args) => {
+    const periodDays = args.periodDays ?? 30;
+    const now = Date.now();
+    const periodStart = now - periodDays * 24 * 60 * 60 * 1000;
+
+    const usage = await ctx.db
+      .query("usageLog")
+      .withIndex("by_directCallId", (q) => q.eq("directCallId", args.directCallId))
+      .filter((q) => q.gte(q.field("timestamp"), periodStart))
+      .collect();
+
+    const totalCalls = usage.length;
+    const successfulCalls = usage.filter((u) => u.success).length;
+    const totalCredits = usage.reduce((sum, u) => sum + u.creditsUsed, 0);
+    const totalLatency = usage.reduce((sum, u) => sum + u.latencyMs, 0);
+
+    return {
+      periodDays,
+      totalCalls,
+      successfulCalls,
+      failedCalls: totalCalls - successfulCalls,
+      successRate: totalCalls > 0 ? (successfulCalls / totalCalls) * 100 : 0,
+      totalCredits,
+      avgLatencyMs: totalCalls > 0 ? Math.round(totalLatency / totalCalls) : 0,
+      uniqueUsers: new Set(usage.map((u) => u.userId)).size,
+    };
+  },
+});
+
+/**
+ * Get recent usage logs (for dashboard/debugging)
+ */
+export const getRecentLogs = query({
+  args: {
+    providerId: v.optional(v.id("providers")),
+    directCallId: v.optional(v.id("providerDirectCall")),
+    limit: v.optional(v.number()),
+  },
+  handler: async (ctx, args) => {
+    const limit = args.limit ?? 50;
+    const { directCallId, providerId } = args;
+
+    if (directCallId !== undefined) {
+      return await ctx.db
+        .query("usageLog")
+        .withIndex("by_directCallId", (q) => q.eq("directCallId", directCallId))
+        .order("desc")
+        .take(limit);
+    }
+
+    if (providerId !== undefined) {
+      return await ctx.db
+        .query("usageLog")
+        .withIndex("by_providerId", (q) => q.eq("providerId", providerId))
+        .order("desc")
+        .take(limit);
+    }
+
+    return await ctx.db
+      .query("usageLog")
+      .withIndex("by_timestamp")
+      .order("desc")
+      .take(limit);
+  },
+});
+
+/**
+ * Check if user is within rate limits
+ * Returns { allowed: boolean, reason?: string }
+ */
+export const checkRateLimit = query({
+  args: {
+    userId: v.string(),
+    providerId: v.id("providers"),
+    rateLimitPerUser: v.number(),
+    rateLimitPerDay: v.number(),
+  },
+  handler: async (ctx, args) => {
+    const now = Date.now();
+    const oneMinuteAgo = now - 60 * 1000;
+    const oneDayAgo = now - 24 * 60 * 60 * 1000;
+
+    const recentUsage = await ctx.db
+      .query("usageLog")
+      .withIndex("by_userId_providerId", (q) =>
+        q.eq("userId", args.userId).eq("providerId", args.providerId)
+      )
+      .filter((q) => q.gte(q.field("timestamp"), oneDayAgo))
+      .collect();
+
+    const minuteCount = recentUsage.filter((u) => u.timestamp >= oneMinuteAgo).length;
+    const dayCount = recentUsage.length;
+
+    if (minuteCount >= args.rateLimitPerUser) {
+      return {
+        allowed: false,
+        reason: `Rate limit exceeded: ${minuteCount}/${args.rateLimitPerUser} requests per minute`,
+      };
+    }
+
+    if (dayCount >= args.rateLimitPerDay) {
+      return {
+        allowed: false,
+        reason: `Daily limit exceeded: ${dayCount}/${args.rateLimitPerDay} requests per day`,
+      };
+    }
+
+    return { allowed: true };
+  },
+});

package/convex/waitlist.d.ts

@@ -0,0 +1,4 @@
+export declare const join: any;
+export declare const count: any;
+export declare const list: any;
+//# sourceMappingURL=waitlist.d.ts.map

package/convex/waitlist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"waitlist.d.ts","sourceRoot":"","sources":["waitlist.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,IAAI,KA4Bf,CAAC;AAEH,eAAO,MAAM,KAAK,KAMhB,CAAC;AAEH,eAAO,MAAM,IAAI,KAaf,CAAC"}

package/convex/waitlist.js

@@ -0,0 +1,49 @@
+import { mutation, query } from "./_generated/server";
+import { v } from "convex/values";
+export const join = mutation({
+    args: {
+        email: v.string(),
+        type: v.optional(v.string()),
+        source: v.optional(v.string()),
+    },
+    handler: async (ctx, args) => {
+        const email = args.email.toLowerCase().trim();
+        // Check if already on waitlist
+        const existing = await ctx.db
+            .query("waitlist")
+            .withIndex("by_email", (q) => q.eq("email", email))
+            .first();
+        if (existing) {
+            return { success: true, alreadyExists: true };
+        }
+        await ctx.db.insert("waitlist", {
+            email,
+            type: args.type || "provider",
+            source: args.source || "landing",
+            createdAt: Date.now(),
+        });
+        return { success: true, alreadyExists: false };
+    },
+});
+export const count = query({
+    args: {},
+    handler: async (ctx) => {
+        const all = await ctx.db.query("waitlist").collect();
+        return all.length;
+    },
+});
+export const list = query({
+    args: {
+        type: v.optional(v.string()),
+    },
+    handler: async (ctx, args) => {
+        if (args.type) {
+            return await ctx.db
+                .query("waitlist")
+                .withIndex("by_type", (q) => q.eq("type", args.type))
+                .collect();
+        }
+        return await ctx.db.query("waitlist").collect();
+    },
+});
+//# sourceMappingURL=waitlist.js.map