@devwithbobby/loops 0.1.19 → 0.2.0

package/dist/types.d.ts

@@ -1,26 +1,7 @@
-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]>;
-}>;
+import type { GenericActionCtx, GenericDataModel, GenericMutationCtx, GenericQueryCtx } from "convex/server";
+export type RunQueryCtx = Pick<GenericQueryCtx<GenericDataModel>, "runQuery">;
+export type RunMutationCtx = Pick<GenericMutationCtx<GenericDataModel>, "runQuery" | "runMutation">;
+export type RunActionCtx = Pick<GenericActionCtx<GenericDataModel>, "runQuery" | "runMutation" | "runAction">;
 export type HeadersInitParam = ConstructorParameters<typeof Headers>[0];
 export interface ContactPayload {
     email: string;
@@ -54,44 +35,250 @@ export interface TriggerPayload {
     dataVariables?: Record<string, unknown>;
     eventName?: string;
 }
-export type InternalActionRef<Args extends Record<string, unknown> = Record<string, unknown>, Result = unknown> = FunctionReference<"action", "internal", Args, Result>;
-export type InternalMutationRef<Args extends Record<string, unknown> = Record<string, unknown>, Result = unknown> = FunctionReference<"mutation", "internal", Args, Result>;
-export type InternalQueryRef<Args extends Record<string, unknown> = Record<string, unknown>, Result = unknown> = FunctionReference<"query", "internal", Args, Result>;
-type AddContactArgs = {
-    apiKey: string;
-    contact: ContactPayload;
-};
-type AddContactResult = {
-    success: boolean;
-    id?: string;
+export declare const internalLib: {
+    storeContact: import("convex/server").FunctionReference<"mutation", "public", {
+        email: string;
+        firstName?: string | undefined;
+        lastName?: string | undefined;
+        userId?: string | undefined;
+        source?: string | undefined;
+        subscribed?: boolean | undefined;
+        userGroup?: string | undefined;
+        loopsContactId?: string | undefined;
+    }, null, string | undefined>;
+    removeContact: import("convex/server").FunctionReference<"mutation", "public", {
+        email: string;
+    }, null, string | undefined>;
+    logEmailOperation: import("convex/server").FunctionReference<"mutation", "public", {
+        operationType: "transactional" | "event" | "campaign" | "loop";
+        email: string;
+        success: boolean;
+        actorId?: string | undefined;
+        transactionalId?: string | undefined;
+        campaignId?: string | undefined;
+        loopId?: string | undefined;
+        eventName?: string | undefined;
+        messageId?: string | undefined;
+        metadata?: Record<string, any> | undefined;
+    }, null, string | undefined>;
+    countContacts: import("convex/server").FunctionReference<"query", "public", {
+        userGroup?: string | undefined;
+        source?: string | undefined;
+        subscribed?: boolean | undefined;
+    }, number, string | undefined>;
+    listContacts: import("convex/server").FunctionReference<"query", "public", {
+        limit: number;
+        userGroup?: string | undefined;
+        source?: string | undefined;
+        subscribed?: boolean | undefined;
+        cursor?: string | null | undefined;
+    }, {
+        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;
+        }[];
+        continueCursor: string | null;
+        isDone: boolean;
+    }, string | undefined>;
+    addContact: import("convex/server").FunctionReference<"action", "public", {
+        apiKey: string;
+        contact: {
+            email: string;
+            firstName?: string | undefined;
+            lastName?: string | undefined;
+            userId?: string | undefined;
+            source?: string | undefined;
+            subscribed?: boolean | undefined;
+            userGroup?: string | undefined;
+        };
+    }, {
+        success: boolean;
+        id?: string | undefined;
+    }, string | undefined>;
+    updateContact: import("convex/server").FunctionReference<"action", "public", {
+        apiKey: string;
+        email: string;
+        dataVariables?: Record<string, any> | undefined;
+        firstName?: string | undefined;
+        lastName?: string | undefined;
+        userId?: string | undefined;
+        source?: string | undefined;
+        subscribed?: boolean | undefined;
+        userGroup?: string | undefined;
+    }, {
+        success: boolean;
+    }, string | undefined>;
+    sendTransactional: import("convex/server").FunctionReference<"action", "public", {
+        apiKey: string;
+        transactionalId: string;
+        email: string;
+        dataVariables?: Record<string, any> | undefined;
+    }, {
+        success: boolean;
+        messageId?: string | undefined;
+    }, string | undefined>;
+    sendEvent: import("convex/server").FunctionReference<"action", "public", {
+        apiKey: string;
+        email: string;
+        eventName: string;
+        eventProperties?: Record<string, any> | undefined;
+    }, {
+        success: boolean;
+    }, string | undefined>;
+    deleteContact: import("convex/server").FunctionReference<"action", "public", {
+        apiKey: string;
+        email: string;
+    }, {
+        success: boolean;
+    }, string | undefined>;
+    triggerLoop: import("convex/server").FunctionReference<"action", "public", {
+        apiKey: string;
+        loopId: string;
+        email: string;
+        dataVariables?: Record<string, any> | undefined;
+        eventName?: string | undefined;
+    }, {
+        success: boolean;
+        warning?: string | undefined;
+    }, string | undefined>;
+    findContact: import("convex/server").FunctionReference<"action", "public", {
+        apiKey: string;
+        email: string;
+    }, {
+        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;
+    }, string | undefined>;
+    batchCreateContacts: import("convex/server").FunctionReference<"action", "public", {
+        apiKey: string;
+        contacts: {
+            email: string;
+            firstName?: string | undefined;
+            lastName?: string | undefined;
+            userId?: string | undefined;
+            source?: string | undefined;
+            subscribed?: boolean | undefined;
+            userGroup?: string | undefined;
+        }[];
+    }, {
+        success: boolean;
+        created?: number | undefined;
+        failed?: number | undefined;
+        results?: {
+            email: string;
+            success: boolean;
+            error?: string | undefined;
+        }[] | undefined;
+    }, string | undefined>;
+    unsubscribeContact: import("convex/server").FunctionReference<"action", "public", {
+        apiKey: string;
+        email: string;
+    }, {
+        success: boolean;
+    }, string | undefined>;
+    resubscribeContact: import("convex/server").FunctionReference<"action", "public", {
+        apiKey: string;
+        email: string;
+    }, {
+        success: boolean;
+    }, string | undefined>;
+    detectRecipientSpam: import("convex/server").FunctionReference<"query", "public", {
+        timeWindowMs: number;
+        maxEmailsPerRecipient: number;
+    }, {
+        [x: string]: any;
+        email: string;
+        count: number;
+        timeWindowMs: number;
+    }[], string | undefined>;
+    detectActorSpam: import("convex/server").FunctionReference<"query", "public", {
+        timeWindowMs: number;
+        maxEmailsPerActor: number;
+    }, {
+        actorId: string;
+        count: number;
+        timeWindowMs: number;
+    }[], string | undefined>;
+    getEmailStats: import("convex/server").FunctionReference<"query", "public", {
+        timeWindowMs: number;
+    }, {
+        [x: string]: any;
+        totalOperations: number;
+        successfulOperations: number;
+        failedOperations: number;
+        operationsByType: Record<string, number>;
+        uniqueRecipients: number;
+        uniqueActors: number;
+    }, string | undefined>;
+    detectRapidFirePatterns: import("convex/server").FunctionReference<"query", "public", {
+        timeWindowMs: number;
+        minEmailsInWindow: number;
+    }, {
+        count: number;
+        timeWindowMs: number;
+        firstTimestamp: number;
+        lastTimestamp: number;
+        email?: string | undefined;
+        actorId?: string | undefined;
+    }[], string | undefined>;
+    checkRecipientRateLimit: import("convex/server").FunctionReference<"query", "public", {
+        email: string;
+        timeWindowMs: number;
+        maxEmails: number;
+    }, {
+        [x: string]: any;
+        allowed: boolean;
+        count: number;
+        limit: number;
+        timeWindowMs: number;
+        retryAfter?: number | undefined;
+    }, string | undefined>;
+    checkActorRateLimit: import("convex/server").FunctionReference<"query", "public", {
+        actorId: string;
+        timeWindowMs: number;
+        maxEmails: number;
+    }, {
+        allowed: boolean;
+        count: number;
+        limit: number;
+        timeWindowMs: number;
+        retryAfter?: number | undefined;
+    }, string | undefined>;
+    checkGlobalRateLimit: import("convex/server").FunctionReference<"query", "public", {
+        timeWindowMs: number;
+        maxEmails: number;
+    }, {
+        allowed: boolean;
+        count: number;
+        limit: number;
+        timeWindowMs: number;
+    }, string | undefined>;
+    backfillContactAggregate: import("convex/server").FunctionReference<"mutation", "public", {
+        batchSize: number;
+        cursor?: string | null | undefined;
+        clear?: boolean | undefined;
+    }, {
+        processed: number;
+        cursor: string | null;
+        isDone: boolean;
+    }, string | undefined>;
 };
-export interface InternalActionLib {
-    addContact: InternalActionRef<AddContactArgs, AddContactResult>;
-    updateContact: InternalActionRef;
-    findContact: InternalActionRef;
-    deleteContact: InternalActionRef;
-    sendTransactional: InternalActionRef;
-    sendEvent: InternalActionRef;
-    triggerLoop: InternalActionRef;
-    batchCreateContacts: InternalActionRef;
-    unsubscribeContact: InternalActionRef;
-    resubscribeContact: InternalActionRef;
-    storeContact: InternalMutationRef;
-    removeContact: InternalMutationRef;
-    logEmailOperation: InternalMutationRef;
-}
-export interface InternalQueryLib {
-    countContacts: InternalQueryRef;
-    listContacts: InternalQueryRef;
-    detectRecipientSpam: InternalQueryRef;
-    detectActorSpam: InternalQueryRef;
-    getEmailStats: InternalQueryRef;
-    detectRapidFirePatterns: InternalQueryRef;
-    checkRecipientRateLimit: InternalQueryRef;
-    checkActorRateLimit: InternalQueryRef;
-    checkGlobalRateLimit: InternalQueryRef;
-}
-export type InternalLibReferences = InternalActionLib & InternalQueryLib;
-export declare const internalLib: InternalLibReferences;
-export {};
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/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;AAG/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;AAEF,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;AAEF,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;AAEF,MAAM,MAAM,SAAS,GAAG,YAAY,GAAG;IACtC,OAAO,EAAE,mBAAmB,CAAC;CAC7B,CAAC;AAEF,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;AAEH,MAAM,MAAM,gBAAgB,GAAG,qBAAqB,CAAC,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AAExE,MAAM,WAAW,cAAc;IAC9B,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,oBAAqB,SAAQ,OAAO,CAAC,cAAc,CAAC;IACpE,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,oBAAoB;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,oBAAoB;IACpC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,YAAY;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,cAAc;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,iBAAiB,CAC5B,IAAI,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9D,MAAM,GAAG,OAAO,IACb,iBAAiB,CAAC,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AAE1D,MAAM,MAAM,mBAAmB,CAC9B,IAAI,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9D,MAAM,GAAG,OAAO,IACb,iBAAiB,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AAE5D,MAAM,MAAM,gBAAgB,CAC3B,IAAI,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9D,MAAM,GAAG,OAAO,IACb,iBAAiB,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AAEzD,KAAK,cAAc,GAAG;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,cAAc,CAAC;CACxB,CAAC;AAEF,KAAK,gBAAgB,GAAG;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,EAAE,CAAC,EAAE,MAAM,CAAC;CACZ,CAAC;AAEF,MAAM,WAAW,iBAAiB;IACjC,UAAU,EAAE,iBAAiB,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAAC;IAChE,aAAa,EAAE,iBAAiB,CAAC;IACjC,WAAW,EAAE,iBAAiB,CAAC;IAC/B,aAAa,EAAE,iBAAiB,CAAC;IACjC,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,SAAS,EAAE,iBAAiB,CAAC;IAC7B,WAAW,EAAE,iBAAiB,CAAC;IAC/B,mBAAmB,EAAE,iBAAiB,CAAC;IACvC,kBAAkB,EAAE,iBAAiB,CAAC;IACtC,kBAAkB,EAAE,iBAAiB,CAAC;IACtC,YAAY,EAAE,mBAAmB,CAAC;IAClC,aAAa,EAAE,mBAAmB,CAAC;IACnC,iBAAiB,EAAE,mBAAmB,CAAC;CACvC;AAED,MAAM,WAAW,gBAAgB;IAChC,aAAa,EAAE,gBAAgB,CAAC;IAChC,YAAY,EAAE,gBAAgB,CAAC;IAC/B,mBAAmB,EAAE,gBAAgB,CAAC;IACtC,eAAe,EAAE,gBAAgB,CAAC;IAClC,aAAa,EAAE,gBAAgB,CAAC;IAChC,uBAAuB,EAAE,gBAAgB,CAAC;IAC1C,uBAAuB,EAAE,gBAAgB,CAAC;IAC1C,mBAAmB,EAAE,gBAAgB,CAAC;IACtC,oBAAoB,EAAE,gBAAgB,CAAC;CACvC;AAED,MAAM,MAAM,qBAAqB,GAAG,iBAAiB,GAAG,gBAAgB,CAAC;AAEzE,eAAO,MAAM,WAAW,uBAEnB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,MAAM,eAAe,CAAC;AAIvB,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,eAAe,CAAC,gBAAgB,CAAC,EAAE,UAAU,CAAC,CAAC;AAE9E,MAAM,MAAM,cAAc,GAAG,IAAI,CAChC,kBAAkB,CAAC,gBAAgB,CAAC,EACpC,UAAU,GAAG,aAAa,CAC1B,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,IAAI,CAC9B,gBAAgB,CAAC,gBAAgB,CAAC,EAClC,UAAU,GAAG,aAAa,GAAG,WAAW,CACxC,CAAC;AAGF,MAAM,MAAM,gBAAgB,GAAG,qBAAqB,CAAC,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AAGxE,MAAM,WAAW,cAAc;IAC9B,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,oBAAqB,SAAQ,OAAO,CAAC,cAAc,CAAC;IACpE,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,oBAAoB;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,oBAAoB;IACpC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,YAAY;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,cAAc;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAID,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAU,CAAC"}

package/dist/types.js

@@ -1,2 +1,4 @@
-import { internal } from "./component/_generated/api";
-export const internalLib = internal.lib;
+import { api } from "./component/_generated/api";
+// Lib reference for component internals
+// This is used internally by the component to call its own functions
+export const internalLib = api.lib;

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" | "metadata" | "operationType" | "actorId" | "transactionalId" | "campaignId" | "loopId" | "eventName" | "timestamp" | "messageId" | "_creationTime" | `metadata.${string}`) | "_id";
+            fieldPaths: ("email" | "success" | "operationType" | "actorId" | "transactionalId" | "campaignId" | "loopId" | "eventName" | "timestamp" | "messageId" | "metadata" | "_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" | "metadata" | "operationType" | "actorId" | "transactionalId" | "campaignId" | "loopId" | "eventName" | "timestamp" | "messageId" | "_creationTime" | `metadata.${string}`) | "_id";
+            fieldPaths: ("email" | "success" | "operationType" | "actorId" | "transactionalId" | "campaignId" | "loopId" | "eventName" | "timestamp" | "messageId" | "metadata" | "_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" | "metadata" | "operationType" | "actorId" | "transactionalId" | "campaignId" | "loopId" | "eventName" | "timestamp" | "messageId" | "_creationTime" | `metadata.${string}`) | "_id";
+            fieldPaths: ("email" | "success" | "operationType" | "actorId" | "transactionalId" | "campaignId" | "loopId" | "eventName" | "timestamp" | "messageId" | "metadata" | "_creationTime" | `metadata.${string}`) | "_id";
             indexes: {
                 email: ["email", "timestamp", "_creationTime"];
                 actorId: ["actorId", "timestamp", "_creationTime"];

package/package.json

@@ -1,9 +1,11 @@
 {
 	"name": "@devwithbobby/loops",
-	"version": "0.1.19",
+	"version": "0.2.0",
 	"description": "Convex component for integrating with Loops.so email marketing platform",
 	"license": "Apache-2.0",
 	"type": "module",
+	"main": "dist/client/index.js",
+	"types": "dist/client/index.d.ts",
 	"keywords": [
 		"convex",
 		"component",
@@ -32,19 +34,22 @@
 	"exports": {
 		"./package.json": "./package.json",
 		".": {
-			"@convex-dev/component-source": "./src/client/index.ts",
 			"types": "./dist/client/index.d.ts",
 			"default": "./dist/client/index.js"
 		},
 		"./convex.config": {
-			"@convex-dev/component-source": "./src/component/convex.config.ts",
 			"types": "./dist/component/convex.config.d.ts",
-			"default": "./src/component/convex.config.ts"
+			"default": "./dist/component/convex.config.js"
 		},
-		"./component": {
-			"@convex-dev/component-source": "./src/component/_generated/component.ts",
-			"types": "./dist/component/_generated/component.d.ts",
-			"default": "./dist/component/_generated/component.js"
+		"./convex.config.js": {
+			"types": "./dist/component/convex.config.d.ts",
+			"default": "./dist/component/convex.config.js"
+		},
+		"./_generated/component": {
+			"types": "./dist/component/_generated/component.d.ts"
+		},
+		"./_generated/component.js": {
+			"types": "./dist/component/_generated/component.d.ts"
 		},
 		"./test": "./src/test.ts"
 	},
@@ -65,7 +70,7 @@
 		"check": "biome check .",
 		"check:fix": "biome check --write .",
 		"typecheck": "tsc --noEmit",
-		"attw": "attw $(npm pack -s) --exclude-entrypoints ./convex.config --profile esm-only",
+		"attw": "attw $(npm pack -s) --exclude-entrypoints ./convex.config ./test --profile esm-only --ignore-rules internal-resolution-error",
 		"prepare": "npm run build || true",
 		"changeset": "changeset",
 		"ci:version": "changeset version && bun update",
@@ -77,6 +82,7 @@
 		"release": "bun run preversion && npm version patch && npm publish"
 	},
 	"dependencies": {
+		"@convex-dev/aggregate": "^0.2.1",
 		"zod": "^4.1.12",
 		"zodvex": "^0.2.3"
 	},

package/src/client/index.ts

@@ -1,7 +1,7 @@
-import { actionGeneric, queryGeneric } from "convex/server";
+import { actionGeneric, mutationGeneric, queryGeneric } from "convex/server";
 import { v } from "convex/values";
 import type { ComponentApi } from "../component/_generated/component.js";
-import type { RunActionCtx, RunQueryCtx } from "../types";
+import type { RunActionCtx, RunMutationCtx, RunQueryCtx } from "../types";
 
 export type LoopsComponent = ComponentApi;
 
@@ -195,9 +195,12 @@ export class Loops {
 	}
 
 	/**
-	 * List contacts with pagination and optional filters
+	 * List contacts with cursor-based pagination and optional filters
 	 * Returns actual contact data, not just a count
 	 * This queries the component's local database, not Loops API
+	 *
+	 * Uses cursor-based pagination for efficiency. Pass the `continueCursor`
+	 * from the previous response as `cursor` to get the next page.
 	 */
 	async listContacts(
 		ctx: RunQueryCtx,
@@ -206,7 +209,7 @@ export class Loops {
 			source?: string;
 			subscribed?: boolean;
 			limit?: number;
-			offset?: number;
+			cursor?: string | null;
 		},
 	) {
 		return ctx.runQuery(this.lib.listContacts, {
@@ -214,7 +217,7 @@ export class Loops {
 			source: options?.source,
 			subscribed: options?.subscribed,
 			limit: options?.limit ?? 100,
-			offset: options?.offset ?? 0,
+			cursor: options?.cursor ?? null,
 		});
 	}
 
@@ -356,6 +359,39 @@ export class Loops {
 		});
 	}
 
+	/**
+	 * Backfill the contact aggregate with existing contacts.
+	 * Run this after upgrading to a version with aggregate support.
+	 *
+	 * This processes contacts in batches to avoid timeout issues with large datasets.
+	 * Call repeatedly with the returned cursor until isDone is true.
+	 *
+	 * Usage:
+	 * ```ts
+	 * // First call - clear existing aggregate and start backfill
+	 * let result = await loops.backfillContactAggregate(ctx, { clear: true });
+	 *
+	 * // Continue until done
+	 * while (!result.isDone) {
+	 *   result = await loops.backfillContactAggregate(ctx, { cursor: result.cursor });
+	 * }
+	 * ```
+	 */
+	async backfillContactAggregate(
+		ctx: RunMutationCtx,
+		options?: {
+			cursor?: string | null;
+			batchSize?: number;
+			clear?: boolean;
+		},
+	) {
+		return ctx.runMutation(this.lib.backfillContactAggregate, {
+			cursor: options?.cursor ?? null,
+			batchSize: options?.batchSize ?? 100,
+			clear: options?.clear,
+		});
+	}
+
 	/**
 	 * For easy re-exporting.
 	 * Apps can do
@@ -491,7 +527,7 @@ export class Loops {
 					source: v.optional(v.string()),
 					subscribed: v.optional(v.boolean()),
 					limit: v.optional(v.number()),
-					offset: v.optional(v.number()),
+					cursor: v.optional(v.union(v.string(), v.null())),
 				},
 				handler: async (ctx, args) => {
 					return await this.listContacts(ctx, args);
@@ -561,6 +597,16 @@ export class Loops {
 					return await this.checkGlobalRateLimit(ctx, args);
 				},
 			}),
+			backfillContactAggregate: mutationGeneric({
+				args: {
+					cursor: v.optional(v.union(v.string(), v.null())),
+					batchSize: v.optional(v.number()),
+					clear: v.optional(v.boolean()),
+				},
+				handler: async (ctx, args) => {
+					return await this.backfillContactAggregate(ctx, args);
+				},
+			}),
 		};
 	}
 }