@rawdash/connector-mixpanel 0.0.1 → 0.17.0

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { BaseConnector, ConnectorContext, SyncOptions, StorageHandle, SyncResult, MetricSample } from '@rawdash/core';
+import { BaseConnector, ConnectorCost, ConnectorContext, SyncOptions, StorageHandle, SyncResult, MetricSample, ConnectorDoc } from '@rawdash/core';
 import { z } from 'zod';
 
 declare const configFields: z.ZodObject<{
@@ -20,6 +20,8 @@ declare const configFields: z.ZodObject<{
     activeUserEvent: z.ZodOptional<z.ZodString>;
     lookbackDays: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
+declare const doc: ConnectorDoc;
+declare const cost: ConnectorCost;
 interface MixpanelFunnelSpec {
     id: string | number;
     name?: string;
@@ -87,12 +89,375 @@ interface RetentionCohort {
     counts: number[];
 }
 type RetentionResponse = Record<string, RetentionCohort>;
+declare const mixpanelResources: {
+    readonly mixpanel_dau: {
+        readonly shape: "metric";
+        readonly description: "Daily active users - unique-user counts for the active-user event, one sample per day.";
+        readonly endpoint: "GET /api/2.0/segmentation (type=unique, unit=day)";
+        readonly unit: "users";
+        readonly granularity: "day";
+        readonly notes: "Each metric is rewritten in full per sync (idempotent replace).";
+        readonly dimensions: [{
+            readonly name: "unit";
+            readonly description: "Active-user window: always `day`.";
+        }, {
+            readonly name: "event";
+            readonly description: "The event the active-user count is based on.";
+        }];
+        readonly responses: {
+            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 mixpanel_wau: {
+        readonly shape: "metric";
+        readonly description: "Weekly active users - unique-user counts for the active-user event, one sample per week.";
+        readonly endpoint: "GET /api/2.0/segmentation (type=unique, unit=week)";
+        readonly unit: "users";
+        readonly granularity: "week";
+        readonly notes: "Each metric is rewritten in full per sync (idempotent replace).";
+        readonly dimensions: [{
+            readonly name: "unit";
+            readonly description: "Active-user window: always `week`.";
+        }, {
+            readonly name: "event";
+            readonly description: "The event the active-user count is based on.";
+        }];
+        readonly responses: {
+            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 mixpanel_mau: {
+        readonly shape: "metric";
+        readonly description: "Monthly active users - unique-user counts for the active-user event, one sample per month.";
+        readonly endpoint: "GET /api/2.0/segmentation (type=unique, unit=month)";
+        readonly unit: "users";
+        readonly granularity: "month";
+        readonly notes: "Each metric is rewritten in full per sync (idempotent replace).";
+        readonly dimensions: [{
+            readonly name: "unit";
+            readonly description: "Active-user window: always `month`.";
+        }, {
+            readonly name: "event";
+            readonly description: "The event the active-user count is based on.";
+        }];
+        readonly responses: {
+            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 mixpanel_events_per_day: {
+        readonly shape: "metric";
+        readonly description: "Per-day volume for each configured event. The sample value is the total event count; unique-user count is carried as an attribute.";
+        readonly endpoint: "GET /api/2.0/segmentation (type=general and type=unique)";
+        readonly unit: "events";
+        readonly granularity: "day";
+        readonly notes: "Each metric is rewritten in full per sync (idempotent replace).";
+        readonly dimensions: [{
+            readonly name: "event";
+            readonly description: "The configured event name.";
+        }, {
+            readonly name: "count";
+            readonly description: "Total event count for the day (equals the value).";
+        }, {
+            readonly name: "uniqueUsers";
+            readonly description: "Distinct users who triggered the event that day.";
+        }];
+        readonly responses: {
+            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 mixpanel_funnel_results: {
+        readonly shape: "metric";
+        readonly description: "Per-day funnel conversion. One sample per (date, step); the value is the user count reaching that step.";
+        readonly endpoint: "GET /api/2.0/funnels (unit=day)";
+        readonly unit: "users";
+        readonly granularity: "day";
+        readonly notes: "Each metric is rewritten in full per sync (idempotent replace).";
+        readonly dimensions: [{
+            readonly name: "funnelId";
+            readonly description: "The configured Mixpanel funnel ID.";
+        }, {
+            readonly name: "funnelName";
+            readonly description: "Optional display name from config (present when set).";
+        }, {
+            readonly name: "step";
+            readonly description: "Zero-based step index in the funnel.";
+        }, {
+            readonly name: "stepLabel";
+            readonly description: "Human-readable step label or event name.";
+        }, {
+            readonly name: "users";
+            readonly description: "Users reaching this step.";
+        }, {
+            readonly name: "conversionRate";
+            readonly description: "Overall conversion ratio from the first step.";
+        }, {
+            readonly name: "stepConversionRate";
+            readonly description: "Conversion ratio from the previous step.";
+        }];
+        readonly responses: {
+            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 mixpanel_retention: {
+        readonly shape: "metric";
+        readonly description: "Cohort retention for the retention event. One sample per (cohort date, period); the value is the retained user count.";
+        readonly endpoint: "GET /api/2.0/retention (retention_type=birth, unit=day)";
+        readonly unit: "users";
+        readonly granularity: "day";
+        readonly notes: "Each metric is rewritten in full per sync (idempotent replace).";
+        readonly dimensions: [{
+            readonly name: "event";
+            readonly description: "The retention (born) event.";
+        }, {
+            readonly name: "period";
+            readonly description: "Days since the cohort birth date (period index).";
+        }, {
+            readonly name: "cohortSize";
+            readonly description: "Number of users in the cohort at birth.";
+        }, {
+            readonly name: "retentionRate";
+            readonly description: "Retained users divided by cohort size.";
+        }];
+        readonly responses: {
+            readonly retention: z.ZodRecord<z.ZodString, z.ZodObject<{
+                first: z.ZodNumber;
+                counts: z.ZodArray<z.ZodNumber>;
+            }, z.core.$strip>>;
+        };
+    };
+};
 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 const id = "mixpanel";
 declare class MixpanelConnector extends BaseConnector<MixpanelSettings, MixpanelCredentials> {
     static readonly id = "mixpanel";
+    static readonly resources: {
+        readonly mixpanel_dau: {
+            readonly shape: "metric";
+            readonly description: "Daily active users - unique-user counts for the active-user event, one sample per day.";
+            readonly endpoint: "GET /api/2.0/segmentation (type=unique, unit=day)";
+            readonly unit: "users";
+            readonly granularity: "day";
+            readonly notes: "Each metric is rewritten in full per sync (idempotent replace).";
+            readonly dimensions: [{
+                readonly name: "unit";
+                readonly description: "Active-user window: always `day`.";
+            }, {
+                readonly name: "event";
+                readonly description: "The event the active-user count is based on.";
+            }];
+            readonly responses: {
+                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 mixpanel_wau: {
+            readonly shape: "metric";
+            readonly description: "Weekly active users - unique-user counts for the active-user event, one sample per week.";
+            readonly endpoint: "GET /api/2.0/segmentation (type=unique, unit=week)";
+            readonly unit: "users";
+            readonly granularity: "week";
+            readonly notes: "Each metric is rewritten in full per sync (idempotent replace).";
+            readonly dimensions: [{
+                readonly name: "unit";
+                readonly description: "Active-user window: always `week`.";
+            }, {
+                readonly name: "event";
+                readonly description: "The event the active-user count is based on.";
+            }];
+            readonly responses: {
+                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 mixpanel_mau: {
+            readonly shape: "metric";
+            readonly description: "Monthly active users - unique-user counts for the active-user event, one sample per month.";
+            readonly endpoint: "GET /api/2.0/segmentation (type=unique, unit=month)";
+            readonly unit: "users";
+            readonly granularity: "month";
+            readonly notes: "Each metric is rewritten in full per sync (idempotent replace).";
+            readonly dimensions: [{
+                readonly name: "unit";
+                readonly description: "Active-user window: always `month`.";
+            }, {
+                readonly name: "event";
+                readonly description: "The event the active-user count is based on.";
+            }];
+            readonly responses: {
+                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 mixpanel_events_per_day: {
+            readonly shape: "metric";
+            readonly description: "Per-day volume for each configured event. The sample value is the total event count; unique-user count is carried as an attribute.";
+            readonly endpoint: "GET /api/2.0/segmentation (type=general and type=unique)";
+            readonly unit: "events";
+            readonly granularity: "day";
+            readonly notes: "Each metric is rewritten in full per sync (idempotent replace).";
+            readonly dimensions: [{
+                readonly name: "event";
+                readonly description: "The configured event name.";
+            }, {
+                readonly name: "count";
+                readonly description: "Total event count for the day (equals the value).";
+            }, {
+                readonly name: "uniqueUsers";
+                readonly description: "Distinct users who triggered the event that day.";
+            }];
+            readonly responses: {
+                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 mixpanel_funnel_results: {
+            readonly shape: "metric";
+            readonly description: "Per-day funnel conversion. One sample per (date, step); the value is the user count reaching that step.";
+            readonly endpoint: "GET /api/2.0/funnels (unit=day)";
+            readonly unit: "users";
+            readonly granularity: "day";
+            readonly notes: "Each metric is rewritten in full per sync (idempotent replace).";
+            readonly dimensions: [{
+                readonly name: "funnelId";
+                readonly description: "The configured Mixpanel funnel ID.";
+            }, {
+                readonly name: "funnelName";
+                readonly description: "Optional display name from config (present when set).";
+            }, {
+                readonly name: "step";
+                readonly description: "Zero-based step index in the funnel.";
+            }, {
+                readonly name: "stepLabel";
+                readonly description: "Human-readable step label or event name.";
+            }, {
+                readonly name: "users";
+                readonly description: "Users reaching this step.";
+            }, {
+                readonly name: "conversionRate";
+                readonly description: "Overall conversion ratio from the first step.";
+            }, {
+                readonly name: "stepConversionRate";
+                readonly description: "Conversion ratio from the previous step.";
+            }];
+            readonly responses: {
+                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 mixpanel_retention: {
+            readonly shape: "metric";
+            readonly description: "Cohort retention for the retention event. One sample per (cohort date, period); the value is the retained user count.";
+            readonly endpoint: "GET /api/2.0/retention (retention_type=birth, unit=day)";
+            readonly unit: "users";
+            readonly granularity: "day";
+            readonly notes: "Each metric is rewritten in full per sync (idempotent replace).";
+            readonly dimensions: [{
+                readonly name: "event";
+                readonly description: "The retention (born) event.";
+            }, {
+                readonly name: "period";
+                readonly description: "Days since the cohort birth date (period index).";
+            }, {
+                readonly name: "cohortSize";
+                readonly description: "Number of users in the cohort at birth.";
+            }, {
+                readonly name: "retentionRate";
+                readonly description: "Retained users divided by cohort size.";
+            }];
+            readonly responses: {
+                readonly retention: z.ZodRecord<z.ZodString, z.ZodObject<{
+                    first: z.ZodNumber;
+                    counts: z.ZodArray<z.ZodNumber>;
+                }, z.core.$strip>>;
+            };
+        };
+    };
     static readonly schemas: {
         readonly dau: z.ZodObject<{
             legend_size: z.ZodOptional<z.ZodNumber>;
@@ -101,6 +466,7 @@ declare class MixpanelConnector extends BaseConnector<MixpanelSettings, Mixpanel
                 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<{
@@ -108,6 +474,7 @@ declare class MixpanelConnector extends BaseConnector<MixpanelSettings, Mixpanel
                 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<{
@@ -115,6 +482,7 @@ declare class MixpanelConnector extends BaseConnector<MixpanelSettings, Mixpanel
                 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<{
@@ -122,6 +490,7 @@ declare class MixpanelConnector extends BaseConnector<MixpanelSettings, Mixpanel
                 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>>;
@@ -143,11 +512,13 @@ declare class MixpanelConnector extends BaseConnector<MixpanelSettings, Mixpanel
                 }, 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>>;
-    };
+    } & Readonly<Record<string, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
+    static readonly cost: ConnectorCost;
     static create(input: unknown, ctx?: ConnectorContext): MixpanelConnector;
     readonly id = "mixpanel";
     readonly credentials: {
@@ -174,4 +545,4 @@ declare class MixpanelConnector extends BaseConnector<MixpanelSettings, Mixpanel
     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 };
+export { MixpanelConnector, type MixpanelFunnelSpec, type MixpanelPhase, type MixpanelResource, type MixpanelSettings, buildActiveUserSamples, buildEventsPerDaySamples, buildFunnelSamples, buildRetentionSamples, configFields, cost, MixpanelConnector as default, doc, getDateRange, id, mixpanelResources as resources };

package/dist/index.js

@@ -8,7 +8,10 @@ function connectorUserAgent(connectorId) {
 // src/mixpanel.ts
 import {
   BaseConnector,
-  defineConfigFields
+  defineConfigFields,
+  defineConnectorDoc,
+  defineResources,
+  schemasFromResources
 } from "@rawdash/core";
 import { z } from "zod";
 var funnelSpec = z.object({
@@ -64,6 +67,34 @@ var configFields = defineConfigFields(
     })
   })
 );
+var doc = defineConnectorDoc({
+  displayName: "Mixpanel",
+  category: "analytics",
+  brandColor: "#7856FF",
+  tagline: "Sync Mixpanel active-user counts, per-event volume, funnel conversion, and cohort retention as metric time series.",
+  vendor: {
+    name: "Mixpanel",
+    apiDocs: "https://developer.mixpanel.com/reference/query-api",
+    website: "https://mixpanel.com"
+  },
+  auth: {
+    summary: "Authenticate with a Mixpanel service account (username + secret) over HTTP Basic auth, scoped to a numeric project ID.",
+    setup: [
+      "In Mixpanel, open Project settings \u2192 Service Accounts and create a service account with at least read access to the project.",
+      "Copy the generated username (e.g. `rawdash-reader.abcdef.mp-service-account`) and the secret shown once at creation.",
+      "Find the numeric project ID under Project settings \u2192 Overview and set it as `projectId`.",
+      'Store the secret and reference it from config as `secret: secret("MIXPANEL_SECRET")`, alongside the `username`.',
+      'For EU-resident projects, set `region: "eu"`.'
+    ]
+  },
+  rateLimit: "Mixpanel's Query API quota is 60 queries/hour per project (default); requests are retried with backoff.",
+  limitations: [
+    "Incremental syncs refetch a 3-day overlap because Mixpanel can re-attribute late-arriving events."
+  ]
+});
+var cost = {
+  warning: "Each configured event and funnel costs one or more queries per sync against Mixpanel quotas; adding many events/funnels or syncing frequently can exhaust the quota."
+};
 var mixpanelCredentials = {
   username: {
     description: "Mixpanel service account username",
@@ -196,6 +227,131 @@ var retentionSchema = z.record(
     counts: z.array(finiteNumber)
   })
 );
+var METRIC_NOTES = "Each metric is rewritten in full per sync (idempotent replace).";
+var mixpanelResources = defineResources({
+  mixpanel_dau: {
+    shape: "metric",
+    description: "Daily active users - unique-user counts for the active-user event, one sample per day.",
+    endpoint: "GET /api/2.0/segmentation (type=unique, unit=day)",
+    unit: "users",
+    granularity: "day",
+    notes: METRIC_NOTES,
+    dimensions: [
+      { name: "unit", description: "Active-user window: always `day`." },
+      {
+        name: "event",
+        description: "The event the active-user count is based on."
+      }
+    ],
+    responses: { dau: segmentationSchema }
+  },
+  mixpanel_wau: {
+    shape: "metric",
+    description: "Weekly active users - unique-user counts for the active-user event, one sample per week.",
+    endpoint: "GET /api/2.0/segmentation (type=unique, unit=week)",
+    unit: "users",
+    granularity: "week",
+    notes: METRIC_NOTES,
+    dimensions: [
+      { name: "unit", description: "Active-user window: always `week`." },
+      {
+        name: "event",
+        description: "The event the active-user count is based on."
+      }
+    ],
+    responses: { wau: segmentationSchema }
+  },
+  mixpanel_mau: {
+    shape: "metric",
+    description: "Monthly active users - unique-user counts for the active-user event, one sample per month.",
+    endpoint: "GET /api/2.0/segmentation (type=unique, unit=month)",
+    unit: "users",
+    granularity: "month",
+    notes: METRIC_NOTES,
+    dimensions: [
+      { name: "unit", description: "Active-user window: always `month`." },
+      {
+        name: "event",
+        description: "The event the active-user count is based on."
+      }
+    ],
+    responses: { mau: segmentationSchema }
+  },
+  mixpanel_events_per_day: {
+    shape: "metric",
+    description: "Per-day volume for each configured event. The sample value is the total event count; unique-user count is carried as an attribute.",
+    endpoint: "GET /api/2.0/segmentation (type=general and type=unique)",
+    unit: "events",
+    granularity: "day",
+    notes: METRIC_NOTES,
+    dimensions: [
+      { name: "event", description: "The configured event name." },
+      {
+        name: "count",
+        description: "Total event count for the day (equals the value)."
+      },
+      {
+        name: "uniqueUsers",
+        description: "Distinct users who triggered the event that day."
+      }
+    ],
+    responses: { events_per_day: segmentationSchema }
+  },
+  mixpanel_funnel_results: {
+    shape: "metric",
+    description: "Per-day funnel conversion. One sample per (date, step); the value is the user count reaching that step.",
+    endpoint: "GET /api/2.0/funnels (unit=day)",
+    unit: "users",
+    granularity: "day",
+    notes: METRIC_NOTES,
+    dimensions: [
+      { name: "funnelId", description: "The configured Mixpanel funnel ID." },
+      {
+        name: "funnelName",
+        description: "Optional display name from config (present when set)."
+      },
+      { name: "step", description: "Zero-based step index in the funnel." },
+      {
+        name: "stepLabel",
+        description: "Human-readable step label or event name."
+      },
+      { name: "users", description: "Users reaching this step." },
+      {
+        name: "conversionRate",
+        description: "Overall conversion ratio from the first step."
+      },
+      {
+        name: "stepConversionRate",
+        description: "Conversion ratio from the previous step."
+      }
+    ],
+    responses: { funnel_results: funnelSchema }
+  },
+  mixpanel_retention: {
+    shape: "metric",
+    description: "Cohort retention for the retention event. One sample per (cohort date, period); the value is the retained user count.",
+    endpoint: "GET /api/2.0/retention (retention_type=birth, unit=day)",
+    unit: "users",
+    granularity: "day",
+    notes: METRIC_NOTES,
+    dimensions: [
+      { name: "event", description: "The retention (born) event." },
+      {
+        name: "period",
+        description: "Days since the cohort birth date (period index)."
+      },
+      {
+        name: "cohortSize",
+        description: "Number of users in the cohort at birth."
+      },
+      {
+        name: "retentionRate",
+        description: "Retained users divided by cohort size."
+      }
+    ],
+    responses: { retention: retentionSchema }
+  }
+});
 function buildActiveUserSamples(response, metricName, unit, event) {
   const samples = [];
   const seriesByEvent = response.data.values;
@@ -316,16 +472,12 @@ function encodeBasicAuth(username, secret) {
 function regionHost(region) {
   return region === "eu" ? "eu.mixpanel.com" : "mixpanel.com";
 }
+var id = "mixpanel";
 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 id = id;
+  static resources = mixpanelResources;
+  static schemas = schemasFromResources(mixpanelResources);
+  static cost = cost;
   static create(input, ctx) {
     const parsed = configFields.parse(input);
     return new _MixpanelConnector(
@@ -345,7 +497,7 @@ var MixpanelConnector = class _MixpanelConnector extends BaseConnector {
       ctx
     );
   }
-  id = "mixpanel";
+  id = id;
   credentials = mixpanelCredentials;
   get apiBase() {
     return `https://${regionHost(this.settings.region)}/api/2.0`;
@@ -567,7 +719,11 @@ export {
   buildFunnelSamples,
   buildRetentionSamples,
   configFields,
+  cost,
   index_default as default,
-  getDateRange
+  doc,
+  getDateRange,
+  id,
+  mixpanelResources as resources
 };
 //# sourceMappingURL=index.js.map