@devwithbobby/loops 0.1.0 → 0.1.2

package/dist/client/index.d.ts

@@ -0,0 +1,186 @@
+import type { Mounts } from "../component/_generated/api.js";
+import type { RunActionCtx, RunQueryCtx, UseApi } from "./types.js";
+export type LoopsComponent = UseApi<Mounts>;
+export interface ContactData {
+    email: string;
+    firstName?: string;
+    lastName?: string;
+    userId?: string;
+    source?: string;
+    subscribed?: boolean;
+    userGroup?: string;
+}
+export interface TransactionalEmailOptions {
+    transactionalId: string;
+    email: string;
+    dataVariables?: Record<string, any>;
+}
+export interface EventOptions {
+    email: string;
+    eventName: string;
+    eventProperties?: Record<string, any>;
+}
+export declare class Loops {
+    component: LoopsComponent;
+    options?: {
+        apiKey?: string;
+    } | undefined;
+    constructor(component: LoopsComponent, options?: {
+        apiKey?: string;
+    } | undefined);
+    private readonly apiKey;
+    /**
+     * Add or update a contact in Loops
+     */
+    addContact(ctx: RunActionCtx, contact: ContactData): Promise<FunctionReturnType<Action>>;
+    /**
+     * Update an existing contact in Loops
+     */
+    updateContact(ctx: RunActionCtx, email: string, updates: Partial<ContactData> & {
+        dataVariables?: Record<string, any>;
+    }): Promise<FunctionReturnType<Action>>;
+    /**
+     * Send a transactional email using a transactional ID
+     */
+    sendTransactional(ctx: RunActionCtx, options: TransactionalEmailOptions): Promise<FunctionReturnType<Action>>;
+    /**
+     * Send an event to Loops to trigger email workflows
+     */
+    sendEvent(ctx: RunActionCtx, options: EventOptions): Promise<FunctionReturnType<Action>>;
+    /**
+     * Find a contact by email
+     * Retrieves contact information from Loops
+     */
+    findContact(ctx: RunActionCtx, email: string): Promise<FunctionReturnType<Action>>;
+    /**
+     * Batch create contacts
+     * Create multiple contacts in a single API call
+     */
+    batchCreateContacts(ctx: RunActionCtx, contacts: ContactData[]): Promise<FunctionReturnType<Action>>;
+    /**
+     * Unsubscribe a contact
+     * Unsubscribes a contact from receiving emails (they remain in the system)
+     */
+    unsubscribeContact(ctx: RunActionCtx, email: string): Promise<FunctionReturnType<Action>>;
+    /**
+     * Resubscribe a contact
+     * Resubscribes a previously unsubscribed contact
+     */
+    resubscribeContact(ctx: RunActionCtx, email: string): Promise<FunctionReturnType<Action>>;
+    /**
+     * Count contacts in the database
+     * Can filter by audience criteria (userGroup, source, subscribed status)
+     * This queries the component's local database, not Loops API
+     */
+    countContacts(ctx: RunQueryCtx, options?: {
+        userGroup?: string;
+        source?: string;
+        subscribed?: boolean;
+    }): Promise<FunctionReturnType<Query>>;
+    /**
+     * Detect spam patterns: emails sent to the same recipient too frequently
+     */
+    detectRecipientSpam(ctx: RunQueryCtx, options?: {
+        timeWindowMs?: number;
+        maxEmailsPerRecipient?: number;
+    }): Promise<FunctionReturnType<Query>>;
+    /**
+     * Detect spam patterns: emails sent by the same actor/user too frequently
+     */
+    detectActorSpam(ctx: RunQueryCtx, options?: {
+        timeWindowMs?: number;
+        maxEmailsPerActor?: number;
+    }): Promise<FunctionReturnType<Query>>;
+    /**
+     * Get email operation statistics for monitoring
+     */
+    getEmailStats(ctx: RunQueryCtx, options?: {
+        timeWindowMs?: number;
+    }): Promise<FunctionReturnType<Query>>;
+    /**
+     * Detect rapid-fire email sending patterns
+     */
+    detectRapidFirePatterns(ctx: RunQueryCtx, options?: {
+        timeWindowMs?: number;
+        minEmailsInWindow?: number;
+    }): Promise<FunctionReturnType<Query>>;
+    /**
+     * Check if an email can be sent to a recipient based on rate limits
+     */
+    checkRecipientRateLimit(ctx: RunQueryCtx, options: {
+        email: string;
+        timeWindowMs: number;
+        maxEmails: number;
+    }): Promise<FunctionReturnType<Query>>;
+    /**
+     * Check if an actor/user can send more emails based on rate limits
+     */
+    checkActorRateLimit(ctx: RunQueryCtx, options: {
+        actorId: string;
+        timeWindowMs: number;
+        maxEmails: number;
+    }): Promise<FunctionReturnType<Query>>;
+    /**
+     * Check global email sending rate limit
+     */
+    checkGlobalRateLimit(ctx: RunQueryCtx, options: {
+        timeWindowMs: number;
+        maxEmails: number;
+    }): Promise<FunctionReturnType<Query>>;
+    /**
+     * 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
+     */
+    triggerLoop(ctx: RunActionCtx, options: {
+        loopId: string;
+        email: string;
+        dataVariables?: Record<string, any>;
+    }): Promise<FunctionReturnType<Action>>;
+    /**
+     * For easy re-exporting.
+     * Apps can do
+     * ```ts
+     * export const { addContact, sendTransactional, sendEvent, sendCampaign, triggerLoop } = loops.api();
+     * ```
+     */
+    api(): {
+        addContact: any;
+        updateContact: any;
+        sendTransactional: any;
+        sendEvent: any;
+        deleteContact: any;
+        sendCampaign: any;
+        triggerLoop: any;
+        findContact: any;
+        batchCreateContacts: any;
+        unsubscribeContact: any;
+        resubscribeContact: any;
+        countContacts: any;
+        detectRecipientSpam: any;
+        detectActorSpam: any;
+        getEmailStats: any;
+        detectRapidFirePatterns: any;
+        checkRecipientRateLimit: any;
+        checkActorRateLimit: any;
+        checkGlobalRateLimit: any;
+    };
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"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"}

package/dist/client/index.js

@@ -0,0 +1,396 @@
+import { actionGeneric, queryGeneric } from "convex/server";
+import { v } from "convex/values";
+export class Loops {
+    component;
+    options;
+    constructor(component, options) {
+        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.");
+        }
+        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.");
+        }
+        this.apiKey = apiKey;
+    }
+    apiKey;
+    /**
+     * Add or update a contact in Loops
+     */
+    async addContact(ctx, contact) {
+        return ctx.runAction(this.component.lib.addContact, {
+            apiKey: this.apiKey,
+            contact,
+        });
+    }
+    /**
+     * Update an existing contact in Loops
+     */
+    async updateContact(ctx, email, updates) {
+        return ctx.runAction(this.component.lib.updateContact, {
+            apiKey: this.apiKey,
+            email,
+            ...updates,
+        });
+    }
+    /**
+     * Send a transactional email using a transactional ID
+     */
+    async sendTransactional(ctx, options) {
+        return ctx.runAction(this.component.lib.sendTransactional, {
+            apiKey: this.apiKey,
+            ...options,
+        });
+    }
+    /**
+     * Send an event to Loops to trigger email workflows
+     */
+    async sendEvent(ctx, options) {
+        return ctx.runAction(this.component.lib.sendEvent, {
+            apiKey: this.apiKey,
+            ...options,
+        });
+    }
+    /**
+     * Find a contact by email
+     * Retrieves contact information from Loops
+     */
+    async findContact(ctx, email) {
+        return ctx.runAction(this.component.lib.findContact, {
+            apiKey: this.apiKey,
+            email,
+        });
+    }
+    /**
+     * Batch create contacts
+     * Create multiple contacts in a single API call
+     */
+    async batchCreateContacts(ctx, contacts) {
+        return ctx.runAction(this.component.lib.batchCreateContacts, {
+            apiKey: this.apiKey,
+            contacts,
+        });
+    }
+    /**
+     * Unsubscribe a contact
+     * Unsubscribes a contact from receiving emails (they remain in the system)
+     */
+    async unsubscribeContact(ctx, email) {
+        return ctx.runAction(this.component.lib.unsubscribeContact, {
+            apiKey: this.apiKey,
+            email,
+        });
+    }
+    /**
+     * Resubscribe a contact
+     * Resubscribes a previously unsubscribed contact
+     */
+    async resubscribeContact(ctx, email) {
+        return ctx.runAction(this.component.lib.resubscribeContact, {
+            apiKey: this.apiKey,
+            email,
+        });
+    }
+    /**
+     * Count contacts in the database
+     * Can filter by audience criteria (userGroup, source, subscribed status)
+     * This queries the component's local database, not Loops API
+     */
+    async countContacts(ctx, options) {
+        return ctx.runQuery(this.component.lib.countContacts, options ?? {});
+    }
+    /**
+     * Detect spam patterns: emails sent to the same recipient too frequently
+     */
+    async detectRecipientSpam(ctx, options) {
+        return ctx.runQuery(this.component.lib.detectRecipientSpam, {
+            timeWindowMs: options?.timeWindowMs ?? 3600000,
+            maxEmailsPerRecipient: options?.maxEmailsPerRecipient ?? 10,
+        });
+    }
+    /**
+     * Detect spam patterns: emails sent by the same actor/user too frequently
+     */
+    async detectActorSpam(ctx, options) {
+        return ctx.runQuery(this.component.lib.detectActorSpam, {
+            timeWindowMs: options?.timeWindowMs ?? 3600000,
+            maxEmailsPerActor: options?.maxEmailsPerActor ?? 100,
+        });
+    }
+    /**
+     * Get email operation statistics for monitoring
+     */
+    async getEmailStats(ctx, options) {
+        return ctx.runQuery(this.component.lib.getEmailStats, {
+            timeWindowMs: options?.timeWindowMs ?? 86400000,
+        });
+    }
+    /**
+     * Detect rapid-fire email sending patterns
+     */
+    async detectRapidFirePatterns(ctx, options) {
+        return ctx.runQuery(this.component.lib.detectRapidFirePatterns, {
+            timeWindowMs: options?.timeWindowMs ?? 60000,
+            minEmailsInWindow: options?.minEmailsInWindow ?? 5,
+        });
+    }
+    /**
+     * 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);
+    }
+    /**
+     * 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);
+    }
+    /**
+     * Check global email sending rate limit
+     */
+    async checkGlobalRateLimit(ctx, options) {
+        return ctx.runQuery(this.component.lib.checkGlobalRateLimit, options);
+    }
+    /**
+     * Delete a contact from Loops
+     */
+    async deleteContact(ctx, email) {
+        return ctx.runAction(this.component.lib.deleteContact, {
+            apiKey: this.apiKey,
+            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
+     */
+    async triggerLoop(ctx, options) {
+        return ctx.runAction(this.component.lib.triggerLoop, {
+            apiKey: this.apiKey,
+            ...options,
+        });
+    }
+    /**
+     * For easy re-exporting.
+     * Apps can do
+     * ```ts
+     * export const { addContact, sendTransactional, sendEvent, sendCampaign, triggerLoop } = loops.api();
+     * ```
+     */
+    api() {
+        return {
+            addContact: actionGeneric({
+                args: {
+                    email: v.string(),
+                    firstName: v.optional(v.string()),
+                    lastName: v.optional(v.string()),
+                    userId: v.optional(v.string()),
+                    source: v.optional(v.string()),
+                    subscribed: v.optional(v.boolean()),
+                    userGroup: v.optional(v.string()),
+                },
+                handler: async (ctx, args) => {
+                    return await this.addContact(ctx, args);
+                },
+            }),
+            updateContact: actionGeneric({
+                args: {
+                    email: v.string(),
+                    firstName: v.optional(v.string()),
+                    lastName: v.optional(v.string()),
+                    userId: v.optional(v.string()),
+                    source: v.optional(v.string()),
+                    subscribed: v.optional(v.boolean()),
+                    userGroup: v.optional(v.string()),
+                    dataVariables: v.optional(v.any()),
+                },
+                handler: async (ctx, args) => {
+                    const { email, ...updates } = args;
+                    return await this.updateContact(ctx, email, updates);
+                },
+            }),
+            sendTransactional: actionGeneric({
+                args: {
+                    transactionalId: v.string(),
+                    email: v.string(),
+                    dataVariables: v.optional(v.any()),
+                },
+                handler: async (ctx, args) => {
+                    return await this.sendTransactional(ctx, args);
+                },
+            }),
+            sendEvent: actionGeneric({
+                args: {
+                    email: v.string(),
+                    eventName: v.string(),
+                    eventProperties: v.optional(v.any()),
+                },
+                handler: async (ctx, args) => {
+                    return await this.sendEvent(ctx, args);
+                },
+            }),
+            deleteContact: actionGeneric({
+                args: {
+                    email: v.string(),
+                },
+                handler: async (ctx, args) => {
+                    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(),
+                    email: v.string(),
+                    dataVariables: v.optional(v.any()),
+                },
+                handler: async (ctx, args) => {
+                    return await this.triggerLoop(ctx, args);
+                },
+            }),
+            findContact: actionGeneric({
+                args: {
+                    email: v.string(),
+                },
+                handler: async (ctx, args) => {
+                    return await this.findContact(ctx, args.email);
+                },
+            }),
+            batchCreateContacts: actionGeneric({
+                args: {
+                    contacts: v.array(v.object({
+                        email: v.string(),
+                        firstName: v.optional(v.string()),
+                        lastName: v.optional(v.string()),
+                        userId: v.optional(v.string()),
+                        source: v.optional(v.string()),
+                        subscribed: v.optional(v.boolean()),
+                        userGroup: v.optional(v.string()),
+                    })),
+                },
+                handler: async (ctx, args) => {
+                    return await this.batchCreateContacts(ctx, args.contacts);
+                },
+            }),
+            unsubscribeContact: actionGeneric({
+                args: {
+                    email: v.string(),
+                },
+                handler: async (ctx, args) => {
+                    return await this.unsubscribeContact(ctx, args.email);
+                },
+            }),
+            resubscribeContact: actionGeneric({
+                args: {
+                    email: v.string(),
+                },
+                handler: async (ctx, args) => {
+                    return await this.resubscribeContact(ctx, args.email);
+                },
+            }),
+            countContacts: queryGeneric({
+                args: {
+                    userGroup: v.optional(v.string()),
+                    source: v.optional(v.string()),
+                    subscribed: v.optional(v.boolean()),
+                },
+                handler: async (ctx, args) => {
+                    return await this.countContacts(ctx, args);
+                },
+            }),
+            detectRecipientSpam: queryGeneric({
+                args: {
+                    timeWindowMs: v.optional(v.number()),
+                    maxEmailsPerRecipient: v.optional(v.number()),
+                },
+                handler: async (ctx, args) => {
+                    return await this.detectRecipientSpam(ctx, args);
+                },
+            }),
+            detectActorSpam: queryGeneric({
+                args: {
+                    timeWindowMs: v.optional(v.number()),
+                    maxEmailsPerActor: v.optional(v.number()),
+                },
+                handler: async (ctx, args) => {
+                    return await this.detectActorSpam(ctx, args);
+                },
+            }),
+            getEmailStats: queryGeneric({
+                args: {
+                    timeWindowMs: v.optional(v.number()),
+                },
+                handler: async (ctx, args) => {
+                    return await this.getEmailStats(ctx, args);
+                },
+            }),
+            detectRapidFirePatterns: queryGeneric({
+                args: {
+                    timeWindowMs: v.optional(v.number()),
+                    minEmailsInWindow: v.optional(v.number()),
+                },
+                handler: async (ctx, args) => {
+                    return await this.detectRapidFirePatterns(ctx, args);
+                },
+            }),
+            checkRecipientRateLimit: queryGeneric({
+                args: {
+                    email: v.string(),
+                    timeWindowMs: v.number(),
+                    maxEmails: v.number(),
+                },
+                handler: async (ctx, args) => {
+                    return await this.checkRecipientRateLimit(ctx, args);
+                },
+            }),
+            checkActorRateLimit: queryGeneric({
+                args: {
+                    actorId: v.string(),
+                    timeWindowMs: v.number(),
+                    maxEmails: v.number(),
+                },
+                handler: async (ctx, args) => {
+                    return await this.checkActorRateLimit(ctx, args);
+                },
+            }),
+            checkGlobalRateLimit: queryGeneric({
+                args: {
+                    timeWindowMs: v.number(),
+                    maxEmails: v.number(),
+                },
+                handler: async (ctx, args) => {
+                    return await this.checkGlobalRateLimit(ctx, args);
+                },
+            }),
+        };
+    }
+}

package/dist/client/types.d.ts

@@ -0,0 +1,24 @@
+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

@@ -0,0 +1 @@
+{"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"}

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

@@ -0,0 +1,3 @@
+declare const component: any;
+export default component;
+//# sourceMappingURL=convex.config.d.ts.map

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

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

package/dist/component/convex.config.js

@@ -0,0 +1,25 @@
+import { defineComponent } from "convex/server";
+import { api } from "./_generated/api.js";
+const component = defineComponent("loops");
+component.export(api, {
+    addContact: api.lib.addContact,
+    updateContact: api.lib.updateContact,
+    findContact: api.lib.findContact,
+    batchCreateContacts: api.lib.batchCreateContacts,
+    unsubscribeContact: api.lib.unsubscribeContact,
+    resubscribeContact: api.lib.resubscribeContact,
+    countContacts: api.lib.countContacts,
+    sendTransactional: api.lib.sendTransactional,
+    sendEvent: api.lib.sendEvent,
+    sendCampaign: api.lib.sendCampaign,
+    triggerLoop: api.lib.triggerLoop,
+    deleteContact: api.lib.deleteContact,
+    detectRecipientSpam: api.lib.detectRecipientSpam,
+    detectActorSpam: api.lib.detectActorSpam,
+    getEmailStats: api.lib.getEmailStats,
+    detectRapidFirePatterns: api.lib.detectRapidFirePatterns,
+    checkRecipientRateLimit: api.lib.checkRecipientRateLimit,
+    checkActorRateLimit: api.lib.checkActorRateLimit,
+    checkGlobalRateLimit: api.lib.checkGlobalRateLimit,
+});
+export default component;