@devwithbobby/loops 0.1.13 → 0.1.14

package/dist/component/helpers.d.ts

@@ -0,0 +1,7 @@
+export declare const LOOPS_API_BASE_URL = "https://app.loops.so/api/v1";
+export declare const sanitizeLoopsError: (status: number, _errorText: string) => Error;
+export type LoopsRequestInit = Omit<RequestInit, "body"> & {
+    json?: unknown;
+};
+export declare const loopsFetch: (apiKey: string, path: string, init?: LoopsRequestInit) => Promise<Response>;
+//# sourceMappingURL=helpers.d.ts.map

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

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

package/dist/component/helpers.js

@@ -0,0 +1,30 @@
+export const LOOPS_API_BASE_URL = "https://app.loops.so/api/v1";
+export const sanitizeLoopsError = (status, _errorText) => {
+    if (status === 401 || status === 403) {
+        return new Error("Authentication failed. Please check your API key.");
+    }
+    if (status === 404) {
+        return new Error("Resource not found.");
+    }
+    if (status === 429) {
+        return new Error("Rate limit exceeded. Please try again later.");
+    }
+    if (status >= 500) {
+        return new Error("Loops service error. Please try again later.");
+    }
+    return new Error(`Loops API error (${status}). Please try again.`);
+};
+export const loopsFetch = async (apiKey, path, init = {}) => {
+    const { json, ...rest } = init;
+    const headers = new Headers(rest.headers ?? {});
+    headers.set("Authorization", `Bearer ${apiKey}`);
+    if (json !== undefined && !headers.has("Content-Type")) {
+        headers.set("Content-Type", "application/json");
+    }
+    return fetch(`${LOOPS_API_BASE_URL}${path}`, {
+        ...rest,
+        headers,
+        // @ts-expect-error RequestInit in this build doesn't declare body
+        body: json !== undefined ? JSON.stringify(json) : rest.body,
+    });
+};

package/dist/component/http.d.ts

@@ -0,0 +1,3 @@
+declare const http: import("convex/server").HttpRouter;
+export default http;
+//# sourceMappingURL=http.d.ts.map

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

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

package/dist/component/http.js

@@ -0,0 +1,268 @@
+import { httpRouter } from "convex/server";
+import { internalLib, } from "../types";
+import { httpAction } from "./_generated/server";
+const http = httpRouter();
+const allowedOrigin = process.env.LOOPS_HTTP_ALLOWED_ORIGIN ?? process.env.CLIENT_ORIGIN ?? "*";
+const buildCorsHeaders = (extra) => {
+    const headers = new Headers(extra ?? {});
+    headers.set("Access-Control-Allow-Origin", allowedOrigin);
+    headers.set("Access-Control-Allow-Methods", "GET,POST,PUT,DELETE,OPTIONS");
+    headers.set("Access-Control-Allow-Headers", "Content-Type, Authorization");
+    headers.set("Access-Control-Max-Age", "86400");
+    headers.set("Vary", "Origin");
+    return headers;
+};
+const jsonResponse = (data, init) => {
+    const headers = buildCorsHeaders(init?.headers ?? undefined);
+    headers.set("Content-Type", "application/json");
+    return new Response(JSON.stringify(data), { ...init, headers });
+};
+const emptyResponse = (init) => {
+    const headers = buildCorsHeaders(init?.headers ?? undefined);
+    return new Response(null, { ...init, headers });
+};
+const readJsonBody = async (request) => {
+    try {
+        return (await request.json());
+    }
+    catch (_error) {
+        throw new Error("Invalid JSON body");
+    }
+};
+const booleanFromQuery = (value) => {
+    if (value === null) {
+        return undefined;
+    }
+    if (value === "true") {
+        return true;
+    }
+    if (value === "false") {
+        return false;
+    }
+    return undefined;
+};
+const numberFromQuery = (value, fallback) => {
+    if (!value) {
+        return fallback;
+    }
+    const parsed = Number.parseInt(value, 10);
+    return Number.isNaN(parsed) ? fallback : parsed;
+};
+const requireLoopsApiKey = () => {
+    const apiKey = process.env.LOOPS_API_KEY;
+    if (!apiKey) {
+        throw new Error("LOOPS_API_KEY environment variable must be set to use the HTTP API.");
+    }
+    return apiKey;
+};
+const respondError = (error) => {
+    console.error("[loops:http]", error);
+    const message = error instanceof Error ? error.message : "Unexpected error";
+    const status = error instanceof Error &&
+        error.message.includes("LOOPS_API_KEY environment variable")
+        ? 500
+        : 400;
+    return jsonResponse({ error: message }, { status });
+};
+http.route({
+    pathPrefix: "/loops",
+    method: "OPTIONS",
+    handler: httpAction(async (_ctx, request) => {
+        const headers = buildCorsHeaders();
+        const requestedHeaders = request.headers.get("Access-Control-Request-Headers");
+        if (requestedHeaders) {
+            headers.set("Access-Control-Allow-Headers", requestedHeaders);
+        }
+        const requestedMethod = request.headers.get("Access-Control-Request-Method");
+        if (requestedMethod) {
+            headers.set("Access-Control-Allow-Methods", `${requestedMethod},OPTIONS`);
+        }
+        return new Response(null, { status: 204, headers });
+    }),
+});
+http.route({
+    path: "/loops/contacts",
+    method: "POST",
+    handler: httpAction(async (ctx, request) => {
+        try {
+            const contact = await readJsonBody(request);
+            const data = await ctx.runAction(internalLib.addContact, {
+                apiKey: requireLoopsApiKey(),
+                contact,
+            });
+            return jsonResponse(data, { status: 201 });
+        }
+        catch (error) {
+            return respondError(error);
+        }
+    }),
+});
+http.route({
+    path: "/loops/contacts",
+    method: "PUT",
+    handler: httpAction(async (ctx, request) => {
+        try {
+            const payload = await readJsonBody(request);
+            if (!payload.email) {
+                throw new Error("email is required");
+            }
+            const data = await ctx.runAction(internalLib.updateContact, {
+                apiKey: requireLoopsApiKey(),
+                email: payload.email,
+                dataVariables: payload.dataVariables,
+                firstName: payload.firstName,
+                lastName: payload.lastName,
+                userId: payload.userId,
+                source: payload.source,
+                subscribed: payload.subscribed,
+                userGroup: payload.userGroup,
+            });
+            return jsonResponse(data);
+        }
+        catch (error) {
+            return respondError(error);
+        }
+    }),
+});
+http.route({
+    path: "/loops/contacts",
+    method: "GET",
+    handler: httpAction(async (ctx, request) => {
+        try {
+            const url = new URL(request.url);
+            const email = url.searchParams.get("email");
+            if (email) {
+                const data = await ctx.runAction(internalLib.findContact, {
+                    apiKey: requireLoopsApiKey(),
+                    email,
+                });
+                return jsonResponse(data);
+            }
+            const data = await ctx.runQuery(internalLib.listContacts, {
+                userGroup: url.searchParams.get("userGroup") ?? undefined,
+                source: url.searchParams.get("source") ?? undefined,
+                subscribed: booleanFromQuery(url.searchParams.get("subscribed")),
+                limit: numberFromQuery(url.searchParams.get("limit"), 100),
+                offset: numberFromQuery(url.searchParams.get("offset"), 0),
+            });
+            return jsonResponse(data);
+        }
+        catch (error) {
+            return respondError(error);
+        }
+    }),
+});
+http.route({
+    path: "/loops/contacts",
+    method: "DELETE",
+    handler: httpAction(async (ctx, request) => {
+        try {
+            const payload = await readJsonBody(request);
+            if (!payload.email) {
+                throw new Error("email is required");
+            }
+            await ctx.runAction(internalLib.deleteContact, {
+                apiKey: requireLoopsApiKey(),
+                email: payload.email,
+            });
+            return emptyResponse({ status: 204 });
+        }
+        catch (error) {
+            return respondError(error);
+        }
+    }),
+});
+http.route({
+    path: "/loops/transactional",
+    method: "POST",
+    handler: httpAction(async (ctx, request) => {
+        try {
+            const payload = await readJsonBody(request);
+            if (!payload.transactionalId) {
+                throw new Error("transactionalId is required");
+            }
+            if (!payload.email) {
+                throw new Error("email is required");
+            }
+            const data = await ctx.runAction(internalLib.sendTransactional, {
+                apiKey: requireLoopsApiKey(),
+                transactionalId: payload.transactionalId,
+                email: payload.email,
+                dataVariables: payload.dataVariables,
+            });
+            return jsonResponse(data);
+        }
+        catch (error) {
+            return respondError(error);
+        }
+    }),
+});
+http.route({
+    path: "/loops/events",
+    method: "POST",
+    handler: httpAction(async (ctx, request) => {
+        try {
+            const payload = await readJsonBody(request);
+            if (!payload.email) {
+                throw new Error("email is required");
+            }
+            if (!payload.eventName) {
+                throw new Error("eventName is required");
+            }
+            const data = await ctx.runAction(internalLib.sendEvent, {
+                apiKey: requireLoopsApiKey(),
+                email: payload.email,
+                eventName: payload.eventName,
+                eventProperties: payload.eventProperties,
+            });
+            return jsonResponse(data);
+        }
+        catch (error) {
+            return respondError(error);
+        }
+    }),
+});
+http.route({
+    path: "/loops/trigger",
+    method: "POST",
+    handler: httpAction(async (ctx, request) => {
+        try {
+            const payload = await readJsonBody(request);
+            if (!payload.loopId) {
+                throw new Error("loopId is required");
+            }
+            if (!payload.email) {
+                throw new Error("email is required");
+            }
+            const data = await ctx.runAction(internalLib.triggerLoop, {
+                apiKey: requireLoopsApiKey(),
+                loopId: payload.loopId,
+                email: payload.email,
+                dataVariables: payload.dataVariables,
+                eventName: payload.eventName,
+            });
+            return jsonResponse(data);
+        }
+        catch (error) {
+            return respondError(error);
+        }
+    }),
+});
+http.route({
+    path: "/loops/stats",
+    method: "GET",
+    handler: httpAction(async (ctx, request) => {
+        try {
+            const url = new URL(request.url);
+            const timeWindowMs = numberFromQuery(url.searchParams.get("timeWindowMs"), 86400000);
+            const data = await ctx.runQuery(internalLib.getEmailStats, {
+                timeWindowMs,
+            });
+            return jsonResponse(data);
+        }
+        catch (error) {
+            return respondError(error);
+        }
+    }),
+});
+export default http;

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

@@ -1 +1 @@
-{"version":3,"file":"lib.d.ts","sourceRoot":"","sources":["../../src/component/lib.ts"],"names":[],"mappings":"AA2BA;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;iBA6CvB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,aAAa;;iBAexB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;iBAiC5B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,aAAa;;;;mBAwCxB,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;GAmFvB,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;GA4HrB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;GAoDxB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;GAqD5B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,SAAS;;;;;;;GAgCpB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;GA8BxB,CAAC;AAEH;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,WAAW;;;;;;;;;GA4DtB,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;GAgEtB,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;GAiE9B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;GA+B7B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;GA+B7B,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;;;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"}