@devwithbobby/loops 0.1.9 → 0.1.11

package/dist/client/index.d.ts

@@ -148,11 +148,18 @@ export declare class Loops {
     /**
      * Trigger a loop for a contact
      * Loops are automated email sequences that can be triggered by events
+     *
+     * Note: Loops.so doesn't have a direct loop trigger endpoint.
+     * Loops are triggered through events. Make sure your loop is configured
+     * in the Loops dashboard to listen for events.
+     *
+     * @param options.eventName - Optional event name. If not provided, uses `loop_{loopId}`
      */
     triggerLoop(ctx: RunActionCtx, options: {
         loopId: string;
         email: string;
         dataVariables?: Record<string, any>;
+        eventName?: string;
     }): Promise<FunctionReturnType<Action>>;
     /**
      * For easy re-exporting.

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

@@ -200,6 +200,12 @@ export class Loops {
     /**
      * Trigger a loop for a contact
      * Loops are automated email sequences that can be triggered by events
+     *
+     * Note: Loops.so doesn't have a direct loop trigger endpoint.
+     * Loops are triggered through events. Make sure your loop is configured
+     * in the Loops dashboard to listen for events.
+     *
+     * @param options.eventName - Optional event name. If not provided, uses `loop_{loopId}`
      */
     async triggerLoop(ctx, options) {
         return ctx.runAction(this.component.lib.triggerLoop, {

package/dist/component/convex.config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"convex.config.d.ts","sourceRoot":"","sources":["../../src/component/convex.config.ts"],"names":[],"mappings":"AAGA,QAAA,MAAM,SAAS,KAA2B,CAAC;AAuB3C,eAAe,SAAS,CAAC"}
+{"version":3,"file":"convex.config.d.ts","sourceRoot":"","sources":["../../src/component/convex.config.ts"],"names":[],"mappings":"AAGA,QAAA,MAAM,SAAS,KAA2B,CAAC;AAwB3C,eAAe,SAAS,CAAC"}

package/dist/component/convex.config.js

@@ -9,6 +9,7 @@ component.export(api, {
     unsubscribeContact: api.lib.unsubscribeContact,
     resubscribeContact: api.lib.resubscribeContact,
     countContacts: api.lib.countContacts,
+    listContacts: api.lib.listContacts,
     sendTransactional: api.lib.sendTransactional,
     sendEvent: api.lib.sendEvent,
     sendCampaign: api.lib.sendCampaign,

package/dist/component/lib.d.ts

@@ -15,6 +15,12 @@ export declare const logEmailOperation: any;
  * Can filter by audience criteria (userGroup, source, subscribed status)
  */
 export declare const countContacts: any;
+/**
+ * List contacts from the database with pagination
+ * Can filter by audience criteria (userGroup, source, subscribed status)
+ * Returns actual contact data, not just a count
+ */
+export declare const listContacts: any;
 /**
  * Add or update a contact in Loops
  * This function tries to create a contact, and if the email already exists (409),
@@ -39,13 +45,26 @@ export declare const sendEvent: any;
 export declare const deleteContact: any;
 /**
  * Send a campaign to contacts
- * Campaigns are one-time email sends to a segment or list of contacts
+ * Note: Campaigns in Loops.so are typically managed from the dashboard.
+ * This function sends transactional emails to multiple contacts as a workaround.
+ * If you need true campaign functionality, use the Loops.so dashboard or contact their support.
  */
 export declare const sendCampaign: any;
 /**
  * Trigger a loop for a contact
- * Loops are automated email sequences that can be triggered by events
- * This is similar to sendEvent but specifically for loops
+ * Note: Loops in Loops.so are triggered through events, not a direct API endpoint.
+ * This function uses the events endpoint to trigger the loop.
+ * The loop must be configured in the Loops dashboard to listen for events.
+ *
+ * IMPORTANT: Loops.so doesn't have a direct /loops/trigger endpoint.
+ * Loops are triggered by sending events. Make sure your loop in the dashboard
+ * is configured to trigger on an event name (e.g., "loop_trigger").
+ *
+ * If you need to trigger a specific loop, you should:
+ * 1. Configure the loop in the dashboard to listen for a specific event name
+ * 2. Use sendEvent() with that event name instead
+ *
+ * This function is kept for backwards compatibility but works by sending an event.
  */
 export declare const triggerLoop: any;
 /**

package/dist/component/lib.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lib.d.ts","sourceRoot":"","sources":["../../src/component/lib.ts"],"names":[],"mappings":"AA0BA;;GAEG;AACH,eAAO,MAAM,YAAY,KA6CvB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,aAAa,KAexB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB,KAgC5B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,aAAa,KAwCxB,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,UAAU,KAiHrB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,aAAa,KAoDxB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB,KAqD5B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,SAAS,KAgCpB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,aAAa,KA8BxB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,YAAY,KAkFvB,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,WAAW,KA+CtB,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,WAAW,KA2DtB,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,KAyD9B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,kBAAkB,KA+B7B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,kBAAkB,KA+B7B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,mBAAmB,KAwC9B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,eAAe,KAwC1B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,aAAa,KAgDxB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,uBAAuB,KAsGlC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,uBAAuB,KA6ClC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,mBAAmB,KA6C9B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,oBAAoB,KA8B/B,CAAC"}
+{"version":3,"file":"lib.d.ts","sourceRoot":"","sources":["../../src/component/lib.ts"],"names":[],"mappings":"AA0BA;;GAEG;AACH,eAAO,MAAM,YAAY,KA6CvB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,aAAa,KAexB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB,KAgC5B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,aAAa,KAwCxB,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,YAAY,KA8EvB,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,UAAU,KAiHrB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,aAAa,KAoDxB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB,KAqD5B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,SAAS,KAgCpB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,aAAa,KA8BxB,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,YAAY,KAiHvB,CAAC;AAEH;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,WAAW,KAyDtB,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,WAAW,KA2DtB,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,KAyD9B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,kBAAkB,KA+B7B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,kBAAkB,KA+B7B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,mBAAmB,KAwC9B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,eAAe,KAwC1B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,aAAa,KAgDxB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,uBAAuB,KAsGlC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,uBAAuB,KA6ClC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,mBAAmB,KA6C9B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,oBAAoB,KA8B/B,CAAC"}

package/dist/component/lib.js

@@ -175,6 +175,86 @@ export const countContacts = zq({
         return contacts.length;
     },
 });
+/**
+ * List contacts from the database with pagination
+ * Can filter by audience criteria (userGroup, source, subscribed status)
+ * Returns actual contact data, not just a count
+ */
+export const listContacts = zq({
+    args: z.object({
+        userGroup: z.string().optional(),
+        source: z.string().optional(),
+        subscribed: z.boolean().optional(),
+        limit: z.number().min(1).max(1000).default(100),
+        offset: z.number().min(0).default(0),
+    }),
+    returns: z.object({
+        contacts: z.array(z.object({
+            _id: z.string(),
+            email: z.string(),
+            firstName: z.string().optional(),
+            lastName: z.string().optional(),
+            userId: z.string().optional(),
+            source: z.string().optional(),
+            subscribed: z.boolean(),
+            userGroup: z.string().optional(),
+            loopsContactId: z.string().optional(),
+            createdAt: z.number(),
+            updatedAt: z.number(),
+        })),
+        total: z.number(),
+        limit: z.number(),
+        offset: z.number(),
+        hasMore: z.boolean(),
+    }),
+    handler: async (ctx, args) => {
+        let allContacts;
+        // Get all contacts matching the filters
+        if (args.userGroup !== undefined) {
+            allContacts = await ctx.db
+                .query("contacts")
+                .withIndex("userGroup", (q) => q.eq("userGroup", args.userGroup))
+                .collect();
+        }
+        else if (args.source !== undefined) {
+            allContacts = await ctx.db
+                .query("contacts")
+                .withIndex("source", (q) => q.eq("source", args.source))
+                .collect();
+        }
+        else if (args.subscribed !== undefined) {
+            allContacts = await ctx.db
+                .query("contacts")
+                .withIndex("subscribed", (q) => q.eq("subscribed", args.subscribed))
+                .collect();
+        }
+        else {
+            allContacts = await ctx.db.query("contacts").collect();
+        }
+        // Apply additional filters (for cases where we need to filter by multiple criteria)
+        if (args.userGroup !== undefined && allContacts) {
+            allContacts = allContacts.filter((c) => c.userGroup === args.userGroup);
+        }
+        if (args.source !== undefined && allContacts) {
+            allContacts = allContacts.filter((c) => c.source === args.source);
+        }
+        if (args.subscribed !== undefined && allContacts) {
+            allContacts = allContacts.filter((c) => c.subscribed === args.subscribed);
+        }
+        // Sort by createdAt (newest first)
+        allContacts.sort((a, b) => b.createdAt - a.createdAt);
+        const total = allContacts.length;
+        const paginatedContacts = allContacts.slice(args.offset, args.offset + args.limit);
+        const hasMore = args.offset + args.limit < total;
+        return {
+            contacts: paginatedContacts,
+            total,
+            limit: args.limit,
+            offset: args.offset,
+            hasMore,
+        };
+    },
+});
 /**
  * Add or update a contact in Loops
  * This function tries to create a contact, and if the email already exists (409),
@@ -450,7 +530,9 @@ export const deleteContact = za({
 });
 /**
  * Send a campaign to contacts
- * Campaigns are one-time email sends to a segment or list of contacts
+ * Note: Campaigns in Loops.so are typically managed from the dashboard.
+ * This function sends transactional emails to multiple contacts as a workaround.
+ * If you need true campaign functionality, use the Loops.so dashboard or contact their support.
  */
 export const sendCampaign = za({
     args: z.object({
@@ -469,68 +551,102 @@ export const sendCampaign = za({
     returns: z.object({
         success: z.boolean(),
         messageId: z.string().optional(),
+        sent: z.number().optional(),
+        errors: z.array(z.object({
+            email: z.string(),
+            error: z.string(),
+        })).optional(),
     }),
     handler: async (ctx, args) => {
-        const payload = {
-            campaignId: args.campaignId,
-        };
-        if (args.emails && args.emails.length > 0) {
-            payload.emails = args.emails;
+        // Loops.so doesn't have a campaigns API endpoint
+        // As a workaround, we'll send transactional emails to the specified contacts
+        if (!args.transactionalId) {
+            throw new Error("Campaigns require a transactionalId. " +
+                "Loops.so campaigns are managed from the dashboard. " +
+                "This function sends transactional emails to multiple contacts as a workaround. " +
+                "Please provide a transactionalId to send emails.");
         }
-        if (args.transactionalId) {
-            payload.transactionalId = args.transactionalId;
-        }
-        if (args.dataVariables) {
-            payload.dataVariables = args.dataVariables;
-        }
-        if (args.audienceFilters) {
-            payload.audienceFilters = args.audienceFilters;
-        }
-        const response = await fetch(`${LOOPS_API_BASE_URL}/campaigns/send`, {
-            method: "POST",
-            headers: {
-                Authorization: `Bearer ${args.apiKey}`,
-                "Content-Type": "application/json",
-            },
-            body: JSON.stringify(payload),
-        });
-        if (!response.ok) {
-            const errorText = await response.text();
-            console.error(`Loops API error [${response.status}]:`, errorText);
-            throw sanitizeError(response.status, errorText);
+        if (!args.emails || args.emails.length === 0) {
+            // If no emails provided but audienceFilters are, we need to query contacts
+            if (args.audienceFilters) {
+                // Query contacts from our database based on filters
+                const contacts = await ctx.runQuery((internal.lib).countContacts, {
+                    userGroup: args.audienceFilters.userGroup,
+                    source: args.audienceFilters.source,
+                });
+                if (contacts === 0) {
+                    return {
+                        success: false,
+                        sent: 0,
+                        errors: [{ email: "audience", error: "No contacts found matching filters" }],
+                    };
+                }
+                // Note: We can't get email list from countContacts, so this is a limitation
+                throw new Error("Campaigns with audienceFilters require emails to be specified. " +
+                    "Please provide the emails array with contacts to send to.");
+            }
+            throw new Error("Campaigns require either emails array or audienceFilters. " +
+                "Please provide at least one email address or use transactional emails for single contacts.");
         }
-        const data = (await response.json());
-        if (args.emails && args.emails.length > 0) {
-            for (const email of args.emails) {
+        // Send transactional emails to each contact as a workaround for campaigns
+        let sent = 0;
+        const errors = [];
+        for (const email of args.emails) {
+            try {
+                await ctx.runAction((internal.lib).sendTransactional, {
+                    apiKey: args.apiKey,
+                    transactionalId: args.transactionalId,
+                    email,
+                    dataVariables: args.dataVariables,
+                });
+                sent++;
+                // Log as campaign operation
                 await ctx.runMutation((internal.lib).logEmailOperation, {
                     operationType: "campaign",
                     email,
                     success: true,
                     campaignId: args.campaignId,
-                    messageId: data.messageId,
+                    transactionalId: args.transactionalId,
+                });
+            }
+            catch (error) {
+                errors.push({
+                    email,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+                // Log failed campaign operation
+                await ctx.runMutation((internal.lib).logEmailOperation, {
+                    operationType: "campaign",
+                    email,
+                    success: false,
+                    campaignId: args.campaignId,
+                    transactionalId: args.transactionalId,
+                    metadata: { error: error instanceof Error ? error.message : String(error) },
                 });
             }
-        }
-        else {
-            await ctx.runMutation((internal.lib).logEmailOperation, {
-                operationType: "campaign",
-                email: "audience",
-                success: true,
-                campaignId: args.campaignId,
-                messageId: data.messageId,
-                metadata: { audienceFilters: args.audienceFilters },
-            });
         }
         return {
-            success: true,
-            messageId: data.messageId,
+            success: sent > 0,
+            sent,
+            errors: errors.length > 0 ? errors : undefined,
         };
     },
 });
 /**
  * Trigger a loop for a contact
- * Loops are automated email sequences that can be triggered by events
- * This is similar to sendEvent but specifically for loops
+ * Note: Loops in Loops.so are triggered through events, not a direct API endpoint.
+ * This function uses the events endpoint to trigger the loop.
+ * The loop must be configured in the Loops dashboard to listen for events.
+ *
+ * IMPORTANT: Loops.so doesn't have a direct /loops/trigger endpoint.
+ * Loops are triggered by sending events. Make sure your loop in the dashboard
+ * is configured to trigger on an event name (e.g., "loop_trigger").
+ *
+ * If you need to trigger a specific loop, you should:
+ * 1. Configure the loop in the dashboard to listen for a specific event name
+ * 2. Use sendEvent() with that event name instead
+ *
+ * This function is kept for backwards compatibility but works by sending an event.
  */
 export const triggerLoop = za({
     args: z.object({
@@ -538,41 +654,53 @@ export const triggerLoop = za({
         loopId: z.string(),
         email: z.string().email(),
         dataVariables: z.record(z.string(), z.any()).optional(),
+        eventName: z.string().optional(), // Event name that triggers the loop
     }),
     returns: z.object({
         success: z.boolean(),
+        warning: z.string().optional(),
     }),
     handler: async (ctx, args) => {
-        const response = await fetch(`${LOOPS_API_BASE_URL}/loops/trigger`, {
-            method: "POST",
-            headers: {
-                Authorization: `Bearer ${args.apiKey}`,
-                "Content-Type": "application/json",
-            },
-            body: JSON.stringify({
-                loopId: args.loopId,
+        // Loops.so doesn't have a /loops/trigger endpoint
+        // Loops are triggered through events. We'll use the events endpoint.
+        // Default event name if not provided
+        const eventName = args.eventName || `loop_${args.loopId}`;
+        try {
+            // Send event to trigger the loop
+            await ctx.runAction((internal.lib).sendEvent, {
+                apiKey: args.apiKey,
                 email: args.email,
-                dataVariables: args.dataVariables,
-            }),
-        });
-        if (!response.ok) {
-            const errorText = await response.text();
-            console.error(`Loops API error [${response.status}]:`, errorText);
+                eventName,
+                eventProperties: {
+                    ...args.dataVariables,
+                    loopId: args.loopId, // Include loopId in event properties
+                },
+            });
+            // Log as loop operation
+            await ctx.runMutation((internal.lib).logEmailOperation, {
+                operationType: "loop",
+                email: args.email,
+                success: true,
+                loopId: args.loopId,
+                eventName,
+            });
+            return {
+                success: true,
+                warning: "Loops are triggered via events. Ensure your loop is configured to listen for this event.",
+            };
+        }
+        catch (error) {
+            // Log failed loop operation
             await ctx.runMutation((internal.lib).logEmailOperation, {
                 operationType: "loop",
                 email: args.email,
                 success: false,
                 loopId: args.loopId,
+                eventName,
+                metadata: { error: error instanceof Error ? error.message : String(error) },
             });
-            throw sanitizeError(response.status, errorText);
+            throw error;
         }
-        await ctx.runMutation((internal.lib).logEmailOperation, {
-            operationType: "loop",
-            email: args.email,
-            success: true,
-            loopId: args.loopId,
-        });
-        return { success: true };
     },
 });
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devwithbobby/loops",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "description": "Convex component for integrating with Loops.so email marketing platform",
   "license": "Apache-2.0",
   "type": "module",

package/src/client/index.ts

@@ -340,6 +340,12 @@ export class Loops {
 	/**
 	 * Trigger a loop for a contact
 	 * Loops are automated email sequences that can be triggered by events
+	 * 
+	 * Note: Loops.so doesn't have a direct loop trigger endpoint.
+	 * Loops are triggered through events. Make sure your loop is configured
+	 * in the Loops dashboard to listen for events.
+	 * 
+	 * @param options.eventName - Optional event name. If not provided, uses `loop_{loopId}`
 	 */
 	async triggerLoop(
 		ctx: RunActionCtx,
@@ -347,6 +353,7 @@ export class Loops {
 			loopId: string;
 			email: string;
 			dataVariables?: Record<string, any>;
+			eventName?: string; // Event name that triggers the loop
 		},
 	) {
 		return ctx.runAction((this.component.lib as any).triggerLoop, {

package/src/component/convex.config.ts

@@ -10,6 +10,7 @@ const component = defineComponent("loops");
 	unsubscribeContact: api.lib.unsubscribeContact,
 	resubscribeContact: api.lib.resubscribeContact,
 	countContacts: api.lib.countContacts,
+	listContacts: api.lib.listContacts,
 	sendTransactional: api.lib.sendTransactional,
 	sendEvent: api.lib.sendEvent,
 	sendCampaign: api.lib.sendCampaign,

package/src/component/lib.ts

@@ -177,6 +177,91 @@ export const countContacts = zq({
 	},
 });
 
+/**
+ * List contacts from the database with pagination
+ * Can filter by audience criteria (userGroup, source, subscribed status)
+ * Returns actual contact data, not just a count
+ */
+export const listContacts = zq({
+	args: z.object({
+		userGroup: z.string().optional(),
+		source: z.string().optional(),
+		subscribed: z.boolean().optional(),
+		limit: z.number().min(1).max(1000).default(100),
+		offset: z.number().min(0).default(0),
+	}),
+	returns: z.object({
+		contacts: z.array(
+			z.object({
+				_id: z.string(),
+				email: z.string(),
+				firstName: z.string().optional(),
+				lastName: z.string().optional(),
+				userId: z.string().optional(),
+				source: z.string().optional(),
+				subscribed: z.boolean(),
+				userGroup: z.string().optional(),
+				loopsContactId: z.string().optional(),
+				createdAt: z.number(),
+				updatedAt: z.number(),
+			}),
+		),
+		total: z.number(),
+		limit: z.number(),
+		offset: z.number(),
+		hasMore: z.boolean(),
+	}),
+	handler: async (ctx, args) => {
+		let allContacts;
+		
+		// Get all contacts matching the filters
+		if (args.userGroup !== undefined) {
+			allContacts = await ctx.db
+				.query("contacts")
+				.withIndex("userGroup", (q) => q.eq("userGroup", args.userGroup))
+				.collect();
+		} else if (args.source !== undefined) {
+			allContacts = await ctx.db
+				.query("contacts")
+				.withIndex("source", (q) => q.eq("source", args.source))
+				.collect();
+		} else if (args.subscribed !== undefined) {
+			allContacts = await ctx.db
+				.query("contacts")
+				.withIndex("subscribed", (q) => q.eq("subscribed", args.subscribed))
+				.collect();
+		} else {
+			allContacts = await ctx.db.query("contacts").collect();
+		}
+
+		// Apply additional filters (for cases where we need to filter by multiple criteria)
+		if (args.userGroup !== undefined && allContacts) {
+			allContacts = allContacts.filter((c) => c.userGroup === args.userGroup);
+		}
+		if (args.source !== undefined && allContacts) {
+			allContacts = allContacts.filter((c) => c.source === args.source);
+		}
+		if (args.subscribed !== undefined && allContacts) {
+			allContacts = allContacts.filter((c) => c.subscribed === args.subscribed);
+		}
+
+		// Sort by createdAt (newest first)
+		allContacts.sort((a, b) => b.createdAt - a.createdAt);
+
+		const total = allContacts.length;
+		const paginatedContacts = allContacts.slice(args.offset, args.offset + args.limit);
+		const hasMore = args.offset + args.limit < total;
+
+		return {
+			contacts: paginatedContacts,
+			total,
+			limit: args.limit,
+			offset: args.offset,
+			hasMore,
+		};
+	},
+});
+
 /**
  * Add or update a contact in Loops
  * This function tries to create a contact, and if the email already exists (409),
@@ -486,7 +571,9 @@ export const deleteContact = za({
 
 /**
  * Send a campaign to contacts
- * Campaigns are one-time email sends to a segment or list of contacts
+ * Note: Campaigns in Loops.so are typically managed from the dashboard.
+ * This function sends transactional emails to multiple contacts as a workaround.
+ * If you need true campaign functionality, use the Loops.so dashboard or contact their support.
  */
 export const sendCampaign = za({
 	args: z.object({
@@ -505,77 +592,119 @@ export const sendCampaign = za({
 	returns: z.object({
 		success: z.boolean(),
 		messageId: z.string().optional(),
+		sent: z.number().optional(),
+		errors: z.array(z.object({
+			email: z.string(),
+			error: z.string(),
+		})).optional(),
 	}),
 	handler: async (ctx, args) => {
-		const payload: Record<string, any> = {
-			campaignId: args.campaignId,
-		};
-
-		if (args.emails && args.emails.length > 0) {
-			payload.emails = args.emails;
-		}
-
-		if (args.transactionalId) {
-			payload.transactionalId = args.transactionalId;
-		}
-
-		if (args.dataVariables) {
-			payload.dataVariables = args.dataVariables;
-		}
-
-		if (args.audienceFilters) {
-			payload.audienceFilters = args.audienceFilters;
+		// Loops.so doesn't have a campaigns API endpoint
+		// As a workaround, we'll send transactional emails to the specified contacts
+		
+		if (!args.transactionalId) {
+			throw new Error(
+				"Campaigns require a transactionalId. " +
+				"Loops.so campaigns are managed from the dashboard. " +
+				"This function sends transactional emails to multiple contacts as a workaround. " +
+				"Please provide a transactionalId to send emails."
+			);
 		}
 
-		const response = await fetch(`${LOOPS_API_BASE_URL}/campaigns/send`, {
-			method: "POST",
-			headers: {
-				Authorization: `Bearer ${args.apiKey}`,
-				"Content-Type": "application/json",
-			},
-			body: JSON.stringify(payload),
-		});
-
-		if (!response.ok) {
-			const errorText = await response.text();
-			console.error(`Loops API error [${response.status}]:`, errorText);
-			throw sanitizeError(response.status, errorText);
+		if (!args.emails || args.emails.length === 0) {
+			// If no emails provided but audienceFilters are, we need to query contacts
+			if (args.audienceFilters) {
+				// Query contacts from our database based on filters
+				const contacts = await ctx.runQuery(((internal as any).lib).countContacts as any, {
+					userGroup: args.audienceFilters.userGroup,
+					source: args.audienceFilters.source,
+				});
+				
+				if (contacts === 0) {
+					return {
+						success: false,
+						sent: 0,
+						errors: [{ email: "audience", error: "No contacts found matching filters" }],
+					};
+				}
+				
+				// Note: We can't get email list from countContacts, so this is a limitation
+				throw new Error(
+					"Campaigns with audienceFilters require emails to be specified. " +
+					"Please provide the emails array with contacts to send to."
+				);
+			}
+			
+			throw new Error(
+				"Campaigns require either emails array or audienceFilters. " +
+				"Please provide at least one email address or use transactional emails for single contacts."
+			);
 		}
 
-		const data = (await response.json()) as { messageId?: string };
+		// Send transactional emails to each contact as a workaround for campaigns
+		let sent = 0;
+		const errors: Array<{ email: string; error: string }> = [];
 
-		if (args.emails && args.emails.length > 0) {
-			for (const email of args.emails) {
+		for (const email of args.emails) {
+			try {
+				await ctx.runAction(((internal as any).lib).sendTransactional as any, {
+					apiKey: args.apiKey,
+					transactionalId: args.transactionalId!,
+					email,
+					dataVariables: args.dataVariables,
+				});
+				
+				sent++;
+				
+				// Log as campaign operation
 				await ctx.runMutation(((internal as any).lib).logEmailOperation as any, {
 					operationType: "campaign",
 					email,
 					success: true,
 					campaignId: args.campaignId,
-					messageId: data.messageId,
+					transactionalId: args.transactionalId,
+				});
+			} catch (error) {
+				errors.push({
+					email,
+					error: error instanceof Error ? error.message : String(error),
+				});
+				
+				// Log failed campaign operation
+				await ctx.runMutation(((internal as any).lib).logEmailOperation as any, {
+					operationType: "campaign",
+					email,
+					success: false,
+					campaignId: args.campaignId,
+					transactionalId: args.transactionalId,
+					metadata: { error: error instanceof Error ? error.message : String(error) },
 				});
 			}
-		} else {
-			await ctx.runMutation(((internal as any).lib).logEmailOperation as any, {
-				operationType: "campaign",
-				email: "audience",
-				success: true,
-				campaignId: args.campaignId,
-				messageId: data.messageId,
-				metadata: { audienceFilters: args.audienceFilters },
-			});
 		}
 
 		return {
-			success: true,
-			messageId: data.messageId,
+			success: sent > 0,
+			sent,
+			errors: errors.length > 0 ? errors : undefined,
 		};
 	},
 });
 
 /**
  * Trigger a loop for a contact
- * Loops are automated email sequences that can be triggered by events
- * This is similar to sendEvent but specifically for loops
+ * Note: Loops in Loops.so are triggered through events, not a direct API endpoint.
+ * This function uses the events endpoint to trigger the loop.
+ * The loop must be configured in the Loops dashboard to listen for events.
+ * 
+ * IMPORTANT: Loops.so doesn't have a direct /loops/trigger endpoint.
+ * Loops are triggered by sending events. Make sure your loop in the dashboard
+ * is configured to trigger on an event name (e.g., "loop_trigger").
+ * 
+ * If you need to trigger a specific loop, you should:
+ * 1. Configure the loop in the dashboard to listen for a specific event name
+ * 2. Use sendEvent() with that event name instead
+ * 
+ * This function is kept for backwards compatibility but works by sending an event.
  */
 export const triggerLoop = za({
 	args: z.object({
@@ -583,46 +712,56 @@ export const triggerLoop = za({
 		loopId: z.string(),
 		email: z.string().email(),
 		dataVariables: z.record(z.string(), z.any()).optional(),
+		eventName: z.string().optional(), // Event name that triggers the loop
 	}),
 	returns: z.object({
 		success: z.boolean(),
+		warning: z.string().optional(),
 	}),
 	handler: async (ctx, args) => {
-		const response = await fetch(`${LOOPS_API_BASE_URL}/loops/trigger`, {
-			method: "POST",
-			headers: {
-				Authorization: `Bearer ${args.apiKey}`,
-				"Content-Type": "application/json",
-			},
-			body: JSON.stringify({
-				loopId: args.loopId,
+		// Loops.so doesn't have a /loops/trigger endpoint
+		// Loops are triggered through events. We'll use the events endpoint.
+		// Default event name if not provided
+		const eventName = args.eventName || `loop_${args.loopId}`;
+		
+		try {
+			// Send event to trigger the loop
+			await ctx.runAction(((internal as any).lib).sendEvent as any, {
+				apiKey: args.apiKey,
 				email: args.email,
-				dataVariables: args.dataVariables,
-			}),
-		});
+				eventName,
+				eventProperties: {
+					...args.dataVariables,
+					loopId: args.loopId, // Include loopId in event properties
+				},
+			});
 
-		if (!response.ok) {
-			const errorText = await response.text();
-			console.error(`Loops API error [${response.status}]:`, errorText);
-			
+			// Log as loop operation
+			await ctx.runMutation(((internal as any).lib).logEmailOperation as any, {
+				operationType: "loop",
+				email: args.email,
+				success: true,
+				loopId: args.loopId,
+				eventName,
+			});
+
+			return {
+				success: true,
+				warning: "Loops are triggered via events. Ensure your loop is configured to listen for this event.",
+			};
+		} catch (error) {
+			// Log failed loop operation
 			await ctx.runMutation(((internal as any).lib).logEmailOperation as any, {
 				operationType: "loop",
 				email: args.email,
 				success: false,
 				loopId: args.loopId,
+				eventName,
+				metadata: { error: error instanceof Error ? error.message : String(error) },
 			});
 			
-			throw sanitizeError(response.status, errorText);
+			throw error;
 		}
-
-		await ctx.runMutation(((internal as any).lib).logEmailOperation as any, {
-			operationType: "loop",
-			email: args.email,
-			success: true,
-			loopId: args.loopId,
-		});
-
-		return { success: true };
 	},
 });