@devwithbobby/loops 0.1.16 → 0.1.18

package/README.md

@@ -6,13 +6,13 @@ A Convex component for integrating with [Loops.so](https://loops.so) email marke
 
 ## Features
 
-- ✅ **Contact Management** - Create, update, find, and delete contacts
-- ✅ **Transactional Emails** - Send one-off emails with templates
-- ✅ **Events** - Trigger email workflows based on events
-- ✅ **Loops** - Trigger automated email sequences
-- ✅ **Monitoring** - Track all email operations with spam detection
-- ✅ **Rate Limiting** - Built-in rate limiting queries for abuse prevention
-- ✅ **Type-Safe** - Full TypeScript support with Zod validation
+- **Contact Management** - Create, update, find, list, and delete contacts
+- **Transactional Emails** - Send one-off emails with templates
+- **Events** - Trigger email workflows based on events
+- **Loops** - Trigger automated email sequences
+- **Monitoring** - Track all email operations with spam detection
+- **Rate Limiting** - Built-in rate limiting queries for abuse prevention
+- **Type-Safe** - Full TypeScript support with Zod validation
 
 ## Installation
 
@@ -40,17 +40,17 @@ export default app;
 
 ### 2. Set Up Environment Variables
 
-**⚠️ IMPORTANT: Set your Loops API key before using the component.**
+**IMPORTANT: Set your Loops API key before using the component.**
 
 ```bash
 npx convex env set LOOPS_API_KEY "your-loops-api-key-here"
 ```
 
 **Or via Convex Dashboard:**
-1. Go to Settings → Environment Variables
+1. Go to Settings -> Environment Variables
 2. Add `LOOPS_API_KEY` with your Loops.so API key
 
-Get your API key from [Loops.so Dashboard](https://app.loops.so/settings/api).
+Get your API key from [Loops.so Dashboard](https://app.loops.so/settings?page=api).
 
 ### 3. Use the Component
 
@@ -135,6 +135,27 @@ await loops.updateContact(ctx, "user@example.com", {
 const contact = await loops.findContact(ctx, "user@example.com");
 ```
 
+#### List Contacts
+
+List contacts with pagination and optional filtering.
+
+```typescript
+// Simple list with default limit (100)
+const result = await loops.listContacts(ctx);
+
+// List with filters and pagination
+const result = await loops.listContacts(ctx, {
+  userGroup: "premium",
+  subscribed: true,
+  limit: 20,
+  offset: 0
+});
+
+console.log(result.contacts); // Array of contacts
+console.log(result.total);    // Total count matching filters
+console.log(result.hasMore);  // Boolean indicating if more pages exist
+```
+
 #### Delete Contact
 
 ```typescript
@@ -335,11 +356,12 @@ export const {
   sendEvent,
   triggerLoop,
   countContacts,
+  listContacts,
   // ... all other functions
 } = loops.api();
 ```
 
-**⚠️ Security Warning:** The `api()` helper exports functions without authentication. Always wrap these functions with auth checks in production:
+**Security Warning:** The `api()` helper exports functions without authentication. Always wrap these functions with auth checks in production:
 
 ```typescript
 export const addContact = action({
@@ -392,12 +414,12 @@ npx convex env set LOOPS_API_KEY "your-api-key"
 
 **Via Dashboard:**
 1. Go to your Convex Dashboard
-2. Navigate to Settings → Environment Variables
+2. Navigate to Settings -> Environment Variables
 3. Add `LOOPS_API_KEY` with your Loops.so API key value
 
-Get your API key from [Loops.so Dashboard](https://app.loops.so/settings/api).
+Get your API key from [Loops.so Dashboard](https://app.loops.so/settings?page=api).
 
-⚠️ **Never** pass the API key directly in code or via function options in production. Always use environment variables.
+**Never** pass the API key directly in code or via function options in production. Always use environment variables.
 
 ## Monitoring & Rate Limiting
 
@@ -458,15 +480,16 @@ example/                   # Example app
 
 This component implements the following Loops.so API endpoints:
 
-- ✅ Create/Update Contact
-- ✅ Delete Contact
-- ✅ Find Contact
-- ✅ Batch Create Contacts
-- ✅ Unsubscribe/Resubscribe Contact
-- ✅ Count Contacts (custom implementation)
-- ✅ Send Transactional Email
-- ✅ Send Event
-- ✅ Trigger Loop
+- Create/Update Contact
+- Delete Contact
+- Find Contact
+- Batch Create Contacts
+- Unsubscribe/Resubscribe Contact
+- Count Contacts (custom implementation)
+- List Contacts (custom implementation)
+- Send Transactional Email
+- Send Event
+- Trigger Loop
 
 ## Contributing
 

package/dist/client/index.d.ts

@@ -373,6 +373,31 @@ export declare class Loops {
             subscribed?: boolean | undefined;
             userGroup?: string | undefined;
         }, Promise<number>>;
+        listContacts: import("convex/server").RegisteredQuery<"public", {
+            source?: string | undefined;
+            subscribed?: boolean | undefined;
+            userGroup?: string | undefined;
+            limit?: number | undefined;
+            offset?: number | undefined;
+        }, Promise<{
+            contacts: {
+                _id: string;
+                email: string;
+                subscribed: boolean;
+                createdAt: number;
+                updatedAt: number;
+                firstName?: string | undefined;
+                lastName?: string | undefined;
+                userId?: string | undefined;
+                source?: string | undefined;
+                userGroup?: string | undefined;
+                loopsContactId?: string | undefined;
+            }[];
+            total: number;
+            limit: number;
+            offset: number;
+            hasMore: boolean;
+        }>>;
         detectRecipientSpam: import("convex/server").RegisteredQuery<"public", {
             timeWindowMs?: number | undefined;
             maxEmailsPerRecipient?: number | undefined;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElE,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,OAAO,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,YAAY;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAED,qBAAa,KAAK;IACjB,SAAgB,OAAO,CAAC,EAAE;QACzB,MAAM,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAqC;gBAGxD,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;;;;IAOxD;;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,OAAO,CAAC,CAAC;KACxC;;;IASF;;OAEG;IACG,iBAAiB,CACtB,GAAG,EAAE,YAAY,EACjB,OAAO,EAAE,yBAAyB;;;;IAQnC;;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,OAAO,CAAC,CAAC;QACxC,SAAS,CAAC,EAAE,MAAM,CAAC;KACnB;;;;IAQF;;;;;;OAMG;IACH,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4LH"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"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"}

package/dist/client/index.js

@@ -24,7 +24,7 @@ export class Loops {
         if (options?.apiKey) {
             console.warn("API key passed directly via options. " +
                 "For security, use LOOPS_API_KEY environment variable instead. " +
-                "See ENV_SETUP.md for details.");
+                "See README.md for details.");
         }
         this.apiKey = apiKey;
     }
@@ -333,6 +333,18 @@ export class Loops {
                     return await this.countContacts(ctx, args);
                 },
             }),
+            listContacts: queryGeneric({
+                args: {
+                    userGroup: v.optional(v.string()),
+                    source: v.optional(v.string()),
+                    subscribed: v.optional(v.boolean()),
+                    limit: v.optional(v.number()),
+                    offset: v.optional(v.number()),
+                },
+                handler: async (ctx, args) => {
+                    return await this.listContacts(ctx, args);
+                },
+            }),
             detectRecipientSpam: queryGeneric({
                 args: {
                     timeWindowMs: v.optional(v.number()),

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

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/component/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAWjD,eAAO,MAAM,kBAAkB,gCAAgC,CAAC;AAEhE,eAAO,MAAM,kBAAkB,WACtB,MAAM,cACF,MAAM,KAChB,KAcF,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,GAAG;IAC1D,IAAI,CAAC,EAAE,OAAO,CAAC;CACf,CAAC;AAEF,eAAO,MAAM,UAAU,WACd,MAAM,QACR,MAAM,SACN,gBAAgB,sBAetB,CAAC;AAEF,eAAO,MAAM,gBAAgB,WAAY,gBAAgB,YAQxD,CAAC;AAEF,eAAO,MAAM,YAAY,SAAU,OAAO,SAAS,YAAY,aAM9D,CAAC;AAEF,eAAO,MAAM,aAAa,UAAW,YAAY,aAKhD,CAAC;AAEF,eAAO,MAAM,YAAY,GAAU,CAAC,WAAW,OAAO,KAAG,OAAO,CAAC,CAAC,CAMjE,CAAC;AAEF,eAAO,MAAM,gBAAgB,UAAW,MAAM,GAAG,IAAI,wBAWpD,CAAC;AAEF,eAAO,MAAM,eAAe,UAAW,MAAM,GAAG,IAAI,YAAY,MAAM,WAMrE,CAAC;AAEF,eAAO,MAAM,kBAAkB,cAQ9B,CAAC;AAEF,eAAO,MAAM,YAAY,UAAW,OAAO,aAS1C,CAAC"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/component/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAWjD,eAAO,MAAM,kBAAkB,gCAAgC,CAAC;AAEhE,eAAO,MAAM,kBAAkB,GAC9B,QAAQ,MAAM,EACd,YAAY,MAAM,KAChB,KAcF,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,GAAG;IAC1D,IAAI,CAAC,EAAE,OAAO,CAAC;CACf,CAAC;AAEF,eAAO,MAAM,UAAU,GACtB,QAAQ,MAAM,EACd,MAAM,MAAM,EACZ,OAAM,gBAAqB,sBAe3B,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,QAAQ,gBAAgB,YAQxD,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,MAAM,OAAO,EAAE,OAAO,YAAY,aAM9D,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,OAAO,YAAY,aAKhD,CAAC;AAEF,eAAO,MAAM,YAAY,GAAU,CAAC,EAAE,SAAS,OAAO,KAAG,OAAO,CAAC,CAAC,CAMjE,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,OAAO,MAAM,GAAG,IAAI,wBAWpD,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,OAAO,MAAM,GAAG,IAAI,EAAE,UAAU,MAAM,WAMrE,CAAC;AAEF,eAAO,MAAM,kBAAkB,cAQ9B,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,OAAO,OAAO,aAS1C,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/component/http.ts"],"names":[],"mappings":"AAsBA,QAAA,MAAM,IAAI,oCAAe,CAAC;AAwN1B,eAAe,IAAI,CAAC"}
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/component/http.ts"],"names":[],"mappings":"AAsBA,QAAA,MAAM,IAAI,oCAAe,CAAC;AAoN1B,eAAe,IAAI,CAAC"}

package/dist/component/http.js

@@ -3,9 +3,8 @@ import { internalLib, } from "../types";
 import { buildCorsHeaders, jsonResponse, emptyResponse, readJsonBody, respondError, booleanFromQuery, numberFromQuery, requireLoopsApiKey, } from "./helpers";
 import { httpAction } from "./_generated/server";
 const http = httpRouter();
-const allowedOrigin = process.env.LOOPS_HTTP_ALLOWED_ORIGIN ?? process.env.CLIENT_ORIGIN ?? "*";
 http.route({
-    pathPrefix: "/loops",
+    pathPrefix: "/loops/",
     method: "OPTIONS",
     handler: httpAction(async (_ctx, request) => {
         const headers = buildCorsHeaders();

package/dist/component/lib.d.ts

@@ -35,6 +35,10 @@ export declare const logEmailOperation: import("convex/server").RegisteredMutati
 /**
  * Count contacts in the database
  * Can filter by audience criteria (userGroup, source, subscribed status)
+ *
+ * Note: When multiple filters are provided, only one index can be used.
+ * Additional filters are applied in-memory, which is efficient for small result sets.
+ * For large contact lists with multiple filters, consider using a composite index.
  */
 export declare const countContacts: import("convex/server").RegisteredQuery<"public", {
     userGroup?: string | undefined;
@@ -45,6 +49,9 @@ export declare const countContacts: import("convex/server").RegisteredQuery<"pub
  * List contacts from the database with pagination
  * Can filter by audience criteria (userGroup, source, subscribed status)
  * Returns actual contact data, not just a count
+ *
+ * Note: When multiple filters are provided, only one index can be used.
+ * Additional filters are applied in-memory before pagination.
  */
 export declare const listContacts: import("convex/server").RegisteredQuery<"public", {
     limit: number;

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

@@ -1 +1 @@
-{"version":3,"file":"lib.d.ts","sourceRoot":"","sources":["../../src/component/lib.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;iBA6CvB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,aAAa;;iBAexB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;iBAkC5B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,aAAa;;;;mBAwCxB,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;GAmFvB,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;GA+GrB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;GAgDxB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;GAiD5B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,SAAS;;;;;;;GA4BpB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;GA0BxB,CAAC;AAEH;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,WAAW;;;;;;;;;GA4DtB,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;GA4DtB,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;GA8D9B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;GA2B7B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;GA2B7B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;KA8C9B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,eAAe;;;;;;;KA4C1B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;GAkDxB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;KAsGlC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;GA+ClC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;GA6C9B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;GA8B/B,CAAC"}
+{"version":3,"file":"lib.d.ts","sourceRoot":"","sources":["../../src/component/lib.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;iBA6CvB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,aAAa;;iBAexB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;iBAkC5B,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa;;;;mBA0DxB,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;GA8FvB,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;GA+GrB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;GAgDxB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;GAiD5B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,SAAS;;;;;;;GAyCpB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;GA0BxB,CAAC;AAEH;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,WAAW;;;;;;;;;GA4DtB,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;GA4DtB,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;GA8D9B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;GA2B7B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;GA2B7B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;KA8C9B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,eAAe;;;;;;;KA4C1B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;GAkDxB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;KAsGlC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;GA+ClC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;GA6C9B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;GA8B/B,CAAC"}

package/dist/component/lib.js

@@ -107,6 +107,10 @@ export const logEmailOperation = zm({
 /**
  * Count contacts in the database
  * Can filter by audience criteria (userGroup, source, subscribed status)
+ *
+ * Note: When multiple filters are provided, only one index can be used.
+ * Additional filters are applied in-memory, which is efficient for small result sets.
+ * For large contact lists with multiple filters, consider using a composite index.
  */
 export const countContacts = zq({
     args: z.object({
@@ -116,6 +120,8 @@ export const countContacts = zq({
     }),
     returns: z.number(),
     handler: async (ctx, args) => {
+        // Build query using the most selective index available
+        // Priority: userGroup > source > subscribed
         let contacts;
         if (args.userGroup !== undefined) {
             contacts = await ctx.db
@@ -138,22 +144,37 @@ export const countContacts = zq({
         else {
             contacts = await ctx.db.query("contacts").collect();
         }
-        if (args.userGroup !== undefined && contacts) {
-            contacts = contacts.filter((c) => c.userGroup === args.userGroup);
-        }
-        if (args.source !== undefined && contacts) {
-            contacts = contacts.filter((c) => c.source === args.source);
+        // Apply additional filters if multiple criteria were provided
+        // This avoids redundant filtering when only one filter was used
+        const needsFiltering = (args.userGroup !== undefined ? 1 : 0) +
+            (args.source !== undefined ? 1 : 0) +
+            (args.subscribed !== undefined ? 1 : 0) >
+            1;
+        if (!needsFiltering) {
+            return contacts.length;
         }
-        if (args.subscribed !== undefined && contacts) {
-            contacts = contacts.filter((c) => c.subscribed === args.subscribed);
-        }
-        return contacts.length;
+        const filtered = contacts.filter((c) => {
+            if (args.userGroup !== undefined && c.userGroup !== args.userGroup) {
+                return false;
+            }
+            if (args.source !== undefined && c.source !== args.source) {
+                return false;
+            }
+            if (args.subscribed !== undefined && c.subscribed !== args.subscribed) {
+                return false;
+            }
+            return true;
+        });
+        return filtered.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
+ *
+ * Note: When multiple filters are provided, only one index can be used.
+ * Additional filters are applied in-memory before pagination.
  */
 export const listContacts = zq({
     args: z.object({
@@ -183,8 +204,8 @@ export const listContacts = zq({
         hasMore: z.boolean(),
     }),
     handler: async (ctx, args) => {
+        // Build query using the most selective index available
         let allContacts;
-        // Get all contacts matching the filters
         if (args.userGroup !== undefined) {
             allContacts = await ctx.db
                 .query("contacts")
@@ -206,15 +227,24 @@ export const listContacts = zq({
         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);
+        // Apply additional filters if multiple criteria were provided
+        const needsFiltering = (args.userGroup !== undefined ? 1 : 0) +
+            (args.source !== undefined ? 1 : 0) +
+            (args.subscribed !== undefined ? 1 : 0) >
+            1;
+        if (needsFiltering) {
+            allContacts = allContacts.filter((c) => {
+                if (args.userGroup !== undefined && c.userGroup !== args.userGroup) {
+                    return false;
+                }
+                if (args.source !== undefined && c.source !== args.source) {
+                    return false;
+                }
+                if (args.subscribed !== undefined && c.subscribed !== args.subscribed) {
+                    return false;
+                }
+                return true;
+            });
         }
         // Sort by createdAt (newest first)
         allContacts.sort((a, b) => b.createdAt - a.createdAt);
@@ -433,7 +463,7 @@ export const sendEvent = za({
     returns: z.object({
         success: z.boolean(),
     }),
-    handler: async (_ctx, args) => {
+    handler: async (ctx, args) => {
         const response = await loopsFetch(args.apiKey, "/events/send", {
             method: "POST",
             json: {
@@ -445,8 +475,20 @@ export const sendEvent = za({
         if (!response.ok) {
             const errorText = await response.text();
             console.error(`Loops API error [${response.status}]:`, errorText);
+            await ctx.runMutation(internalLib.logEmailOperation, {
+                operationType: "event",
+                email: args.email,
+                success: false,
+                eventName: args.eventName,
+            });
             throw sanitizeLoopsError(response.status, errorText);
         }
+        await ctx.runMutation(internalLib.logEmailOperation, {
+            operationType: "event",
+            email: args.email,
+            success: true,
+            eventName: args.eventName,
+        });
         return { success: true };
     },
 });

package/dist/component/schema.d.ts

@@ -29,13 +29,13 @@ declare const _default: import("convex/server").SchemaDefinition<{
         subscribed: ["subscribed", "_creationTime"];
     }, {}, {}>;
     emailOperations: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        metadata?: Record<string, any> | undefined;
         actorId?: string | undefined;
         transactionalId?: string | undefined;
         campaignId?: string | undefined;
         loopId?: string | undefined;
         eventName?: string | undefined;
         messageId?: string | undefined;
-        metadata?: Record<string, any> | undefined;
         email: string;
         success: boolean;
         operationType: "transactional" | "event" | "campaign" | "loop";
@@ -57,7 +57,7 @@ declare const _default: import("convex/server").SchemaDefinition<{
         success: import("zod").ZodBoolean;
         messageId: import("zod").ZodOptional<import("zod").ZodString>;
         metadata: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodAny>>;
-    }>, "required", "email" | "success" | "operationType" | "actorId" | "transactionalId" | "campaignId" | "loopId" | "eventName" | "timestamp" | "messageId" | "metadata" | `metadata.${string}`>, {
+    }>, "required", "email" | "success" | "metadata" | "operationType" | "actorId" | "transactionalId" | "campaignId" | "loopId" | "eventName" | "timestamp" | "messageId" | `metadata.${string}`>, {
         email: ["email", "timestamp", "_creationTime"];
         actorId: ["actorId", "timestamp", "_creationTime"];
         operationType: ["operationType", "timestamp", "_creationTime"];

package/dist/component/tables/contacts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contacts.d.ts","sourceRoot":"","sources":["../../../src/component/tables/contacts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBAYu99B,EAAG,SAAS;;;;;;;;uBAAgW,EAAG,SAAS;;CADl2+B,CAAC"}
+{"version":3,"file":"contacts.d.ts","sourceRoot":"","sources":["../../../src/component/tables/contacts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAWnB,CAAC"}

package/dist/component/tables/emailOperations.d.ts

@@ -2,13 +2,13 @@ import { z } from "zod";
 export declare const EmailOperations: {
     name: "emailOperations";
     table: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        metadata?: Record<string, any> | undefined;
         actorId?: string | undefined;
         transactionalId?: string | undefined;
         campaignId?: string | undefined;
         loopId?: string | undefined;
         eventName?: string | undefined;
         messageId?: string | undefined;
-        metadata?: Record<string, any> | undefined;
         email: string;
         success: boolean;
         operationType: "transactional" | "event" | "campaign" | "loop";
@@ -30,15 +30,15 @@ export declare const EmailOperations: {
         success: z.ZodBoolean;
         messageId: z.ZodOptional<z.ZodString>;
         metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-    }>, "required", "email" | "success" | "operationType" | "actorId" | "transactionalId" | "campaignId" | "loopId" | "eventName" | "timestamp" | "messageId" | "metadata" | `metadata.${string}`>, {}, {}, {}>;
+    }>, "required", "email" | "success" | "metadata" | "operationType" | "actorId" | "transactionalId" | "campaignId" | "loopId" | "eventName" | "timestamp" | "messageId" | `metadata.${string}`>, {}, {}, {}>;
     doc: import("convex/values").VObject<{
+        metadata?: Record<string, any> | undefined;
         actorId?: string | undefined;
         transactionalId?: string | undefined;
         campaignId?: string | undefined;
         loopId?: string | undefined;
         eventName?: string | undefined;
         messageId?: string | undefined;
-        metadata?: Record<string, any> | undefined;
         email: string;
         success: boolean;
         operationType: "transactional" | "event" | "campaign" | "loop";
@@ -59,7 +59,7 @@ export declare const EmailOperations: {
         metadata: import("convex/values").VRecord<Record<string, any> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VAny<"required", "required", string>, "optional", string>;
         _id: import("convex/values").VId<import("convex/values").GenericId<"emailOperations">, "required">;
         _creationTime: import("convex/values").VFloat64<number, "required">;
-    }, "required", "email" | "success" | "operationType" | "actorId" | "transactionalId" | "campaignId" | "loopId" | "eventName" | "timestamp" | "messageId" | "metadata" | "_creationTime" | `metadata.${string}` | "_id">;
+    }, "required", "email" | "success" | "metadata" | "operationType" | "actorId" | "transactionalId" | "campaignId" | "loopId" | "eventName" | "timestamp" | "messageId" | "_creationTime" | `metadata.${string}` | "_id">;
     withoutSystemFields: import("zodvex").ConvexValidatorFromZodFieldsAuto<{
         operationType: z.ZodEnum<{
             transactional: "transactional";

package/dist/component/tables/emailOperations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"emailOperations.d.ts","sourceRoot":"","sources":["../../../src/component/tables/emailOperations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBAay29B,EAAG,SAAS;;;;;;;;uBAAgW,EAAG,SAAS;;CAD3v+B,CAAC"}
+{"version":3,"file":"emailOperations.d.ts","sourceRoot":"","sources":["../../../src/component/tables/emailOperations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAY1B,CAAC"}

package/dist/utils.d.ts

@@ -33,19 +33,19 @@ export declare const zq: <A extends import("zod").ZodType | Record<string, impor
             document: {
                 _id: import("convex/values").GenericId<"emailOperations">;
                 _creationTime: number;
+                metadata?: Record<string, any> | undefined;
                 actorId?: string | undefined;
                 transactionalId?: string | undefined;
                 campaignId?: string | undefined;
                 loopId?: string | undefined;
                 eventName?: string | undefined;
                 messageId?: string | undefined;
-                metadata?: Record<string, any> | undefined;
                 email: string;
                 success: boolean;
                 operationType: "transactional" | "event" | "campaign" | "loop";
                 timestamp: number;
             };
-            fieldPaths: ("email" | "success" | "operationType" | "actorId" | "transactionalId" | "campaignId" | "loopId" | "eventName" | "timestamp" | "messageId" | "metadata" | "_creationTime" | `metadata.${string}`) | "_id";
+            fieldPaths: ("email" | "success" | "metadata" | "operationType" | "actorId" | "transactionalId" | "campaignId" | "loopId" | "eventName" | "timestamp" | "messageId" | "_creationTime" | `metadata.${string}`) | "_id";
             indexes: {
                 email: ["email", "timestamp", "_creationTime"];
                 actorId: ["actorId", "timestamp", "_creationTime"];
@@ -95,19 +95,19 @@ export declare const zm: <A extends import("zod").ZodType | Record<string, impor
             document: {
                 _id: import("convex/values").GenericId<"emailOperations">;
                 _creationTime: number;
+                metadata?: Record<string, any> | undefined;
                 actorId?: string | undefined;
                 transactionalId?: string | undefined;
                 campaignId?: string | undefined;
                 loopId?: string | undefined;
                 eventName?: string | undefined;
                 messageId?: string | undefined;
-                metadata?: Record<string, any> | undefined;
                 email: string;
                 success: boolean;
                 operationType: "transactional" | "event" | "campaign" | "loop";
                 timestamp: number;
             };
-            fieldPaths: ("email" | "success" | "operationType" | "actorId" | "transactionalId" | "campaignId" | "loopId" | "eventName" | "timestamp" | "messageId" | "metadata" | "_creationTime" | `metadata.${string}`) | "_id";
+            fieldPaths: ("email" | "success" | "metadata" | "operationType" | "actorId" | "transactionalId" | "campaignId" | "loopId" | "eventName" | "timestamp" | "messageId" | "_creationTime" | `metadata.${string}`) | "_id";
             indexes: {
                 email: ["email", "timestamp", "_creationTime"];
                 actorId: ["actorId", "timestamp", "_creationTime"];
@@ -157,19 +157,19 @@ export declare const za: <A extends import("zod").ZodType | Record<string, impor
             document: {
                 _id: import("convex/values").GenericId<"emailOperations">;
                 _creationTime: number;
+                metadata?: Record<string, any> | undefined;
                 actorId?: string | undefined;
                 transactionalId?: string | undefined;
                 campaignId?: string | undefined;
                 loopId?: string | undefined;
                 eventName?: string | undefined;
                 messageId?: string | undefined;
-                metadata?: Record<string, any> | undefined;
                 email: string;
                 success: boolean;
                 operationType: "transactional" | "event" | "campaign" | "loop";
                 timestamp: number;
             };
-            fieldPaths: ("email" | "success" | "operationType" | "actorId" | "transactionalId" | "campaignId" | "loopId" | "eventName" | "timestamp" | "messageId" | "metadata" | "_creationTime" | `metadata.${string}`) | "_id";
+            fieldPaths: ("email" | "success" | "metadata" | "operationType" | "actorId" | "transactionalId" | "campaignId" | "loopId" | "eventName" | "timestamp" | "messageId" | "_creationTime" | `metadata.${string}`) | "_id";
             indexes: {
                 email: ["email", "timestamp", "_creationTime"];
                 actorId: ["actorId", "timestamp", "_creationTime"];

package/package.json

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

package/src/client/index.ts

@@ -70,7 +70,7 @@ export class Loops {
 			console.warn(
 				"API key passed directly via options. " +
 					"For security, use LOOPS_API_KEY environment variable instead. " +
-					"See ENV_SETUP.md for details.",
+					"See README.md for details.",
 			);
 		}
 
@@ -480,6 +480,18 @@ export class Loops {
 					return await this.countContacts(ctx, args);
 				},
 			}),
+			listContacts: queryGeneric({
+				args: {
+					userGroup: v.optional(v.string()),
+					source: v.optional(v.string()),
+					subscribed: v.optional(v.boolean()),
+					limit: v.optional(v.number()),
+					offset: v.optional(v.number()),
+				},
+				handler: async (ctx, args) => {
+					return await this.listContacts(ctx, args);
+				},
+			}),
 			detectRecipientSpam: queryGeneric({
 				args: {
 					timeWindowMs: v.optional(v.number()),

package/src/component/http.ts

@@ -22,12 +22,8 @@ import { httpAction } from "./_generated/server";
 
 const http = httpRouter();
 
-const allowedOrigin =
-	process.env.LOOPS_HTTP_ALLOWED_ORIGIN ?? process.env.CLIENT_ORIGIN ?? "*";
-
-
 http.route({
-	pathPrefix: "/loops",
+	pathPrefix: "/loops/",
 	method: "OPTIONS",
 	handler: httpAction(async (_ctx, request) => {
 		const headers = buildCorsHeaders();

package/src/component/lib.ts

@@ -117,6 +117,10 @@ export const logEmailOperation = zm({
 /**
  * Count contacts in the database
  * Can filter by audience criteria (userGroup, source, subscribed status)
+ *
+ * Note: When multiple filters are provided, only one index can be used.
+ * Additional filters are applied in-memory, which is efficient for small result sets.
+ * For large contact lists with multiple filters, consider using a composite index.
  */
 export const countContacts = zq({
 	args: z.object({
@@ -126,7 +130,10 @@ export const countContacts = zq({
 	}),
 	returns: z.number(),
 	handler: async (ctx, args) => {
+		// Build query using the most selective index available
+		// Priority: userGroup > source > subscribed
 		let contacts: Doc<"contacts">[];
+
 		if (args.userGroup !== undefined) {
 			contacts = await ctx.db
 				.query("contacts")
@@ -146,17 +153,32 @@ export const countContacts = zq({
 			contacts = await ctx.db.query("contacts").collect();
 		}
 
-		if (args.userGroup !== undefined && contacts) {
-			contacts = contacts.filter((c) => c.userGroup === args.userGroup);
-		}
-		if (args.source !== undefined && contacts) {
-			contacts = contacts.filter((c) => c.source === args.source);
-		}
-		if (args.subscribed !== undefined && contacts) {
-			contacts = contacts.filter((c) => c.subscribed === args.subscribed);
+		// Apply additional filters if multiple criteria were provided
+		// This avoids redundant filtering when only one filter was used
+		const needsFiltering =
+			(args.userGroup !== undefined ? 1 : 0) +
+				(args.source !== undefined ? 1 : 0) +
+				(args.subscribed !== undefined ? 1 : 0) >
+			1;
+
+		if (!needsFiltering) {
+			return contacts.length;
 		}
 
-		return contacts.length;
+		const filtered = contacts.filter((c) => {
+			if (args.userGroup !== undefined && c.userGroup !== args.userGroup) {
+				return false;
+			}
+			if (args.source !== undefined && c.source !== args.source) {
+				return false;
+			}
+			if (args.subscribed !== undefined && c.subscribed !== args.subscribed) {
+				return false;
+			}
+			return true;
+		});
+
+		return filtered.length;
 	},
 });
 
@@ -164,6 +186,9 @@ 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
+ *
+ * Note: When multiple filters are provided, only one index can be used.
+ * Additional filters are applied in-memory before pagination.
  */
 export const listContacts = zq({
 	args: z.object({
@@ -195,9 +220,9 @@ export const listContacts = zq({
 		hasMore: z.boolean(),
 	}),
 	handler: async (ctx, args) => {
+		// Build query using the most selective index available
 		let allContacts: Doc<"contacts">[];
 
-		// Get all contacts matching the filters
 		if (args.userGroup !== undefined) {
 			allContacts = await ctx.db
 				.query("contacts")
@@ -217,15 +242,26 @@ export const listContacts = zq({
 			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);
+		// Apply additional filters if multiple criteria were provided
+		const needsFiltering =
+			(args.userGroup !== undefined ? 1 : 0) +
+				(args.source !== undefined ? 1 : 0) +
+				(args.subscribed !== undefined ? 1 : 0) >
+			1;
+
+		if (needsFiltering) {
+			allContacts = allContacts.filter((c) => {
+				if (args.userGroup !== undefined && c.userGroup !== args.userGroup) {
+					return false;
+				}
+				if (args.source !== undefined && c.source !== args.source) {
+					return false;
+				}
+				if (args.subscribed !== undefined && c.subscribed !== args.subscribed) {
+					return false;
+				}
+				return true;
+			});
 		}
 
 		// Sort by createdAt (newest first)
@@ -488,7 +524,7 @@ export const sendEvent = za({
 	returns: z.object({
 		success: z.boolean(),
 	}),
-	handler: async (_ctx, args) => {
+	handler: async (ctx, args) => {
 		const response = await loopsFetch(args.apiKey, "/events/send", {
 			method: "POST",
 			json: {
@@ -501,9 +537,22 @@ export const sendEvent = za({
 		if (!response.ok) {
 			const errorText = await response.text();
 			console.error(`Loops API error [${response.status}]:`, errorText);
+			await ctx.runMutation(internalLib.logEmailOperation, {
+				operationType: "event",
+				email: args.email,
+				success: false,
+				eventName: args.eventName,
+			});
 			throw sanitizeLoopsError(response.status, errorText);
 		}
 
+		await ctx.runMutation(internalLib.logEmailOperation, {
+			operationType: "event",
+			email: args.email,
+			success: true,
+			eventName: args.eventName,
+		});
+
 		return { success: true };
 	},
 });

package/dist/client/types.d.ts

@@ -1,24 +0,0 @@
-import type { Expand, FunctionArgs, FunctionReference, FunctionReturnType, StorageActionWriter, StorageReader } from "convex/server";
-import type { GenericId } from "convex/values";
-export type RunQueryCtx = {
-    runQuery: <Query extends FunctionReference<"query", "internal">>(query: Query, args: FunctionArgs<Query>) => Promise<FunctionReturnType<Query>>;
-};
-export type RunMutationCtx = RunQueryCtx & {
-    runMutation: <Mutation extends FunctionReference<"mutation", "internal">>(mutation: Mutation, args: FunctionArgs<Mutation>) => Promise<FunctionReturnType<Mutation>>;
-};
-export type RunActionCtx = RunMutationCtx & {
-    runAction<Action extends FunctionReference<"action", "internal">>(action: Action, args: FunctionArgs<Action>): Promise<FunctionReturnType<Action>>;
-};
-export type ActionCtx = RunActionCtx & {
-    storage: StorageActionWriter;
-};
-export type QueryCtx = RunQueryCtx & {
-    storage: StorageReader;
-};
-export type OpaqueIds<T> = T extends GenericId<infer _T> ? string : T extends (infer U)[] ? OpaqueIds<U>[] : T extends ArrayBuffer ? ArrayBuffer : T extends object ? {
-    [K in keyof T]: OpaqueIds<T[K]>;
-} : T;
-export type UseApi<API> = Expand<{
-    [mod in keyof API]: API[mod] extends FunctionReference<infer FType, "public", infer FArgs, infer FReturnType, infer FComponentPath> ? FunctionReference<FType, "internal", OpaqueIds<FArgs>, OpaqueIds<FReturnType>, FComponentPath> : UseApi<API[mod]>;
-}>;
-//# sourceMappingURL=types.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,MAAM,EACN,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,EACb,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C,MAAM,MAAM,WAAW,GAAG;IACzB,QAAQ,EAAE,CAAC,KAAK,SAAS,iBAAiB,CAAC,OAAO,EAAE,UAAU,CAAC,EAC9D,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,YAAY,CAAC,KAAK,CAAC,KACrB,OAAO,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC;CACxC,CAAC;AACF,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG;IAC1C,WAAW,EAAE,CAAC,QAAQ,SAAS,iBAAiB,CAAC,UAAU,EAAE,UAAU,CAAC,EACvE,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,YAAY,CAAC,QAAQ,CAAC,KACxB,OAAO,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC;CAC3C,CAAC;AACF,MAAM,MAAM,YAAY,GAAG,cAAc,GAAG;IAC3C,SAAS,CAAC,MAAM,SAAS,iBAAiB,CAAC,QAAQ,EAAE,UAAU,CAAC,EAC/D,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,GACxB,OAAO,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC;CACvC,CAAC;AACF,MAAM,MAAM,SAAS,GAAG,YAAY,GAAG;IACtC,OAAO,EAAE,mBAAmB,CAAC;CAC7B,CAAC;AACF,MAAM,MAAM,QAAQ,GAAG,WAAW,GAAG;IACpC,OAAO,EAAE,aAAa,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,SAAS,CAAC,MAAM,EAAE,CAAC,GACrD,MAAM,GACN,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GACpB,SAAS,CAAC,CAAC,CAAC,EAAE,GACd,CAAC,SAAS,WAAW,GACpB,WAAW,GACX,CAAC,SAAS,MAAM,GACf;KACC,CAAC,IAAI,MAAM,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAC/B,GACA,CAAC,CAAC;AAER,MAAM,MAAM,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC;KAC/B,GAAG,IAAI,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,SAAS,iBAAiB,CACrD,MAAM,KAAK,EACX,QAAQ,EACR,MAAM,KAAK,EACX,MAAM,WAAW,EACjB,MAAM,cAAc,CACpB,GACE,iBAAiB,CACjB,KAAK,EACL,UAAU,EACV,SAAS,CAAC,KAAK,CAAC,EAChB,SAAS,CAAC,WAAW,CAAC,EACtB,cAAc,CACd,GACA,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;CACnB,CAAC,CAAC"}