@rawdash/connector-mailgun 0.28.0

package/README.md

@@ -0,0 +1,126 @@
+<!-- This file is generated from connector metadata by scripts/generate-connector-docs.ts. Do not edit by hand. -->
+
+# @rawdash/connector-mailgun
+
+[![npm version](https://img.shields.io/npm/v/@rawdash/connector-mailgun)](https://www.npmjs.com/package/@rawdash/connector-mailgun)
+[![license](https://img.shields.io/npm/l/@rawdash/connector-mailgun)](https://github.com/rawdash/rawdash/blob/main/LICENSE)
+
+Sync transactional email volume, delivery, bounce, and complaint metrics plus recent delivery events from Mailgun.
+
+## Install
+
+```sh
+npm install @rawdash/connector-mailgun
+```
+
+## Authentication
+
+A Mailgun API key with read access to analytics, sent via HTTP basic auth (username `api`, password is the key).
+
+1. In the Mailgun dashboard open Settings -> API Keys and create or copy an API key with analytics read access.
+2. Note which region hosts your domain (US or EU); set the connector `region` accordingly.
+3. Store the key as a secret and reference it from the connector config as `apiKey: secret("MAILGUN_API_KEY")`, and set `domain` to the sending domain you want to report on.
+
+## Configuration
+
+| Field          | Type         | Required | Description                                                                                                      |
+| -------------- | ------------ | -------- | ---------------------------------------------------------------------------------------------------------------- |
+| `apiKey`       | secret       | Yes      | A Mailgun API key with read access to analytics. Create one in the Mailgun dashboard under Settings -> API Keys. |
+| `domain`       | string       | Yes      | The Mailgun sending domain to report on (e.g. mg.example.com). Metrics and logs are filtered to this domain.     |
+| `region`       | `us` \| `eu` | No       | Which Mailgun region hosts the domain. 'us' uses api.mailgun.net; 'eu' uses api.eu.mailgun.net.                  |
+| `lookbackDays` | number       | No       | How many calendar days of stats/events to fetch on a full sync. Defaults to 90.                                  |
+| `resources`    | array        | No       | Which Mailgun resources to sync. Omit to sync all of them.                                                       |
+
+## Resources
+
+- **`mailgun_email_stats`** _(metric)_ - Daily transactional email volume and engagement for the configured domain. The canonical value is `accepted` (messages accepted for sending); delivery, failure, and engagement counts are carried as measures.
+  - Endpoint: `POST /v1/analytics/metrics`
+  - Unit: emails
+  - Granularity: day
+  - Dimensions: `date`, `domain`
+  - Measures: `delivered`, `failed`, `opened`, `clicked`, `unsubscribed`, `complained`
+- **`mailgun_event`** _(event)_ - Recent per-message delivery events (accepted, delivered, failed, opened, clicked, unsubscribed, complained) for the configured domain. Deduplicated by Mailgun event id.
+  - Endpoint: `POST /v1/analytics/logs`
+  - A bounded sample of the most recent logs is stored; Mailgun retains log data for a limited period.
+  - `eventId`: Mailgun event id (stable per event).
+  - `eventType`: Event type (accepted, delivered, failed, opened, clicked, unsubscribed, complained).
+  - `recipient`: Recipient email address.
+  - `domain`: The Mailgun sending domain.
+  - `severity`: Failure severity, when present.
+  - `reason`: Failure reason, when present.
+
+## Example
+
+```ts
+import {
+  defineConfig,
+  defineDashboard,
+  defineMetric,
+  secret,
+} from '@rawdash/core';
+
+const mailgun = {
+  name: 'mailgun',
+  connectorId: 'mailgun',
+  config: {
+    apiKey: secret('MAILGUN_API_KEY'),
+    domain: 'mg.example.com',
+    region: 'us' as const,
+    lookbackDays: 90,
+  },
+};
+
+export default defineConfig({
+  connectors: [mailgun],
+  dashboards: {
+    email: defineDashboard({
+      widgets: {
+        sends_30d: {
+          kind: 'stat',
+          title: 'Emails sent (30d)',
+          window: '30d',
+          metric: defineMetric({
+            connector: mailgun,
+            shape: 'metric',
+            name: 'mailgun_email_stats',
+            field: 'value',
+            fn: 'sum',
+          }),
+        },
+        daily_sends: {
+          kind: 'timeseries',
+          title: 'Daily email volume',
+          window: '30d',
+          metric: defineMetric({
+            connector: mailgun,
+            shape: 'metric',
+            name: 'mailgun_email_stats',
+            field: 'value',
+            fn: 'sum',
+          }),
+        },
+      },
+    }),
+  },
+});
+```
+
+## Rate limits
+
+Mailgun applies per-endpoint rate limits and returns 429 with a Retry-After header when exceeded; the shared HTTP client backs off and retries automatically.
+
+## Limitations
+
+- Metrics are reported at daily resolution; the connector requests `resolution=day` from the analytics API.
+- Incremental syncs re-fetch a fixed trailing window and replace only that window, so older samples are preserved.
+- The events resource stores a bounded sample of the most recent delivery logs (Mailgun retains log data for a limited period), not a complete event archive.
+
+## Links
+
+- [Rawdash docs](https://rawdash.dev/docs/connectors)
+- [Mailgun API docs](https://documentation.mailgun.com/docs/mailgun/api-reference/)
+- [GitHub](https://github.com/rawdash/rawdash)
+
+## License
+
+Apache-2.0

package/dist/index.d.ts

@@ -0,0 +1,340 @@
+import { BaseConnector, ConnectorContext, SyncOptions, StorageHandle, SyncResult, ConnectorDoc, Event, MetricSample } from '@rawdash/core';
+import { z } from 'zod';
+
+declare const configFields: z.ZodObject<{
+    apiKey: z.ZodObject<{
+        $secret: z.ZodString;
+    }, z.core.$strip>;
+    domain: z.ZodString;
+    region: z.ZodDefault<z.ZodEnum<{
+        us: "us";
+        eu: "eu";
+    }>>;
+    lookbackDays: z.ZodOptional<z.ZodNumber>;
+    resources: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        events: "events";
+        email_stats: "email_stats";
+    }>>>;
+}, z.core.$strip>;
+declare const doc: ConnectorDoc;
+interface MailgunSettings {
+    domain: string;
+    region: 'us' | 'eu';
+    lookbackDays?: number;
+    resources?: readonly MailgunResource[];
+}
+declare const mailgunCredentials: {
+    apiKey: {
+        description: string;
+        auth: "required";
+    };
+};
+type MailgunCredentials = typeof mailgunCredentials;
+declare const PHASE_ORDER: readonly ["email_stats", "events"];
+type MailgunPhase = (typeof PHASE_ORDER)[number];
+type MailgunResource = MailgunPhase;
+declare const metricsItemSchema: z.ZodObject<{
+    dimensions: z.ZodArray<z.ZodObject<{
+        dimension: z.ZodString;
+        value: z.ZodString;
+        display_value: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>;
+    metrics: z.ZodObject<{
+        accepted_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        delivered_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        failed_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        opened_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        clicked_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        unsubscribed_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        complained_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+declare const logsItemSchema: z.ZodObject<{
+    id: z.ZodString;
+    event: z.ZodString;
+    '@timestamp': z.ZodString;
+    recipient: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    'recipient-domain': z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    severity: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    reason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+declare const mailgunResources: {
+    readonly mailgun_email_stats: {
+        readonly shape: "metric";
+        readonly description: "Daily transactional email volume and engagement for the configured domain. The canonical value is `accepted` (messages accepted for sending); delivery, failure, and engagement counts are carried as measures.";
+        readonly endpoint: "POST /v1/analytics/metrics";
+        readonly unit: "emails";
+        readonly granularity: "day";
+        readonly dimensions: [{
+            readonly name: "date";
+            readonly description: "Calendar day of the metric sample (UTC).";
+        }, {
+            readonly name: "domain";
+            readonly description: "The Mailgun sending domain.";
+        }];
+        readonly measures: [{
+            readonly name: "delivered";
+            readonly description: "Messages delivered on the day.";
+        }, {
+            readonly name: "failed";
+            readonly description: "Messages that failed (bounced/dropped).";
+        }, {
+            readonly name: "opened";
+            readonly description: "Message opens recorded on the day.";
+        }, {
+            readonly name: "clicked";
+            readonly description: "Link clicks recorded on the day.";
+        }, {
+            readonly name: "unsubscribed";
+            readonly description: "Unsubscribes recorded on the day.";
+        }, {
+            readonly name: "complained";
+            readonly description: "Spam complaints recorded on the day.";
+        }];
+        readonly responses: {
+            readonly email_stats: z.ZodObject<{
+                items: z.ZodArray<z.ZodObject<{
+                    dimensions: z.ZodArray<z.ZodObject<{
+                        dimension: z.ZodString;
+                        value: z.ZodString;
+                        display_value: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    }, z.core.$strip>>;
+                    metrics: z.ZodObject<{
+                        accepted_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                        delivered_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                        failed_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                        opened_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                        clicked_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                        unsubscribed_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                        complained_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                    }, z.core.$strip>;
+                }, z.core.$strip>>;
+                pagination: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                    skip: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                    limit: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                    total: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                }, z.core.$strip>>>;
+            }, z.core.$strip>;
+        };
+    };
+    readonly mailgun_event: {
+        readonly shape: "event";
+        readonly description: "Recent per-message delivery events (accepted, delivered, failed, opened, clicked, unsubscribed, complained) for the configured domain. Deduplicated by Mailgun event id.";
+        readonly endpoint: "POST /v1/analytics/logs";
+        readonly notes: "A bounded sample of the most recent logs is stored; Mailgun retains log data for a limited period.";
+        readonly fields: [{
+            readonly name: "eventId";
+            readonly description: "Mailgun event id (stable per event).";
+        }, {
+            readonly name: "eventType";
+            readonly description: "Event type (accepted, delivered, failed, opened, clicked, unsubscribed, complained).";
+        }, {
+            readonly name: "recipient";
+            readonly description: "Recipient email address.";
+        }, {
+            readonly name: "domain";
+            readonly description: "The Mailgun sending domain.";
+        }, {
+            readonly name: "severity";
+            readonly description: "Failure severity, when present.";
+        }, {
+            readonly name: "reason";
+            readonly description: "Failure reason, when present.";
+        }];
+        readonly filterable: [];
+        readonly responses: {
+            readonly events: z.ZodObject<{
+                items: z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    event: z.ZodString;
+                    '@timestamp': z.ZodString;
+                    recipient: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    'recipient-domain': z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    severity: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    reason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                }, z.core.$strip>>;
+                pagination: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                    next: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    previous: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    total: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                }, z.core.$strip>>>;
+            }, z.core.$strip>;
+        };
+    };
+};
+type MailgunMetricsItem = z.infer<typeof metricsItemSchema>;
+type MailgunLogsItem = z.infer<typeof logsItemSchema>;
+interface MailgunWindow {
+    startMs: number;
+    endMs: number;
+}
+declare function getWindow(options: SyncOptions, lookbackDays: number, now?: number): MailgunWindow;
+declare function metricsItemToSample(item: MailgunMetricsItem, domain: string): MetricSample;
+declare function logsItemToEvent(item: MailgunLogsItem, domain: string): Event;
+declare const id = "mailgun";
+declare class MailgunConnector extends BaseConnector<MailgunSettings, MailgunCredentials> {
+    static readonly id = "mailgun";
+    static readonly resources: {
+        readonly mailgun_email_stats: {
+            readonly shape: "metric";
+            readonly description: "Daily transactional email volume and engagement for the configured domain. The canonical value is `accepted` (messages accepted for sending); delivery, failure, and engagement counts are carried as measures.";
+            readonly endpoint: "POST /v1/analytics/metrics";
+            readonly unit: "emails";
+            readonly granularity: "day";
+            readonly dimensions: [{
+                readonly name: "date";
+                readonly description: "Calendar day of the metric sample (UTC).";
+            }, {
+                readonly name: "domain";
+                readonly description: "The Mailgun sending domain.";
+            }];
+            readonly measures: [{
+                readonly name: "delivered";
+                readonly description: "Messages delivered on the day.";
+            }, {
+                readonly name: "failed";
+                readonly description: "Messages that failed (bounced/dropped).";
+            }, {
+                readonly name: "opened";
+                readonly description: "Message opens recorded on the day.";
+            }, {
+                readonly name: "clicked";
+                readonly description: "Link clicks recorded on the day.";
+            }, {
+                readonly name: "unsubscribed";
+                readonly description: "Unsubscribes recorded on the day.";
+            }, {
+                readonly name: "complained";
+                readonly description: "Spam complaints recorded on the day.";
+            }];
+            readonly responses: {
+                readonly email_stats: z.ZodObject<{
+                    items: z.ZodArray<z.ZodObject<{
+                        dimensions: z.ZodArray<z.ZodObject<{
+                            dimension: z.ZodString;
+                            value: z.ZodString;
+                            display_value: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        }, z.core.$strip>>;
+                        metrics: z.ZodObject<{
+                            accepted_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                            delivered_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                            failed_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                            opened_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                            clicked_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                            unsubscribed_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                            complained_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                        }, z.core.$strip>;
+                    }, z.core.$strip>>;
+                    pagination: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                        skip: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                        limit: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                        total: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                    }, z.core.$strip>>>;
+                }, z.core.$strip>;
+            };
+        };
+        readonly mailgun_event: {
+            readonly shape: "event";
+            readonly description: "Recent per-message delivery events (accepted, delivered, failed, opened, clicked, unsubscribed, complained) for the configured domain. Deduplicated by Mailgun event id.";
+            readonly endpoint: "POST /v1/analytics/logs";
+            readonly notes: "A bounded sample of the most recent logs is stored; Mailgun retains log data for a limited period.";
+            readonly fields: [{
+                readonly name: "eventId";
+                readonly description: "Mailgun event id (stable per event).";
+            }, {
+                readonly name: "eventType";
+                readonly description: "Event type (accepted, delivered, failed, opened, clicked, unsubscribed, complained).";
+            }, {
+                readonly name: "recipient";
+                readonly description: "Recipient email address.";
+            }, {
+                readonly name: "domain";
+                readonly description: "The Mailgun sending domain.";
+            }, {
+                readonly name: "severity";
+                readonly description: "Failure severity, when present.";
+            }, {
+                readonly name: "reason";
+                readonly description: "Failure reason, when present.";
+            }];
+            readonly filterable: [];
+            readonly responses: {
+                readonly events: z.ZodObject<{
+                    items: z.ZodArray<z.ZodObject<{
+                        id: z.ZodString;
+                        event: z.ZodString;
+                        '@timestamp': z.ZodString;
+                        recipient: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        'recipient-domain': z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        severity: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        reason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    }, z.core.$strip>>;
+                    pagination: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                        next: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        previous: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        total: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                    }, z.core.$strip>>>;
+                }, z.core.$strip>;
+            };
+        };
+    };
+    static readonly schemas: {
+        readonly email_stats: z.ZodObject<{
+            items: z.ZodArray<z.ZodObject<{
+                dimensions: z.ZodArray<z.ZodObject<{
+                    dimension: z.ZodString;
+                    value: z.ZodString;
+                    display_value: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                }, z.core.$strip>>;
+                metrics: z.ZodObject<{
+                    accepted_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                    delivered_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                    failed_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                    opened_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                    clicked_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                    unsubscribed_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                    complained_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                }, z.core.$strip>;
+            }, z.core.$strip>>;
+            pagination: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                skip: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                limit: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                total: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>;
+    } & {
+        readonly events: z.ZodObject<{
+            items: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                event: z.ZodString;
+                '@timestamp': z.ZodString;
+                recipient: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                'recipient-domain': z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                severity: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                reason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            }, z.core.$strip>>;
+            pagination: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                next: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                previous: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                total: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>;
+    } & Readonly<Record<string, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
+    static create(input: unknown, ctx?: ConnectorContext): MailgunConnector;
+    readonly id = "mailgun";
+    readonly credentials: {
+        apiKey: {
+            description: string;
+            auth: "required";
+        };
+    };
+    private baseUrl;
+    private buildHeaders;
+    private domainFilter;
+    private fetchMetricItems;
+    private fetchLogItems;
+    private writePhase;
+    sync(options: SyncOptions, storage: StorageHandle, signal?: AbortSignal): Promise<SyncResult>;
+}
+
+export { MailgunConnector, type MailgunLogsItem, type MailgunMetricsItem, type MailgunResource, type MailgunSettings, type MailgunWindow, configFields, MailgunConnector as default, doc, getWindow, id, logsItemToEvent, metricsItemToSample, mailgunResources as resources };

package/dist/index.js

@@ -0,0 +1,476 @@
+// ../../connector-shared/dist/index.js
+var HTTP_CLIENT_VERSION = "0.0.0";
+var DEFAULT_USER_AGENT = `rawdash-connector/${HTTP_CLIENT_VERSION} (+https://rawdash.dev)`;
+function connectorUserAgent(connectorId) {
+  return `rawdash-connector-${connectorId}/${HTTP_CLIENT_VERSION} (+https://rawdash.dev)`;
+}
+function parseEpoch(value, unit) {
+  if (value === null || value === void 0) {
+    return null;
+  }
+  if (unit === "iso") {
+    if (typeof value !== "string") {
+      return null;
+    }
+    const ms = new Date(value).getTime();
+    return Number.isFinite(ms) ? ms : null;
+  }
+  if (typeof value === "string" && value.trim() === "") {
+    return null;
+  }
+  const n = typeof value === "number" ? value : Number(value);
+  if (!Number.isFinite(n)) {
+    return null;
+  }
+  const result = unit === "s" ? n * 1e3 : n;
+  return Number.isFinite(result) ? result : null;
+}
+
+// src/mailgun.ts
+import {
+  BaseConnector,
+  defineConfigFields,
+  defineConnectorDoc,
+  defineResources,
+  makeChunkedCursorGuard,
+  metricSample,
+  paginateChunked,
+  schemasFromResources,
+  selectActivePhases
+} from "@rawdash/core";
+import { z } from "zod";
+var configFields = defineConfigFields(
+  z.object({
+    apiKey: z.object({ $secret: z.string() }).meta({
+      label: "API key",
+      description: "A Mailgun API key with read access to analytics. Create one in the Mailgun dashboard under Settings -> API Keys.",
+      placeholder: "key-...",
+      secret: true
+    }),
+    domain: z.string().trim().min(1, "A sending domain is required").meta({
+      label: "Sending domain",
+      description: "The Mailgun sending domain to report on (e.g. mg.example.com). Metrics and logs are filtered to this domain.",
+      placeholder: "mg.example.com"
+    }),
+    region: z.enum(["us", "eu"]).default("us").meta({
+      label: "Region",
+      description: "Which Mailgun region hosts the domain. 'us' uses api.mailgun.net; 'eu' uses api.eu.mailgun.net.",
+      placeholder: "us"
+    }),
+    lookbackDays: z.number().int().positive().optional().meta({
+      label: "Lookback days (full sync)",
+      description: "How many calendar days of stats/events to fetch on a full sync. Defaults to 90.",
+      placeholder: "90"
+    }),
+    resources: z.array(z.enum(["email_stats", "events"])).nonempty().optional().meta({
+      label: "Resources",
+      description: "Which Mailgun resources to sync. Omit to sync all of them."
+    })
+  })
+);
+var doc = defineConnectorDoc({
+  displayName: "Mailgun",
+  category: "engineering",
+  brandColor: "#F06B66",
+  tagline: "Sync transactional email volume, delivery, bounce, and complaint metrics plus recent delivery events from Mailgun.",
+  vendor: {
+    name: "Mailgun",
+    domain: "mailgun.com",
+    apiDocs: "https://documentation.mailgun.com/docs/mailgun/api-reference/",
+    website: "https://www.mailgun.com"
+  },
+  auth: {
+    summary: "A Mailgun API key with read access to analytics, sent via HTTP basic auth (username `api`, password is the key).",
+    setup: [
+      "In the Mailgun dashboard open Settings -> API Keys and create or copy an API key with analytics read access.",
+      "Note which region hosts your domain (US or EU); set the connector `region` accordingly.",
+      'Store the key as a secret and reference it from the connector config as `apiKey: secret("MAILGUN_API_KEY")`, and set `domain` to the sending domain you want to report on.'
+    ]
+  },
+  rateLimit: "Mailgun applies per-endpoint rate limits and returns 429 with a Retry-After header when exceeded; the shared HTTP client backs off and retries automatically.",
+  limitations: [
+    "Metrics are reported at daily resolution; the connector requests `resolution=day` from the analytics API.",
+    "Incremental syncs re-fetch a fixed trailing window and replace only that window, so older samples are preserved.",
+    "The events resource stores a bounded sample of the most recent delivery logs (Mailgun retains log data for a limited period), not a complete event archive."
+  ]
+});
+var mailgunCredentials = {
+  apiKey: {
+    description: "Mailgun API key",
+    auth: "required"
+  }
+};
+var PHASE_ORDER = ["email_stats", "events"];
+var isMailgunSyncCursor = makeChunkedCursorGuard(PHASE_ORDER);
+var MS_PER_DAY = 24 * 60 * 60 * 1e3;
+var DEFAULT_LOOKBACK_DAYS = 90;
+var INCREMENTAL_LOOKBACK_DAYS = 7;
+var METRICS_PAGE_LIMIT = 1e3;
+var EVENTS_PAGE_LIMIT = 300;
+var MAX_EVENT_PAGES = 20;
+var EMAIL_STATS_METRIC = "mailgun_email_stats";
+var MAILGUN_EVENT = "mailgun_event";
+var METRIC_FIELDS = [
+  "accepted_count",
+  "delivered_count",
+  "failed_count",
+  "opened_count",
+  "clicked_count",
+  "unsubscribed_count",
+  "complained_count"
+];
+var EVENT_TYPES = [
+  "accepted",
+  "delivered",
+  "failed",
+  "opened",
+  "clicked",
+  "unsubscribed",
+  "complained"
+];
+var metricsDimensionSchema = z.object({
+  dimension: z.string(),
+  value: z.string(),
+  display_value: z.string().nullish()
+});
+var metricsItemSchema = z.object({
+  dimensions: z.array(metricsDimensionSchema),
+  metrics: z.object({
+    accepted_count: z.number().nullish(),
+    delivered_count: z.number().nullish(),
+    failed_count: z.number().nullish(),
+    opened_count: z.number().nullish(),
+    clicked_count: z.number().nullish(),
+    unsubscribed_count: z.number().nullish(),
+    complained_count: z.number().nullish()
+  })
+});
+var metricsResponseSchema = z.object({
+  items: z.array(metricsItemSchema),
+  pagination: z.object({
+    skip: z.number().nullish(),
+    limit: z.number().nullish(),
+    total: z.number().nullish()
+  }).nullish()
+});
+var logsItemSchema = z.object({
+  id: z.string(),
+  event: z.string(),
+  "@timestamp": z.string(),
+  recipient: z.string().nullish(),
+  "recipient-domain": z.string().nullish(),
+  severity: z.string().nullish(),
+  reason: z.string().nullish()
+});
+var logsResponseSchema = z.object({
+  items: z.array(logsItemSchema),
+  pagination: z.object({
+    next: z.string().nullish(),
+    previous: z.string().nullish(),
+    total: z.number().nullish()
+  }).nullish()
+});
+var mailgunResources = defineResources({
+  [EMAIL_STATS_METRIC]: {
+    shape: "metric",
+    description: "Daily transactional email volume and engagement for the configured domain. The canonical value is `accepted` (messages accepted for sending); delivery, failure, and engagement counts are carried as measures.",
+    endpoint: "POST /v1/analytics/metrics",
+    unit: "emails",
+    granularity: "day",
+    dimensions: [
+      { name: "date", description: "Calendar day of the metric sample (UTC)." },
+      { name: "domain", description: "The Mailgun sending domain." }
+    ],
+    measures: [
+      { name: "delivered", description: "Messages delivered on the day." },
+      {
+        name: "failed",
+        description: "Messages that failed (bounced/dropped)."
+      },
+      { name: "opened", description: "Message opens recorded on the day." },
+      { name: "clicked", description: "Link clicks recorded on the day." },
+      {
+        name: "unsubscribed",
+        description: "Unsubscribes recorded on the day."
+      },
+      {
+        name: "complained",
+        description: "Spam complaints recorded on the day."
+      }
+    ],
+    responses: { email_stats: metricsResponseSchema }
+  },
+  [MAILGUN_EVENT]: {
+    shape: "event",
+    description: "Recent per-message delivery events (accepted, delivered, failed, opened, clicked, unsubscribed, complained) for the configured domain. Deduplicated by Mailgun event id.",
+    endpoint: "POST /v1/analytics/logs",
+    notes: "A bounded sample of the most recent logs is stored; Mailgun retains log data for a limited period.",
+    fields: [
+      { name: "eventId", description: "Mailgun event id (stable per event)." },
+      {
+        name: "eventType",
+        description: "Event type (accepted, delivered, failed, opened, clicked, unsubscribed, complained)."
+      },
+      { name: "recipient", description: "Recipient email address." },
+      { name: "domain", description: "The Mailgun sending domain." },
+      { name: "severity", description: "Failure severity, when present." },
+      { name: "reason", description: "Failure reason, when present." }
+    ],
+    filterable: [],
+    responses: { events: logsResponseSchema }
+  }
+});
+function startOfUtcDay(ms) {
+  return Math.floor(ms / MS_PER_DAY) * MS_PER_DAY;
+}
+function pad2(n) {
+  return String(n).padStart(2, "0");
+}
+function toIsoDate(ms) {
+  const d = new Date(ms);
+  return `${d.getUTCFullYear()}-${pad2(d.getUTCMonth() + 1)}-${pad2(d.getUTCDate())}`;
+}
+function getWindow(options, lookbackDays, now = Date.now()) {
+  const endMs = startOfUtcDay(now) + MS_PER_DAY - 1;
+  const today = startOfUtcDay(now);
+  if (options.mode === "latest") {
+    return {
+      startMs: today - (INCREMENTAL_LOOKBACK_DAYS - 1) * MS_PER_DAY,
+      endMs
+    };
+  }
+  if (options.since) {
+    const sinceMs = new Date(options.since).getTime();
+    if (Number.isFinite(sinceMs)) {
+      const requested = Math.max(
+        1,
+        Math.ceil((today - startOfUtcDay(sinceMs)) / MS_PER_DAY) + 1
+      );
+      const capped = Math.min(requested, lookbackDays);
+      return { startMs: today - (capped - 1) * MS_PER_DAY, endMs };
+    }
+  }
+  return { startMs: today - (lookbackDays - 1) * MS_PER_DAY, endMs };
+}
+function toNumber(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : 0;
+}
+function timeDimensionValue(item) {
+  const timeDim = item.dimensions.find((d) => d.dimension === "time") ?? item.dimensions[0];
+  return timeDim ? timeDim.value : null;
+}
+function metricsItemToSample(item, domain) {
+  const raw = timeDimensionValue(item);
+  const parsed = raw ? parseEpoch(raw, "iso") : null;
+  const ts = parsed ?? (raw ? Date.parse(raw) : NaN);
+  const tsMs = Number.isFinite(ts) ? ts : 0;
+  const date = Number.isFinite(ts) ? toIsoDate(tsMs) : raw ?? "";
+  const m = item.metrics;
+  return metricSample(mailgunResources, EMAIL_STATS_METRIC, {
+    ts: tsMs,
+    value: toNumber(m.accepted_count),
+    attributes: {
+      date,
+      domain,
+      delivered: toNumber(m.delivered_count),
+      failed: toNumber(m.failed_count),
+      opened: toNumber(m.opened_count),
+      clicked: toNumber(m.clicked_count),
+      unsubscribed: toNumber(m.unsubscribed_count),
+      complained: toNumber(m.complained_count)
+    }
+  });
+}
+function logsItemToEvent(item, domain) {
+  const parsed = parseEpoch(item["@timestamp"], "iso");
+  const ts = parsed ?? Date.parse(item["@timestamp"]);
+  const startTs = Number.isFinite(ts) ? ts : 0;
+  return {
+    name: MAILGUN_EVENT,
+    start_ts: startTs,
+    end_ts: startTs,
+    attributes: {
+      eventId: item.id,
+      eventType: item.event,
+      recipient: item.recipient ?? null,
+      domain,
+      severity: item.severity ?? null,
+      reason: item.reason ?? null
+    }
+  };
+}
+var id = "mailgun";
+var MailgunConnector = class _MailgunConnector extends BaseConnector {
+  static id = id;
+  static resources = mailgunResources;
+  static schemas = schemasFromResources(mailgunResources);
+  static create(input, ctx) {
+    const parsed = configFields.parse(input);
+    return new _MailgunConnector(
+      {
+        domain: parsed.domain,
+        region: parsed.region,
+        lookbackDays: parsed.lookbackDays,
+        resources: parsed.resources
+      },
+      { apiKey: parsed.apiKey },
+      ctx
+    );
+  }
+  id = id;
+  credentials = mailgunCredentials;
+  baseUrl() {
+    return this.settings.region === "eu" ? "https://api.eu.mailgun.net" : "https://api.mailgun.net";
+  }
+  buildHeaders() {
+    const token = btoa(`api:${this.creds.apiKey}`);
+    return {
+      Authorization: `Basic ${token}`,
+      "Content-Type": "application/json",
+      Accept: "application/json",
+      "User-Agent": connectorUserAgent("mailgun")
+    };
+  }
+  domainFilter() {
+    return {
+      AND: [
+        {
+          attribute: "domain",
+          comparator: "=",
+          values: [
+            { label: this.settings.domain, value: this.settings.domain }
+          ]
+        }
+      ]
+    };
+  }
+  async fetchMetricItems(window, signal) {
+    const url = `${this.baseUrl()}/v1/analytics/metrics`;
+    const start = new Date(window.startMs).toUTCString();
+    const end = new Date(window.endMs).toUTCString();
+    const items = [];
+    let skip = 0;
+    for (; ; ) {
+      const body = JSON.stringify({
+        start,
+        end,
+        resolution: "day",
+        dimensions: ["time"],
+        metrics: METRIC_FIELDS,
+        filter: this.domainFilter(),
+        include_subaccounts: false,
+        include_aggregates: false,
+        skip,
+        limit: METRICS_PAGE_LIMIT
+      });
+      const res = await this.post(url, {
+        resource: "email_stats",
+        headers: this.buildHeaders(),
+        body,
+        signal
+      });
+      const page = res.body.items ?? [];
+      items.push(...page);
+      const total = res.body.pagination?.total ?? null;
+      skip += page.length;
+      if (page.length < METRICS_PAGE_LIMIT) {
+        break;
+      }
+      if (total !== null && skip >= total) {
+        break;
+      }
+    }
+    return items;
+  }
+  async fetchLogItems(window, signal) {
+    const url = `${this.baseUrl()}/v1/analytics/logs`;
+    const start = new Date(window.startMs).toUTCString();
+    const end = new Date(window.endMs).toUTCString();
+    const byId = /* @__PURE__ */ new Map();
+    const seenTokens = /* @__PURE__ */ new Set();
+    let token = null;
+    for (let page = 0; page < MAX_EVENT_PAGES; page++) {
+      const body = JSON.stringify(
+        token ? { pagination: { token, limit: EVENTS_PAGE_LIMIT } } : {
+          start,
+          end,
+          events: EVENT_TYPES,
+          filter: this.domainFilter(),
+          include_subaccounts: false,
+          pagination: { sort: "timestamp:asc", limit: EVENTS_PAGE_LIMIT }
+        }
+      );
+      const res = await this.post(url, {
+        resource: "events",
+        headers: this.buildHeaders(),
+        body,
+        signal
+      });
+      for (const item of res.body.items ?? []) {
+        byId.set(item.id, item);
+      }
+      const next = res.body.pagination?.next ?? null;
+      if (!next || seenTokens.has(next) || (res.body.items ?? []).length === 0) {
+        break;
+      }
+      seenTokens.add(next);
+      token = next;
+    }
+    return Array.from(byId.values());
+  }
+  async writePhase(storage, phase, window, signal) {
+    if (phase === "email_stats") {
+      const items2 = await this.fetchMetricItems(window, signal);
+      const samples = items2.map(
+        (item) => metricsItemToSample(item, this.settings.domain)
+      );
+      await storage.metrics(samples, {
+        names: [EMAIL_STATS_METRIC],
+        replaceWindow: { start: window.startMs, end: window.endMs }
+      });
+      return;
+    }
+    const items = await this.fetchLogItems(window, signal);
+    const events = items.map(
+      (item) => logsItemToEvent(item, this.settings.domain)
+    );
+    await storage.events(events, { names: [MAILGUN_EVENT] });
+  }
+  async sync(options, storage, signal) {
+    const cursor = isMailgunSyncCursor(
+      options.cursor
+    ) ? options.cursor : void 0;
+    const lookbackDays = this.settings.lookbackDays ?? DEFAULT_LOOKBACK_DAYS;
+    const window = getWindow(options, lookbackDays);
+    const phases = selectActivePhases(
+      (r) => r,
+      PHASE_ORDER,
+      this.settings.resources
+    );
+    return paginateChunked({
+      phases,
+      cursor,
+      signal,
+      logger: this.logger,
+      fetchPage: async (_phase, _page, _sig) => ({ items: [null], next: null }),
+      writeBatch: async (phase, _items, _page) => {
+        await this.writePhase(storage, phase, window, signal);
+      }
+    });
+  }
+};
+
+// src/index.ts
+var index_default = MailgunConnector;
+export {
+  MailgunConnector,
+  configFields,
+  index_default as default,
+  doc,
+  getWindow,
+  id,
+  logsItemToEvent,
+  metricsItemToSample,
+  mailgunResources as resources
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../connector-shared/src/errors.ts","../../../connector-shared/src/retry.ts","../../../connector-shared/src/version.ts","../../../connector-shared/src/request.ts","../../../connector-shared/src/rate-limit.ts","../../../connector-shared/src/map-concurrent.ts","../../../connector-shared/src/sanitize.ts","../../../connector-shared/src/epoch.ts","../../../connector-shared/src/pagination.ts","../../../connector-shared/src/logger.ts","../src/mailgun.ts","../src/index.ts"],"sourcesContent":["import type { HttpResponse } from './types';\n\nexport type HttpErrorKind =\n  | 'transient'\n  | 'rate_limit'\n  | 'auth'\n  | 'upstream_bug'\n  | 'client_bug';\n\nexport abstract class HttpClientError extends Error {\n  abstract readonly kind: HttpErrorKind;\n  readonly response?: HttpResponse;\n\n  constructor(message: string, response?: HttpResponse) {\n    super(message);\n    this.name = new.target.name;\n    this.response = response;\n  }\n}\n\nexport class TransientError extends HttpClientError {\n  readonly kind = 'transient' as const;\n}\n\nexport class RateLimitError extends HttpClientError {\n  readonly kind = 'rate_limit' as const;\n  readonly retryAfter?: Date;\n\n  constructor(message: string, response?: HttpResponse, retryAfter?: Date) {\n    super(message, response);\n    this.retryAfter = retryAfter;\n  }\n}\n\nexport class AuthError extends HttpClientError {\n  readonly kind = 'auth' as const;\n}\n\nexport class UpstreamBugError extends HttpClientError {\n  readonly kind = 'upstream_bug' as const;\n}\n\nexport class ClientBugError extends HttpClientError {\n  readonly kind = 'client_bug' as const;\n}\n\nexport function classifyStatus(status: number): HttpErrorKind {\n  if (status === 429) {\n    return 'rate_limit';\n  }\n  if (status === 401 || status === 403) {\n    return 'auth';\n  }\n  if (status === 408) {\n    return 'transient';\n  }\n  if (status >= 500) {\n    return 'upstream_bug';\n  }\n  if (status >= 400) {\n    return 'client_bug';\n  }\n  return 'client_bug';\n}\n\nexport function errorForStatus(\n  message: string,\n  response: HttpResponse,\n  retryAfter?: Date,\n): HttpClientError {\n  const kind = classifyStatus(response.status);\n  switch (kind) {\n    case 'rate_limit':\n      return new RateLimitError(message, response, retryAfter);\n    case 'auth':\n      return new AuthError(message, response);\n    case 'transient':\n      return new TransientError(message, response);\n    case 'upstream_bug':\n      return new UpstreamBugError(message, response);\n    case 'client_bug':\n      return new ClientBugError(message, response);\n  }\n}\n","import { HttpClientError, RateLimitError, TransientError } from './errors';\n\nexport interface RetryPolicy {\n  maxAttempts?: number;\n  initialDelayMs?: number;\n  maxDelayMs?: number;\n  retryOn?: (status: number | null, err?: Error) => boolean;\n}\n\nexport const defaultRetryOn = (status: number | null, err?: Error): boolean => {\n  if (err instanceof RateLimitError) {\n    return true;\n  }\n  if (err instanceof TransientError) {\n    return true;\n  }\n  if (status === null) {\n    return err instanceof Error && !(err instanceof HttpClientError);\n  }\n  if (status === 408 || status === 429) {\n    return true;\n  }\n  if (status >= 500) {\n    return true;\n  }\n  return false;\n};\n\nexport function backoffDelayMs(\n  attempt: number,\n  policy: Required<Pick<RetryPolicy, 'initialDelayMs' | 'maxDelayMs'>>,\n): number {\n  const base = policy.initialDelayMs * 2 ** attempt;\n  const jitter = base * 0.25 * Math.random();\n  return Math.min(base + jitter, policy.maxDelayMs);\n}\n\nexport function parseRetryAfter(\n  headerValue: string | null,\n  now: Date = new Date(),\n): Date | undefined {\n  if (!headerValue) {\n    return undefined;\n  }\n  const trimmed = headerValue.trim();\n  if (/^\\d+$/.test(trimmed)) {\n    return new Date(now.getTime() + Number(trimmed) * 1000);\n  }\n  const parsed = Date.parse(trimmed);\n  if (Number.isNaN(parsed)) {\n    return undefined;\n  }\n  return new Date(parsed);\n}\n\nexport function sleep(ms: number, signal?: AbortSignal): Promise<void> {\n  if (signal?.aborted) {\n    return Promise.reject(signal.reason ?? new Error('Aborted'));\n  }\n  return new Promise<void>((resolve, reject) => {\n    const onAbort = () => {\n      clearTimeout(timer);\n      reject(signal!.reason ?? new Error('Aborted'));\n    };\n    const timer = setTimeout(() => {\n      signal?.removeEventListener('abort', onAbort);\n      resolve();\n    }, ms);\n    signal?.addEventListener('abort', onAbort, { once: true });\n  });\n}\n","export const HTTP_CLIENT_VERSION = '0.0.0';\n\nexport const DEFAULT_USER_AGENT = `rawdash-connector/${HTTP_CLIENT_VERSION} (+https://rawdash.dev)`;\n\nexport function connectorUserAgent(connectorId: string): string {\n  return `rawdash-connector-${connectorId}/${HTTP_CLIENT_VERSION} (+https://rawdash.dev)`;\n}\n","import {\n  AuthError,\n  ClientBugError,\n  HttpClientError,\n  RateLimitError,\n  TransientError,\n  UpstreamBugError,\n  errorForStatus,\n} from './errors';\nimport { defaultRetryOn, parseRetryAfter, sleep } from './retry';\nimport type { FetchLike, HttpMethod, HttpRequest, HttpResponse } from './types';\nimport { DEFAULT_USER_AGENT } from './version';\n\nconst DEFAULT_TIMEOUT_MS = 10_000;\nconst DEFAULT_MAX_ATTEMPTS = 3;\nconst DEFAULT_INITIAL_DELAY_MS = 1000;\nconst DEFAULT_MAX_DELAY_MS = 60_000;\nconst OBSERVER_TIMEOUT_MS = 250;\n\nexport interface RequestObservation {\n  url: string;\n  method: HttpMethod;\n  status: number;\n  resource: string;\n  requestId: string;\n  body: unknown;\n}\n\nexport type RequestObserver = (\n  event: RequestObservation,\n) => void | Promise<void>;\n\nexport interface RequestOptions {\n  fetch?: FetchLike;\n  observer?: RequestObserver;\n  resource: string;\n  requestId?: string;\n}\n\nasync function notifyObserver(\n  observer: RequestObserver,\n  event: RequestObservation,\n): Promise<void> {\n  let result: void | Promise<void>;\n  try {\n    result = observer(event);\n  } catch (err) {\n    console.warn('[connector-shared] request observer threw:', err);\n    return;\n  }\n  if (!(result instanceof Promise)) {\n    return;\n  }\n  const guarded = result.catch((err) => {\n    console.warn('[connector-shared] request observer rejected:', err);\n  });\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  const timeout = new Promise<void>((resolve) => {\n    timer = setTimeout(resolve, OBSERVER_TIMEOUT_MS);\n  });\n  try {\n    await Promise.race([guarded, timeout]);\n  } finally {\n    if (timer) {\n      clearTimeout(timer);\n    }\n  }\n}\n\nfunction newRequestId(): string {\n  const c = (globalThis as { crypto?: { randomUUID?: () => string } }).crypto;\n  if (c?.randomUUID) {\n    return c.randomUUID();\n  }\n  return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;\n}\n\nfunction mergeHeaders(\n  defaults: Record<string, string>,\n  overrides: Record<string, string> | undefined,\n): Record<string, string> {\n  const merged: Record<string, string> = {};\n  for (const [k, v] of Object.entries(defaults)) {\n    merged[k.toLowerCase()] = v;\n  }\n  if (overrides) {\n    for (const [k, v] of Object.entries(overrides)) {\n      merged[k.toLowerCase()] = v;\n    }\n  }\n  return merged;\n}\n\nfunction linkTimeoutSignal(\n  parent: AbortSignal | undefined,\n  timeoutMs: number,\n): { signal: AbortSignal; cancel: () => void } {\n  const controller = new AbortController();\n  const onParentAbort = () => {\n    controller.abort(parent?.reason);\n  };\n  if (parent) {\n    if (parent.aborted) {\n      controller.abort(parent.reason);\n    } else {\n      parent.addEventListener('abort', onParentAbort, { once: true });\n    }\n  }\n  const timer = setTimeout(() => {\n    controller.abort(new Error(`Request timed out after ${timeoutMs}ms`));\n  }, timeoutMs);\n  return {\n    signal: controller.signal,\n    cancel: () => {\n      clearTimeout(timer);\n      if (parent) {\n        parent.removeEventListener('abort', onParentAbort);\n      }\n    },\n  };\n}\n\nasync function readBody(\n  res: Response,\n  parseJson: boolean,\n  binary: boolean,\n): Promise<unknown> {\n  if (res.status === 204 || res.status === 205) {\n    return null;\n  }\n  if (binary) {\n    return new Uint8Array(await res.arrayBuffer());\n  }\n  const contentType = res.headers.get('content-type') ?? '';\n  if (parseJson && contentType.includes('application/json')) {\n    const text = await res.text();\n    if (text.length === 0) {\n      return null;\n    }\n    return JSON.parse(text);\n  }\n  return res.text();\n}\n\nexport async function request<T = unknown>(\n  req: HttpRequest,\n  options: RequestOptions,\n): Promise<HttpResponse<T>> {\n  const fetchImpl: FetchLike = options.fetch ?? (globalThis.fetch as FetchLike);\n  const retry = req.retry ?? {};\n  const maxAttempts = retry.maxAttempts ?? DEFAULT_MAX_ATTEMPTS;\n  const initialDelayMs = retry.initialDelayMs ?? DEFAULT_INITIAL_DELAY_MS;\n  const maxDelayMs = retry.maxDelayMs ?? DEFAULT_MAX_DELAY_MS;\n  const retryOn = retry.retryOn ?? defaultRetryOn;\n  const timeoutMs = req.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n  const parseJson = req.parseJson ?? true;\n  const binary = req.binary ?? false;\n\n  const headers = mergeHeaders(\n    {\n      'User-Agent': DEFAULT_USER_AGENT,\n      Accept: 'application/json',\n    },\n    req.headers,\n  );\n\n  let lastErr: Error | undefined;\n\n  for (let attempt = 0; attempt < maxAttempts; attempt++) {\n    req.signal?.throwIfAborted();\n\n    const { signal, cancel } = linkTimeoutSignal(req.signal, timeoutMs);\n    let res: Response;\n    try {\n      res = await fetchImpl(req.url, {\n        method: req.method ?? 'GET',\n        headers,\n        body: req.body as RequestInit['body'],\n        signal,\n      });\n    } catch (err) {\n      cancel();\n      if (req.signal?.aborted) {\n        throw req.signal.reason ?? err;\n      }\n      const error = err instanceof Error ? err : new Error(String(err));\n      lastErr = error;\n      if (attempt < maxAttempts - 1 && retryOn(null, error)) {\n        const delay = computeDelay(attempt, initialDelayMs, maxDelayMs);\n        await sleep(delay, req.signal);\n        continue;\n      }\n      throw new TransientError(error.message);\n    }\n    cancel();\n\n    const body = await readBody(res, parseJson, binary);\n    const httpResponse: HttpResponse<T> = {\n      status: res.status,\n      headers: res.headers,\n      body: body as T,\n    };\n    if (req.rateLimit) {\n      const state = req.rateLimit.parse(res.headers);\n      if (state) {\n        httpResponse.rateLimitState = state;\n      }\n    }\n\n    if (options.observer) {\n      await notifyObserver(options.observer, {\n        url: req.url,\n        method: req.method ?? 'GET',\n        status: res.status,\n        resource: options.resource,\n        requestId: options.requestId ?? newRequestId(),\n        body,\n      });\n    }\n\n    if (res.ok) {\n      return httpResponse;\n    }\n\n    const retryAfter = parseRetryAfter(res.headers.get('retry-after'));\n    const message = `HTTP ${res.status} ${res.statusText} for ${req.method ?? 'GET'} ${req.url}`;\n    const err = errorForStatus(message, httpResponse, retryAfter);\n\n    if (\n      attempt < maxAttempts - 1 &&\n      retryOn(res.status, err) &&\n      !(err instanceof AuthError) &&\n      !(err instanceof ClientBugError)\n    ) {\n      lastErr = err;\n      let delay = computeDelay(attempt, initialDelayMs, maxDelayMs);\n      if (err instanceof RateLimitError && retryAfter) {\n        const wait = retryAfter.getTime() - Date.now();\n        if (wait > 0) {\n          delay = Math.min(wait, maxDelayMs);\n        }\n      }\n      await sleep(delay, req.signal);\n      continue;\n    }\n\n    throw err;\n  }\n\n  throw lastErr ?? new UpstreamBugError('Exhausted retry attempts');\n}\n\nfunction computeDelay(\n  attempt: number,\n  initialDelayMs: number,\n  maxDelayMs: number,\n): number {\n  const base = initialDelayMs * 2 ** attempt;\n  const jitter = base * 0.25 * Math.random();\n  return Math.min(base + jitter, maxDelayMs);\n}\n\nexport { HttpClientError };\n","export interface RateLimitState {\n  remaining: number;\n  resetAt: Date;\n}\n\nexport interface RateLimitPolicy {\n  parse(headers: Headers): RateLimitState | null;\n}\n\nexport interface StandardRateLimitPolicyConfig {\n  remainingHeader: string;\n  resetHeader: string;\n  resetUnit: 's' | 'ms';\n  resetFallbackMs?: number;\n}\n\nexport function standardRateLimitPolicy(\n  config: StandardRateLimitPolicyConfig,\n): RateLimitPolicy {\n  const { remainingHeader, resetHeader, resetUnit, resetFallbackMs } = config;\n  const multiplier = resetUnit === 's' ? 1000 : 1;\n  return {\n    parse(h) {\n      const remainingRaw = h.get(remainingHeader);\n      if (remainingRaw === null || remainingRaw.trim() === '') {\n        return null;\n      }\n      const remaining = Number(remainingRaw);\n      if (!Number.isFinite(remaining)) {\n        return null;\n      }\n      const resetRaw = h.get(resetHeader);\n      if (resetRaw === null) {\n        if (resetFallbackMs === undefined) {\n          return null;\n        }\n        return {\n          remaining,\n          resetAt: new Date(Date.now() + resetFallbackMs),\n        };\n      }\n      if (resetRaw.trim() === '') {\n        return null;\n      }\n      const reset = Number(resetRaw);\n      if (!Number.isFinite(reset) || reset < 0) {\n        return null;\n      }\n      const resetMs = reset * multiplier;\n      if (!Number.isFinite(resetMs)) {\n        return null;\n      }\n      return { remaining, resetAt: new Date(resetMs) };\n    },\n  };\n}\n","export async function mapWithConcurrency<T, R>(\n  items: readonly T[],\n  concurrency: number,\n  fn: (item: T, index: number) => Promise<R>,\n): Promise<R[]> {\n  const results = new Array<R>(items.length);\n  if (items.length === 0) {\n    return results;\n  }\n  const normalized = Number.isFinite(concurrency) ? Math.floor(concurrency) : 1;\n  const limit = Math.max(1, Math.min(normalized, items.length));\n  let next = 0;\n  let failed = false;\n\n  async function worker(): Promise<void> {\n    while (!failed) {\n      const i = next++;\n      if (i >= items.length) {\n        return;\n      }\n      try {\n        results[i] = await fn(items[i]!, i);\n      } catch (err) {\n        failed = true;\n        throw err;\n      }\n    }\n  }\n\n  const workers: Promise<void>[] = [];\n  for (let w = 0; w < limit; w++) {\n    workers.push(worker());\n  }\n  await Promise.all(workers);\n  return results;\n}\n","export interface SanitizeAllowedUrlOptions {\n  url: string | null;\n  host: string;\n  pathname: string;\n  protocol?: 'https:' | 'http:';\n}\n\nexport function sanitizeAllowedUrl(\n  options: SanitizeAllowedUrlOptions,\n): string | null {\n  const { url, host, pathname, protocol = 'https:' } = options;\n  if (url === null) {\n    return null;\n  }\n  try {\n    const u = new URL(url);\n    if (u.protocol !== protocol || u.host !== host || u.pathname !== pathname) {\n      return null;\n    }\n    return u.toString();\n  } catch {\n    return null;\n  }\n}\n","export type EpochUnit = 'ms' | 's' | 'iso';\n\nexport function parseEpoch(\n  value: number | string | null | undefined,\n  unit: EpochUnit,\n): number | null {\n  if (value === null || value === undefined) {\n    return null;\n  }\n  if (unit === 'iso') {\n    if (typeof value !== 'string') {\n      return null;\n    }\n    const ms = new Date(value).getTime();\n    return Number.isFinite(ms) ? ms : null;\n  }\n  if (typeof value === 'string' && value.trim() === '') {\n    return null;\n  }\n  const n = typeof value === 'number' ? value : Number(value);\n  if (!Number.isFinite(n)) {\n    return null;\n  }\n  const result = unit === 's' ? n * 1000 : n;\n  return Number.isFinite(result) ? result : null;\n}\n","import { request } from './request';\nimport type { HttpRequest } from './types';\n\nexport function parseLinkHeader(header: string | null): Record<string, string> {\n  if (!header) {\n    return {};\n  }\n  const result: Record<string, string> = {};\n  for (const part of header.split(',')) {\n    const match = part.match(/<([^>]+)>\\s*;\\s*rel=\"([^\"]+)\"/);\n    if (match) {\n      result[match[2]!] = match[1]!;\n    }\n  }\n  return result;\n}\n\nexport async function* paginateLink<T>(\n  initial: HttpRequest,\n  parse: (body: unknown) => T[],\n  options: { resource: string },\n): AsyncIterable<T> {\n  let next: string | null = initial.url;\n  while (next) {\n    const res: Awaited<ReturnType<typeof request>> = await request(\n      {\n        ...initial,\n        url: next,\n      },\n      { resource: options.resource },\n    );\n    for (const item of parse(res.body)) {\n      yield item;\n    }\n    const links = parseLinkHeader(res.headers.get('link'));\n    next = links['next'] ?? null;\n  }\n}\n\nexport async function* paginateCursor<T>(\n  initial: HttpRequest,\n  parse: (body: unknown) => { items: T[]; nextCursor: string | null },\n  buildNext: (req: HttpRequest, cursor: string) => HttpRequest,\n  options: { resource: string },\n): AsyncIterable<T> {\n  let req: HttpRequest = initial;\n  while (true) {\n    const res = await request(req, { resource: options.resource });\n    const { items, nextCursor } = parse(res.body);\n    for (const item of items) {\n      yield item;\n    }\n    if (!nextCursor) {\n      return;\n    }\n    req = buildNext(req, nextCursor);\n  }\n}\n\nexport async function* paginatePage<T>(\n  initial: HttpRequest,\n  parse: (body: unknown) => { items: T[]; hasMore: boolean },\n  buildPage: (req: HttpRequest, page: number) => HttpRequest,\n  options: { resource: string },\n): AsyncIterable<T> {\n  let page = 1;\n  while (true) {\n    const req = page === 1 ? initial : buildPage(initial, page);\n    const res = await request(req, { resource: options.resource });\n    const { items, hasMore } = parse(res.body);\n    for (const item of items) {\n      yield item;\n    }\n    if (!hasMore || items.length === 0) {\n      return;\n    }\n    page++;\n  }\n}\n","export type LogFields = Record<string, unknown>;\n\nexport interface ConnectorLogger {\n  info(event: string, fields?: LogFields): void;\n  warn(event: string, fields?: LogFields): void;\n}\n\nexport interface ConnectorLoggerOptions {\n  scope: string;\n}\n\nconst MAX_VALUE_LEN = 120;\n\nfunction truncate(s: string, max = MAX_VALUE_LEN): string {\n  if (s.length <= max) {\n    return s;\n  }\n  return `${s.slice(0, max - 1)}…`;\n}\n\nfunction formatValue(value: unknown): string {\n  if (value === null) {\n    return 'null';\n  }\n  if (value === undefined) {\n    return '';\n  }\n  if (typeof value === 'number' || typeof value === 'boolean') {\n    return String(value);\n  }\n  if (typeof value === 'string') {\n    const t = truncate(value);\n    if (/[\\s\"=]/.test(t)) {\n      return JSON.stringify(t);\n    }\n    return t;\n  }\n  if (typeof value === 'bigint') {\n    return value.toString();\n  }\n  let json: string | undefined;\n  try {\n    json = JSON.stringify(value);\n  } catch {\n    json = undefined;\n  }\n  return truncate(json ?? String(value));\n}\n\nexport function formatLogFields(fields?: LogFields): string {\n  if (!fields) {\n    return '';\n  }\n  const parts: string[] = [];\n  for (const [k, v] of Object.entries(fields)) {\n    if (v === undefined) {\n      continue;\n    }\n    parts.push(`${k}=${formatValue(v)}`);\n  }\n  return parts.length > 0 ? ` ${parts.join(' ')}` : '';\n}\n\nexport function formatLogLine(\n  scope: string,\n  event: string,\n  fields?: LogFields,\n): string {\n  return `[${scope}] ${event}${formatLogFields(fields)}`;\n}\n\nexport function createDefaultConnectorLogger(\n  opts: ConnectorLoggerOptions,\n): ConnectorLogger {\n  return {\n    info(event, fields) {\n      console.info(formatLogLine(opts.scope, event, fields));\n    },\n    warn(event, fields) {\n      console.warn(formatLogLine(opts.scope, event, fields));\n    },\n  };\n}\n\nconst NOOP_LOGGER: ConnectorLogger = {\n  info() {},\n  warn() {},\n};\n\nexport function noopConnectorLogger(): ConnectorLogger {\n  return NOOP_LOGGER;\n}\n","import { connectorUserAgent, parseEpoch } from '@rawdash/connector-shared';\nimport {\n  BaseConnector,\n  type ChunkedSyncCursor,\n  type ConnectorContext,\n  type ConnectorDoc,\n  type CredentialsSchema,\n  type Event,\n  type MetricSample,\n  type StorageHandle,\n  type SyncOptions,\n  type SyncResult,\n  defineConfigFields,\n  defineConnectorDoc,\n  defineResources,\n  makeChunkedCursorGuard,\n  metricSample,\n  paginateChunked,\n  schemasFromResources,\n  selectActivePhases,\n} from '@rawdash/core';\nimport { z } from 'zod';\n\nexport const configFields = defineConfigFields(\n  z.object({\n    apiKey: z.object({ $secret: z.string() }).meta({\n      label: 'API key',\n      description:\n        'A Mailgun API key with read access to analytics. Create one in the Mailgun dashboard under Settings -> API Keys.',\n      placeholder: 'key-...',\n      secret: true,\n    }),\n    domain: z.string().trim().min(1, 'A sending domain is required').meta({\n      label: 'Sending domain',\n      description:\n        'The Mailgun sending domain to report on (e.g. mg.example.com). Metrics and logs are filtered to this domain.',\n      placeholder: 'mg.example.com',\n    }),\n    region: z.enum(['us', 'eu']).default('us').meta({\n      label: 'Region',\n      description:\n        \"Which Mailgun region hosts the domain. 'us' uses api.mailgun.net; 'eu' uses api.eu.mailgun.net.\",\n      placeholder: 'us',\n    }),\n    lookbackDays: z.number().int().positive().optional().meta({\n      label: 'Lookback days (full sync)',\n      description:\n        'How many calendar days of stats/events to fetch on a full sync. Defaults to 90.',\n      placeholder: '90',\n    }),\n    resources: z\n      .array(z.enum(['email_stats', 'events']))\n      .nonempty()\n      .optional()\n      .meta({\n        label: 'Resources',\n        description:\n          'Which Mailgun resources to sync. Omit to sync all of them.',\n      }),\n  }),\n);\n\nexport const doc: ConnectorDoc = defineConnectorDoc({\n  displayName: 'Mailgun',\n  category: 'engineering',\n  brandColor: '#F06B66',\n  tagline:\n    'Sync transactional email volume, delivery, bounce, and complaint metrics plus recent delivery events from Mailgun.',\n  vendor: {\n    name: 'Mailgun',\n    domain: 'mailgun.com',\n    apiDocs: 'https://documentation.mailgun.com/docs/mailgun/api-reference/',\n    website: 'https://www.mailgun.com',\n  },\n  auth: {\n    summary:\n      'A Mailgun API key with read access to analytics, sent via HTTP basic auth (username `api`, password is the key).',\n    setup: [\n      'In the Mailgun dashboard open Settings -> API Keys and create or copy an API key with analytics read access.',\n      'Note which region hosts your domain (US or EU); set the connector `region` accordingly.',\n      'Store the key as a secret and reference it from the connector config as `apiKey: secret(\"MAILGUN_API_KEY\")`, and set `domain` to the sending domain you want to report on.',\n    ],\n  },\n  rateLimit:\n    'Mailgun applies per-endpoint rate limits and returns 429 with a Retry-After header when exceeded; the shared HTTP client backs off and retries automatically.',\n  limitations: [\n    'Metrics are reported at daily resolution; the connector requests `resolution=day` from the analytics API.',\n    'Incremental syncs re-fetch a fixed trailing window and replace only that window, so older samples are preserved.',\n    'The events resource stores a bounded sample of the most recent delivery logs (Mailgun retains log data for a limited period), not a complete event archive.',\n  ],\n});\n\nexport interface MailgunSettings {\n  domain: string;\n  region: 'us' | 'eu';\n  lookbackDays?: number;\n  resources?: readonly MailgunResource[];\n}\n\nconst mailgunCredentials = {\n  apiKey: {\n    description: 'Mailgun API key',\n    auth: 'required' as const,\n  },\n} satisfies CredentialsSchema;\n\ntype MailgunCredentials = typeof mailgunCredentials;\n\nconst PHASE_ORDER = ['email_stats', 'events'] as const;\n\ntype MailgunPhase = (typeof PHASE_ORDER)[number];\n\nexport type MailgunResource = MailgunPhase;\n\ntype MailgunSyncCursor = ChunkedSyncCursor<MailgunPhase, string>;\n\nconst isMailgunSyncCursor = makeChunkedCursorGuard(PHASE_ORDER);\n\nconst MS_PER_DAY = 24 * 60 * 60 * 1000;\nconst DEFAULT_LOOKBACK_DAYS = 90;\nconst INCREMENTAL_LOOKBACK_DAYS = 7;\nconst METRICS_PAGE_LIMIT = 1000;\nconst EVENTS_PAGE_LIMIT = 300;\nconst MAX_EVENT_PAGES = 20;\n\nconst EMAIL_STATS_METRIC = 'mailgun_email_stats';\nconst MAILGUN_EVENT = 'mailgun_event';\n\nconst METRIC_FIELDS = [\n  'accepted_count',\n  'delivered_count',\n  'failed_count',\n  'opened_count',\n  'clicked_count',\n  'unsubscribed_count',\n  'complained_count',\n] as const;\n\nconst EVENT_TYPES = [\n  'accepted',\n  'delivered',\n  'failed',\n  'opened',\n  'clicked',\n  'unsubscribed',\n  'complained',\n] as const;\n\nconst metricsDimensionSchema = z.object({\n  dimension: z.string(),\n  value: z.string(),\n  display_value: z.string().nullish(),\n});\n\nconst metricsItemSchema = z.object({\n  dimensions: z.array(metricsDimensionSchema),\n  metrics: z.object({\n    accepted_count: z.number().nullish(),\n    delivered_count: z.number().nullish(),\n    failed_count: z.number().nullish(),\n    opened_count: z.number().nullish(),\n    clicked_count: z.number().nullish(),\n    unsubscribed_count: z.number().nullish(),\n    complained_count: z.number().nullish(),\n  }),\n});\n\nconst metricsResponseSchema = z.object({\n  items: z.array(metricsItemSchema),\n  pagination: z\n    .object({\n      skip: z.number().nullish(),\n      limit: z.number().nullish(),\n      total: z.number().nullish(),\n    })\n    .nullish(),\n});\n\nconst logsItemSchema = z.object({\n  id: z.string(),\n  event: z.string(),\n  '@timestamp': z.string(),\n  recipient: z.string().nullish(),\n  'recipient-domain': z.string().nullish(),\n  severity: z.string().nullish(),\n  reason: z.string().nullish(),\n});\n\nconst logsResponseSchema = z.object({\n  items: z.array(logsItemSchema),\n  pagination: z\n    .object({\n      next: z.string().nullish(),\n      previous: z.string().nullish(),\n      total: z.number().nullish(),\n    })\n    .nullish(),\n});\n\nexport const mailgunResources = defineResources({\n  [EMAIL_STATS_METRIC]: {\n    shape: 'metric',\n    description:\n      'Daily transactional email volume and engagement for the configured domain. The canonical value is `accepted` (messages accepted for sending); delivery, failure, and engagement counts are carried as measures.',\n    endpoint: 'POST /v1/analytics/metrics',\n    unit: 'emails',\n    granularity: 'day',\n    dimensions: [\n      { name: 'date', description: 'Calendar day of the metric sample (UTC).' },\n      { name: 'domain', description: 'The Mailgun sending domain.' },\n    ],\n    measures: [\n      { name: 'delivered', description: 'Messages delivered on the day.' },\n      {\n        name: 'failed',\n        description: 'Messages that failed (bounced/dropped).',\n      },\n      { name: 'opened', description: 'Message opens recorded on the day.' },\n      { name: 'clicked', description: 'Link clicks recorded on the day.' },\n      {\n        name: 'unsubscribed',\n        description: 'Unsubscribes recorded on the day.',\n      },\n      {\n        name: 'complained',\n        description: 'Spam complaints recorded on the day.',\n      },\n    ],\n    responses: { email_stats: metricsResponseSchema },\n  },\n  [MAILGUN_EVENT]: {\n    shape: 'event',\n    description:\n      'Recent per-message delivery events (accepted, delivered, failed, opened, clicked, unsubscribed, complained) for the configured domain. Deduplicated by Mailgun event id.',\n    endpoint: 'POST /v1/analytics/logs',\n    notes:\n      'A bounded sample of the most recent logs is stored; Mailgun retains log data for a limited period.',\n    fields: [\n      { name: 'eventId', description: 'Mailgun event id (stable per event).' },\n      {\n        name: 'eventType',\n        description:\n          'Event type (accepted, delivered, failed, opened, clicked, unsubscribed, complained).',\n      },\n      { name: 'recipient', description: 'Recipient email address.' },\n      { name: 'domain', description: 'The Mailgun sending domain.' },\n      { name: 'severity', description: 'Failure severity, when present.' },\n      { name: 'reason', description: 'Failure reason, when present.' },\n    ],\n    filterable: [],\n    responses: { events: logsResponseSchema },\n  },\n});\n\nexport type MailgunMetricsItem = z.infer<typeof metricsItemSchema>;\nexport type MailgunLogsItem = z.infer<typeof logsItemSchema>;\n\nexport interface MailgunWindow {\n  startMs: number;\n  endMs: number;\n}\n\nfunction startOfUtcDay(ms: number): number {\n  return Math.floor(ms / MS_PER_DAY) * MS_PER_DAY;\n}\n\nfunction pad2(n: number): string {\n  return String(n).padStart(2, '0');\n}\n\nfunction toIsoDate(ms: number): string {\n  const d = new Date(ms);\n  return `${d.getUTCFullYear()}-${pad2(d.getUTCMonth() + 1)}-${pad2(d.getUTCDate())}`;\n}\n\nexport function getWindow(\n  options: SyncOptions,\n  lookbackDays: number,\n  now: number = Date.now(),\n): MailgunWindow {\n  const endMs = startOfUtcDay(now) + MS_PER_DAY - 1;\n  const today = startOfUtcDay(now);\n  if (options.mode === 'latest') {\n    return {\n      startMs: today - (INCREMENTAL_LOOKBACK_DAYS - 1) * MS_PER_DAY,\n      endMs,\n    };\n  }\n  if (options.since) {\n    const sinceMs = new Date(options.since).getTime();\n    if (Number.isFinite(sinceMs)) {\n      const requested = Math.max(\n        1,\n        Math.ceil((today - startOfUtcDay(sinceMs)) / MS_PER_DAY) + 1,\n      );\n      const capped = Math.min(requested, lookbackDays);\n      return { startMs: today - (capped - 1) * MS_PER_DAY, endMs };\n    }\n  }\n  return { startMs: today - (lookbackDays - 1) * MS_PER_DAY, endMs };\n}\n\nfunction toNumber(value: number | null | undefined): number {\n  return typeof value === 'number' && Number.isFinite(value) ? value : 0;\n}\n\nfunction timeDimensionValue(item: MailgunMetricsItem): string | null {\n  const timeDim =\n    item.dimensions.find((d) => d.dimension === 'time') ?? item.dimensions[0];\n  return timeDim ? timeDim.value : null;\n}\n\nexport function metricsItemToSample(\n  item: MailgunMetricsItem,\n  domain: string,\n): MetricSample {\n  const raw = timeDimensionValue(item);\n  const parsed = raw ? parseEpoch(raw, 'iso') : null;\n  const ts = parsed ?? (raw ? Date.parse(raw) : NaN);\n  const tsMs = Number.isFinite(ts) ? ts : 0;\n  const date = Number.isFinite(ts) ? toIsoDate(tsMs) : (raw ?? '');\n  const m = item.metrics;\n  return metricSample(mailgunResources, EMAIL_STATS_METRIC, {\n    ts: tsMs,\n    value: toNumber(m.accepted_count),\n    attributes: {\n      date,\n      domain,\n      delivered: toNumber(m.delivered_count),\n      failed: toNumber(m.failed_count),\n      opened: toNumber(m.opened_count),\n      clicked: toNumber(m.clicked_count),\n      unsubscribed: toNumber(m.unsubscribed_count),\n      complained: toNumber(m.complained_count),\n    },\n  });\n}\n\nexport function logsItemToEvent(item: MailgunLogsItem, domain: string): Event {\n  const parsed = parseEpoch(item['@timestamp'], 'iso');\n  const ts = parsed ?? Date.parse(item['@timestamp']);\n  const startTs = Number.isFinite(ts) ? ts : 0;\n  return {\n    name: MAILGUN_EVENT,\n    start_ts: startTs,\n    end_ts: startTs,\n    attributes: {\n      eventId: item.id,\n      eventType: item.event,\n      recipient: item.recipient ?? null,\n      domain,\n      severity: item.severity ?? null,\n      reason: item.reason ?? null,\n    },\n  };\n}\n\nexport const id = 'mailgun';\n\nexport class MailgunConnector extends BaseConnector<\n  MailgunSettings,\n  MailgunCredentials\n> {\n  static readonly id = id;\n\n  static readonly resources = mailgunResources;\n\n  static readonly schemas = schemasFromResources(mailgunResources);\n\n  static create(input: unknown, ctx?: ConnectorContext): MailgunConnector {\n    const parsed = configFields.parse(input);\n    return new MailgunConnector(\n      {\n        domain: parsed.domain,\n        region: parsed.region,\n        lookbackDays: parsed.lookbackDays,\n        resources: parsed.resources,\n      },\n      { apiKey: parsed.apiKey },\n      ctx,\n    );\n  }\n\n  readonly id = id;\n  override readonly credentials = mailgunCredentials;\n\n  private baseUrl(): string {\n    return this.settings.region === 'eu'\n      ? 'https://api.eu.mailgun.net'\n      : 'https://api.mailgun.net';\n  }\n\n  private buildHeaders(): Record<string, string> {\n    const token = btoa(`api:${this.creds.apiKey}`);\n    return {\n      Authorization: `Basic ${token}`,\n      'Content-Type': 'application/json',\n      Accept: 'application/json',\n      'User-Agent': connectorUserAgent('mailgun'),\n    };\n  }\n\n  private domainFilter(): Record<string, unknown> {\n    return {\n      AND: [\n        {\n          attribute: 'domain',\n          comparator: '=',\n          values: [\n            { label: this.settings.domain, value: this.settings.domain },\n          ],\n        },\n      ],\n    };\n  }\n\n  private async fetchMetricItems(\n    window: MailgunWindow,\n    signal?: AbortSignal,\n  ): Promise<MailgunMetricsItem[]> {\n    const url = `${this.baseUrl()}/v1/analytics/metrics`;\n    const start = new Date(window.startMs).toUTCString();\n    const end = new Date(window.endMs).toUTCString();\n    const items: MailgunMetricsItem[] = [];\n    let skip = 0;\n    for (;;) {\n      const body = JSON.stringify({\n        start,\n        end,\n        resolution: 'day',\n        dimensions: ['time'],\n        metrics: METRIC_FIELDS,\n        filter: this.domainFilter(),\n        include_subaccounts: false,\n        include_aggregates: false,\n        skip,\n        limit: METRICS_PAGE_LIMIT,\n      });\n      const res = await this.post<z.infer<typeof metricsResponseSchema>>(url, {\n        resource: 'email_stats',\n        headers: this.buildHeaders(),\n        body,\n        signal,\n      });\n      const page = res.body.items ?? [];\n      items.push(...page);\n      const total = res.body.pagination?.total ?? null;\n      skip += page.length;\n      if (page.length < METRICS_PAGE_LIMIT) {\n        break;\n      }\n      if (total !== null && skip >= total) {\n        break;\n      }\n    }\n    return items;\n  }\n\n  private async fetchLogItems(\n    window: MailgunWindow,\n    signal?: AbortSignal,\n  ): Promise<MailgunLogsItem[]> {\n    const url = `${this.baseUrl()}/v1/analytics/logs`;\n    const start = new Date(window.startMs).toUTCString();\n    const end = new Date(window.endMs).toUTCString();\n    const byId = new Map<string, MailgunLogsItem>();\n    const seenTokens = new Set<string>();\n    let token: string | null = null;\n    for (let page = 0; page < MAX_EVENT_PAGES; page++) {\n      const body: string = JSON.stringify(\n        token\n          ? { pagination: { token, limit: EVENTS_PAGE_LIMIT } }\n          : {\n              start,\n              end,\n              events: EVENT_TYPES,\n              filter: this.domainFilter(),\n              include_subaccounts: false,\n              pagination: { sort: 'timestamp:asc', limit: EVENTS_PAGE_LIMIT },\n            },\n      );\n      const res = await this.post<z.infer<typeof logsResponseSchema>>(url, {\n        resource: 'events',\n        headers: this.buildHeaders(),\n        body,\n        signal,\n      });\n      for (const item of res.body.items ?? []) {\n        byId.set(item.id, item);\n      }\n      const next: string | null = res.body.pagination?.next ?? null;\n      if (\n        !next ||\n        seenTokens.has(next) ||\n        (res.body.items ?? []).length === 0\n      ) {\n        break;\n      }\n      seenTokens.add(next);\n      token = next;\n    }\n    return Array.from(byId.values());\n  }\n\n  private async writePhase(\n    storage: StorageHandle,\n    phase: MailgunPhase,\n    window: MailgunWindow,\n    signal?: AbortSignal,\n  ): Promise<void> {\n    if (phase === 'email_stats') {\n      const items = await this.fetchMetricItems(window, signal);\n      const samples = items.map((item) =>\n        metricsItemToSample(item, this.settings.domain),\n      );\n      await storage.metrics(samples, {\n        names: [EMAIL_STATS_METRIC],\n        replaceWindow: { start: window.startMs, end: window.endMs },\n      });\n      return;\n    }\n    const items = await this.fetchLogItems(window, signal);\n    const events = items.map((item) =>\n      logsItemToEvent(item, this.settings.domain),\n    );\n    await storage.events(events, { names: [MAILGUN_EVENT] });\n  }\n\n  async sync(\n    options: SyncOptions,\n    storage: StorageHandle,\n    signal?: AbortSignal,\n  ): Promise<SyncResult> {\n    const cursor: MailgunSyncCursor | undefined = isMailgunSyncCursor(\n      options.cursor,\n    )\n      ? options.cursor\n      : undefined;\n    const lookbackDays = this.settings.lookbackDays ?? DEFAULT_LOOKBACK_DAYS;\n    const window = getWindow(options, lookbackDays);\n\n    const phases = selectActivePhases<MailgunResource, MailgunPhase>(\n      (r) => r,\n      PHASE_ORDER,\n      this.settings.resources,\n    );\n\n    return paginateChunked<MailgunPhase, string>({\n      phases,\n      cursor,\n      signal,\n      logger: this.logger,\n      fetchPage: async (_phase, _page, _sig) => ({ items: [null], next: null }),\n      writeBatch: async (phase, _items, _page) => {\n        await this.writePhase(storage, phase, window, signal);\n      },\n    });\n  }\n}\n","import { MailgunConnector } from './mailgun';\n\nexport {\n  MailgunConnector,\n  configFields,\n  doc,\n  getWindow,\n  id,\n  logsItemToEvent,\n  mailgunResources as resources,\n  metricsItemToSample,\n} from './mailgun';\nexport type {\n  MailgunLogsItem,\n  MailgunMetricsItem,\n  MailgunResource,\n  MailgunSettings,\n  MailgunWindow,\n} from './mailgun';\nexport default MailgunConnector;\n"],"mappings":"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","names":["items"]}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@rawdash/connector-mailgun",
+  "version": "0.28.0",
+  "description": "Rawdash connector for Mailgun — syncs daily transactional email metrics (accepted, delivered, failed, opens, clicks, unsubscribes, complaints) and recent delivery events via the Mailgun Analytics API",
+  "license": "Apache-2.0",
+  "type": "module",
+  "sideEffects": false,
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rawdash/rawdash.git",
+    "directory": "packages/connectors/mailgun"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "@rawdash/source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@rawdash/core": "workspace:*",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@rawdash/connector-shared": "workspace:*",
+    "@rawdash/connector-test-utils": "workspace:*",
+    "fast-check": "^4.8.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.7.2",
+    "vitest": "^4.1.4"
+  }
+}