convex-affiliates 1.1.3 → 2.0.0

package/README.md

@@ -255,14 +255,22 @@ If you're not using `@convex-dev/stripe`, use the standalone handler with built-
 // convex/http.ts
 import { httpRouter } from "convex/server";
 import { components } from "./_generated/api";
-import { createStripeWebhookHandler } from "convex-affiliates";
+import { createAffiliateApi } from "convex-affiliates";
 
 const http = httpRouter();
 
+const affiliates = createAffiliateApi(components.affiliates, {
+  auth: async (ctx) => {
+    const identity = await ctx.auth.getUserIdentity();
+    if (!identity) throw new Error("Not authenticated");
+    return identity.subject;
+  },
+});
+
 http.route({
   path: "/webhooks/stripe",
   method: "POST",
-  handler: createStripeWebhookHandler(components.affiliates, {
+  handler: affiliates.createStripeWebhookHandler({
     webhookSecret: process.env.STRIPE_WEBHOOK_SECRET!,
   }),
 });

package/dist/client/index.d.ts

@@ -168,19 +168,14 @@ export interface CreateAffiliateApiConfig extends AffiliateConfig {
  * import { createAffiliateApi } from "convex-affiliates";
  * import { components } from "./_generated/api";
  *
- * export const {
- *   trackClick,
- *   register,
- *   getPortalData,
- *   adminDashboard,
- * } = createAffiliateApi(components.affiliates, {
- *   defaultCommissionValue: 25,
- *   auth: async (ctx) => {
- *     const identity = await ctx.auth.getUserIdentity();
- *     if (!identity) throw new Error("Not authenticated");
- *     return identity.subject;
- *   },
- * });
+ * export const { trackClick, register, getPortalData } =
+ *   createAffiliateApi(components.affiliates, {
+ *     auth: async (ctx) => {
+ *       const identity = await ctx.auth.getUserIdentity();
+ *       if (!identity) throw new Error("Not authenticated");
+ *       return identity.subject;
+ *     },
+ *   });
  * ```
  */
 export declare function createAffiliateApi(component: ComponentApi, config: CreateAffiliateApiConfig): {
@@ -950,14 +945,44 @@ export declare function createAffiliateApi(component: ComponentApi, config: Crea
         slug: string;
         commissionValue: number;
     }, Promise<import("../component/_generated/dataModel.js").Id<"campaigns">>>;
+    /**
+     * Register HTTP routes for affiliate functionality.
+     * The component reference is already available from the closure.
+     *
+     * @param http - The Convex HTTP router
+     * @param options - Optional configuration (e.g., pathPrefix)
+     *
+     * @example
+     * ```typescript
+     * const affiliates = createAffiliateApi(components.affiliates, { ... });
+     * affiliates.registerRoutes(http, { pathPrefix: "/affiliates" });
+     * ```
+     */
+    registerRoutes(http: HttpRouter, options?: {
+        pathPrefix?: string;
+    }): void;
+    /**
+     * Create a Stripe webhook handler that processes affiliate-related events.
+     * The component reference is already available from the closure.
+     *
+     * @param webhookConfig - Configuration with webhookSecret
+     * @returns An HTTP action handler for Stripe webhooks
+     *
+     * @example
+     * ```typescript
+     * const affiliates = createAffiliateApi(components.affiliates, { ... });
+     *
+     * http.route({
+     *   path: "/webhooks/stripe",
+     *   method: "POST",
+     *   handler: affiliates.createStripeWebhookHandler({
+     *     webhookSecret: process.env.STRIPE_WEBHOOK_SECRET!,
+     *   }),
+     * });
+     * ```
+     */
+    createStripeWebhookHandler(webhookConfig: StripeWebhookConfig): import("convex/server").PublicHttpAction;
 };
-/**
- * Register HTTP routes for affiliate functionality.
- * Useful for public API endpoints and webhook handling.
- */
-export declare function registerRoutes(http: HttpRouter, component: ComponentApi, options?: {
-    pathPrefix?: string;
-}): void;
 export interface StripeWebhookConfig {
     /**
      * Stripe webhook signing secret (whsec_...).
@@ -966,30 +991,6 @@ export interface StripeWebhookConfig {
      */
     webhookSecret: string;
 }
-/**
- * Create a Stripe webhook handler that processes affiliate-related events.
- * Handles invoice.paid, charge.refunded, and checkout.session.completed events.
- *
- * @example
- * ```typescript
- * import { httpRouter } from "convex/server";
- * import { createStripeWebhookHandler } from "convex-affiliates";
- * import { components } from "./_generated/api";
- *
- * const http = httpRouter();
- *
- * http.route({
- *   path: "/webhooks/stripe",
- *   method: "POST",
- *   handler: createStripeWebhookHandler(components.affiliates, {
- *     webhookSecret: process.env.STRIPE_WEBHOOK_SECRET!,
- *   }),
- * });
- *
- * export default http;
- * ```
- */
-export declare function createStripeWebhookHandler(component: ComponentApi, config: StripeWebhookConfig): import("convex/server").PublicHttpAction;
 /**
  * Options for Stripe event handlers.
  */

package/dist/client/index.d.ts.map

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

package/dist/client/index.js

@@ -14,22 +14,20 @@ import { affiliateStatusValidator, payoutTermValidator, commissionTypeValidator,
  * import { createAffiliateApi } from "convex-affiliates";
  * import { components } from "./_generated/api";
  *
- * export const {
- *   trackClick,
- *   register,
- *   getPortalData,
- *   adminDashboard,
- * } = createAffiliateApi(components.affiliates, {
- *   defaultCommissionValue: 25,
- *   auth: async (ctx) => {
- *     const identity = await ctx.auth.getUserIdentity();
- *     if (!identity) throw new Error("Not authenticated");
- *     return identity.subject;
- *   },
- * });
+ * export const { trackClick, register, getPortalData } =
+ *   createAffiliateApi(components.affiliates, {
+ *     auth: async (ctx) => {
+ *       const identity = await ctx.auth.getUserIdentity();
+ *       if (!identity) throw new Error("Not authenticated");
+ *       return identity.subject;
+ *     },
+ *   });
  * ```
  */
 export function createAffiliateApi(component, config) {
+    const auth = config.auth;
+    const isAdmin = config.isAdmin;
+    const hooks = config.hooks;
     const defaults = {
         defaultCommissionType: config.defaultCommissionType ?? "percentage",
         defaultCommissionValue: config.defaultCommissionValue ?? 20,
@@ -57,14 +55,14 @@ export function createAffiliateApi(component, config) {
     };
     // Helper to check admin access
     const requireAdmin = async (ctx) => {
-        if (config.isAdmin) {
-            const isAdmin = await config.isAdmin(ctx);
-            if (!isAdmin)
+        if (isAdmin) {
+            const isAdminResult = await isAdmin(ctx);
+            if (!isAdminResult)
                 throw new Error("Not authorized - admin access required");
         }
         else {
             // Fall back to just requiring auth
-            await config.auth(ctx);
+            await auth(ctx);
         }
     };
     // Helper to get affiliate by userId
@@ -73,7 +71,7 @@ export function createAffiliateApi(component, config) {
     };
     // Helper to call lifecycle hooks safely (errors are logged, not thrown)
     async function callHook(hookName, data) {
-        const hook = config.hooks?.[hookName];
+        const hook = hooks?.[hookName];
         if (hook) {
             try {
                 await hook(data);
@@ -201,7 +199,7 @@ export function createAffiliateApi(component, config) {
                 customCode: v.optional(v.string()),
             },
             handler: async (ctx, args) => {
-                const userId = await config.auth(ctx);
+                const userId = await auth(ctx);
                 const campaign = await ensureDefaultCampaign(ctx);
                 const result = await ctx.runMutation(component.affiliates.register, {
                     userId,
@@ -243,7 +241,7 @@ export function createAffiliateApi(component, config) {
         getAffiliate: queryGeneric({
             args: {},
             handler: async (ctx) => {
-                const userId = await config.auth(ctx);
+                const userId = await auth(ctx);
                 return ctx.runQuery(component.affiliates.getByUserId, { userId });
             },
         }),
@@ -280,7 +278,7 @@ export function createAffiliateApi(component, config) {
                 payoutEmail: v.optional(v.string()),
             },
             handler: async (ctx, args) => {
-                const userId = await config.auth(ctx);
+                const userId = await auth(ctx);
                 const affiliate = await ctx.runQuery(component.affiliates.getByUserId, {
                     userId,
                 });
@@ -313,7 +311,7 @@ export function createAffiliateApi(component, config) {
         getPortalData: queryGeneric({
             args: {},
             handler: async (ctx) => {
-                const userId = await config.auth(ctx);
+                const userId = await auth(ctx);
                 return ctx.runQuery(component.analytics.getPortalData, { userId });
             },
         }),
@@ -345,7 +343,7 @@ export function createAffiliateApi(component, config) {
                 paginationOpts: paginationOptsValidator,
             },
             handler: async (ctx, args) => {
-                const userId = await config.auth(ctx);
+                const userId = await auth(ctx);
                 const affiliate = await getAffiliateByUserId(ctx, userId);
                 if (!affiliate) {
                     return { page: [], isDone: true, continueCursor: "" };
@@ -384,7 +382,7 @@ export function createAffiliateApi(component, config) {
                 paginationOpts: paginationOptsValidator,
             },
             handler: async (ctx, args) => {
-                const userId = await config.auth(ctx);
+                const userId = await auth(ctx);
                 const affiliate = await getAffiliateByUserId(ctx, userId);
                 if (!affiliate) {
                     return { page: [], isDone: true, continueCursor: "" };
@@ -421,7 +419,7 @@ export function createAffiliateApi(component, config) {
                 limit: v.optional(v.number()),
             },
             handler: async (ctx, args) => {
-                const userId = await config.auth(ctx);
+                const userId = await auth(ctx);
                 const affiliate = await getAffiliateByUserId(ctx, userId);
                 if (!affiliate) {
                     return [];
@@ -465,7 +463,7 @@ export function createAffiliateApi(component, config) {
                 subId: v.optional(v.string()),
             },
             handler: async (ctx, args) => {
-                const userId = await config.auth(ctx);
+                const userId = await auth(ctx);
                 const affiliate = await ctx.runQuery(component.affiliates.getByUserId, {
                     userId,
                 });
@@ -857,52 +855,149 @@ export function createAffiliateApi(component, config) {
                 });
             },
         }),
-    };
-}
-// =============================================================================
-// HTTP Routes Helper
-// =============================================================================
-/**
- * Register HTTP routes for affiliate functionality.
- * Useful for public API endpoints and webhook handling.
- */
-export function registerRoutes(http, component, options = {}) {
-    const prefix = options.pathPrefix ?? "/affiliates";
-    // Get affiliate by code (public endpoint for link validation)
-    http.route({
-        path: `${prefix}/affiliate/:code`,
-        method: "GET",
-        handler: httpActionGeneric(async (ctx, request) => {
-            const url = new URL(request.url);
-            const code = url.pathname.split("/").pop();
-            if (!code) {
-                return new Response(JSON.stringify({ error: "Code required" }), {
-                    status: 400,
-                    headers: { "Content-Type": "application/json" },
-                });
-            }
-            const affiliate = await ctx.runQuery(component.affiliates.getByCode, {
-                code: code.toUpperCase(),
+        // =========================================================================
+        // HTTP Routes
+        // =========================================================================
+        /**
+         * Register HTTP routes for affiliate functionality.
+         * The component reference is already available from the closure.
+         *
+         * @param http - The Convex HTTP router
+         * @param options - Optional configuration (e.g., pathPrefix)
+         *
+         * @example
+         * ```typescript
+         * const affiliates = createAffiliateApi(components.affiliates, { ... });
+         * affiliates.registerRoutes(http, { pathPrefix: "/affiliates" });
+         * ```
+         */
+        registerRoutes(http, options = {}) {
+            const prefix = options.pathPrefix ?? "/affiliates";
+            http.route({
+                path: `${prefix}/affiliate/:code`,
+                method: "GET",
+                handler: httpActionGeneric(async (ctx, request) => {
+                    const url = new URL(request.url);
+                    const code = url.pathname.split("/").pop();
+                    if (!code) {
+                        return new Response(JSON.stringify({ error: "Code required" }), {
+                            status: 400,
+                            headers: { "Content-Type": "application/json" },
+                        });
+                    }
+                    const affiliate = await ctx.runQuery(component.affiliates.getByCode, {
+                        code: code.toUpperCase(),
+                    });
+                    if (!affiliate) {
+                        return new Response(JSON.stringify({ error: "Affiliate not found" }), {
+                            status: 404,
+                            headers: { "Content-Type": "application/json" },
+                        });
+                    }
+                    return new Response(JSON.stringify({
+                        code: affiliate.code,
+                        displayName: affiliate.displayName,
+                        valid: affiliate.status === "approved",
+                    }), {
+                        status: 200,
+                        headers: { "Content-Type": "application/json" },
+                    });
+                }),
             });
-            if (!affiliate) {
-                return new Response(JSON.stringify({ error: "Affiliate not found" }), {
-                    status: 404,
-                    headers: { "Content-Type": "application/json" },
-                });
+        },
+        // =========================================================================
+        // Stripe Webhook Handler
+        // =========================================================================
+        /**
+         * Create a Stripe webhook handler that processes affiliate-related events.
+         * The component reference is already available from the closure.
+         *
+         * @param webhookConfig - Configuration with webhookSecret
+         * @returns An HTTP action handler for Stripe webhooks
+         *
+         * @example
+         * ```typescript
+         * const affiliates = createAffiliateApi(components.affiliates, { ... });
+         *
+         * http.route({
+         *   path: "/webhooks/stripe",
+         *   method: "POST",
+         *   handler: affiliates.createStripeWebhookHandler({
+         *     webhookSecret: process.env.STRIPE_WEBHOOK_SECRET!,
+         *   }),
+         * });
+         * ```
+         */
+        createStripeWebhookHandler(webhookConfig) {
+            if (!webhookConfig.webhookSecret) {
+                throw new Error("webhookSecret is required for Stripe webhook handler. " +
+                    "Set STRIPE_WEBHOOK_SECRET in your Convex environment variables.");
             }
-            return new Response(JSON.stringify({
-                code: affiliate.code,
-                displayName: affiliate.displayName,
-                valid: affiliate.status === "approved",
-            }), {
-                status: 200,
-                headers: { "Content-Type": "application/json" },
+            return httpActionGeneric(async (ctx, request) => {
+                const rawBody = await request.text();
+                const signature = request.headers.get("stripe-signature");
+                if (!signature) {
+                    return new Response(JSON.stringify({ error: "Missing stripe-signature header" }), { status: 400, headers: { "Content-Type": "application/json" } });
+                }
+                const isValid = await verifyStripeSignature(rawBody, signature, webhookConfig.webhookSecret);
+                if (!isValid) {
+                    return new Response(JSON.stringify({ error: "Invalid signature" }), {
+                        status: 401,
+                        headers: { "Content-Type": "application/json" },
+                    });
+                }
+                const event = JSON.parse(rawBody);
+                try {
+                    switch (event.type) {
+                        case "invoice.paid": {
+                            const invoice = event.data.object;
+                            await ctx.runMutation(component.commissions.createFromInvoice, {
+                                stripeInvoiceId: invoice.id,
+                                stripeCustomerId: invoice.customer,
+                                stripeChargeId: invoice.charge,
+                                stripeSubscriptionId: invoice.subscription,
+                                stripeProductId: invoice.lines?.data?.[0]?.price?.product,
+                                amountPaidCents: invoice.amount_paid,
+                                currency: invoice.currency,
+                                affiliateCode: invoice.metadata?.affiliate_code,
+                            });
+                            break;
+                        }
+                        case "charge.refunded": {
+                            const charge = event.data.object;
+                            await ctx.runMutation(component.commissions.reverseByCharge, {
+                                stripeChargeId: charge.id,
+                                reason: charge.refunds?.data?.[0]?.reason ?? "Charge refunded",
+                            });
+                            break;
+                        }
+                        case "checkout.session.completed": {
+                            const session = event.data.object;
+                            await ctx.runMutation(component.referrals.linkStripeCustomer, {
+                                stripeCustomerId: session.customer,
+                                userId: session.client_reference_id,
+                                affiliateCode: session.metadata?.affiliate_code,
+                            });
+                            break;
+                        }
+                    }
+                    return new Response(JSON.stringify({ received: true }), {
+                        status: 200,
+                        headers: { "Content-Type": "application/json" },
+                    });
+                }
+                catch (error) {
+                    console.error("Stripe webhook error:", error);
+                    return new Response(JSON.stringify({
+                        error: error instanceof Error ? error.message : "Unknown error",
+                    }), { status: 500, headers: { "Content-Type": "application/json" } });
+                }
             });
-        }),
-    });
+        },
+    };
 }
 // =============================================================================
-// Stripe Webhook Handler
+// Stripe Webhook Signature Verification
 // =============================================================================
 /**
  * Verify Stripe webhook signature without the Stripe SDK.
@@ -930,98 +1025,6 @@ async function verifyStripeSignature(payload, signature, secret) {
     // Constant-time comparison
     return sig === expectedSig;
 }
-/**
- * Create a Stripe webhook handler that processes affiliate-related events.
- * Handles invoice.paid, charge.refunded, and checkout.session.completed events.
- *
- * @example
- * ```typescript
- * import { httpRouter } from "convex/server";
- * import { createStripeWebhookHandler } from "convex-affiliates";
- * import { components } from "./_generated/api";
- *
- * const http = httpRouter();
- *
- * http.route({
- *   path: "/webhooks/stripe",
- *   method: "POST",
- *   handler: createStripeWebhookHandler(components.affiliates, {
- *     webhookSecret: process.env.STRIPE_WEBHOOK_SECRET!,
- *   }),
- * });
- *
- * export default http;
- * ```
- */
-export function createStripeWebhookHandler(component, config) {
-    // Validate webhook secret at creation time for helpful error messages
-    if (!config.webhookSecret) {
-        throw new Error("webhookSecret is required for Stripe webhook handler. " +
-            "Set STRIPE_WEBHOOK_SECRET in your Convex environment variables.");
-    }
-    return httpActionGeneric(async (ctx, request) => {
-        // Get raw body for signature verification
-        const rawBody = await request.text();
-        // Verify signature (required)
-        const signature = request.headers.get("stripe-signature");
-        if (!signature) {
-            return new Response(JSON.stringify({ error: "Missing stripe-signature header" }), { status: 400, headers: { "Content-Type": "application/json" } });
-        }
-        const isValid = await verifyStripeSignature(rawBody, signature, config.webhookSecret);
-        if (!isValid) {
-            return new Response(JSON.stringify({ error: "Invalid signature" }), {
-                status: 401,
-                headers: { "Content-Type": "application/json" },
-            });
-        }
-        const event = JSON.parse(rawBody);
-        try {
-            switch (event.type) {
-                case "invoice.paid": {
-                    const invoice = event.data.object;
-                    await ctx.runMutation(component.commissions.createFromInvoice, {
-                        stripeInvoiceId: invoice.id,
-                        stripeCustomerId: invoice.customer,
-                        stripeChargeId: invoice.charge,
-                        stripeSubscriptionId: invoice.subscription,
-                        stripeProductId: invoice.lines?.data?.[0]?.price?.product,
-                        amountPaidCents: invoice.amount_paid,
-                        currency: invoice.currency,
-                        affiliateCode: invoice.metadata?.affiliate_code,
-                    });
-                    break;
-                }
-                case "charge.refunded": {
-                    const charge = event.data.object;
-                    await ctx.runMutation(component.commissions.reverseByCharge, {
-                        stripeChargeId: charge.id,
-                        reason: charge.refunds?.data?.[0]?.reason ?? "Charge refunded",
-                    });
-                    break;
-                }
-                case "checkout.session.completed": {
-                    const session = event.data.object;
-                    await ctx.runMutation(component.referrals.linkStripeCustomer, {
-                        stripeCustomerId: session.customer,
-                        userId: session.client_reference_id,
-                        affiliateCode: session.metadata?.affiliate_code,
-                    });
-                    break;
-                }
-            }
-            return new Response(JSON.stringify({ received: true }), {
-                status: 200,
-                headers: { "Content-Type": "application/json" },
-            });
-        }
-        catch (error) {
-            console.error("Stripe webhook error:", error);
-            return new Response(JSON.stringify({
-                error: error instanceof Error ? error.message : "Unknown error",
-            }), { status: 500, headers: { "Content-Type": "application/json" } });
-        }
-    });
-}
 /**
  * Get Stripe event handlers for affiliate tracking.
  * Optionally merge with your own handlers (affiliate runs first).