@devwithbobby/loops 0.1.11 → 0.1.13

package/src/client/index.ts

@@ -32,7 +32,7 @@ export class Loops {
 	public readonly options?: {
 		apiKey?: string;
 	};
-	
+
 	constructor(
 		component: LoopsComponent,
 		options?: {
@@ -43,26 +43,26 @@ export class Loops {
 			throw new Error(
 				"Loops component reference is required. " +
 					"Make sure the component is mounted in your convex.config.ts and use: " +
-					"new Loops(components.loops)"
+					"new Loops(components.loops)",
 			);
 		}
-		
+
 		if (!component.lib) {
 			throw new Error(
 				"Invalid component reference. " +
 					"The component may not be properly mounted. " +
 					"Ensure the component is correctly mounted in convex.config.ts: " +
-					"app.use(loops);"
+					"app.use(loops);",
 			);
 		}
-		
+
 		this.component = component;
 		this.options = options;
-		
+
 		const apiKey = options?.apiKey ?? process.env.LOOPS_API_KEY;
 		if (!apiKey) {
 			throw new Error(
-				"Loops API key is required. Set LOOPS_API_KEY in your Convex environment variables."
+				"Loops API key is required. Set LOOPS_API_KEY in your Convex environment variables.",
 			);
 		}
 
@@ -87,7 +87,7 @@ export class Loops {
 			throw new Error(
 				"Loops component is not initialized. " +
 					"Make sure to pass components.loops to the Loops constructor: " +
-					"new Loops(components.loops)"
+					"new Loops(components.loops)",
 			);
 		}
 		if (!this.component.lib) {
@@ -95,7 +95,7 @@ export class Loops {
 				"Invalid component reference. " +
 					"The component may not be properly mounted. " +
 					"Ensure the component is correctly mounted in convex.config.ts: " +
-					"app.use(loops);"
+					"app.use(loops);",
 			);
 		}
 		return ctx.runAction((this.component.lib as any).addContact, {
@@ -124,7 +124,10 @@ export class Loops {
 	/**
 	 * Send a transactional email using a transactional ID
 	 */
-	async sendTransactional(ctx: RunActionCtx, options: TransactionalEmailOptions) {
+	async sendTransactional(
+		ctx: RunActionCtx,
+		options: TransactionalEmailOptions,
+	) {
 		return ctx.runAction((this.component.lib as any).sendTransactional, {
 			apiKey: this.apiKey,
 			...options,
@@ -198,7 +201,34 @@ export class Loops {
 			subscribed?: boolean;
 		},
 	) {
-		return ctx.runQuery((this.component.lib as any).countContacts, options ?? {});
+		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,
+		});
 	}
 
 	/**
@@ -274,7 +304,10 @@ export class Loops {
 			maxEmails: number;
 		},
 	) {
-		return ctx.runQuery((this.component.lib as any).checkRecipientRateLimit, options);
+		return ctx.runQuery(
+			(this.component.lib as any).checkRecipientRateLimit,
+			options,
+		);
 	}
 
 	/**
@@ -288,7 +321,10 @@ export class Loops {
 			maxEmails: number;
 		},
 	) {
-		return ctx.runQuery((this.component.lib as any).checkActorRateLimit, options);
+		return ctx.runQuery(
+			(this.component.lib as any).checkActorRateLimit,
+			options,
+		);
 	}
 
 	/**
@@ -301,7 +337,10 @@ export class Loops {
 			maxEmails: number;
 		},
 	) {
-		return ctx.runQuery((this.component.lib as any).checkGlobalRateLimit, options);
+		return ctx.runQuery(
+			(this.component.lib as any).checkGlobalRateLimit,
+			options,
+		);
 	}
 
 	/**
@@ -314,37 +353,14 @@ 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
-	 * 
+	 *
 	 * 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(
@@ -366,7 +382,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 +445,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

@@ -13,7 +13,6 @@ const component = defineComponent("loops");
 	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,