@devwithbobby/loops 0.1.10 → 0.1.12

package/README.md

@@ -2,14 +2,13 @@
 
 [![npm version](https://img.shields.io/npm/v/@devwithbobby/loops.svg)](https://www.npmjs.com/package/@devwithbobby/loops)
 
-A Convex component for integrating with [Loops.so](https://loops.so) email marketing platform. Send transactional emails, manage contacts, trigger campaigns and loops, and monitor email operations with built-in spam detection and rate limiting.
+A Convex component for integrating with [Loops.so](https://loops.so) email marketing platform. Send transactional emails, manage contacts, trigger loops, and monitor email operations with built-in spam detection and rate limiting.
 
 ## Features
 
 - ✅ **Contact Management** - Create, update, find, and delete contacts
 - ✅ **Transactional Emails** - Send one-off emails with templates
 - ✅ **Events** - Trigger email workflows based on events
-- ✅ **Campaigns** - Send campaigns to audiences or specific contacts
 - ✅ **Loops** - Trigger automated email sequences
 - ✅ **Monitoring** - Track all email operations with spam detection
 - ✅ **Rate Limiting** - Built-in rate limiting queries for abuse prevention
@@ -201,26 +200,6 @@ await loops.sendEvent(ctx, {
 });
 ```
 
-#### Send Campaign
-
-```typescript
-// Send to specific emails
-await loops.sendCampaign(ctx, {
-  campaignId: "campaign-id-from-loops",
-  emails: ["user1@example.com", "user2@example.com"],
-  dataVariables: { discount: "20%" },
-});
-
-// Send to audience
-await loops.sendCampaign(ctx, {
-  campaignId: "campaign-id-from-loops",
-  audienceFilters: {
-    userGroup: "premium",
-    source: "webapp",
-  },
-});
-```
-
 #### Trigger Loop (Automated Sequence)
 
 ```typescript
@@ -354,7 +333,6 @@ export const {
   updateContact,
   sendTransactional,
   sendEvent,
-  sendCampaign,
   triggerLoop,
   countContacts,
   // ... all other functions
@@ -488,7 +466,6 @@ This component implements the following Loops.so API endpoints:
 - ✅ Count Contacts (custom implementation)
 - ✅ Send Transactional Email
 - ✅ Send Event
-- ✅ Send Campaign
 - ✅ Trigger Loop
 
 ## Contributing

package/dist/client/index.d.ts

@@ -77,6 +77,18 @@ export declare class Loops {
         source?: string;
         subscribed?: boolean;
     }): Promise<FunctionReturnType<Query>>;
+    /**
+     * List contacts with pagination and optional filters
+     * Returns actual contact data, not just a count
+     * This queries the component's local database, not Loops API
+     */
+    listContacts(ctx: RunQueryCtx, options?: {
+        userGroup?: string;
+        source?: string;
+        subscribed?: boolean;
+        limit?: number;
+        offset?: number;
+    }): Promise<FunctionReturnType<Query>>;
     /**
      * Detect spam patterns: emails sent to the same recipient too frequently
      */
@@ -131,20 +143,6 @@ export declare class Loops {
      * Delete a contact from Loops
      */
     deleteContact(ctx: RunActionCtx, email: string): Promise<FunctionReturnType<Action>>;
-    /**
-     * Send a campaign to contacts
-     * Campaigns are one-time email sends to a segment or list of contacts
-     */
-    sendCampaign(ctx: RunActionCtx, options: {
-        campaignId: string;
-        emails?: string[];
-        transactionalId?: string;
-        dataVariables?: Record<string, any>;
-        audienceFilters?: {
-            userGroup?: string;
-            source?: string;
-        };
-    }): Promise<FunctionReturnType<Action>>;
     /**
      * Trigger a loop for a contact
      * Loops are automated email sequences that can be triggered by events
@@ -165,7 +163,7 @@ export declare class Loops {
      * For easy re-exporting.
      * Apps can do
      * ```ts
-     * export const { addContact, sendTransactional, sendEvent, sendCampaign, triggerLoop } = loops.api();
+     * export const { addContact, sendTransactional, sendEvent, triggerLoop } = loops.api();
      * ```
      */
     api(): {
@@ -174,7 +172,6 @@ export declare class Loops {
         sendTransactional: any;
         sendEvent: any;
         deleteContact: any;
-        sendCampaign: any;
         triggerLoop: any;
         findContact: any;
         batchCreateContacts: any;

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":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gCAAgC,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEpE,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;AAE5C,MAAM,WAAW,WAAW;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,yBAAyB;IACzC,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,YAAY;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACtC;AAED,qBAAa,KAAK;IACjB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;IAC3C,SAAgB,OAAO,CAAC,EAAE;QACzB,MAAM,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;gBAGD,SAAS,EAAE,cAAc,EACzB,OAAO,CAAC,EAAE;QACT,MAAM,CAAC,EAAE,MAAM,CAAC;KAChB;IAwCF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAEhC;;OAEG;IACG,UAAU,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW;IAsBxD;;OAEG;IACG,aAAa,CAClB,GAAG,EAAE,YAAY,EACjB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG;QAC/B,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KACpC;IASF;;OAEG;IACG,iBAAiB,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,yBAAyB;IAO7E;;OAEG;IACG,SAAS,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,YAAY;IAOxD;;;OAGG;IACG,WAAW,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM;IAOlD;;;OAGG;IACG,mBAAmB,CAAC,GAAG,EAAE,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE;IAOpE;;;OAGG;IACG,kBAAkB,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM;IAOzD;;;OAGG;IACG,kBAAkB,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM;IAOzD;;;;OAIG;IACG,aAAa,CAClB,GAAG,EAAE,WAAW,EAChB,OAAO,CAAC,EAAE;QACT,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,OAAO,CAAC;KACrB;IAKF;;;;OAIG;IACG,YAAY,CACjB,GAAG,EAAE,WAAW,EAChB,OAAO,CAAC,EAAE;QACT,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KAChB;IAWF;;OAEG;IACG,mBAAmB,CACxB,GAAG,EAAE,WAAW,EAChB,OAAO,CAAC,EAAE;QACT,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,qBAAqB,CAAC,EAAE,MAAM,CAAC;KAC/B;IAQF;;OAEG;IACG,eAAe,CACpB,GAAG,EAAE,WAAW,EAChB,OAAO,CAAC,EAAE;QACT,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC3B;IAQF;;OAEG;IACG,aAAa,CAClB,GAAG,EAAE,WAAW,EAChB,OAAO,CAAC,EAAE;QACT,YAAY,CAAC,EAAE,MAAM,CAAC;KACtB;IAOF;;OAEG;IACG,uBAAuB,CAC5B,GAAG,EAAE,WAAW,EAChB,OAAO,CAAC,EAAE;QACT,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC3B;IAQF;;OAEG;IACG,uBAAuB,CAC5B,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE;QACR,KAAK,EAAE,MAAM,CAAC;QACd,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;KAClB;IAKF;;OAEG;IACG,mBAAmB,CACxB,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE;QACR,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;KAClB;IAKF;;OAEG;IACG,oBAAoB,CACzB,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE;QACR,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;KAClB;IAKF;;OAEG;IACG,aAAa,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM;IAOpD;;;;;;;;;OASG;IACG,WAAW,CAChB,GAAG,EAAE,YAAY,EACjB,OAAO,EAAE;QACR,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACpC,SAAS,CAAC,EAAE,MAAM,CAAC;KACnB;IAQF;;;;;;OAMG;IACH,GAAG;;;;;;;;;;;;;;;;;;;;CA4LH"}

package/dist/client/index.js

@@ -125,6 +125,20 @@ export class Loops {
     async countContacts(ctx, options) {
         return ctx.runQuery(this.component.lib.countContacts, options ?? {});
     }
+    /**
+     * List contacts with pagination and optional filters
+     * Returns actual contact data, not just a count
+     * This queries the component's local database, not Loops API
+     */
+    async listContacts(ctx, options) {
+        return ctx.runQuery(this.component.lib.listContacts, {
+            userGroup: options?.userGroup,
+            source: options?.source,
+            subscribed: options?.subscribed,
+            limit: options?.limit ?? 100,
+            offset: options?.offset ?? 0,
+        });
+    }
     /**
      * Detect spam patterns: emails sent to the same recipient too frequently
      */
@@ -187,16 +201,6 @@ export class Loops {
             email,
         });
     }
-    /**
-     * Send a campaign to contacts
-     * Campaigns are one-time email sends to a segment or list of contacts
-     */
-    async sendCampaign(ctx, options) {
-        return ctx.runAction(this.component.lib.sendCampaign, {
-            apiKey: this.apiKey,
-            ...options,
-        });
-    }
     /**
      * Trigger a loop for a contact
      * Loops are automated email sequences that can be triggered by events
@@ -217,7 +221,7 @@ export class Loops {
      * For easy re-exporting.
      * Apps can do
      * ```ts
-     * export const { addContact, sendTransactional, sendEvent, sendCampaign, triggerLoop } = loops.api();
+     * export const { addContact, sendTransactional, sendEvent, triggerLoop } = loops.api();
      * ```
      */
     api() {
@@ -280,21 +284,6 @@ export class Loops {
                     return await this.deleteContact(ctx, args.email);
                 },
             }),
-            sendCampaign: actionGeneric({
-                args: {
-                    campaignId: v.string(),
-                    emails: v.optional(v.array(v.string())),
-                    transactionalId: v.optional(v.string()),
-                    dataVariables: v.optional(v.any()),
-                    audienceFilters: v.optional(v.object({
-                        userGroup: v.optional(v.string()),
-                        source: v.optional(v.string()),
-                    })),
-                },
-                handler: async (ctx, args) => {
-                    return await this.sendCampaign(ctx, args);
-                },
-            }),
             triggerLoop: actionGeneric({
                 args: {
                     loopId: v.string(),

package/dist/component/convex.config.js

@@ -9,9 +9,9 @@ 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,
     triggerLoop: api.lib.triggerLoop,
     deleteContact: api.lib.deleteContact,
     detectRecipientSpam: api.lib.detectRecipientSpam,

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),
@@ -37,13 +43,6 @@ export declare const sendEvent: any;
  * Delete a contact from Loops
  */
 export declare const deleteContact: any;
-/**
- * Send a campaign to 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
  * Note: Loops in Loops.so are triggered through events, not a direct API endpoint.

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;;;;;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"}
+{"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;;;;;;;;;;;;;;;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),
@@ -448,110 +528,6 @@ export const deleteContact = za({
         return { success: true };
     },
 });
-/**
- * Send a campaign to 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({
-        apiKey: z.string(),
-        campaignId: z.string(),
-        emails: z.array(z.string().email()).optional(),
-        transactionalId: z.string().optional(),
-        dataVariables: z.record(z.string(), z.any()).optional(),
-        audienceFilters: z
-            .object({
-            userGroup: z.string().optional(),
-            source: z.string().optional(),
-        })
-            .optional(),
-    }),
-    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) => {
-        // 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.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.");
-        }
-        // 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,
-                    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) },
-                });
-            }
-        }
-        return {
-            success: sent > 0,
-            sent,
-            errors: errors.length > 0 ? errors : undefined,
-        };
-    },
-});
 /**
  * Trigger a loop for a contact
  * Note: Loops in Loops.so are triggered through events, not a direct API endpoint.

package/package.json

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

package/src/client/index.ts

@@ -201,6 +201,30 @@ export class Loops {
 		return ctx.runQuery((this.component.lib as any).countContacts, options ?? {});
 	}
 
+	/**
+	 * List contacts with pagination and optional filters
+	 * Returns actual contact data, not just a count
+	 * This queries the component's local database, not Loops API
+	 */
+	async listContacts(
+		ctx: RunQueryCtx,
+		options?: {
+			userGroup?: string;
+			source?: string;
+			subscribed?: boolean;
+			limit?: number;
+			offset?: number;
+		},
+	) {
+		return ctx.runQuery((this.component.lib as any).listContacts, {
+			userGroup: options?.userGroup,
+			source: options?.source,
+			subscribed: options?.subscribed,
+			limit: options?.limit ?? 100,
+			offset: options?.offset ?? 0,
+		});
+	}
+
 	/**
 	 * Detect spam patterns: emails sent to the same recipient too frequently
 	 */
@@ -314,29 +338,6 @@ export class Loops {
 		});
 	}
 
-	/**
-	 * Send a campaign to contacts
-	 * Campaigns are one-time email sends to a segment or list of contacts
-	 */
-	async sendCampaign(
-		ctx: RunActionCtx,
-		options: {
-			campaignId: string;
-			emails?: string[];
-			transactionalId?: string;
-			dataVariables?: Record<string, any>;
-			audienceFilters?: {
-				userGroup?: string;
-				source?: string;
-			};
-		},
-	) {
-		return ctx.runAction((this.component.lib as any).sendCampaign, {
-			apiKey: this.apiKey,
-			...options,
-		});
-	}
-
 	/**
 	 * Trigger a loop for a contact
 	 * Loops are automated email sequences that can be triggered by events
@@ -366,7 +367,7 @@ export class Loops {
 	 * For easy re-exporting.
 	 * Apps can do
 	 * ```ts
-	 * export const { addContact, sendTransactional, sendEvent, sendCampaign, triggerLoop } = loops.api();
+	 * export const { addContact, sendTransactional, sendEvent, triggerLoop } = loops.api();
 	 * ```
 	 */
 	api() {
@@ -429,23 +430,6 @@ export class Loops {
 					return await this.deleteContact(ctx, args.email);
 				},
 			}),
-			sendCampaign: actionGeneric({
-				args: {
-					campaignId: v.string(),
-					emails: v.optional(v.array(v.string())),
-					transactionalId: v.optional(v.string()),
-					dataVariables: v.optional(v.any()),
-					audienceFilters: v.optional(
-						v.object({
-							userGroup: v.optional(v.string()),
-							source: v.optional(v.string()),
-						}),
-					),
-				},
-				handler: async (ctx, args) => {
-					return await this.sendCampaign(ctx, args);
-				},
-			}),
 			triggerLoop: actionGeneric({
 				args: {
 					loopId: v.string(),

package/src/component/convex.config.ts

@@ -10,9 +10,9 @@ 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,
 	triggerLoop: api.lib.triggerLoop,
 	deleteContact: api.lib.deleteContact,
 	detectRecipientSpam: api.lib.detectRecipientSpam,

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),
@@ -484,127 +569,6 @@ export const deleteContact = za({
 	},
 });
 
-/**
- * Send a campaign to 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({
-		apiKey: z.string(),
-		campaignId: z.string(),
-		emails: z.array(z.string().email()).optional(),
-		transactionalId: z.string().optional(),
-		dataVariables: z.record(z.string(), z.any()).optional(),
-		audienceFilters: z
-			.object({
-				userGroup: z.string().optional(),
-				source: z.string().optional(),
-			})
-			.optional(),
-	}),
-	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) => {
-		// 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.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."
-			);
-		}
-
-		// Send transactional emails to each contact as a workaround for campaigns
-		let sent = 0;
-		const errors: Array<{ email: string; error: string }> = [];
-
-		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,
-					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) },
-				});
-			}
-		}
-
-		return {
-			success: sent > 0,
-			sent,
-			errors: errors.length > 0 ? errors : undefined,
-		};
-	},
-});
-
 /**
  * Trigger a loop for a contact
  * Note: Loops in Loops.so are triggered through events, not a direct API endpoint.