@devwithbobby/loops 0.1.13 → 0.1.16

package/dist/client/index.d.ts

@@ -1,5 +1,5 @@
-import type { Mounts } from "../component/_generated/api.js";
-import type { RunActionCtx, RunQueryCtx, UseApi } from "./types.js";
+import type { Mounts } from "../component/_generated/api";
+import type { RunActionCtx, RunQueryCtx, UseApi } from "../types";
 export type LoopsComponent = UseApi<Mounts>;
 export interface ContactData {
     email: string;
@@ -13,18 +13,18 @@ export interface ContactData {
 export interface TransactionalEmailOptions {
     transactionalId: string;
     email: string;
-    dataVariables?: Record<string, any>;
+    dataVariables?: Record<string, unknown>;
 }
 export interface EventOptions {
     email: string;
     eventName: string;
-    eventProperties?: Record<string, any>;
+    eventProperties?: Record<string, unknown>;
 }
 export declare class Loops {
-    private readonly component;
     readonly options?: {
         apiKey?: string;
     };
+    private readonly lib;
     constructor(component: LoopsComponent, options?: {
         apiKey?: string;
     });
@@ -32,41 +32,77 @@ export declare class Loops {
     /**
      * Add or update a contact in Loops
      */
-    addContact(ctx: RunActionCtx, contact: ContactData): Promise<any>;
+    addContact(ctx: RunActionCtx, contact: ContactData): Promise<{
+        success: boolean;
+        id?: string | undefined;
+    }>;
     /**
      * Update an existing contact in Loops
      */
     updateContact(ctx: RunActionCtx, email: string, updates: Partial<ContactData> & {
-        dataVariables?: Record<string, any>;
-    }): Promise<any>;
+        dataVariables?: Record<string, unknown>;
+    }): Promise<{
+        success: boolean;
+    }>;
     /**
      * Send a transactional email using a transactional ID
      */
-    sendTransactional(ctx: RunActionCtx, options: TransactionalEmailOptions): Promise<any>;
+    sendTransactional(ctx: RunActionCtx, options: TransactionalEmailOptions): Promise<{
+        success: boolean;
+        messageId?: string | undefined;
+    }>;
     /**
      * Send an event to Loops to trigger email workflows
      */
-    sendEvent(ctx: RunActionCtx, options: EventOptions): Promise<any>;
+    sendEvent(ctx: RunActionCtx, options: EventOptions): Promise<{
+        success: boolean;
+    }>;
     /**
      * Find a contact by email
      * Retrieves contact information from Loops
      */
-    findContact(ctx: RunActionCtx, email: string): Promise<any>;
+    findContact(ctx: RunActionCtx, email: string): Promise<{
+        success: boolean;
+        contact?: {
+            id?: string | null | undefined;
+            email?: string | null | undefined;
+            firstName?: string | null | undefined;
+            lastName?: string | null | undefined;
+            source?: string | null | undefined;
+            subscribed?: boolean | null | undefined;
+            userGroup?: string | null | undefined;
+            userId?: string | null | undefined;
+            createdAt?: string | null | undefined;
+        } | undefined;
+    }>;
     /**
      * Batch create contacts
      * Create multiple contacts in a single API call
      */
-    batchCreateContacts(ctx: RunActionCtx, contacts: ContactData[]): Promise<any>;
+    batchCreateContacts(ctx: RunActionCtx, contacts: ContactData[]): Promise<{
+        success: boolean;
+        created?: number | undefined;
+        failed?: number | undefined;
+        results?: {
+            email: string;
+            success: boolean;
+            error?: string | undefined;
+        }[] | undefined;
+    }>;
     /**
      * Unsubscribe a contact
      * Unsubscribes a contact from receiving emails (they remain in the system)
      */
-    unsubscribeContact(ctx: RunActionCtx, email: string): Promise<any>;
+    unsubscribeContact(ctx: RunActionCtx, email: string): Promise<{
+        success: boolean;
+    }>;
     /**
      * Resubscribe a contact
      * Resubscribes a previously unsubscribed contact
      */
-    resubscribeContact(ctx: RunActionCtx, email: string): Promise<any>;
+    resubscribeContact(ctx: RunActionCtx, email: string): Promise<{
+        success: boolean;
+    }>;
     /**
      * Count contacts in the database
      * Can filter by audience criteria (userGroup, source, subscribed status)
@@ -76,7 +112,7 @@ export declare class Loops {
         userGroup?: string;
         source?: string;
         subscribed?: boolean;
-    }): Promise<any>;
+    }): Promise<number>;
     /**
      * List contacts with pagination and optional filters
      * Returns actual contact data, not just a count
@@ -88,34 +124,78 @@ export declare class Loops {
         subscribed?: boolean;
         limit?: number;
         offset?: number;
-    }): Promise<any>;
+    }): 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;
+    }>;
     /**
      * Detect spam patterns: emails sent to the same recipient too frequently
      */
     detectRecipientSpam(ctx: RunQueryCtx, options?: {
         timeWindowMs?: number;
         maxEmailsPerRecipient?: number;
-    }): Promise<any>;
+    }): Promise<{
+        [x: string]: any;
+        email: string;
+        count: number;
+        timeWindowMs: number;
+    }[]>;
     /**
      * Detect spam patterns: emails sent by the same actor/user too frequently
      */
     detectActorSpam(ctx: RunQueryCtx, options?: {
         timeWindowMs?: number;
         maxEmailsPerActor?: number;
-    }): Promise<any>;
+    }): Promise<{
+        actorId: string;
+        count: number;
+        timeWindowMs: number;
+    }[]>;
     /**
      * Get email operation statistics for monitoring
      */
     getEmailStats(ctx: RunQueryCtx, options?: {
         timeWindowMs?: number;
-    }): Promise<any>;
+    }): Promise<{
+        [x: string]: any;
+        totalOperations: number;
+        successfulOperations: number;
+        failedOperations: number;
+        operationsByType: {
+            [x: string]: number;
+        };
+        uniqueRecipients: number;
+        uniqueActors: number;
+    }>;
     /**
      * Detect rapid-fire email sending patterns
      */
     detectRapidFirePatterns(ctx: RunQueryCtx, options?: {
         timeWindowMs?: number;
         minEmailsInWindow?: number;
-    }): Promise<any>;
+    }): Promise<{
+        count: number;
+        timeWindowMs: number;
+        firstTimestamp: number;
+        lastTimestamp: number;
+        email?: string | undefined;
+        actorId?: string | undefined;
+    }[]>;
     /**
      * Check if an email can be sent to a recipient based on rate limits
      */
@@ -123,7 +203,14 @@ export declare class Loops {
         email: string;
         timeWindowMs: number;
         maxEmails: number;
-    }): Promise<any>;
+    }): Promise<{
+        [x: string]: any;
+        allowed: boolean;
+        count: number;
+        limit: number;
+        timeWindowMs: number;
+        retryAfter?: number | undefined;
+    }>;
     /**
      * Check if an actor/user can send more emails based on rate limits
      */
@@ -131,18 +218,31 @@ export declare class Loops {
         actorId: string;
         timeWindowMs: number;
         maxEmails: number;
-    }): Promise<any>;
+    }): Promise<{
+        allowed: boolean;
+        count: number;
+        limit: number;
+        timeWindowMs: number;
+        retryAfter?: number | undefined;
+    }>;
     /**
      * Check global email sending rate limit
      */
     checkGlobalRateLimit(ctx: RunQueryCtx, options: {
         timeWindowMs: number;
         maxEmails: number;
-    }): Promise<any>;
+    }): Promise<{
+        allowed: boolean;
+        count: number;
+        limit: number;
+        timeWindowMs: number;
+    }>;
     /**
      * Delete a contact from Loops
      */
-    deleteContact(ctx: RunActionCtx, email: string): Promise<any>;
+    deleteContact(ctx: RunActionCtx, email: string): Promise<{
+        success: boolean;
+    }>;
     /**
      * Trigger a loop for a contact
      * Loops are automated email sequences that can be triggered by events
@@ -156,9 +256,12 @@ export declare class Loops {
     triggerLoop(ctx: RunActionCtx, options: {
         loopId: string;
         email: string;
-        dataVariables?: Record<string, any>;
+        dataVariables?: Record<string, unknown>;
         eventName?: string;
-    }): Promise<any>;
+    }): Promise<{
+        success: boolean;
+        warning?: string | undefined;
+    }>;
     /**
      * For easy re-exporting.
      * Apps can do
@@ -175,7 +278,10 @@ export declare class Loops {
             subscribed?: boolean | undefined;
             userGroup?: string | undefined;
             email: string;
-        }, Promise<any>>;
+        }, Promise<{
+            success: boolean;
+            id?: string | undefined;
+        }>>;
         updateContact: import("convex/server").RegisteredAction<"public", {
             firstName?: string | undefined;
             lastName?: string | undefined;
@@ -185,28 +291,53 @@ export declare class Loops {
             userGroup?: string | undefined;
             dataVariables?: any;
             email: string;
-        }, Promise<any>>;
+        }, Promise<{
+            success: boolean;
+        }>>;
         sendTransactional: import("convex/server").RegisteredAction<"public", {
             dataVariables?: any;
             email: string;
             transactionalId: string;
-        }, Promise<any>>;
+        }, Promise<{
+            success: boolean;
+            messageId?: string | undefined;
+        }>>;
         sendEvent: import("convex/server").RegisteredAction<"public", {
             eventProperties?: any;
             email: string;
             eventName: string;
-        }, Promise<any>>;
+        }, Promise<{
+            success: boolean;
+        }>>;
         deleteContact: import("convex/server").RegisteredAction<"public", {
             email: string;
-        }, Promise<any>>;
+        }, Promise<{
+            success: boolean;
+        }>>;
         triggerLoop: import("convex/server").RegisteredAction<"public", {
             dataVariables?: any;
             email: string;
             loopId: string;
-        }, Promise<any>>;
+        }, Promise<{
+            success: boolean;
+            warning?: string | undefined;
+        }>>;
         findContact: import("convex/server").RegisteredAction<"public", {
             email: string;
-        }, Promise<any>>;
+        }, Promise<{
+            success: boolean;
+            contact?: {
+                id?: string | null | undefined;
+                email?: string | null | undefined;
+                firstName?: string | null | undefined;
+                lastName?: string | null | undefined;
+                source?: string | null | undefined;
+                subscribed?: boolean | null | undefined;
+                userGroup?: string | null | undefined;
+                userId?: string | null | undefined;
+                createdAt?: string | null | undefined;
+            } | undefined;
+        }>>;
         batchCreateContacts: import("convex/server").RegisteredAction<"public", {
             contacts: {
                 firstName?: string | undefined;
@@ -217,47 +348,104 @@ export declare class Loops {
                 userGroup?: string | undefined;
                 email: string;
             }[];
-        }, Promise<any>>;
+        }, Promise<{
+            success: boolean;
+            created?: number | undefined;
+            failed?: number | undefined;
+            results?: {
+                email: string;
+                success: boolean;
+                error?: string | undefined;
+            }[] | undefined;
+        }>>;
         unsubscribeContact: import("convex/server").RegisteredAction<"public", {
             email: string;
-        }, Promise<any>>;
+        }, Promise<{
+            success: boolean;
+        }>>;
         resubscribeContact: import("convex/server").RegisteredAction<"public", {
             email: string;
-        }, Promise<any>>;
+        }, Promise<{
+            success: boolean;
+        }>>;
         countContacts: import("convex/server").RegisteredQuery<"public", {
             source?: string | undefined;
             subscribed?: boolean | undefined;
             userGroup?: string | undefined;
-        }, Promise<any>>;
+        }, Promise<number>>;
         detectRecipientSpam: import("convex/server").RegisteredQuery<"public", {
             timeWindowMs?: number | undefined;
             maxEmailsPerRecipient?: number | undefined;
-        }, Promise<any>>;
+        }, Promise<{
+            [x: string]: any;
+            email: string;
+            count: number;
+            timeWindowMs: number;
+        }[]>>;
         detectActorSpam: import("convex/server").RegisteredQuery<"public", {
             timeWindowMs?: number | undefined;
             maxEmailsPerActor?: number | undefined;
-        }, Promise<any>>;
+        }, Promise<{
+            actorId: string;
+            count: number;
+            timeWindowMs: number;
+        }[]>>;
         getEmailStats: import("convex/server").RegisteredQuery<"public", {
             timeWindowMs?: number | undefined;
-        }, Promise<any>>;
+        }, Promise<{
+            [x: string]: any;
+            totalOperations: number;
+            successfulOperations: number;
+            failedOperations: number;
+            operationsByType: {
+                [x: string]: number;
+            };
+            uniqueRecipients: number;
+            uniqueActors: number;
+        }>>;
         detectRapidFirePatterns: import("convex/server").RegisteredQuery<"public", {
             timeWindowMs?: number | undefined;
             minEmailsInWindow?: number | undefined;
-        }, Promise<any>>;
+        }, Promise<{
+            count: number;
+            timeWindowMs: number;
+            firstTimestamp: number;
+            lastTimestamp: number;
+            email?: string | undefined;
+            actorId?: string | undefined;
+        }[]>>;
         checkRecipientRateLimit: import("convex/server").RegisteredQuery<"public", {
             email: string;
             timeWindowMs: number;
             maxEmails: number;
-        }, Promise<any>>;
+        }, Promise<{
+            [x: string]: any;
+            allowed: boolean;
+            count: number;
+            limit: number;
+            timeWindowMs: number;
+            retryAfter?: number | undefined;
+        }>>;
         checkActorRateLimit: import("convex/server").RegisteredQuery<"public", {
             actorId: string;
             timeWindowMs: number;
             maxEmails: number;
-        }, Promise<any>>;
+        }, Promise<{
+            allowed: boolean;
+            count: number;
+            limit: number;
+            timeWindowMs: number;
+            retryAfter?: number | undefined;
+        }>>;
         checkGlobalRateLimit: import("convex/server").RegisteredQuery<"public", {
             timeWindowMs: number;
             maxEmails: number;
-        }, Promise<any>>;
+        }, Promise<{
+            allowed: boolean;
+            count: number;
+            limit: number;
+            timeWindowMs: number;
+        }>>;
     };
 }
 //# sourceMappingURL=index.d.ts.map

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

@@ -1,8 +1,8 @@
 import { actionGeneric, queryGeneric } from "convex/server";
 import { v } from "convex/values";
 export class Loops {
-    component;
     options;
+    lib;
     constructor(component, options) {
         if (!component) {
             throw new Error("Loops component reference is required. " +
@@ -15,7 +15,7 @@ export class Loops {
                 "Ensure the component is correctly mounted in convex.config.ts: " +
                 "app.use(loops);");
         }
-        this.component = component;
+        this.lib = component.lib;
         this.options = options;
         const apiKey = options?.apiKey ?? process.env.LOOPS_API_KEY;
         if (!apiKey) {
@@ -33,18 +33,7 @@ export class Loops {
      * Add or update a contact in Loops
      */
     async addContact(ctx, contact) {
-        if (!this.component) {
-            throw new Error("Loops component is not initialized. " +
-                "Make sure to pass components.loops to the Loops constructor: " +
-                "new Loops(components.loops)");
-        }
-        if (!this.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);");
-        }
-        return ctx.runAction(this.component.lib.addContact, {
+        return ctx.runAction(this.lib.addContact, {
             apiKey: this.apiKey,
             contact,
         });
@@ -53,7 +42,7 @@ export class Loops {
      * Update an existing contact in Loops
      */
     async updateContact(ctx, email, updates) {
-        return ctx.runAction(this.component.lib.updateContact, {
+        return ctx.runAction(this.lib.updateContact, {
             apiKey: this.apiKey,
             email,
             ...updates,
@@ -63,7 +52,7 @@ export class Loops {
      * Send a transactional email using a transactional ID
      */
     async sendTransactional(ctx, options) {
-        return ctx.runAction(this.component.lib.sendTransactional, {
+        return ctx.runAction(this.lib.sendTransactional, {
             apiKey: this.apiKey,
             ...options,
         });
@@ -72,7 +61,7 @@ export class Loops {
      * Send an event to Loops to trigger email workflows
      */
     async sendEvent(ctx, options) {
-        return ctx.runAction(this.component.lib.sendEvent, {
+        return ctx.runAction(this.lib.sendEvent, {
             apiKey: this.apiKey,
             ...options,
         });
@@ -82,7 +71,7 @@ export class Loops {
      * Retrieves contact information from Loops
      */
     async findContact(ctx, email) {
-        return ctx.runAction(this.component.lib.findContact, {
+        return ctx.runAction(this.lib.findContact, {
             apiKey: this.apiKey,
             email,
         });
@@ -92,7 +81,7 @@ export class Loops {
      * Create multiple contacts in a single API call
      */
     async batchCreateContacts(ctx, contacts) {
-        return ctx.runAction(this.component.lib.batchCreateContacts, {
+        return ctx.runAction(this.lib.batchCreateContacts, {
             apiKey: this.apiKey,
             contacts,
         });
@@ -102,7 +91,7 @@ export class Loops {
      * Unsubscribes a contact from receiving emails (they remain in the system)
      */
     async unsubscribeContact(ctx, email) {
-        return ctx.runAction(this.component.lib.unsubscribeContact, {
+        return ctx.runAction(this.lib.unsubscribeContact, {
             apiKey: this.apiKey,
             email,
         });
@@ -112,7 +101,7 @@ export class Loops {
      * Resubscribes a previously unsubscribed contact
      */
     async resubscribeContact(ctx, email) {
-        return ctx.runAction(this.component.lib.resubscribeContact, {
+        return ctx.runAction(this.lib.resubscribeContact, {
             apiKey: this.apiKey,
             email,
         });
@@ -123,7 +112,7 @@ export class Loops {
      * This queries the component's local database, not Loops API
      */
     async countContacts(ctx, options) {
-        return ctx.runQuery(this.component.lib.countContacts, options ?? {});
+        return ctx.runQuery(this.lib.countContacts, options ?? {});
     }
     /**
      * List contacts with pagination and optional filters
@@ -131,7 +120,7 @@ export class Loops {
      * This queries the component's local database, not Loops API
      */
     async listContacts(ctx, options) {
-        return ctx.runQuery(this.component.lib.listContacts, {
+        return ctx.runQuery(this.lib.listContacts, {
             userGroup: options?.userGroup,
             source: options?.source,
             subscribed: options?.subscribed,
@@ -143,7 +132,7 @@ export class Loops {
      * Detect spam patterns: emails sent to the same recipient too frequently
      */
     async detectRecipientSpam(ctx, options) {
-        return ctx.runQuery(this.component.lib.detectRecipientSpam, {
+        return ctx.runQuery(this.lib.detectRecipientSpam, {
             timeWindowMs: options?.timeWindowMs ?? 3600000,
             maxEmailsPerRecipient: options?.maxEmailsPerRecipient ?? 10,
         });
@@ -152,7 +141,7 @@ export class Loops {
      * Detect spam patterns: emails sent by the same actor/user too frequently
      */
     async detectActorSpam(ctx, options) {
-        return ctx.runQuery(this.component.lib.detectActorSpam, {
+        return ctx.runQuery(this.lib.detectActorSpam, {
             timeWindowMs: options?.timeWindowMs ?? 3600000,
             maxEmailsPerActor: options?.maxEmailsPerActor ?? 100,
         });
@@ -161,7 +150,7 @@ export class Loops {
      * Get email operation statistics for monitoring
      */
     async getEmailStats(ctx, options) {
-        return ctx.runQuery(this.component.lib.getEmailStats, {
+        return ctx.runQuery(this.lib.getEmailStats, {
             timeWindowMs: options?.timeWindowMs ?? 86400000,
         });
     }
@@ -169,7 +158,7 @@ export class Loops {
      * Detect rapid-fire email sending patterns
      */
     async detectRapidFirePatterns(ctx, options) {
-        return ctx.runQuery(this.component.lib.detectRapidFirePatterns, {
+        return ctx.runQuery(this.lib.detectRapidFirePatterns, {
             timeWindowMs: options?.timeWindowMs ?? 60000,
             minEmailsInWindow: options?.minEmailsInWindow ?? 5,
         });
@@ -178,25 +167,25 @@ export class Loops {
      * Check if an email can be sent to a recipient based on rate limits
      */
     async checkRecipientRateLimit(ctx, options) {
-        return ctx.runQuery(this.component.lib.checkRecipientRateLimit, options);
+        return ctx.runQuery(this.lib.checkRecipientRateLimit, options);
     }
     /**
      * Check if an actor/user can send more emails based on rate limits
      */
     async checkActorRateLimit(ctx, options) {
-        return ctx.runQuery(this.component.lib.checkActorRateLimit, options);
+        return ctx.runQuery(this.lib.checkActorRateLimit, options);
     }
     /**
      * Check global email sending rate limit
      */
     async checkGlobalRateLimit(ctx, options) {
-        return ctx.runQuery(this.component.lib.checkGlobalRateLimit, options);
+        return ctx.runQuery(this.lib.checkGlobalRateLimit, options);
     }
     /**
      * Delete a contact from Loops
      */
     async deleteContact(ctx, email) {
-        return ctx.runAction(this.component.lib.deleteContact, {
+        return ctx.runAction(this.lib.deleteContact, {
             apiKey: this.apiKey,
             email,
         });
@@ -212,7 +201,7 @@ export class Loops {
      * @param options.eventName - Optional event name. If not provided, uses `loop_{loopId}`
      */
     async triggerLoop(ctx, options) {
-        return ctx.runAction(this.component.lib.triggerLoop, {
+        return ctx.runAction(this.lib.triggerLoop, {
             apiKey: this.apiKey,
             ...options,
         });

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,kDAA2B,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,kDAA2B,CAAC;AA4B3C,eAAe,SAAS,CAAC"}

package/dist/component/convex.config.js

@@ -1,5 +1,5 @@
 import { defineComponent } from "convex/server";
-import { api } from "./_generated/api.js";
+import { api } from "./_generated/api";
 const component = defineComponent("loops");
 component.export(api, {
     addContact: api.lib.addContact,