agentmail-clone-v1 0.1.0

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "agentmail-clone-v1",
+  "version": "0.1.0",
+  "description": "API-first inbox SaaS for agents (V1)",
+  "type": "module",
+  "main": "src/server.js",
+  "scripts": {
+    "dev": "node --watch src/server.js",
+    "landing:dev": "npx --yes serve@14.2.4 landing -l 8080",
+    "start": "node src/server.js",
+    "migrate": "node scripts/migrate.js",
+    "lint:openapi": "npx --yes @redocly/cli@1.24.0 lint openapi/openapi.yaml",
+    "docs:validate": "node scripts/validate-docs.js",
+    "landing:validate": "node scripts/validate-landing.js",
+    "generate:sdk:ts": "./scripts/generate-sdk-ts.sh",
+    "generate:sdk:py": "./scripts/generate-sdk-py.sh",
+    "generate:sdks": "npm run generate:sdk:ts && npm run generate:sdk:py",
+    "check:sdk:drift": "git diff --exit-code"
+  },
+  "dependencies": {
+    "@fastify/cookie": "^9.4.0",
+    "@fastify/formbody": "^7.4.0",
+    "@fastify/multipart": "^8.3.1",
+    "@fastify/session": "^10.9.0",
+    "@fastify/view": "^9.1.0",
+    "dodopayments": "^2.19.0",
+    "dotenv": "^16.4.5",
+    "ejs": "^3.1.10",
+    "fastify": "^4.28.1",
+    "fastify-raw-body": "^4.3.0",
+    "fastify-plugin": "^5.0.1",
+    "pg": "^8.13.1"
+  }
+}

package/render.yaml

@@ -0,0 +1,48 @@
+services:
+  - type: web
+    name: emailagent-app
+    runtime: node
+    plan: free
+    autoDeployTrigger: commit
+    healthCheckPath: /healthz
+    buildCommand: npm ci
+    startCommand: npm start
+    envVars:
+      - key: NODE_ENV
+        value: production
+      - key: NODE_VERSION
+        value: 22
+      - key: DATABASE_URL
+        fromDatabase:
+          name: emailagent-db
+          property: connectionString
+      - key: APP_BASE_URL
+        value: https://app.emailagent.dev
+      - key: APP_SHARED_DOMAIN
+        value: emailagent.dev
+      - key: ADMIN_EMAIL
+        value: jagan.ganti@gmail.com
+      - key: SESSION_SECRET
+        generateValue: true
+      - key: API_KEY_HASH_SECRET
+        generateValue: true
+      - key: MAILGUN_API_KEY
+        sync: false
+      - key: MAILGUN_REGION
+        value: us
+      - key: MAILGUN_WEBHOOK_SIGNING_KEY
+        sync: false
+      - key: MAILGUN_ACCOUNT_DOMAIN
+        value: emailagent.dev
+      - key: DODO_PAYMENTS_API_KEY
+        sync: false
+      - key: DODO_PAYMENTS_ENVIRONMENT
+        value: live_mode
+      - key: DODO_PAYMENTS_WEBHOOK_KEY
+        sync: false
+      - key: DODO_PAYMENTS_PRODUCT_ID_PAID
+        sync: false
+
+databases:
+  - name: emailagent-db
+    plan: free

package/scripts/generate-sdk-py.sh

@@ -0,0 +1,16 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+SPEC_PATH="$ROOT_DIR/openapi/openapi.yaml"
+OUT_DIR="$ROOT_DIR/sdks/python/generated"
+CONFIG_PATH="$ROOT_DIR/sdks/python/openapitools.json"
+
+rm -rf "$OUT_DIR"
+mkdir -p "$OUT_DIR"
+
+npx --yes @openapitools/openapi-generator-cli@2.20.0 generate \
+  -g python \
+  -i "$SPEC_PATH" \
+  -o "$OUT_DIR" \
+  -c "$CONFIG_PATH"

package/scripts/generate-sdk-ts.sh

@@ -0,0 +1,16 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+SPEC_PATH="$ROOT_DIR/openapi/openapi.yaml"
+OUT_DIR="$ROOT_DIR/sdks/typescript/generated"
+CONFIG_PATH="$ROOT_DIR/sdks/typescript/openapitools.json"
+
+rm -rf "$OUT_DIR"
+mkdir -p "$OUT_DIR"
+
+npx --yes @openapitools/openapi-generator-cli@2.20.0 generate \
+  -g typescript-fetch \
+  -i "$SPEC_PATH" \
+  -o "$OUT_DIR" \
+  -c "$CONFIG_PATH"

package/scripts/migrate.js

@@ -0,0 +1,66 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import dotenv from 'dotenv';
+import pg from 'pg';
+
+dotenv.config();
+
+const { Pool } = pg;
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const migrationsDir = path.resolve(__dirname, '../sql');
+
+async function run() {
+  if (!process.env.DATABASE_URL) {
+    throw new Error('DATABASE_URL is required');
+  }
+
+  const pool = new Pool({ connectionString: process.env.DATABASE_URL });
+  const client = await pool.connect();
+
+  try {
+    await client.query('BEGIN');
+    await client.query(`
+      CREATE TABLE IF NOT EXISTS schema_migrations (
+        id BIGSERIAL PRIMARY KEY,
+        filename TEXT UNIQUE NOT NULL,
+        executed_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+      )
+    `);
+
+    const files = (await fs.readdir(migrationsDir))
+      .filter((f) => f.endsWith('.sql'))
+      .sort();
+
+    for (const filename of files) {
+      const already = await client.query(
+        'SELECT 1 FROM schema_migrations WHERE filename = $1',
+        [filename]
+      );
+
+      if (already.rowCount > 0) {
+        continue;
+      }
+
+      const sql = await fs.readFile(path.join(migrationsDir, filename), 'utf8');
+      await client.query(sql);
+      await client.query('INSERT INTO schema_migrations (filename) VALUES ($1)', [filename]);
+      console.log(`Applied ${filename}`);
+    }
+
+    await client.query('COMMIT');
+    console.log('Migrations complete');
+  } catch (err) {
+    await client.query('ROLLBACK');
+    throw err;
+  } finally {
+    client.release();
+    await pool.end();
+  }
+}
+
+run().catch((err) => {
+  console.error(err);
+  process.exit(1);
+});

package/scripts/validate-docs.js

@@ -0,0 +1,56 @@
+import fs from 'node:fs';
+import path from 'node:path';
+
+const root = process.cwd();
+const docsDir = path.join(root, 'docs');
+const docsConfigPath = path.join(docsDir, 'docs.json');
+
+if (!fs.existsSync(docsConfigPath)) {
+  console.error('Missing docs/docs.json');
+  process.exit(1);
+}
+
+const config = JSON.parse(fs.readFileSync(docsConfigPath, 'utf8'));
+const missing = [];
+
+function collectPages(node) {
+  if (!node) return [];
+  if (Array.isArray(node)) {
+    return node.flatMap(collectPages);
+  }
+  if (typeof node === 'string') {
+    return [node];
+  }
+  if (typeof node === 'object') {
+    if (Array.isArray(node.pages)) {
+      return node.pages.flatMap(collectPages);
+    }
+    return Object.values(node).flatMap(collectPages);
+  }
+  return [];
+}
+
+const pages = [...new Set(collectPages(config.navigation))];
+for (const page of pages) {
+  if (page.startsWith('http://') || page.startsWith('https://')) {
+    continue;
+  }
+  const filePath = path.join(docsDir, `${page}.mdx`);
+  if (!fs.existsSync(filePath)) {
+    missing.push(filePath);
+  }
+}
+
+if (!fs.existsSync(path.join(root, 'openapi', 'openapi.yaml'))) {
+  missing.push(path.join(root, 'openapi', 'openapi.yaml'));
+}
+
+if (missing.length > 0) {
+  console.error('Docs validation failed. Missing files:');
+  for (const item of missing) {
+    console.error(`- ${item}`);
+  }
+  process.exit(1);
+}
+
+console.log(`Docs validation passed (${pages.length} pages found).`);

package/scripts/validate-landing.js

@@ -0,0 +1,39 @@
+import fs from 'node:fs';
+import path from 'node:path';
+
+const root = process.cwd();
+const landingDir = path.join(root, 'landing');
+const requiredFiles = ['index.html', 'styles.css', 'main.js', 'privacy.html', 'terms.html', 'favicon.svg'];
+const missing = requiredFiles.filter((file) => !fs.existsSync(path.join(landingDir, file)));
+
+if (missing.length) {
+  console.error('Landing validation failed. Missing files:');
+  for (const file of missing) {
+    console.error(`- landing/${file}`);
+  }
+  process.exit(1);
+}
+
+const indexHtml = fs.readFileSync(path.join(landingDir, 'index.html'), 'utf8');
+
+const requiredMarkers = [
+  'Email infrastructure for AI agents',
+  'https://app.emailagent.dev/',
+  'https://docs.emailagent.dev',
+  'data-cta="start-free-hero"',
+  'data-cta="docs-hero"',
+  '/privacy.html',
+  '/terms.html',
+  'canonical" href="https://emailagent.dev"'
+];
+
+const missingMarkers = requiredMarkers.filter((marker) => !indexHtml.includes(marker));
+if (missingMarkers.length) {
+  console.error('Landing validation failed. Missing required content markers:');
+  for (const marker of missingMarkers) {
+    console.error(`- ${marker}`);
+  }
+  process.exit(1);
+}
+
+console.log('Landing validation passed.');

package/sdks/python/README.md

@@ -0,0 +1,40 @@
+# emailagent-sdk (Python)
+
+Official Python SDK for EmailAgent.
+
+## Install
+
+```bash
+pip install emailagent-sdk==0.1.0
+```
+
+## Usage
+
+```python
+from emailagent_sdk import EmailAgentClient
+
+client = EmailAgentClient(
+    api_key="<api_key>",
+    base_url="https://api.emailagent.dev",
+)
+
+print(client.list_inboxes())
+
+emails = client.list_emails(inbox_id="<inbox_uuid>")
+print(emails)
+
+client.update_email_read(
+    email_id="<email_uuid>",
+    is_read=True,
+    idempotency_key="mark-read-001",
+)
+```
+
+## Idempotency
+
+```python
+client.create_inbox(
+    local_part="agent-1",
+    idempotency_key="create-inbox-agent-1",
+)
+```

package/sdks/python/emailagent_sdk/__init__.py

@@ -0,0 +1,157 @@
+"""Official Python SDK for EmailAgent."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import Any
+from urllib.parse import quote
+
+import requests
+
+
+@dataclass
+class EmailAgentApiError(Exception):
+    status_code: int
+    payload: Any
+
+    def __str__(self) -> str:
+        if isinstance(self.payload, dict) and self.payload.get("error"):
+            return str(self.payload["error"])
+        return f"EmailAgent API error ({self.status_code})"
+
+
+class EmailAgentClient:
+    def __init__(self, api_key: str, base_url: str = "https://api.emailagent.dev") -> None:
+        self.base_url = base_url.rstrip("/")
+        self.session = requests.Session()
+        self.session.headers.update({"Authorization": f"Bearer {api_key}"})
+
+    def _request(
+        self,
+        method: str,
+        path: str,
+        body: dict[str, Any] | None = None,
+        idempotency_key: str | None = None,
+    ) -> Any:
+        headers: dict[str, str] = {}
+        if idempotency_key:
+            headers["Idempotency-Key"] = idempotency_key
+
+        response = self.session.request(
+            method=method,
+            url=f"{self.base_url}{path}",
+            json=body,
+            headers=headers or None,
+            timeout=30,
+        )
+
+        payload: Any
+        try:
+            payload = response.json()
+        except ValueError:
+            payload = response.text
+
+        if response.status_code >= 400:
+            raise EmailAgentApiError(response.status_code, payload)
+
+        return payload
+
+    def list_inboxes(self) -> Any:
+        return self._request("GET", "/api/v1/inboxes")
+
+    def create_inbox(
+        self,
+        local_part: str,
+        display_name: str | None = None,
+        domain_name: str | None = None,
+        idempotency_key: str | None = None,
+    ) -> Any:
+        body: dict[str, Any] = {"localPart": local_part}
+        if display_name is not None:
+            body["displayName"] = display_name
+        if domain_name is not None:
+            body["domainName"] = domain_name
+        return self._request("POST", "/api/v1/inboxes", body, idempotency_key)
+
+    def update_inbox(self, inbox_id: str, display_name: str, idempotency_key: str | None = None) -> Any:
+        return self._request(
+            "PATCH",
+            f"/api/v1/inboxes/{inbox_id}",
+            {"displayName": display_name},
+            idempotency_key,
+        )
+
+    def delete_inbox(self, inbox_id: str, idempotency_key: str | None = None) -> Any:
+        return self._request("DELETE", f"/api/v1/inboxes/{inbox_id}", None, idempotency_key)
+
+    def send_email(
+        self,
+        inbox_id: str,
+        to: str,
+        subject: str | None = None,
+        text: str | None = None,
+        idempotency_key: str | None = None,
+    ) -> Any:
+        body: dict[str, Any] = {"inboxId": inbox_id, "to": to}
+        if subject is not None:
+            body["subject"] = subject
+        if text is not None:
+            body["text"] = text
+        return self._request("POST", "/api/v1/emails/send", body, idempotency_key)
+
+    def list_emails(self, inbox_id: str | None = None) -> Any:
+        path = "/api/v1/emails"
+        if inbox_id:
+            path = f"{path}?inboxId={quote(inbox_id, safe='')}"
+        return self._request("GET", path)
+
+    def update_email_read(
+        self,
+        email_id: str,
+        is_read: bool,
+        idempotency_key: str | None = None,
+    ) -> Any:
+        return self._request(
+            "PATCH",
+            f"/api/v1/emails/{email_id}/read",
+            {"isRead": is_read},
+            idempotency_key,
+        )
+
+    def delete_email(self, email_id: str, idempotency_key: str | None = None) -> Any:
+        return self._request("DELETE", f"/api/v1/emails/{email_id}", None, idempotency_key)
+
+    def list_domains(self) -> Any:
+        return self._request("GET", "/api/v1/domains")
+
+    def create_domain(self, name: str, idempotency_key: str | None = None) -> Any:
+        return self._request("POST", "/api/v1/domains", {"name": name}, idempotency_key)
+
+    def verify_domain(self, domain_id: str, idempotency_key: str | None = None) -> Any:
+        return self._request("POST", f"/api/v1/domains/{domain_id}/verify", None, idempotency_key)
+
+    def delete_domain(self, domain_id: str, idempotency_key: str | None = None) -> Any:
+        return self._request("DELETE", f"/api/v1/domains/{domain_id}", None, idempotency_key)
+
+    def list_api_keys(self) -> Any:
+        return self._request("GET", "/api/v1/api-keys")
+
+    def create_api_key(
+        self,
+        name: str,
+        scopes: list[str] | str | None = None,
+        idempotency_key: str | None = None,
+    ) -> Any:
+        body: dict[str, Any] = {"name": name}
+        if scopes is not None:
+            body["scopes"] = scopes
+        return self._request("POST", "/api/v1/api-keys", body, idempotency_key)
+
+    def rotate_api_key(self, api_key_id: str, idempotency_key: str | None = None) -> Any:
+        return self._request("POST", f"/api/v1/api-keys/{api_key_id}/rotate", None, idempotency_key)
+
+    def revoke_api_key(self, api_key_id: str, idempotency_key: str | None = None) -> Any:
+        return self._request("POST", f"/api/v1/api-keys/{api_key_id}/revoke", None, idempotency_key)
+
+    def get_metrics(self) -> Any:
+        return self._request("GET", "/api/v1/metrics")

package/sdks/python/generated/.openapi-generator/FILES

@@ -0,0 +1,101 @@
+.openapi-generator-ignore
+emailagent_sdk_generated/__init__.py
+emailagent_sdk_generated/api/__init__.py
+emailagent_sdk_generated/api/api_keys_api.py
+emailagent_sdk_generated/api/domains_api.py
+emailagent_sdk_generated/api/emails_api.py
+emailagent_sdk_generated/api/inboxes_api.py
+emailagent_sdk_generated/api/metrics_api.py
+emailagent_sdk_generated/api_client.py
+emailagent_sdk_generated/api_response.py
+emailagent_sdk_generated/configuration.py
+emailagent_sdk_generated/docs/APIKeysApi.md
+emailagent_sdk_generated/docs/ApiKeyCreated.md
+emailagent_sdk_generated/docs/ApiKeyCreatedResponse.md
+emailagent_sdk_generated/docs/ApiKeyListItem.md
+emailagent_sdk_generated/docs/ApiKeyListResponse.md
+emailagent_sdk_generated/docs/CreateApiKeyRequest.md
+emailagent_sdk_generated/docs/CreateApiKeyRequestScopes.md
+emailagent_sdk_generated/docs/CreateDomainRequest.md
+emailagent_sdk_generated/docs/CreateInboxRequest.md
+emailagent_sdk_generated/docs/Domain.md
+emailagent_sdk_generated/docs/DomainListResponse.md
+emailagent_sdk_generated/docs/DomainResponse.md
+emailagent_sdk_generated/docs/DomainsApi.md
+emailagent_sdk_generated/docs/Email.md
+emailagent_sdk_generated/docs/EmailListResponse.md
+emailagent_sdk_generated/docs/EmailResponse.md
+emailagent_sdk_generated/docs/EmailsApi.md
+emailagent_sdk_generated/docs/ErrorResponse.md
+emailagent_sdk_generated/docs/Inbox.md
+emailagent_sdk_generated/docs/InboxListResponse.md
+emailagent_sdk_generated/docs/InboxResponse.md
+emailagent_sdk_generated/docs/InboxesApi.md
+emailagent_sdk_generated/docs/MetricsApi.md
+emailagent_sdk_generated/docs/MetricsData.md
+emailagent_sdk_generated/docs/MetricsResponse.md
+emailagent_sdk_generated/docs/OkResponse.md
+emailagent_sdk_generated/docs/PlanLimits.md
+emailagent_sdk_generated/docs/SendEmailRequest.md
+emailagent_sdk_generated/docs/UpdateEmailReadRequest.md
+emailagent_sdk_generated/docs/UpdateInboxRequest.md
+emailagent_sdk_generated/exceptions.py
+emailagent_sdk_generated/models/__init__.py
+emailagent_sdk_generated/models/api_key_created.py
+emailagent_sdk_generated/models/api_key_created_response.py
+emailagent_sdk_generated/models/api_key_list_item.py
+emailagent_sdk_generated/models/api_key_list_response.py
+emailagent_sdk_generated/models/create_api_key_request.py
+emailagent_sdk_generated/models/create_api_key_request_scopes.py
+emailagent_sdk_generated/models/create_domain_request.py
+emailagent_sdk_generated/models/create_inbox_request.py
+emailagent_sdk_generated/models/domain.py
+emailagent_sdk_generated/models/domain_list_response.py
+emailagent_sdk_generated/models/domain_response.py
+emailagent_sdk_generated/models/email.py
+emailagent_sdk_generated/models/email_list_response.py
+emailagent_sdk_generated/models/email_response.py
+emailagent_sdk_generated/models/error_response.py
+emailagent_sdk_generated/models/inbox.py
+emailagent_sdk_generated/models/inbox_list_response.py
+emailagent_sdk_generated/models/inbox_response.py
+emailagent_sdk_generated/models/metrics_data.py
+emailagent_sdk_generated/models/metrics_response.py
+emailagent_sdk_generated/models/ok_response.py
+emailagent_sdk_generated/models/plan_limits.py
+emailagent_sdk_generated/models/send_email_request.py
+emailagent_sdk_generated/models/update_email_read_request.py
+emailagent_sdk_generated/models/update_inbox_request.py
+emailagent_sdk_generated/rest.py
+emailagent_sdk_generated/test/__init__.py
+emailagent_sdk_generated/test/test_api_key_created.py
+emailagent_sdk_generated/test/test_api_key_created_response.py
+emailagent_sdk_generated/test/test_api_key_list_item.py
+emailagent_sdk_generated/test/test_api_key_list_response.py
+emailagent_sdk_generated/test/test_api_keys_api.py
+emailagent_sdk_generated/test/test_create_api_key_request.py
+emailagent_sdk_generated/test/test_create_api_key_request_scopes.py
+emailagent_sdk_generated/test/test_create_domain_request.py
+emailagent_sdk_generated/test/test_create_inbox_request.py
+emailagent_sdk_generated/test/test_domain.py
+emailagent_sdk_generated/test/test_domain_list_response.py
+emailagent_sdk_generated/test/test_domain_response.py
+emailagent_sdk_generated/test/test_domains_api.py
+emailagent_sdk_generated/test/test_email.py
+emailagent_sdk_generated/test/test_email_list_response.py
+emailagent_sdk_generated/test/test_email_response.py
+emailagent_sdk_generated/test/test_emails_api.py
+emailagent_sdk_generated/test/test_error_response.py
+emailagent_sdk_generated/test/test_inbox.py
+emailagent_sdk_generated/test/test_inbox_list_response.py
+emailagent_sdk_generated/test/test_inbox_response.py
+emailagent_sdk_generated/test/test_inboxes_api.py
+emailagent_sdk_generated/test/test_metrics_api.py
+emailagent_sdk_generated/test/test_metrics_data.py
+emailagent_sdk_generated/test/test_metrics_response.py
+emailagent_sdk_generated/test/test_ok_response.py
+emailagent_sdk_generated/test/test_plan_limits.py
+emailagent_sdk_generated/test/test_send_email_request.py
+emailagent_sdk_generated/test/test_update_email_read_request.py
+emailagent_sdk_generated/test/test_update_inbox_request.py
+emailagent_sdk_generated_README.md

package/sdks/python/generated/.openapi-generator/VERSION

@@ -0,0 +1 @@
+7.14.0

package/sdks/python/generated/.openapi-generator-ignore

@@ -0,0 +1,23 @@
+# OpenAPI Generator Ignore
+# Generated by openapi-generator https://github.com/openapitools/openapi-generator
+
+# Use this file to prevent files from being overwritten by the generator.
+# The patterns follow closely to .gitignore or .dockerignore.
+
+# As an example, the C# client generator defines ApiClient.cs.
+# You can make changes and tell OpenAPI Generator to ignore just this file by uncommenting the following line:
+#ApiClient.cs
+
+# You can match any string of characters against a directory, file or extension with a single asterisk (*):
+#foo/*/qux
+# The above matches foo/bar/qux and foo/baz/qux, but not foo/bar/baz/qux
+
+# You can recursively match patterns against a directory, file or extension with a double asterisk (**):
+#foo/**/qux
+# This matches foo/bar/qux, foo/baz/qux, and foo/bar/baz/qux
+
+# You can also negate patterns with an exclamation (!).
+# For example, you can ignore all files in a docs folder with the file extension .md:
+#docs/*.md
+# Then explicitly reverse the ignore rule for a single file:
+#!docs/README.md