@zackbart/connecta 0.30.0 → 0.32.0

package/dist/providers/mixpanel/index.d.ts

@@ -2,7 +2,7 @@ import { type RemoteMcpAuth } from "../../connectors/remote-mcp.js";
 import type { ConnectorCallAdmissionPolicy } from "../../types.js";
 export type MixpanelRegion = "us" | "eu" | "in";
 export declare const MIXPANEL_MCP_ENDPOINTS: Readonly<Record<MixpanelRegion, string>>;
-export interface MixpanelOptions {
+interface MixpanelCommonOptions {
     /**
      * Human-readable display name; defaults to "Mixpanel (<region>)". The region
      * rides the title because a project lives in exactly one residency and
@@ -18,25 +18,40 @@ export interface MixpanelOptions {
      * region answers empty rather than wrong, which reads as an empty project.
      */
     region?: MixpanelRegion;
-    /**
-     * OAuth by default; static headers support Mixpanel service accounts, and
-     * `{ type: "credential" }` takes the same service account as an
-     * operator-managed `username:secret` that Connecta frames for the endpoint.
-     */
-    auth?: RemoteMcpAuth;
     /** Account-specific conventions appended to the maintained provider guide. */
     instructions?: string;
     /** Connector-specific inline result limit; omit to inherit the deployment. */
     maxResultBytes?: number;
     /**
-     * Optional per-runtime policy. There is no default: Mixpanel meters its MCP
-     * server per user per hour, and a per-runtime counter over-counts one runtime
-     * serving many users and under-counts many runtimes sharing one credential.
-     * Only an operator who knows the account can pick a number worth enforcing.
+     * Optional per-runtime policy. API mode defaults to 60 calls/hour and five
+     * concurrent calls across all tools and projects. MCP mode has no default:
+     * its per-user hourly quota cannot be modeled by one per-runtime counter.
      */
     callAdmission?: ConnectorCallAdmissionPolicy;
 }
-/** A maintained Mixpanel hosted-MCP connection. */
+/** The default hosted MCP connection. Existing auth configurations still work. */
+export interface MixpanelMcpOptions extends MixpanelCommonOptions {
+    via?: "mcp";
+    /**
+     * OAuth by default; static headers support Mixpanel service accounts, and
+     * `{ type: "credential" }` takes the same service account as an
+     * operator-managed `username:secret` that Connecta frames for the endpoint.
+     */
+    auth?: RemoteMcpAuth;
+    defaultProjectId?: never;
+}
+/** REST APIs using an operator-managed username:secret service account. */
+export interface MixpanelApiOptions extends MixpanelCommonOptions {
+    via: "api";
+    auth: {
+        type: "credential";
+    };
+    /** Fills an omitted project_id. Explicit ids still reach other granted projects. */
+    defaultProjectId?: number;
+}
+export type MixpanelOptions = MixpanelMcpOptions | MixpanelApiOptions;
+/** Mixpanel hosted MCP by default, or service-account REST with via: "api". */
 export declare const mixpanel: import("../../provider.js").ProviderFactory<MixpanelOptions>;
 /** @deprecated Read `mixpanel.definition.classify` instead. Kept for existing imports. */
 export declare const MIXPANEL_VETTED_CATALOG: import("../../catalog-drift.js").VettedCatalog;
+export {};

package/dist/providers/mixpanel/index.js

@@ -1,9 +1,11 @@
 import { skill } from "./skill.generated.js";
 import { remoteMcp, withCredentialDefaults } from "../../connectors/remote-mcp.js";
 import { reviewedCatalog } from "../../catalog-drift.js";
-import { keys, optionsOf } from "../../config-schema.js";
+import { keys, optionsOf, variants } from "../../config-schema.js";
 import { PROVIDER_COMMON, REMOTE_MCP_AUTH } from "../../connectors/option-shapes.js";
 import { defineProvider } from "../../provider.js";
+import { apiConnector } from "../../connectors/api-connector.js";
+import { mixpanelRest, MIXPANEL_API_ADMISSION } from "./rest.js";
 export const MIXPANEL_MCP_ENDPOINTS = {
     us: "https://mcp.mixpanel.com/mcp",
     eu: "https://mcp-eu.mixpanel.com/mcp",
@@ -358,18 +360,39 @@ ${regionNote}
 Account purpose: ${purpose}${skill.fragments.guide_1}${accountInstructions ? `\n## ${skill.instructionsHeading}\n\n${accountInstructions}\n` : ""}`;
 }
 /** The closed options mixpanel() accepts; see `assertKnownOptions`. */
-const MIXPANEL_OPTIONS = optionsOf()({ ...PROVIDER_COMMON, ...keys("region"), auth: REMOTE_MCP_AUTH });
-/** A maintained Mixpanel hosted-MCP connection. */
+const MIXPANEL_OPTIONS = variants("via", {
+    mcp: optionsOf()({
+        ...PROVIDER_COMMON,
+        ...keys("region", "via"),
+        auth: REMOTE_MCP_AUTH,
+    }).shape,
+    api: optionsOf()({
+        ...PROVIDER_COMMON,
+        ...keys("region", "via", "defaultProjectId"),
+        auth: variants("type", { credential: optionsOf()(keys("type")).shape }),
+    }).shape,
+}, "mcp");
+/** Mixpanel hosted MCP by default, or service-account REST with via: "api". */
 export const mixpanel = defineProvider({
     name: "mixpanel",
     title: "Mixpanel",
-    kind: "mcp",
+    kind: "dual",
     readme: "Mixpanel",
-    bundle: { "baselineGzip": 131378, "maxGzip": 191378 },
+    bundle: {
+        baselineGzip: 205500,
+        maxGzip: 265500,
+        note: "./providers/mixpanel (#823) adds the REST connector, guarded transport, shared operation index and value-safety engine alongside the unchanged hosted MCP client. The nine-operation reviewed subset was shrunk to depth 3 without descriptions before remeasuring: operations.ts is 1355 B gzip. The provider remeasures at about 205500 B gzip, compared with the 131378 B MCP-only baseline; the cap follows baseline + 60000 B. No new runtime dependencies.",
+    },
     skill,
     options: MIXPANEL_OPTIONS,
     classify: MIXPANEL_CLASSIFICATION,
-    create: mixpanelConnector,
+    create: (id, options, provider) => {
+        const region = options.region ?? "us";
+        if (!Object.hasOwn(MIXPANEL_MCP_ENDPOINTS, region)) {
+            throw new Error('region must be "us", "eu", or "in".');
+        }
+        return options.via === "api" ? mixpanelApi(id, options, provider) : mixpanelConnector(id, options, provider);
+    },
 });
 function mixpanelConnector(id, options, provider) {
     const purpose = options.purpose.trim();
@@ -412,5 +435,34 @@ function mixpanelConnector(id, options, provider) {
     });
     return connector;
 }
+function mixpanelApi(id, options, provider) {
+    if (options.auth?.type !== "credential")
+        throw new Error('via: "api" requires auth: { type: "credential" }.');
+    if (options.defaultProjectId !== undefined &&
+        (!Number.isSafeInteger(options.defaultProjectId) || options.defaultProjectId < 1)) {
+        throw new Error("defaultProjectId must be a positive safe integer.");
+    }
+    const region = options.region ?? "us";
+    const rest = mixpanelRest(region, options.defaultProjectId);
+    const instructions = options.instructions?.trim();
+    return apiConnector(id, {
+        ...provider.connectorOptions,
+        title: options.title ?? `Mixpanel API (${region})`,
+        description: `Mixpanel service-account REST APIs (${region} residency): ${options.purpose}`,
+        credential: {
+            label: "Mixpanel service account",
+            description: "username:secret from Mixpanel organization settings. Import requires Owner or Admin on the target project.",
+            placeholder: "username:secret",
+        },
+        testCredential: rest.testCredential,
+        callAdmission: options.callAdmission ?? MIXPANEL_API_ADMISSION,
+        usageGuide: {
+            content: `# Mixpanel API usage\n\nService-account REST, ${region} residency. Account purpose: ${options.purpose}\n\nDefault project: ${options.defaultProjectId ?? "none; supply project_id"}.${skill.fragments.api}${instructions ? `\n## ${skill.instructionsHeading}\n\n${instructions}\n` : ""}`,
+            summary: `${REGION_COPY[region]} residency, service-account REST. Raw export, user activity, profiles, reports and event import.`,
+            required: true,
+        },
+        tools: rest.tools,
+    });
+}
 /** @deprecated Read `mixpanel.definition.classify` instead. Kept for existing imports. */
 export const MIXPANEL_VETTED_CATALOG = reviewedCatalog(mixpanel.definition.classify, 'defineProvider("mixpanel")');

package/dist/providers/mixpanel/operations.js

@@ -0,0 +1,20 @@
+export const openapi = {
+    source: "https://docs.mixpanel.com/openapi/query.openapi.yaml",
+    revision: "reviewed-2026-10-14",
+    digest: "sha256:d9bbbbfa67f0a31f900b325932462b9cd541d287e55357d28e201df69a35e677",
+    version: "1.0.0",
+    servers: ["query", "export", "app", "ingestion"],
+    tags: ["Export", "Account", "Engage", "Funnels", "Insights", "Retention", "Activity Feed", "Events"],
+    ops: [
+        ["GET", "/api/2.0/export", "raw-event-export", "Download Data", 0, 1],
+        ["GET", "/api/app/me", "service-account-me", "Service-account identity and reachable projects", 1, 2],
+        ["POST", "/api/query/engage", "engage-query", "Query Profiles", 2],
+        ["GET", "/api/query/funnels", "funnels-query", "Query Saved Report", 3],
+        ["GET", "/api/query/funnels/list", "funnels-list-saved", "List Saved Funnels", 3],
+        ["GET", "/api/query/insights", "insights-query", "Query Saved Report", 4],
+        ["GET", "/api/query/retention", "retention-query", "Query Retention Report", 5],
+        ["GET", "/api/query/stream/query", "activity-stream-query", "Profile Event Activity", 6],
+        ["POST", "/import", "import-events", "Import Events", 7, 3],
+    ],
+    details: '{"d":[],"o":[[[["project_id","query",0,{"t":"integer"}],["from_date","query",1,{"t":"string"}],["to_date","query",1,{"t":"string"}],["limit","query",0,{"t":"integer"}],["event","query",0,{"t":"string"}],["where","query",0,{"t":"string"}],["time_in_ms","query",0,{"t":"boolean"}]],0],0,[[["project_id","query",1,{"t":"integer"}],["workspace_id","query",0,{"t":"integer"}]],["application/x-www-form-urlencoded",{"p":{"distinct_id":{"t":"string"},"distinct_ids":{"t":"string"},"data_group_id":{"t":"string"},"where":{"t":"string"},"output_properties":{"t":"array","i":{"t":"string"}},"session_id":{"t":"string"},"page":{"t":"integer"},"behaviors":{"t":"integer"},"as_of_timestamp":{"t":"integer"},"filter_by_cohort":{"t":"string"},"include_all_users":{"t":"boolean"}}}]],[[["project_id","query",1,{"t":"integer"}],["workspace_id","query",0,{"t":"integer"}],["funnel_id","query",1,{"t":"integer"}],["from_date","query",1,{"t":"string"}],["to_date","query",1,{"t":"string"}],["length","query",0,{"t":"integer"}],["length_unit","query",0,{"t":"string","e":["day","hour","minute","second"]}],["interval","query",0,{"t":"integer"}],["unit","query",0,{"t":"string","e":["day","week","month"]}],["on","query",0,{"t":"string"}],["where","query",0,{"t":"string"}],["limit","query",0,{"t":"integer"}]],0],[[["project_id","query",1,{"t":"integer"}],["workspace_id","query",0,{"t":"integer"}]],0],[[["project_id","query",1,{"t":"integer"}],["workspace_id","query",0,{"t":"integer"}],["bookmark_id","query",1,{"t":"integer"}]],0],[[["project_id","query",1,{"t":"integer"}],["workspace_id","query",0,{"t":"integer"}],["from_date","query",1,{"t":"string"}],["to_date","query",1,{"t":"string"}],["retention_type","query",0,{"t":"string","e":["birth","compounded"]}],["born_event","query",0,{"t":"string"}],["event","query",0,{"t":"string"}],["born_where","query",0,{"t":"string"}],["where","query",0,{"t":"string"}],["interval","query",0,{"t":"integer"}],["interval_count","query",0,{"t":"integer"}],["unit","query",0,{"t":"string","e":["day","week","month"]}],["unbounded_retention","query",0,{"t":"boolean"}],["on","query",0,{"t":"string"}],["limit","query",0,{"t":"integer"}]],0],[[["project_id","query",1,{"t":"integer"}],["workspace_id","query",0,{"t":"integer"}],["distinct_ids","query",1,{"t":"string"}],["from_date","query",1,{"t":"string"}],["to_date","query",1,{"t":"string"}]],0],[[["strict","query",1,{"t":"string","e":["0","1"]}],["project_id","query",1,{"t":"string"}]],["application/json",{"t":"array","i":{"t":"object","p":{"event":{"t":"string"},"properties":{"t":"object","p":{"time":{"t":"integer"},"distinct_id":{"t":"string"},"$insert_id":{"t":"string"}},"r":["time","$insert_id","distinct_id"],"m":{}}},"r":["event","properties"]}},1]]]}',
+};