@rawdash/connector-mixpanel 0.0.1

package/README.md

@@ -0,0 +1,182 @@
+# @rawdash/connector-mixpanel
+
+Rawdash connector for [Mixpanel](https://mixpanel.com) — syncs daily/weekly/monthly active users, per-event volume, declared funnel conversion data, and cohort retention into the six-shape storage model via the [Mixpanel Query API](https://developer.mixpanel.com/reference/query-api).
+
+## Auth setup
+
+The connector authenticates with a Mixpanel **service account** (recommended for server-to-server use). Service account credentials are project-scoped and survive user offboarding.
+
+1. Open your Mixpanel project and navigate to **Settings → Project Settings → Service Accounts** (Mixpanel docs: [Creating a Service Account](https://developer.mixpanel.com/reference/service-accounts)).
+2. Click **Add Service Account**.
+3. Give it a descriptive name (e.g. `rawdash-reader`).
+4. Choose a role of **Consumer** (read-only is sufficient for query access).
+5. Set an expiration (a long-lived secret is fine for server use; pick a date that fits your rotation policy).
+6. Click **Create**. Mixpanel will display the **Username** and **Secret** once; copy both before closing the dialog.
+7. Store the secret in your secrets manager under (for example) `MIXPANEL_SECRET`. The username is not sensitive and can live in plain configuration.
+8. Note your **Project ID** under **Settings → Project Settings → Overview**.
+
+The connector calls the API with HTTP Basic auth (`Authorization: Basic base64(<username>:<secret>)`) and includes `project_id=<id>` on every request, which is the contract Mixpanel requires for service-account access.
+
+## Configuration
+
+```ts
+import { secret } from '@rawdash/core';
+
+const mixpanel = {
+  name: 'mixpanel',
+  connectorId: 'mixpanel',
+  config: {
+    projectId: '1234567',
+    username: 'rawdash-reader.abcdef.mp-service-account',
+    secret: secret('MIXPANEL_SECRET'),
+    region: 'us', // 'us' (default) or 'eu' for EU residency
+    events: ['Signed Up', 'Purchase'],
+    funnels: [
+      { id: 42, name: 'Activation' },
+      { id: 99, name: 'Checkout' },
+    ],
+    retentionEvent: 'Signed Up',
+    activeUserEvent: 'Signed Up',
+    lookbackDays: 90,
+  },
+};
+```
+
+Register the connector class when mounting the engine:
+
+```ts
+import { MixpanelConnector } from '@rawdash/connector-mixpanel';
+import { mountEngine } from '@rawdash/hono';
+
+mountEngine(config, {
+  connectorRegistry: { mixpanel: MixpanelConnector },
+});
+```
+
+Then wire it into `defineConfig`:
+
+```ts
+import { defineConfig, defineDashboard, defineMetric } from '@rawdash/core';
+
+export default defineConfig({
+  connectors: [mixpanel],
+  dashboards: {
+    product: defineDashboard({
+      widgets: {
+        dau: {
+          kind: 'stat',
+          title: 'DAU',
+          metric: defineMetric({
+            connector: mixpanel,
+            shape: 'metric',
+            name: 'mixpanel_dau',
+            field: 'value',
+            fn: 'latest',
+          }),
+        },
+        dau_trend: {
+          kind: 'timeseries',
+          title: 'DAU over time',
+          window: '30d',
+          metric: defineMetric({
+            connector: mixpanel,
+            shape: 'metric',
+            name: 'mixpanel_dau',
+            field: 'value',
+            fn: 'sum',
+            window: '30d',
+            groupBy: { field: 'ts', granularity: 'day' },
+          }),
+        },
+        signups_per_day: {
+          kind: 'timeseries',
+          title: 'Sign-ups per day',
+          window: '30d',
+          metric: defineMetric({
+            connector: mixpanel,
+            shape: 'metric',
+            name: 'mixpanel_events_per_day',
+            field: 'count',
+            fn: 'sum',
+            window: '30d',
+            filter: [{ field: 'event', op: 'eq', value: 'Signed Up' }],
+            groupBy: { field: 'ts', granularity: 'day' },
+          }),
+        },
+        events_distribution: {
+          kind: 'distribution',
+          title: 'Top events (last 30d)',
+          metric: defineMetric({
+            connector: mixpanel,
+            shape: 'metric',
+            name: 'mixpanel_events_per_day',
+            field: 'count',
+            fn: 'sum',
+            window: '30d',
+            groupBy: { field: 'event' },
+          }),
+        },
+      },
+    }),
+  },
+});
+```
+
+## Configuration reference
+
+| Field             | Required | Type              | Default | Notes                                                                                                                                                         |
+| ----------------- | -------- | ----------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `projectId`       | yes      | `string` (digits) | —       | Mixpanel numeric project ID.                                                                                                                                  |
+| `username`        | yes      | `string`          | —       | Service-account username.                                                                                                                                     |
+| `secret`          | yes      | `Secret`          | —       | Service-account secret. Use `secret('MIXPANEL_SECRET')`.                                                                                                      |
+| `region`          | no       | `'us' \| 'eu'`    | `'us'`  | Switches the API host between `mixpanel.com` and `eu.mixpanel.com`.                                                                                           |
+| `events`          | no       | `string[]`        | —       | Event names to fetch per-day volume + unique-user counts for. Skips the phase when empty/unset.                                                               |
+| `funnels`         | no       | `{ id, name? }[]` | —       | Mixpanel funnel IDs to track. Each entry produces daily funnel-step samples. Skips when empty/unset.                                                          |
+| `retentionEvent`  | no       | `string`          | —       | Event used for the retention cohort phase. Skips when unset.                                                                                                  |
+| `activeUserEvent` | no       | `string`          | —       | Event used for the DAU/WAU/MAU `unique`-type segmentation queries. Defaults to the first `events` entry. Both DAU/WAU/MAU phases skip when no event resolves. |
+| `lookbackDays`    | no       | `number`          | `90`    | Window in days fetched on a full sync. Incremental syncs (`mode: 'latest'`) refetch the trailing 3 days regardless.                                           |
+
+## Data model
+
+All resources are stored as **metric samples** (`shape: 'metric'`). The `ts` field is the bucket date in Unix milliseconds. Mixpanel returns aggregated data, so the connector writes pre-aggregated metric rows — no event-stream backfill.
+
+| Metric name               | Bucket             | `value`                 | Attributes                                                                                      |
+| ------------------------- | ------------------ | ----------------------- | ----------------------------------------------------------------------------------------------- |
+| `mixpanel_dau`            | day                | unique users that day   | `unit='day'`, `event`                                                                           |
+| `mixpanel_wau`            | week               | unique users that week  | `unit='week'`, `event`                                                                          |
+| `mixpanel_mau`            | month              | unique users that month | `unit='month'`, `event`                                                                         |
+| `mixpanel_events_per_day` | day                | total event count       | `event`, `count`, `uniqueUsers`                                                                 |
+| `mixpanel_funnel_results` | day, step          | users at the step       | `funnelId`, `funnelName?`, `step`, `stepLabel`, `users`, `conversionRate`, `stepConversionRate` |
+| `mixpanel_retention`      | cohort day, period | retained users          | `event`, `period` (days since cohort), `cohortSize`, `retentionRate`                            |
+
+## Sync behaviour
+
+- **Backfill** (`mode: 'full'`): fetches the rolling `lookbackDays` window (default 90 days) for every configured resource.
+- **Incremental** (`mode: 'latest'`): refetches the trailing 3 days for every configured resource. Mixpanel can re-attribute late-arriving events, so a small overlap keeps the metrics accurate without re-syncing the full backfill.
+- **Idempotency**: each phase writes via a single `storage.metrics(samples, { names: [<metric>] })` call, which replaces all prior samples for that metric. Re-running the sync against the same window converges on the same storage state.
+- **Resumable**: the cursor captures `(phase, dateRange)` so an interrupted sync resumes at the next phase using the originally-computed window.
+- **Resource allowlist**: `options.resources` filters which phases run. A resource not in the allowlist is skipped entirely, including its API calls.
+- **Rate limits**: Mixpanel's Query API quota is 60 queries/hour per project (default). The connector batches each event/funnel into one query and reuses the result across active-user phases where possible. 429 responses fall through to the shared HTTP client's retry-with-backoff path.
+
+## Schemas
+
+`MixpanelConnector.schemas` exposes the Zod schema for each `request()` resource — used by the cloud shape-drift pipeline to populate `connector_baselines` and by the package's property tests.
+
+| Resource              | Represents                                                                          |
+| --------------------- | ----------------------------------------------------------------------------------- |
+| `dau` / `wau` / `mau` | `GET /api/2.0/segmentation?type=unique&unit={day,week,month}` per active-user event |
+| `events_per_day`      | `GET /api/2.0/segmentation?type={general,unique}&unit=day` per configured event     |
+| `funnel_results`      | `GET /api/2.0/funnels?funnel_id=…&unit=day` per configured funnel                   |
+| `retention`           | `GET /api/2.0/retention?retention_type=birth&unit=day&born_event=…&event=…`         |
+
+## Aggregates
+
+No aggregates yet — `count` / `latest` widgets fall back to evaluating against synced storage rows. Mixpanel's Query API doesn't expose a cheaper single-scalar endpoint than the segmentation/funnel queries the connector already runs, so a future `aggregate()` implementation wouldn't materially shorten the round-trip. The metric rows the connector writes are already daily aggregates, which keeps local `count` / `latest` cheap.
+
+## Property tests
+
+Resources in this connector have fast-check property tests under `src/property.test.ts` that:
+
+1. Generate N≥50 synthetic API payloads from a Zod schema mirroring the upstream API response.
+2. Pipe them through `connector.sync()` against an `InMemoryStorage` instance.
+3. Assert universal invariants (finite timestamps, no `undefined` leaking, no thrown errors) plus per-resource cardinality (one sample per unique date, one funnel sample per `(date, step)`, one retention sample per `(cohort, period)`).

package/dist/index.d.ts

@@ -0,0 +1,177 @@
+import { BaseConnector, ConnectorContext, SyncOptions, StorageHandle, SyncResult, MetricSample } from '@rawdash/core';
+import { z } from 'zod';
+
+declare const configFields: z.ZodObject<{
+    username: z.ZodString;
+    secret: z.ZodObject<{
+        $secret: z.ZodString;
+    }, z.core.$strip>;
+    projectId: z.ZodString;
+    region: z.ZodOptional<z.ZodEnum<{
+        us: "us";
+        eu: "eu";
+    }>>;
+    events: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    funnels: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+        name: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    retentionEvent: z.ZodOptional<z.ZodString>;
+    activeUserEvent: z.ZodOptional<z.ZodString>;
+    lookbackDays: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+interface MixpanelFunnelSpec {
+    id: string | number;
+    name?: string;
+}
+interface MixpanelSettings {
+    projectId: string;
+    region?: 'us' | 'eu';
+    events?: readonly string[];
+    funnels?: readonly MixpanelFunnelSpec[];
+    retentionEvent?: string;
+    activeUserEvent?: string;
+    lookbackDays?: number;
+}
+declare const mixpanelCredentials: {
+    username: {
+        description: string;
+        auth: "required";
+    };
+    secret: {
+        description: string;
+        auth: "required";
+    };
+};
+type MixpanelCredentials = typeof mixpanelCredentials;
+declare const PHASE_ORDER: readonly ["dau", "wau", "mau", "events_per_day", "funnel_results", "retention"];
+type MixpanelPhase = (typeof PHASE_ORDER)[number];
+type MixpanelResource = MixpanelPhase;
+interface MixpanelDateRange {
+    from: string;
+    to: string;
+}
+declare function getDateRange(options: SyncOptions, lookbackDays: number, now?: number): MixpanelDateRange;
+interface SegmentationResponse {
+    legend_size?: number;
+    data: {
+        series: string[];
+        values: Record<string, Record<string, number>>;
+    };
+}
+interface FunnelStep {
+    step_label?: string;
+    goal?: string;
+    event?: string;
+    count: number;
+    overall_conv_ratio?: number;
+    step_conv_ratio?: number;
+}
+interface FunnelDateBucket {
+    steps: FunnelStep[];
+    analysis?: {
+        completion?: number;
+        starting_amount?: number;
+        steps?: number;
+        worst?: number;
+    };
+}
+interface FunnelResponse {
+    meta?: {
+        dates?: string[];
+    };
+    data: Record<string, FunnelDateBucket>;
+}
+interface RetentionCohort {
+    first: number;
+    counts: number[];
+}
+type RetentionResponse = Record<string, RetentionCohort>;
+declare function buildActiveUserSamples(response: SegmentationResponse, metricName: string, unit: 'day' | 'week' | 'month', event: string): MetricSample[];
+declare function buildEventsPerDaySamples(generalResponse: SegmentationResponse, uniqueResponse: SegmentationResponse, event: string): MetricSample[];
+declare function buildFunnelSamples(response: FunnelResponse, funnel: MixpanelFunnelSpec): MetricSample[];
+declare function buildRetentionSamples(response: RetentionResponse, event: string): MetricSample[];
+declare class MixpanelConnector extends BaseConnector<MixpanelSettings, MixpanelCredentials> {
+    static readonly id = "mixpanel";
+    static readonly schemas: {
+        readonly dau: z.ZodObject<{
+            legend_size: z.ZodOptional<z.ZodNumber>;
+            data: z.ZodObject<{
+                series: z.ZodArray<z.ZodString>;
+                values: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodNumber>>;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
+        readonly wau: z.ZodObject<{
+            legend_size: z.ZodOptional<z.ZodNumber>;
+            data: z.ZodObject<{
+                series: z.ZodArray<z.ZodString>;
+                values: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodNumber>>;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
+        readonly mau: z.ZodObject<{
+            legend_size: z.ZodOptional<z.ZodNumber>;
+            data: z.ZodObject<{
+                series: z.ZodArray<z.ZodString>;
+                values: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodNumber>>;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
+        readonly events_per_day: z.ZodObject<{
+            legend_size: z.ZodOptional<z.ZodNumber>;
+            data: z.ZodObject<{
+                series: z.ZodArray<z.ZodString>;
+                values: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodNumber>>;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
+        readonly funnel_results: z.ZodObject<{
+            meta: z.ZodOptional<z.ZodObject<{
+                dates: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strip>>;
+            data: z.ZodRecord<z.ZodString, z.ZodObject<{
+                steps: z.ZodArray<z.ZodObject<{
+                    step_label: z.ZodOptional<z.ZodString>;
+                    goal: z.ZodOptional<z.ZodString>;
+                    event: z.ZodOptional<z.ZodString>;
+                    count: z.ZodNumber;
+                    overall_conv_ratio: z.ZodOptional<z.ZodNumber>;
+                    step_conv_ratio: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strip>>;
+                analysis: z.ZodOptional<z.ZodObject<{
+                    completion: z.ZodOptional<z.ZodNumber>;
+                    starting_amount: z.ZodOptional<z.ZodNumber>;
+                    steps: z.ZodOptional<z.ZodNumber>;
+                    worst: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+        readonly retention: z.ZodRecord<z.ZodString, z.ZodObject<{
+            first: z.ZodNumber;
+            counts: z.ZodArray<z.ZodNumber>;
+        }, z.core.$strip>>;
+    };
+    static create(input: unknown, ctx?: ConnectorContext): MixpanelConnector;
+    readonly id = "mixpanel";
+    readonly credentials: {
+        username: {
+            description: string;
+            auth: "required";
+        };
+        secret: {
+            description: string;
+            auth: "required";
+        };
+    };
+    private get apiBase();
+    private authHeaders;
+    private buildQuery;
+    private getSegmentation;
+    private getFunnel;
+    private getRetention;
+    private resolveActiveUserEvent;
+    private runActiveUserPhase;
+    private runEventsPerDayPhase;
+    private runFunnelPhase;
+    private runRetentionPhase;
+    sync(options: SyncOptions, storage: StorageHandle, signal?: AbortSignal): Promise<SyncResult>;
+}
+
+export { MixpanelConnector, type MixpanelFunnelSpec, type MixpanelPhase, type MixpanelResource, type MixpanelSettings, buildActiveUserSamples, buildEventsPerDaySamples, buildFunnelSamples, buildRetentionSamples, configFields, MixpanelConnector as default, getDateRange };

package/dist/index.js

@@ -0,0 +1,573 @@
+// ../../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)`;
+}
+
+// src/mixpanel.ts
+import {
+  BaseConnector,
+  defineConfigFields
+} from "@rawdash/core";
+import { z } from "zod";
+var funnelSpec = z.object({
+  id: z.union([z.string().min(1), z.number().int().positive()]).meta({
+    label: "Funnel ID",
+    description: "Numeric funnel ID (as shown in Mixpanel report URLs)."
+  }),
+  name: z.string().min(1).optional().meta({
+    label: "Funnel display name",
+    description: "Optional label attached to each metric sample."
+  })
+});
+var configFields = defineConfigFields(
+  z.object({
+    username: z.string().min(1).meta({
+      label: "Service account username",
+      description: "Mixpanel service account username (e.g. `rawdash-reader.abcdef.mp-service-account`). Create one at Project settings \u2192 Service Accounts."
+    }),
+    secret: z.object({ $secret: z.string() }).meta({
+      label: "Service account secret",
+      description: "Mixpanel service account secret, paired with the username via HTTP Basic auth.",
+      secret: true
+    }),
+    projectId: z.string().trim().regex(/^\d+$/, "projectId must be a Mixpanel numeric project ID").meta({
+      label: "Project ID",
+      description: "Numeric Mixpanel project ID. Found under Project settings \u2192 Overview.",
+      placeholder: "1234567"
+    }),
+    region: z.enum(["us", "eu"]).optional().meta({
+      label: "Data residency region",
+      description: "Mixpanel API region. Defaults to `us`."
+    }),
+    events: z.array(z.string().min(1)).optional().meta({
+      label: "Events to track",
+      description: "Event names to fetch per-day volume and unique-user counts for. Each event runs one segmentation query per sync per type."
+    }),
+    funnels: z.array(funnelSpec).optional().meta({
+      label: "Funnels",
+      description: "Mixpanel funnels to sync per-day conversion data for. Add one entry per funnel ID."
+    }),
+    retentionEvent: z.string().min(1).optional().meta({
+      label: "Retention event",
+      description: "Event name to use for cohort retention. When set, the connector runs a single retention query per sync."
+    }),
+    activeUserEvent: z.string().min(1).optional().meta({
+      label: "Active-user event",
+      description: "Event name used for DAU/WAU/MAU unique-user counts. Defaults to the first entry in `events` when unset."
+    }),
+    lookbackDays: z.number().int().positive().optional().meta({
+      label: "Backfill window (days)",
+      description: "How many days to fetch on a full sync. Defaults to 90.",
+      placeholder: "90"
+    })
+  })
+);
+var mixpanelCredentials = {
+  username: {
+    description: "Mixpanel service account username",
+    auth: "required"
+  },
+  secret: {
+    description: "Mixpanel service account secret",
+    auth: "required"
+  }
+};
+var DEFAULT_LOOKBACK_DAYS = 90;
+var INCREMENTAL_LOOKBACK_DAYS = 3;
+var MS_PER_DAY = 864e5;
+var PHASE_ORDER = [
+  "dau",
+  "wau",
+  "mau",
+  "events_per_day",
+  "funnel_results",
+  "retention"
+];
+var METRIC_NAMES = {
+  dau: "mixpanel_dau",
+  wau: "mixpanel_wau",
+  mau: "mixpanel_mau",
+  events_per_day: "mixpanel_events_per_day",
+  funnel_results: "mixpanel_funnel_results",
+  retention: "mixpanel_retention"
+};
+var PHASE_UNIT = {
+  dau: "day",
+  wau: "week",
+  mau: "month"
+};
+var DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
+function isDateString(value) {
+  return typeof value === "string" && DATE_RE.test(value);
+}
+function isDateRange(value) {
+  if (typeof value !== "object" || value === null) {
+    return false;
+  }
+  const v = value;
+  return isDateString(v.from) && isDateString(v.to);
+}
+function isMixpanelSyncCursor(value) {
+  if (typeof value !== "object" || value === null) {
+    return false;
+  }
+  const v = value;
+  if (typeof v.phase !== "string") {
+    return false;
+  }
+  if (!PHASE_ORDER.includes(v.phase)) {
+    return false;
+  }
+  return isDateRange(v.dateRange);
+}
+function pad2(n) {
+  return String(n).padStart(2, "0");
+}
+function toMixpanelDate(ms) {
+  const d = new Date(ms);
+  return `${d.getUTCFullYear()}-${pad2(d.getUTCMonth() + 1)}-${pad2(d.getUTCDate())}`;
+}
+function mixpanelDateToMs(date) {
+  const m = /^(\d{4})-(\d{2})-(\d{2})$/.exec(date);
+  if (!m) {
+    return NaN;
+  }
+  return Date.UTC(Number(m[1]), Number(m[2]) - 1, Number(m[3]));
+}
+function getDateRange(options, lookbackDays, now = Date.now()) {
+  const to = toMixpanelDate(now);
+  if (options.mode === "latest") {
+    return {
+      from: toMixpanelDate(now - (INCREMENTAL_LOOKBACK_DAYS - 1) * MS_PER_DAY),
+      to
+    };
+  }
+  if (options.since !== void 0) {
+    const sinceMs = Date.parse(options.since);
+    if (Number.isFinite(sinceMs)) {
+      const elapsed = Math.max(1, Math.ceil((now - sinceMs) / MS_PER_DAY));
+      const days = Math.min(elapsed, lookbackDays);
+      return { from: toMixpanelDate(now - (days - 1) * MS_PER_DAY), to };
+    }
+  }
+  return {
+    from: toMixpanelDate(now - (lookbackDays - 1) * MS_PER_DAY),
+    to
+  };
+}
+var dateString = z.string().regex(DATE_RE);
+var finiteNumber = z.number();
+var segmentationSchema = z.object({
+  legend_size: z.number().optional(),
+  data: z.object({
+    series: z.array(dateString),
+    values: z.record(z.string(), z.record(dateString, finiteNumber))
+  })
+});
+var funnelStepSchema = z.object({
+  step_label: z.string().optional(),
+  goal: z.string().optional(),
+  event: z.string().optional(),
+  count: finiteNumber,
+  overall_conv_ratio: finiteNumber.optional(),
+  step_conv_ratio: finiteNumber.optional()
+});
+var funnelSchema = z.object({
+  meta: z.object({ dates: z.array(dateString).optional() }).optional(),
+  data: z.record(
+    dateString,
+    z.object({
+      steps: z.array(funnelStepSchema),
+      analysis: z.object({
+        completion: finiteNumber.optional(),
+        starting_amount: finiteNumber.optional(),
+        steps: finiteNumber.optional(),
+        worst: finiteNumber.optional()
+      }).optional()
+    })
+  )
+});
+var retentionSchema = z.record(
+  dateString,
+  z.object({
+    first: finiteNumber,
+    counts: z.array(finiteNumber)
+  })
+);
+function buildActiveUserSamples(response, metricName, unit, event) {
+  const samples = [];
+  const seriesByEvent = response.data.values;
+  const dateTotals = /* @__PURE__ */ new Map();
+  for (const eventValues of Object.values(seriesByEvent)) {
+    for (const [date, value] of Object.entries(eventValues)) {
+      const ts = mixpanelDateToMs(date);
+      if (!Number.isFinite(ts)) {
+        continue;
+      }
+      const prior = dateTotals.get(date) ?? 0;
+      dateTotals.set(date, prior + value);
+    }
+  }
+  for (const [date, value] of dateTotals) {
+    const ts = mixpanelDateToMs(date);
+    samples.push({
+      name: metricName,
+      ts,
+      value,
+      attributes: { unit, event }
+    });
+  }
+  return samples;
+}
+function buildEventsPerDaySamples(generalResponse, uniqueResponse, event) {
+  const samples = [];
+  const generalValues = generalResponse.data.values[event] ?? {};
+  const uniqueValues = uniqueResponse.data.values[event] ?? {};
+  const allDates = /* @__PURE__ */ new Set([
+    ...Object.keys(generalValues),
+    ...Object.keys(uniqueValues)
+  ]);
+  for (const date of allDates) {
+    const ts = mixpanelDateToMs(date);
+    if (!Number.isFinite(ts)) {
+      continue;
+    }
+    const count = generalValues[date] ?? 0;
+    const uniqueUsers = uniqueValues[date] ?? 0;
+    samples.push({
+      name: METRIC_NAMES.events_per_day,
+      ts,
+      value: count,
+      attributes: {
+        event,
+        count,
+        uniqueUsers
+      }
+    });
+  }
+  return samples;
+}
+function buildFunnelSamples(response, funnel) {
+  const samples = [];
+  const funnelIdAttr = typeof funnel.id === "number" ? funnel.id : String(funnel.id);
+  for (const [date, bucket] of Object.entries(response.data)) {
+    const ts = mixpanelDateToMs(date);
+    if (!Number.isFinite(ts)) {
+      continue;
+    }
+    bucket.steps.forEach((step, stepIdx) => {
+      const attributes = {
+        funnelId: funnelIdAttr,
+        step: stepIdx,
+        stepLabel: step.step_label ?? step.event ?? `step_${stepIdx}`,
+        users: step.count,
+        conversionRate: step.overall_conv_ratio ?? null,
+        stepConversionRate: step.step_conv_ratio ?? null
+      };
+      if (funnel.name !== void 0) {
+        attributes["funnelName"] = funnel.name;
+      }
+      samples.push({
+        name: METRIC_NAMES.funnel_results,
+        ts,
+        value: step.count,
+        attributes
+      });
+    });
+  }
+  return samples;
+}
+function buildRetentionSamples(response, event) {
+  const samples = [];
+  for (const [cohortDate, cohort] of Object.entries(response)) {
+    const ts = mixpanelDateToMs(cohortDate);
+    if (!Number.isFinite(ts)) {
+      continue;
+    }
+    cohort.counts.forEach((retained, period) => {
+      samples.push({
+        name: METRIC_NAMES.retention,
+        ts,
+        value: retained,
+        attributes: {
+          event,
+          period,
+          cohortSize: cohort.first,
+          retentionRate: cohort.first > 0 ? retained / cohort.first : 0
+        }
+      });
+    });
+  }
+  return samples;
+}
+function encodeBasicAuth(username, secret) {
+  const raw = `${username}:${secret}`;
+  if (typeof btoa === "function") {
+    return `Basic ${btoa(raw)}`;
+  }
+  const bufferCtor = globalThis.Buffer;
+  if (bufferCtor) {
+    return `Basic ${bufferCtor.from(raw).toString("base64")}`;
+  }
+  throw new Error("No base64 encoder available in this runtime");
+}
+function regionHost(region) {
+  return region === "eu" ? "eu.mixpanel.com" : "mixpanel.com";
+}
+var MixpanelConnector = class _MixpanelConnector extends BaseConnector {
+  static id = "mixpanel";
+  static schemas = {
+    dau: segmentationSchema,
+    wau: segmentationSchema,
+    mau: segmentationSchema,
+    events_per_day: segmentationSchema,
+    funnel_results: funnelSchema,
+    retention: retentionSchema
+  };
+  static create(input, ctx) {
+    const parsed = configFields.parse(input);
+    return new _MixpanelConnector(
+      {
+        projectId: parsed.projectId,
+        region: parsed.region,
+        events: parsed.events,
+        funnels: parsed.funnels,
+        retentionEvent: parsed.retentionEvent,
+        activeUserEvent: parsed.activeUserEvent,
+        lookbackDays: parsed.lookbackDays
+      },
+      {
+        username: parsed.username,
+        secret: parsed.secret
+      },
+      ctx
+    );
+  }
+  id = "mixpanel";
+  credentials = mixpanelCredentials;
+  get apiBase() {
+    return `https://${regionHost(this.settings.region)}/api/2.0`;
+  }
+  authHeaders() {
+    return {
+      Authorization: encodeBasicAuth(this.creds.username, this.creds.secret),
+      Accept: "application/json",
+      "User-Agent": connectorUserAgent("mixpanel")
+    };
+  }
+  buildQuery(extra) {
+    const params = new URLSearchParams({
+      project_id: this.settings.projectId,
+      ...extra
+    });
+    return params.toString();
+  }
+  async getSegmentation(resource, params, signal) {
+    const url = `${this.apiBase}/segmentation?${this.buildQuery(params)}`;
+    const res = await this.get(url, {
+      resource,
+      headers: this.authHeaders(),
+      signal
+    });
+    return segmentationSchema.parse(res.body);
+  }
+  async getFunnel(funnelId, range, signal) {
+    const url = `${this.apiBase}/funnels?${this.buildQuery({
+      funnel_id: String(funnelId),
+      from_date: range.from,
+      to_date: range.to,
+      unit: "day"
+    })}`;
+    const res = await this.get(url, {
+      resource: "funnel_results",
+      headers: this.authHeaders(),
+      signal
+    });
+    return funnelSchema.parse(res.body);
+  }
+  async getRetention(event, range, signal) {
+    const url = `${this.apiBase}/retention?${this.buildQuery({
+      from_date: range.from,
+      to_date: range.to,
+      retention_type: "birth",
+      unit: "day",
+      born_event: event,
+      event
+    })}`;
+    const res = await this.get(url, {
+      resource: "retention",
+      headers: this.authHeaders(),
+      signal
+    });
+    return retentionSchema.parse(res.body);
+  }
+  resolveActiveUserEvent() {
+    if (this.settings.activeUserEvent !== void 0) {
+      return this.settings.activeUserEvent;
+    }
+    const first = this.settings.events?.[0];
+    return first;
+  }
+  async runActiveUserPhase(phase, range, storage, signal) {
+    const metricName = METRIC_NAMES[phase];
+    const event = this.resolveActiveUserEvent();
+    if (event === void 0) {
+      await storage.metrics([], { names: [metricName] });
+      return;
+    }
+    const response = await this.getSegmentation(
+      phase,
+      {
+        event,
+        from_date: range.from,
+        to_date: range.to,
+        unit: PHASE_UNIT[phase],
+        type: "unique"
+      },
+      signal
+    );
+    const samples = buildActiveUserSamples(
+      response,
+      metricName,
+      PHASE_UNIT[phase],
+      event
+    );
+    await storage.metrics(samples, { names: [metricName] });
+  }
+  async runEventsPerDayPhase(range, storage, signal) {
+    const metricName = METRIC_NAMES.events_per_day;
+    const events = this.settings.events ?? [];
+    if (events.length === 0) {
+      await storage.metrics([], { names: [metricName] });
+      return;
+    }
+    const samples = [];
+    for (const event of events) {
+      if (signal?.aborted) {
+        throw new Error("aborted");
+      }
+      const [generalResponse, uniqueResponse] = await Promise.all([
+        this.getSegmentation(
+          "events_per_day",
+          {
+            event,
+            from_date: range.from,
+            to_date: range.to,
+            unit: "day",
+            type: "general"
+          },
+          signal
+        ),
+        this.getSegmentation(
+          "events_per_day",
+          {
+            event,
+            from_date: range.from,
+            to_date: range.to,
+            unit: "day",
+            type: "unique"
+          },
+          signal
+        )
+      ]);
+      samples.push(
+        ...buildEventsPerDaySamples(generalResponse, uniqueResponse, event)
+      );
+    }
+    await storage.metrics(samples, { names: [metricName] });
+  }
+  async runFunnelPhase(range, storage, signal) {
+    const metricName = METRIC_NAMES.funnel_results;
+    const funnels = this.settings.funnels ?? [];
+    if (funnels.length === 0) {
+      await storage.metrics([], { names: [metricName] });
+      return;
+    }
+    const samples = [];
+    for (const funnel of funnels) {
+      if (signal?.aborted) {
+        throw new Error("aborted");
+      }
+      const response = await this.getFunnel(funnel.id, range, signal);
+      samples.push(...buildFunnelSamples(response, funnel));
+    }
+    await storage.metrics(samples, { names: [metricName] });
+  }
+  async runRetentionPhase(range, storage, signal) {
+    const metricName = METRIC_NAMES.retention;
+    const event = this.settings.retentionEvent;
+    if (event === void 0) {
+      await storage.metrics([], { names: [metricName] });
+      return;
+    }
+    const response = await this.getRetention(event, range, signal);
+    const samples = buildRetentionSamples(response, event);
+    await storage.metrics(samples, { names: [metricName] });
+  }
+  async sync(options, storage, signal) {
+    const lookbackDays = this.settings.lookbackDays ?? DEFAULT_LOOKBACK_DAYS;
+    const cursor = isMixpanelSyncCursor(options.cursor) ? options.cursor : void 0;
+    const dateRange = cursor?.dateRange ?? getDateRange(options, lookbackDays);
+    const resumeIdx = cursor ? PHASE_ORDER.indexOf(cursor.phase) : -1;
+    const startIdx = resumeIdx >= 0 ? resumeIdx : 0;
+    const requested = options.resources;
+    for (let i = startIdx; i < PHASE_ORDER.length; i++) {
+      const phase = PHASE_ORDER[i];
+      if (signal?.aborted) {
+        return { done: false, cursor: { phase, dateRange } };
+      }
+      if (requested && requested.size > 0 && !requested.has(phase)) {
+        continue;
+      }
+      const phaseStart = Date.now();
+      try {
+        if (phase === "dau" || phase === "wau" || phase === "mau") {
+          await this.runActiveUserPhase(phase, dateRange, storage, signal);
+        } else if (phase === "events_per_day") {
+          await this.runEventsPerDayPhase(dateRange, storage, signal);
+        } else if (phase === "funnel_results") {
+          await this.runFunnelPhase(dateRange, storage, signal);
+        } else {
+          await this.runRetentionPhase(dateRange, storage, signal);
+        }
+      } catch (err) {
+        if (signal?.aborted || err instanceof Error && err.name === "AbortError") {
+          return { done: false, cursor: { phase, dateRange } };
+        }
+        this.logger.warn("fetch page failed", {
+          resource: phase,
+          page: 1,
+          error: err instanceof Error ? err.message : String(err)
+        });
+        return {
+          done: false,
+          cursor: { phase, dateRange },
+          transientError: err
+        };
+      }
+      this.logger.info("resource done", {
+        resource: phase,
+        pages: 1,
+        items: 0,
+        duration_ms: Date.now() - phaseStart
+      });
+    }
+    return { done: true };
+  }
+};
+
+// src/index.ts
+var index_default = MixpanelConnector;
+export {
+  MixpanelConnector,
+  buildActiveUserSamples,
+  buildEventsPerDaySamples,
+  buildFunnelSamples,
+  buildRetentionSamples,
+  configFields,
+  index_default as default,
+  getDateRange
+};
+//# 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/sanitize.ts","../../../connector-shared/src/epoch.ts","../../../connector-shared/src/pagination.ts","../../../connector-shared/src/logger.ts","../src/mixpanel.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(res: Response, parseJson: boolean): Promise<unknown> {\n  if (res.status === 204 || res.status === 205) {\n    return null;\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\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);\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 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 } from '@rawdash/connector-shared';\nimport {\n  BaseConnector,\n  type ConnectorContext,\n  type CredentialsSchema,\n  type JSONValue,\n  type MetricSample,\n  type StorageHandle,\n  type SyncOptions,\n  type SyncResult,\n  defineConfigFields,\n} from '@rawdash/core';\nimport { z } from 'zod';\n\n// ---------------------------------------------------------------------------\n// Config\n// ---------------------------------------------------------------------------\n\nconst funnelSpec = z.object({\n  id: z.union([z.string().min(1), z.number().int().positive()]).meta({\n    label: 'Funnel ID',\n    description: 'Numeric funnel ID (as shown in Mixpanel report URLs).',\n  }),\n  name: z.string().min(1).optional().meta({\n    label: 'Funnel display name',\n    description: 'Optional label attached to each metric sample.',\n  }),\n});\n\nexport const configFields = defineConfigFields(\n  z.object({\n    username: z.string().min(1).meta({\n      label: 'Service account username',\n      description:\n        'Mixpanel service account username (e.g. `rawdash-reader.abcdef.mp-service-account`). Create one at Project settings → Service Accounts.',\n    }),\n    secret: z.object({ $secret: z.string() }).meta({\n      label: 'Service account secret',\n      description:\n        'Mixpanel service account secret, paired with the username via HTTP Basic auth.',\n      secret: true,\n    }),\n    projectId: z\n      .string()\n      .trim()\n      .regex(/^\\d+$/, 'projectId must be a Mixpanel numeric project ID')\n      .meta({\n        label: 'Project ID',\n        description:\n          'Numeric Mixpanel project ID. Found under Project settings → Overview.',\n        placeholder: '1234567',\n      }),\n    region: z.enum(['us', 'eu']).optional().meta({\n      label: 'Data residency region',\n      description: 'Mixpanel API region. Defaults to `us`.',\n    }),\n    events: z.array(z.string().min(1)).optional().meta({\n      label: 'Events to track',\n      description:\n        'Event names to fetch per-day volume and unique-user counts for. Each event runs one segmentation query per sync per type.',\n    }),\n    funnels: z.array(funnelSpec).optional().meta({\n      label: 'Funnels',\n      description:\n        'Mixpanel funnels to sync per-day conversion data for. Add one entry per funnel ID.',\n    }),\n    retentionEvent: z.string().min(1).optional().meta({\n      label: 'Retention event',\n      description:\n        'Event name to use for cohort retention. When set, the connector runs a single retention query per sync.',\n    }),\n    activeUserEvent: z.string().min(1).optional().meta({\n      label: 'Active-user event',\n      description:\n        'Event name used for DAU/WAU/MAU unique-user counts. Defaults to the first entry in `events` when unset.',\n    }),\n    lookbackDays: z.number().int().positive().optional().meta({\n      label: 'Backfill window (days)',\n      description: 'How many days to fetch on a full sync. Defaults to 90.',\n      placeholder: '90',\n    }),\n  }),\n);\n\n// ---------------------------------------------------------------------------\n// Settings / credentials\n// ---------------------------------------------------------------------------\n\nexport interface MixpanelFunnelSpec {\n  id: string | number;\n  name?: string;\n}\n\nexport interface MixpanelSettings {\n  projectId: string;\n  region?: 'us' | 'eu';\n  events?: readonly string[];\n  funnels?: readonly MixpanelFunnelSpec[];\n  retentionEvent?: string;\n  activeUserEvent?: string;\n  lookbackDays?: number;\n}\n\nconst mixpanelCredentials = {\n  username: {\n    description: 'Mixpanel service account username',\n    auth: 'required' as const,\n  },\n  secret: {\n    description: 'Mixpanel service account secret',\n    auth: 'required' as const,\n  },\n} satisfies CredentialsSchema;\n\ntype MixpanelCredentials = typeof mixpanelCredentials;\n\n// ---------------------------------------------------------------------------\n// Constants\n// ---------------------------------------------------------------------------\n\nconst DEFAULT_LOOKBACK_DAYS = 90;\nconst INCREMENTAL_LOOKBACK_DAYS = 3;\nconst MS_PER_DAY = 86_400_000;\n\nconst PHASE_ORDER = [\n  'dau',\n  'wau',\n  'mau',\n  'events_per_day',\n  'funnel_results',\n  'retention',\n] as const;\n\nexport type MixpanelPhase = (typeof PHASE_ORDER)[number];\nexport type MixpanelResource = MixpanelPhase;\n\nconst METRIC_NAMES: Record<MixpanelPhase, string> = {\n  dau: 'mixpanel_dau',\n  wau: 'mixpanel_wau',\n  mau: 'mixpanel_mau',\n  events_per_day: 'mixpanel_events_per_day',\n  funnel_results: 'mixpanel_funnel_results',\n  retention: 'mixpanel_retention',\n};\n\nconst PHASE_UNIT: Record<'dau' | 'wau' | 'mau', 'day' | 'week' | 'month'> = {\n  dau: 'day',\n  wau: 'week',\n  mau: 'month',\n};\n\n// ---------------------------------------------------------------------------\n// Cursor + helpers\n// ---------------------------------------------------------------------------\n\ninterface MixpanelDateRange {\n  from: string;\n  to: string;\n}\n\ninterface MixpanelSyncCursor {\n  phase: MixpanelPhase;\n  dateRange: MixpanelDateRange;\n}\n\nconst DATE_RE = /^\\d{4}-\\d{2}-\\d{2}$/;\n\nfunction isDateString(value: unknown): value is string {\n  return typeof value === 'string' && DATE_RE.test(value);\n}\n\nfunction isDateRange(value: unknown): value is MixpanelDateRange {\n  if (typeof value !== 'object' || value === null) {\n    return false;\n  }\n  const v = value as { from?: unknown; to?: unknown };\n  return isDateString(v.from) && isDateString(v.to);\n}\n\nfunction isMixpanelSyncCursor(value: unknown): value is MixpanelSyncCursor {\n  if (typeof value !== 'object' || value === null) {\n    return false;\n  }\n  const v = value as { phase?: unknown; dateRange?: unknown };\n  if (typeof v.phase !== 'string') {\n    return false;\n  }\n  if (!(PHASE_ORDER as readonly string[]).includes(v.phase)) {\n    return false;\n  }\n  return isDateRange(v.dateRange);\n}\n\nfunction pad2(n: number): string {\n  return String(n).padStart(2, '0');\n}\n\nfunction toMixpanelDate(ms: number): string {\n  const d = new Date(ms);\n  return `${d.getUTCFullYear()}-${pad2(d.getUTCMonth() + 1)}-${pad2(d.getUTCDate())}`;\n}\n\nfunction mixpanelDateToMs(date: string): number {\n  const m = /^(\\d{4})-(\\d{2})-(\\d{2})$/.exec(date);\n  if (!m) {\n    return NaN;\n  }\n  return Date.UTC(Number(m[1]), Number(m[2]) - 1, Number(m[3]));\n}\n\nexport function getDateRange(\n  options: SyncOptions,\n  lookbackDays: number,\n  now: number = Date.now(),\n): MixpanelDateRange {\n  const to = toMixpanelDate(now);\n  if (options.mode === 'latest') {\n    return {\n      from: toMixpanelDate(now - (INCREMENTAL_LOOKBACK_DAYS - 1) * MS_PER_DAY),\n      to,\n    };\n  }\n  if (options.since !== undefined) {\n    const sinceMs = Date.parse(options.since);\n    if (Number.isFinite(sinceMs)) {\n      const elapsed = Math.max(1, Math.ceil((now - sinceMs) / MS_PER_DAY));\n      const days = Math.min(elapsed, lookbackDays);\n      return { from: toMixpanelDate(now - (days - 1) * MS_PER_DAY), to };\n    }\n  }\n  return {\n    from: toMixpanelDate(now - (lookbackDays - 1) * MS_PER_DAY),\n    to,\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Mixpanel response shapes (permissive — wire format is JSON, validated by\n// the per-resource Zod schemas below before sample extraction)\n// ---------------------------------------------------------------------------\n\nexport interface SegmentationResponse {\n  legend_size?: number;\n  data: {\n    series: string[];\n    values: Record<string, Record<string, number>>;\n  };\n}\n\nexport interface FunnelStep {\n  step_label?: string;\n  goal?: string;\n  event?: string;\n  count: number;\n  overall_conv_ratio?: number;\n  step_conv_ratio?: number;\n}\n\nexport interface FunnelDateBucket {\n  steps: FunnelStep[];\n  analysis?: {\n    completion?: number;\n    starting_amount?: number;\n    steps?: number;\n    worst?: number;\n  };\n}\n\nexport interface FunnelResponse {\n  meta?: { dates?: string[] };\n  data: Record<string, FunnelDateBucket>;\n}\n\nexport interface RetentionCohort {\n  first: number;\n  counts: number[];\n}\n\nexport type RetentionResponse = Record<string, RetentionCohort>;\n\n// ---------------------------------------------------------------------------\n// Zod schemas — describe each resource's wire shape\n// ---------------------------------------------------------------------------\n\nconst dateString = z.string().regex(DATE_RE);\nconst finiteNumber = z.number();\n\nconst segmentationSchema = z.object({\n  legend_size: z.number().optional(),\n  data: z.object({\n    series: z.array(dateString),\n    values: z.record(z.string(), z.record(dateString, finiteNumber)),\n  }),\n});\n\nconst funnelStepSchema = z.object({\n  step_label: z.string().optional(),\n  goal: z.string().optional(),\n  event: z.string().optional(),\n  count: finiteNumber,\n  overall_conv_ratio: finiteNumber.optional(),\n  step_conv_ratio: finiteNumber.optional(),\n});\n\nconst funnelSchema = z.object({\n  meta: z.object({ dates: z.array(dateString).optional() }).optional(),\n  data: z.record(\n    dateString,\n    z.object({\n      steps: z.array(funnelStepSchema),\n      analysis: z\n        .object({\n          completion: finiteNumber.optional(),\n          starting_amount: finiteNumber.optional(),\n          steps: finiteNumber.optional(),\n          worst: finiteNumber.optional(),\n        })\n        .optional(),\n    }),\n  ),\n});\n\nconst retentionSchema = z.record(\n  dateString,\n  z.object({\n    first: finiteNumber,\n    counts: z.array(finiteNumber),\n  }),\n);\n\n// ---------------------------------------------------------------------------\n// Sample extraction (pure, exported for unit tests)\n// ---------------------------------------------------------------------------\n\nexport function buildActiveUserSamples(\n  response: SegmentationResponse,\n  metricName: string,\n  unit: 'day' | 'week' | 'month',\n  event: string,\n): MetricSample[] {\n  const samples: MetricSample[] = [];\n  const seriesByEvent = response.data.values;\n  // Mixpanel returns values keyed by the queried event name; merge across keys\n  // so a single sample per date is emitted regardless of how many event keys\n  // appear in the response.\n  const dateTotals = new Map<string, number>();\n  for (const eventValues of Object.values(seriesByEvent)) {\n    for (const [date, value] of Object.entries(eventValues)) {\n      const ts = mixpanelDateToMs(date);\n      if (!Number.isFinite(ts)) {\n        continue;\n      }\n      const prior = dateTotals.get(date) ?? 0;\n      dateTotals.set(date, prior + value);\n    }\n  }\n  for (const [date, value] of dateTotals) {\n    const ts = mixpanelDateToMs(date);\n    samples.push({\n      name: metricName,\n      ts,\n      value,\n      attributes: { unit, event },\n    });\n  }\n  return samples;\n}\n\nexport function buildEventsPerDaySamples(\n  generalResponse: SegmentationResponse,\n  uniqueResponse: SegmentationResponse,\n  event: string,\n): MetricSample[] {\n  const samples: MetricSample[] = [];\n  const generalValues = generalResponse.data.values[event] ?? {};\n  const uniqueValues = uniqueResponse.data.values[event] ?? {};\n  const allDates = new Set<string>([\n    ...Object.keys(generalValues),\n    ...Object.keys(uniqueValues),\n  ]);\n  for (const date of allDates) {\n    const ts = mixpanelDateToMs(date);\n    if (!Number.isFinite(ts)) {\n      continue;\n    }\n    const count = generalValues[date] ?? 0;\n    const uniqueUsers = uniqueValues[date] ?? 0;\n    samples.push({\n      name: METRIC_NAMES.events_per_day,\n      ts,\n      value: count,\n      attributes: {\n        event,\n        count,\n        uniqueUsers,\n      },\n    });\n  }\n  return samples;\n}\n\nexport function buildFunnelSamples(\n  response: FunnelResponse,\n  funnel: MixpanelFunnelSpec,\n): MetricSample[] {\n  const samples: MetricSample[] = [];\n  const funnelIdAttr: JSONValue =\n    typeof funnel.id === 'number' ? funnel.id : String(funnel.id);\n  for (const [date, bucket] of Object.entries(response.data)) {\n    const ts = mixpanelDateToMs(date);\n    if (!Number.isFinite(ts)) {\n      continue;\n    }\n    bucket.steps.forEach((step, stepIdx) => {\n      const attributes: Record<string, JSONValue> = {\n        funnelId: funnelIdAttr,\n        step: stepIdx,\n        stepLabel: step.step_label ?? step.event ?? `step_${stepIdx}`,\n        users: step.count,\n        conversionRate: step.overall_conv_ratio ?? null,\n        stepConversionRate: step.step_conv_ratio ?? null,\n      };\n      if (funnel.name !== undefined) {\n        attributes['funnelName'] = funnel.name;\n      }\n      samples.push({\n        name: METRIC_NAMES.funnel_results,\n        ts,\n        value: step.count,\n        attributes,\n      });\n    });\n  }\n  return samples;\n}\n\nexport function buildRetentionSamples(\n  response: RetentionResponse,\n  event: string,\n): MetricSample[] {\n  const samples: MetricSample[] = [];\n  for (const [cohortDate, cohort] of Object.entries(response)) {\n    const ts = mixpanelDateToMs(cohortDate);\n    if (!Number.isFinite(ts)) {\n      continue;\n    }\n    cohort.counts.forEach((retained, period) => {\n      samples.push({\n        name: METRIC_NAMES.retention,\n        ts,\n        value: retained,\n        attributes: {\n          event,\n          period,\n          cohortSize: cohort.first,\n          retentionRate: cohort.first > 0 ? retained / cohort.first : 0,\n        },\n      });\n    });\n  }\n  return samples;\n}\n\n// ---------------------------------------------------------------------------\n// Auth helper\n// ---------------------------------------------------------------------------\n\nfunction encodeBasicAuth(username: string, secret: string): string {\n  const raw = `${username}:${secret}`;\n  if (typeof btoa === 'function') {\n    return `Basic ${btoa(raw)}`;\n  }\n  const bufferCtor = (\n    globalThis as {\n      Buffer?: { from: (s: string) => { toString: (enc: string) => string } };\n    }\n  ).Buffer;\n  if (bufferCtor) {\n    return `Basic ${bufferCtor.from(raw).toString('base64')}`;\n  }\n  throw new Error('No base64 encoder available in this runtime');\n}\n\nfunction regionHost(region: 'us' | 'eu' | undefined): string {\n  return region === 'eu' ? 'eu.mixpanel.com' : 'mixpanel.com';\n}\n\n// ---------------------------------------------------------------------------\n// MixpanelConnector\n// ---------------------------------------------------------------------------\n\nexport class MixpanelConnector extends BaseConnector<\n  MixpanelSettings,\n  MixpanelCredentials\n> {\n  static readonly id = 'mixpanel';\n\n  static readonly schemas = {\n    dau: segmentationSchema,\n    wau: segmentationSchema,\n    mau: segmentationSchema,\n    events_per_day: segmentationSchema,\n    funnel_results: funnelSchema,\n    retention: retentionSchema,\n  } as const;\n\n  static create(input: unknown, ctx?: ConnectorContext): MixpanelConnector {\n    const parsed = configFields.parse(input);\n    return new MixpanelConnector(\n      {\n        projectId: parsed.projectId,\n        region: parsed.region,\n        events: parsed.events,\n        funnels: parsed.funnels,\n        retentionEvent: parsed.retentionEvent,\n        activeUserEvent: parsed.activeUserEvent,\n        lookbackDays: parsed.lookbackDays,\n      },\n      {\n        username: parsed.username,\n        secret: parsed.secret,\n      },\n      ctx,\n    );\n  }\n\n  readonly id = 'mixpanel';\n  override readonly credentials = mixpanelCredentials;\n\n  private get apiBase(): string {\n    return `https://${regionHost(this.settings.region)}/api/2.0`;\n  }\n\n  private authHeaders(): Record<string, string> {\n    return {\n      Authorization: encodeBasicAuth(this.creds.username, this.creds.secret),\n      Accept: 'application/json',\n      'User-Agent': connectorUserAgent('mixpanel'),\n    };\n  }\n\n  private buildQuery(extra: Record<string, string>): string {\n    const params = new URLSearchParams({\n      project_id: this.settings.projectId,\n      ...extra,\n    });\n    return params.toString();\n  }\n\n  private async getSegmentation(\n    resource: MixpanelPhase,\n    params: Record<string, string>,\n    signal: AbortSignal | undefined,\n  ): Promise<SegmentationResponse> {\n    const url = `${this.apiBase}/segmentation?${this.buildQuery(params)}`;\n    const res = await this.get<unknown>(url, {\n      resource,\n      headers: this.authHeaders(),\n      signal,\n    });\n    return segmentationSchema.parse(res.body);\n  }\n\n  private async getFunnel(\n    funnelId: string | number,\n    range: MixpanelDateRange,\n    signal: AbortSignal | undefined,\n  ): Promise<FunnelResponse> {\n    const url = `${this.apiBase}/funnels?${this.buildQuery({\n      funnel_id: String(funnelId),\n      from_date: range.from,\n      to_date: range.to,\n      unit: 'day',\n    })}`;\n    const res = await this.get<unknown>(url, {\n      resource: 'funnel_results',\n      headers: this.authHeaders(),\n      signal,\n    });\n    return funnelSchema.parse(res.body);\n  }\n\n  private async getRetention(\n    event: string,\n    range: MixpanelDateRange,\n    signal: AbortSignal | undefined,\n  ): Promise<RetentionResponse> {\n    const url = `${this.apiBase}/retention?${this.buildQuery({\n      from_date: range.from,\n      to_date: range.to,\n      retention_type: 'birth',\n      unit: 'day',\n      born_event: event,\n      event,\n    })}`;\n    const res = await this.get<unknown>(url, {\n      resource: 'retention',\n      headers: this.authHeaders(),\n      signal,\n    });\n    return retentionSchema.parse(res.body);\n  }\n\n  private resolveActiveUserEvent(): string | undefined {\n    if (this.settings.activeUserEvent !== undefined) {\n      return this.settings.activeUserEvent;\n    }\n    const first = this.settings.events?.[0];\n    return first;\n  }\n\n  private async runActiveUserPhase(\n    phase: 'dau' | 'wau' | 'mau',\n    range: MixpanelDateRange,\n    storage: StorageHandle,\n    signal: AbortSignal | undefined,\n  ): Promise<void> {\n    const metricName = METRIC_NAMES[phase];\n    const event = this.resolveActiveUserEvent();\n    if (event === undefined) {\n      // No configured event to base active-user counts on; clear and skip.\n      await storage.metrics([], { names: [metricName] });\n      return;\n    }\n    const response = await this.getSegmentation(\n      phase,\n      {\n        event,\n        from_date: range.from,\n        to_date: range.to,\n        unit: PHASE_UNIT[phase],\n        type: 'unique',\n      },\n      signal,\n    );\n    const samples = buildActiveUserSamples(\n      response,\n      metricName,\n      PHASE_UNIT[phase],\n      event,\n    );\n    await storage.metrics(samples, { names: [metricName] });\n  }\n\n  private async runEventsPerDayPhase(\n    range: MixpanelDateRange,\n    storage: StorageHandle,\n    signal: AbortSignal | undefined,\n  ): Promise<void> {\n    const metricName = METRIC_NAMES.events_per_day;\n    const events = this.settings.events ?? [];\n    if (events.length === 0) {\n      await storage.metrics([], { names: [metricName] });\n      return;\n    }\n    const samples: MetricSample[] = [];\n    for (const event of events) {\n      if (signal?.aborted) {\n        throw new Error('aborted');\n      }\n      const [generalResponse, uniqueResponse] = await Promise.all([\n        this.getSegmentation(\n          'events_per_day',\n          {\n            event,\n            from_date: range.from,\n            to_date: range.to,\n            unit: 'day',\n            type: 'general',\n          },\n          signal,\n        ),\n        this.getSegmentation(\n          'events_per_day',\n          {\n            event,\n            from_date: range.from,\n            to_date: range.to,\n            unit: 'day',\n            type: 'unique',\n          },\n          signal,\n        ),\n      ]);\n      samples.push(\n        ...buildEventsPerDaySamples(generalResponse, uniqueResponse, event),\n      );\n    }\n    await storage.metrics(samples, { names: [metricName] });\n  }\n\n  private async runFunnelPhase(\n    range: MixpanelDateRange,\n    storage: StorageHandle,\n    signal: AbortSignal | undefined,\n  ): Promise<void> {\n    const metricName = METRIC_NAMES.funnel_results;\n    const funnels = this.settings.funnels ?? [];\n    if (funnels.length === 0) {\n      await storage.metrics([], { names: [metricName] });\n      return;\n    }\n    const samples: MetricSample[] = [];\n    for (const funnel of funnels) {\n      if (signal?.aborted) {\n        throw new Error('aborted');\n      }\n      const response = await this.getFunnel(funnel.id, range, signal);\n      samples.push(...buildFunnelSamples(response, funnel));\n    }\n    await storage.metrics(samples, { names: [metricName] });\n  }\n\n  private async runRetentionPhase(\n    range: MixpanelDateRange,\n    storage: StorageHandle,\n    signal: AbortSignal | undefined,\n  ): Promise<void> {\n    const metricName = METRIC_NAMES.retention;\n    const event = this.settings.retentionEvent;\n    if (event === undefined) {\n      await storage.metrics([], { names: [metricName] });\n      return;\n    }\n    const response = await this.getRetention(event, range, signal);\n    const samples = buildRetentionSamples(response, event);\n    await storage.metrics(samples, { names: [metricName] });\n  }\n\n  async sync(\n    options: SyncOptions,\n    storage: StorageHandle,\n    signal?: AbortSignal,\n  ): Promise<SyncResult> {\n    const lookbackDays = this.settings.lookbackDays ?? DEFAULT_LOOKBACK_DAYS;\n    const cursor = isMixpanelSyncCursor(options.cursor)\n      ? options.cursor\n      : undefined;\n    // Restore the originally-computed window on resume so phases stay aligned\n    // across midnight rollovers and lookbackDays changes between runs.\n    const dateRange = cursor?.dateRange ?? getDateRange(options, lookbackDays);\n\n    const resumeIdx = cursor ? PHASE_ORDER.indexOf(cursor.phase) : -1;\n    const startIdx = resumeIdx >= 0 ? resumeIdx : 0;\n    const requested = options.resources;\n\n    for (let i = startIdx; i < PHASE_ORDER.length; i++) {\n      const phase = PHASE_ORDER[i]!;\n      if (signal?.aborted) {\n        return { done: false, cursor: { phase, dateRange } };\n      }\n      if (requested && requested.size > 0 && !requested.has(phase)) {\n        continue;\n      }\n      const phaseStart = Date.now();\n      try {\n        if (phase === 'dau' || phase === 'wau' || phase === 'mau') {\n          await this.runActiveUserPhase(phase, dateRange, storage, signal);\n        } else if (phase === 'events_per_day') {\n          await this.runEventsPerDayPhase(dateRange, storage, signal);\n        } else if (phase === 'funnel_results') {\n          await this.runFunnelPhase(dateRange, storage, signal);\n        } else {\n          await this.runRetentionPhase(dateRange, storage, signal);\n        }\n      } catch (err) {\n        if (\n          signal?.aborted ||\n          (err instanceof Error && err.name === 'AbortError')\n        ) {\n          return { done: false, cursor: { phase, dateRange } };\n        }\n        this.logger.warn('fetch page failed', {\n          resource: phase,\n          page: 1,\n          error: err instanceof Error ? err.message : String(err),\n        });\n        return {\n          done: false,\n          cursor: { phase, dateRange },\n          transientError: err,\n        };\n      }\n      this.logger.info('resource done', {\n        resource: phase,\n        pages: 1,\n        items: 0,\n        duration_ms: Date.now() - phaseStart,\n      });\n    }\n\n    return { done: true };\n  }\n}\n","import { MixpanelConnector } from './mixpanel';\n\nexport {\n  buildActiveUserSamples,\n  buildEventsPerDaySamples,\n  buildFunnelSamples,\n  buildRetentionSamples,\n  configFields,\n  getDateRange,\n  MixpanelConnector,\n} from './mixpanel';\nexport type {\n  MixpanelFunnelSpec,\n  MixpanelPhase,\n  MixpanelResource,\n  MixpanelSettings,\n} from './mixpanel';\nexport default MixpanelConnector;\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@rawdash/connector-mixpanel",
+  "version": "0.0.1",
+  "description": "Rawdash connector for Mixpanel — syncs event volume, funnels, retention, and DAU/WAU/MAU into the six-shape storage model via the Mixpanel Query API",
+  "license": "Apache-2.0",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rawdash/rawdash.git",
+    "directory": "packages/connectors/mixpanel"
+  },
+  "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"
+  }
+}