zerodrop-client 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,36 @@
+export interface ZeroDropEmail {
+    id: string;
+    from: string;
+    to: string;
+    subject: string;
+    body: string;
+    rawBody: string;
+    receivedAt: Date;
+}
+export interface WaitForLatestOptions {
+    timeout?: number;
+    pollInterval?: number;
+}
+export interface ZeroDropOptions {
+    baseUrl?: string;
+}
+export declare class ZeroDropTimeoutError extends Error {
+    constructor(inbox: string, timeoutMs: number);
+}
+export declare class ZeroDropAuthError extends Error {
+    constructor();
+}
+export declare class ZeroDrop {
+    private apiKey;
+    private baseUrl;
+    constructor(apiKey?: string, options?: ZeroDropOptions);
+    generateInbox(): string;
+    fetchLatest(inbox: string): Promise<ZeroDropEmail | null>;
+    waitForLatest(inbox: string, options?: WaitForLatestOptions): Promise<ZeroDropEmail>;
+    onReceived(inbox: string, webhookUrl: string): Promise<{
+        registered: boolean;
+    }>;
+    private sleep;
+}
+export default ZeroDrop;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAMD,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAO7C;AAED,qBAAa,iBAAkB,SAAQ,KAAK;;CAK3C;AAuCD,qBAAa,QAAQ;IACnB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB;IAmB1D,aAAa,IAAI,MAAM;IAYjB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAoDzD,aAAa,CACjB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,aAAa,CAAC;IAoBnB,UAAU,CACd,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC;QAAE,UAAU,EAAE,OAAO,CAAA;KAAE,CAAC;IA2BnC,OAAO,CAAC,KAAK;CAGd;AAMD,eAAe,QAAQ,CAAC"}

package/dist/index.js

@@ -0,0 +1,168 @@
+"use strict";
+// ============================================
+// @zerodrop/client
+// Instant temporary email inboxes for CI/CD
+// ============================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZeroDrop = exports.ZeroDropAuthError = exports.ZeroDropTimeoutError = void 0;
+const BASE_URL = "https://zerodrop.dev";
+const FREE_DOMAIN = "zerodrop-sandbox.online";
+const POLL_INTERVAL = 2000;
+// ============================================
+// Custom Errors
+// ============================================
+class ZeroDropTimeoutError extends Error {
+    constructor(inbox, timeoutMs) {
+        super(`ZeroDrop: No email received at "${inbox}" within ${timeoutMs}ms. ` +
+            `Check that your app is sending to the correct address.`);
+        this.name = "ZeroDropTimeoutError";
+    }
+}
+exports.ZeroDropTimeoutError = ZeroDropTimeoutError;
+class ZeroDropAuthError extends Error {
+    constructor() {
+        super("ZeroDrop: Invalid or missing API key.");
+        this.name = "ZeroDropAuthError";
+    }
+}
+exports.ZeroDropAuthError = ZeroDropAuthError;
+// ============================================
+// Email body extractor
+// ============================================
+function extractBody(raw) {
+    if (!raw)
+        return "";
+    const plainMatch = raw.match(/Content-Type: text\/plain[^\r\n]*\r\n\r\n([\s\S]*?)(?:\r\n--|\r\n\r\n--)/);
+    if (plainMatch)
+        return plainMatch[1].trim();
+    const lines = raw.split("\r\n");
+    const bodyStart = lines.findIndex((l) => l === "");
+    return lines
+        .slice(bodyStart + 1)
+        .join("\n")
+        .trim()
+        .substring(0, 5000);
+}
+// ============================================
+// Random inbox generator (zero-auth)
+// ============================================
+function generateRandomInboxName() {
+    const adjectives = [
+        "swift", "dark", "cold", "null", "void",
+        "zero", "dead", "raw", "base", "core"
+    ];
+    const adj = adjectives[Math.floor(Math.random() * adjectives.length)];
+    const id = Math.random().toString(36).substring(2, 9);
+    return `${adj}-${id}`;
+}
+// ============================================
+// Main ZeroDrop Client
+// ============================================
+class ZeroDrop {
+    constructor(apiKey, options = {}) {
+        this.apiKey = apiKey || null;
+        this.baseUrl = options.baseUrl || BASE_URL;
+        if (!apiKey) {
+            console.warn("[ZeroDrop] No API key provided. Running in public sandbox mode.\n" +
+                "[ZeroDrop] Emails are AI-filtered and inboxes expire in 30 minutes.\n" +
+                "[ZeroDrop] For CI pipelines, upgrade to a Workspace: https://zerodrop.dev");
+        }
+    }
+    // ============================================
+    // generateInbox()
+    // Returns a ready-to-use email address instantly
+    // No network request needed
+    // ============================================
+    generateInbox() {
+        const name = generateRandomInboxName();
+        const domain = FREE_DOMAIN;
+        return `${name}@${domain}`;
+    }
+    // ============================================
+    // fetchLatest()
+    // Fetches current emails for an inbox
+    // Returns null if empty
+    // ============================================
+    async fetchLatest(inbox) {
+        const inboxName = inbox.split("@")[0].toLowerCase();
+        const headers = {
+            "Content-Type": "application/json",
+        };
+        if (this.apiKey) {
+            headers["Authorization"] = `Bearer ${this.apiKey}`;
+        }
+        const res = await fetch(`${this.baseUrl}/api/inbox/${inboxName}`, { headers });
+        if (res.status === 401)
+            throw new ZeroDropAuthError();
+        if (!res.ok) {
+            throw new Error(`ZeroDrop: API error ${res.status}`);
+        }
+        const data = await res.json();
+        if (!data.emails || data.emails.length === 0)
+            return null;
+        const latest = data.emails[0];
+        return {
+            id: latest.id,
+            from: latest.from,
+            to: latest.to,
+            subject: latest.subject || "",
+            body: extractBody(latest.raw),
+            rawBody: latest.raw,
+            receivedAt: new Date(latest.receivedAt),
+        };
+    }
+    // ============================================
+    // waitForLatest()
+    // Polls until an email arrives or timeout
+    // Throws ZeroDropTimeoutError on timeout
+    // ============================================
+    async waitForLatest(inbox, options = {}) {
+        var _a, _b;
+        const timeout = (_a = options.timeout) !== null && _a !== void 0 ? _a : 10000;
+        const pollInterval = (_b = options.pollInterval) !== null && _b !== void 0 ? _b : POLL_INTERVAL;
+        const startTime = Date.now();
+        while (Date.now() - startTime < timeout) {
+            const email = await this.fetchLatest(inbox);
+            if (email)
+                return email;
+            await this.sleep(pollInterval);
+        }
+        throw new ZeroDropTimeoutError(inbox, timeout);
+    }
+    // ============================================
+    // onReceived()
+    // Registers a webhook for a workspace inbox
+    // Requires API key
+    // ============================================
+    async onReceived(inbox, webhookUrl) {
+        if (!this.apiKey) {
+            throw new ZeroDropAuthError();
+        }
+        const res = await fetch(`${this.baseUrl}/api/webhooks/register`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "Authorization": `Bearer ${this.apiKey}`,
+            },
+            body: JSON.stringify({ inbox, webhookUrl }),
+        });
+        if (res.status === 401)
+            throw new ZeroDropAuthError();
+        if (!res.ok) {
+            throw new Error(`ZeroDrop: Failed to register webhook ${res.status}`);
+        }
+        return { registered: true };
+    }
+    // ============================================
+    // Private helpers
+    // ============================================
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+exports.ZeroDrop = ZeroDrop;
+// ============================================
+// Default export for convenience
+// ============================================
+exports.default = ZeroDrop;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "zerodrop-client",
+  "version": "0.1.0",
+  "description": "Instant temporary email inboxes for CI pipelines and QA testing",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  },
+  "keywords": ["email", "testing", "ci", "playwright", "cypress", "qa", "temporary-email", "sandbox"],
+  "author": "ZeroDrop",
+  "license": "MIT",
+  "devDependencies": {
+    "typescript": "^6.0.3"
+  }
+}