@mostly-good-metrics/cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mostly Good Metrics
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,126 @@
+# MostlyGoodMetrics CLI
+
+Command-line interface for [MostlyGoodMetrics](https://mostlygoodmetrics.com) — manage projects, API keys, and dashboards, and run funnels, retention, and queries from your terminal.
+
+Documentation: [docs.mostlygoodmetrics.com](https://docs.mostlygoodmetrics.com)
+
+## Install
+
+Coming to npm soon. For now, install from source:
+
+```bash
+git clone https://github.com/Mostly-Good-Metrics/cli.git
+cd cli
+npm install
+npm run build
+npm link   # makes the `mgm` command available on your PATH
+```
+
+Requires Node.js 18 or newer.
+
+## Quickstart
+
+```bash
+# Log in (opens your browser for OAuth)
+mgm login
+
+# Set up a project in the current directory (writes .mgm.json)
+mgm init
+
+# See your dashboard
+mgm dashboard --range 30d
+```
+
+Most project-scoped commands read the project from `.mgm.json` (created by `mgm init`) or accept an explicit `--project <id>`. Add `--json` to any read command for machine-readable output.
+
+## Automation and agents
+
+The CLI is designed to be safely discoverable from a script or coding agent:
+
+```bash
+# Discover the complete command tree and each command's flags
+mgm commands --json
+mgm schema experiments update --json
+
+# Emit JSON and filter it with jq
+mgm commands --json --jq '.[] | select(.path == "experiments update")'
+
+# Avoid browser/prompt flows in CI
+MGM_TOKEN="..." MGM_PROJECT_ID="prj_123" mgm experiments list --json
+# Set MGM_API_URL alongside MGM_APP_URL for a local API/OAuth development environment.
+mgm init --project "My App" --org acme --no-input --json
+
+# Explicitly confirm irreversible operations in scripts
+mgm experiments delete exp_123 --project prj_123 --no-input --yes --json
+```
+
+`--no-input` makes commands that would otherwise prompt fail with a usage error. Deletions, key revocations, dashboard-widget resets, and stopping an experiment require confirmation; in non-interactive environments, pass `--yes` explicitly. `--jq` requires the standard `jq` executable.
+
+## Commands
+
+| Command | Description |
+| --- | --- |
+| `mgm login` / `mgm signup` / `mgm logout` | Browser-based OAuth auth (`--token` for CI) |
+| `mgm whoami` | Show current user and organizations |
+| `mgm init` | Create a project + API key and save local context |
+| `mgm orgs list\|show\|create\|invite` | Manage organizations and members |
+| `mgm projects list\|create\|show` | Manage projects |
+| `mgm keys list\|create\|revoke` | Manage project API keys |
+| `mgm dashboard` / `mgm dashboard filters` | Dashboard stats and available filter values |
+| `mgm events list\|types\|send` | Inspect recent events, send test events |
+| `mgm funnels list\|create\|show\|update\|execute\|delete` | Saved and ad-hoc funnels |
+| `mgm retention list\|create\|show\|update\|execute\|delete` | Retention analyses |
+| `mgm queries list\|create\|show\|update\|execute\|delete` | Saved and ad-hoc queries |
+| `mgm experiments list\|create\|show\|update\|start\|stop\|delete` | Manage and analyze A/B experiments |
+| `mgm widgets list\|add\|remove\|reset` | Manage dashboard widgets |
+| `mgm commands` / `mgm schema <command>` | Discover the full command tree and typed flags |
+
+Run `mgm <command> --help` for full options.
+
+## Examples
+
+```bash
+# Ad-hoc funnel across three events
+mgm funnels execute --steps "app_open,add_to_cart,purchase" --range 30d
+
+# Unique users by day, as JSON
+mgm queries execute --metric unique_users --group-by date --range 7d --json
+
+# Create an API key for CI
+mgm keys create "CI" --project prj_123
+```
+
+## Development
+
+```bash
+npm install
+npm run build      # compile TypeScript to dist/
+npm test           # run the vitest suite
+npm run test:watch # watch mode
+node bin/mgm.js --help
+```
+
+CI (build + tests on Node 20 and 22) runs on every PR via GitHub Actions.
+
+## Releasing
+
+Publishing is automated by `.github/workflows/release.yml`, which runs on version tags and publishes to npm **only if the `NPM_TOKEN` repository secret is set**.
+
+One-time setup:
+
+1. Create an npm automation token with publish access to the `@mostly-good-metrics` scope (the org must exist on npm).
+2. Add it as the `NPM_TOKEN` secret in the GitHub repo (Settings > Secrets and variables > Actions).
+
+To ship a release:
+
+```bash
+# bump "version" in package.json (and VERSION in src/program.ts), commit, then:
+git tag v0.1.0
+git push --tags
+```
+
+The workflow installs, builds, tests, and runs `npm publish --access public`. If `NPM_TOKEN` is missing it skips the publish step with a warning instead of failing.
+
+## License
+
+MIT

package/bin/mgm.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import "../dist/index.js";

package/dist/auth.d.ts

@@ -0,0 +1,8 @@
+export declare function getToken(): string | undefined;
+export declare function getEmail(): string | undefined;
+export declare function getClientId(): string | undefined;
+export declare function getRedirectUri(): string | undefined;
+export declare function saveToken(token: string, email?: string): void;
+export declare function saveClientId(clientId: string, redirectUri?: string): void;
+export declare function clearToken(): void;
+export declare function requireToken(): string;

package/dist/auth.js

@@ -0,0 +1,146 @@
+import fs from "node:fs";
+import path from "node:path";
+import os from "node:os";
+import { Entry } from "@napi-rs/keyring";
+function getConfigDir() {
+    const platform = process.platform;
+    if (platform === "win32") {
+        return path.join(process.env.APPDATA ?? path.join(os.homedir(), "AppData", "Roaming"), "mgm");
+    }
+    // macOS and Linux: follow XDG_CONFIG_HOME, default to ~/.config
+    return path.join(process.env.XDG_CONFIG_HOME ?? path.join(os.homedir(), ".config"), "mgm");
+}
+const CONFIG_DIR = getConfigDir();
+const CONFIG_FILE = path.join(CONFIG_DIR, "config.json");
+const KEYCHAIN_SERVICE = "com.mostlygoodmetrics.cli";
+const KEYCHAIN_ACCOUNT = "oauth-token";
+// Migrate from legacy ~/.mgm/config.json if it exists
+const LEGACY_CONFIG = path.join(os.homedir(), ".mgm", "config.json");
+try {
+    if (fs.existsSync(LEGACY_CONFIG) && !fs.existsSync(CONFIG_FILE)) {
+        fs.mkdirSync(CONFIG_DIR, { recursive: true });
+        fs.copyFileSync(LEGACY_CONFIG, CONFIG_FILE);
+        fs.chmodSync(CONFIG_FILE, 0o600);
+        fs.unlinkSync(LEGACY_CONFIG);
+        try {
+            fs.rmdirSync(path.dirname(LEGACY_CONFIG));
+        }
+        catch { }
+    }
+}
+catch { }
+function readConfig() {
+    try {
+        const config = JSON.parse(fs.readFileSync(CONFIG_FILE, "utf-8"));
+        // Ensure legacy/file-fallback credentials are never left world-readable.
+        try {
+            fs.chmodSync(CONFIG_FILE, 0o600);
+        }
+        catch { }
+        return config;
+    }
+    catch {
+        return {};
+    }
+}
+function writeConfig(config) {
+    fs.mkdirSync(CONFIG_DIR, { recursive: true });
+    const temporaryFile = `${CONFIG_FILE}.${process.pid}.tmp`;
+    fs.writeFileSync(temporaryFile, JSON.stringify(config, null, 2) + "\n", {
+        mode: 0o600,
+    });
+    fs.chmodSync(temporaryFile, 0o600);
+    fs.renameSync(temporaryFile, CONFIG_FILE);
+    // chmod is required for existing files, where writeFile's mode is ignored.
+    fs.chmodSync(CONFIG_FILE, 0o600);
+}
+function credentialEntry() {
+    return new Entry(KEYCHAIN_SERVICE, KEYCHAIN_ACCOUNT);
+}
+function readKeychainToken() {
+    try {
+        const token = credentialEntry().getPassword();
+        return token || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function saveKeychainToken(token) {
+    try {
+        credentialEntry().setPassword(token);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function deleteKeychainToken() {
+    try {
+        credentialEntry().deletePassword();
+    }
+    catch {
+        // The credential may not exist or the OS store may be unavailable.
+    }
+}
+export function getToken() {
+    if (process.env.MGM_TOKEN)
+        return process.env.MGM_TOKEN;
+    const keychainToken = readKeychainToken();
+    if (keychainToken)
+        return keychainToken;
+    const config = readConfig();
+    const legacyToken = config.token;
+    if (legacyToken && saveKeychainToken(legacyToken)) {
+        delete config.token;
+        writeConfig(config);
+        return legacyToken;
+    }
+    return legacyToken;
+}
+export function getEmail() {
+    return readConfig().email;
+}
+export function getClientId() {
+    return readConfig().client_id;
+}
+export function getRedirectUri() {
+    return readConfig().redirect_uri;
+}
+export function saveToken(token, email) {
+    const config = readConfig();
+    if (saveKeychainToken(token)) {
+        delete config.token;
+    }
+    else {
+        // Do not let a stale Keychain value silently override this new login.
+        deleteKeychainToken();
+        config.token = token;
+    }
+    if (email)
+        config.email = email;
+    writeConfig(config);
+}
+export function saveClientId(clientId, redirectUri) {
+    const config = readConfig();
+    config.client_id = clientId;
+    if (redirectUri)
+        config.redirect_uri = redirectUri;
+    writeConfig(config);
+}
+export function clearToken() {
+    const config = readConfig();
+    deleteKeychainToken();
+    delete config.token;
+    delete config.email;
+    writeConfig(config);
+}
+export function requireToken() {
+    const token = getToken();
+    if (!token) {
+        console.error("Not logged in. Run `mgm login` first.");
+        process.exit(1);
+    }
+    return token;
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEzC,SAAS,YAAY;IACnB,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAClC,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,KAAK,CAAC,CAAC;IAChG,CAAC;IACD,gEAAgE;IAChE,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,EAAE,KAAK,CAAC,CAAC;AAC7F,CAAC;AAED,MAAM,UAAU,GAAG,YAAY,EAAE,CAAC;AAClC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;AACzD,MAAM,gBAAgB,GAAG,2BAA2B,CAAC;AACrD,MAAM,gBAAgB,GAAG,aAAa,CAAC;AAEvC,sDAAsD;AACtD,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC;AACrE,IAAI,CAAC;IACH,IAAI,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAChE,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,EAAE,CAAC,YAAY,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;QAC5C,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;QACjC,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;QAC7B,IAAI,CAAC;YAAC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;IAC7D,CAAC;AACH,CAAC;AAAC,MAAM,CAAC,CAAA,CAAC;AASV,SAAS,UAAU;IACjB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAW,CAAC;QAC3E,yEAAyE;QACzE,IAAI,CAAC;YAAC,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;QAClD,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,MAAc;IACjC,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,MAAM,aAAa,GAAG,GAAG,WAAW,IAAI,OAAO,CAAC,GAAG,MAAM,CAAC;IAC1D,EAAE,CAAC,aAAa,CAAC,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE;QACtE,IAAI,EAAE,KAAK;KACZ,CAAC,CAAC;IACH,EAAE,CAAC,SAAS,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;IACnC,EAAE,CAAC,UAAU,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;IAC1C,2EAA2E;IAC3E,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,eAAe;IACtB,OAAO,IAAI,KAAK,CAAC,gBAAgB,EAAE,gBAAgB,CAAC,CAAC;AACvD,CAAC;AAED,SAAS,iBAAiB;IACxB,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,eAAe,EAAE,CAAC,WAAW,EAAE,CAAC;QAC9C,OAAO,KAAK,IAAI,SAAS,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAa;IACtC,IAAI,CAAC;QACH,eAAe,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,mBAAmB;IAC1B,IAAI,CAAC;QACH,eAAe,EAAE,CAAC,cAAc,EAAE,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,mEAAmE;IACrE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,QAAQ;IACtB,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS;QAAE,OAAO,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC;IACxD,MAAM,aAAa,GAAG,iBAAiB,EAAE,CAAC;IAC1C,IAAI,aAAa;QAAE,OAAO,aAAa,CAAC;IAExC,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC;IACjC,IAAI,WAAW,IAAI,iBAAiB,CAAC,WAAW,CAAC,EAAE,CAAC;QAClD,OAAO,MAAM,CAAC,KAAK,CAAC;QACpB,WAAW,CAAC,MAAM,CAAC,CAAC;QACpB,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,QAAQ;IACtB,OAAO,UAAU,EAAE,CAAC,KAAK,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,OAAO,UAAU,EAAE,CAAC,SAAS,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,UAAU,EAAE,CAAC,YAAY,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAa,EAAE,KAAc;IACrD,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,IAAI,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,MAAM,CAAC,KAAK,CAAC;IACtB,CAAC;SAAM,CAAC;QACN,sEAAsE;QACtE,mBAAmB,EAAE,CAAC;QACtB,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;IACvB,CAAC;IACD,IAAI,KAAK;QAAE,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;IAChC,WAAW,CAAC,MAAM,CAAC,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,WAAoB;IACjE,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC5B,IAAI,WAAW;QAAE,MAAM,CAAC,YAAY,GAAG,WAAW,CAAC;IACnD,WAAW,CAAC,MAAM,CAAC,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,mBAAmB,EAAE,CAAC;IACtB,OAAO,MAAM,CAAC,KAAK,CAAC;IACpB,OAAO,MAAM,CAAC,KAAK,CAAC;IACpB,WAAW,CAAC,MAAM,CAAC,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;IACzB,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;QACvD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/client.d.ts

@@ -0,0 +1,287 @@
+export declare class ApiError extends Error {
+    status: number;
+    code: string;
+    constructor(status: number, code: string, message: string);
+}
+export declare const sendMagicLink: (email: string) => Promise<{
+    status: string;
+    message: string;
+}>;
+export declare const verifyMagicLink: (token: string) => Promise<{
+    token: string;
+    user: User;
+    organizations: Org[];
+}>;
+export declare const completeRegistration: (token: string) => Promise<{
+    token: string;
+    user: User;
+    organizations: Org[];
+}>;
+export declare const getMe: () => Promise<{
+    user: User;
+    organizations: Org[];
+}>;
+export declare const logout: () => Promise<{
+    status: string;
+}>;
+export declare const listOrganizations: () => Promise<{
+    organizations: Org[];
+}>;
+export declare const getOrganization: (slug: string) => Promise<{
+    organization: Org;
+    projects: Project[];
+}>;
+export declare const createOrganization: (name: string) => Promise<{
+    organization: Org;
+}>;
+export declare const inviteMember: (orgSlug: string, email: string, role?: string) => Promise<{
+    invitation: unknown;
+}>;
+export declare const listProjects: () => Promise<{
+    projects: Project[];
+}>;
+export declare const getProject: (id: string) => Promise<{
+    project: Project;
+}>;
+export declare const createProject: (orgSlug: string, name: string, timezone?: string) => Promise<{
+    project: Project;
+}>;
+export declare const updateProject: (id: string, attrs: Record<string, unknown>) => Promise<{
+    project: Project;
+}>;
+export declare const deleteProject: (id: string) => Promise<{
+    status: string;
+}>;
+export declare const listApiKeys: (projectId: string) => Promise<{
+    api_keys: ApiKey[];
+}>;
+export declare const createApiKey: (projectId: string, name: string) => Promise<{
+    api_key: ApiKey & {
+        key: string;
+    };
+}>;
+export declare const revokeApiKey: (projectId: string, keyId: string) => Promise<{
+    status: string;
+}>;
+export declare const getDashboard: (projectId: string, params?: Record<string, string>) => Promise<DashboardResponse>;
+export declare const getDashboardFilters: (projectId: string) => Promise<FiltersResponse>;
+export declare const listEvents: (projectId: string, params?: Record<string, string>) => Promise<{
+    events: Event[];
+}>;
+export declare const listEventTypes: (projectId: string, params?: Record<string, string>) => Promise<{
+    event_types: EventType[];
+}>;
+export declare const listEventDefinitions: (projectId: string) => Promise<{
+    event_definitions: EventDefinition[];
+}>;
+export declare const listInsights: (projectId: string) => Promise<{
+    insights: SavedQuery[];
+}>;
+export declare const getInsight: (projectId: string, id: string) => Promise<{
+    insight: SavedQuery;
+}>;
+export declare const createInsight: (projectId: string, attrs: Record<string, unknown>) => Promise<{
+    insight: SavedQuery;
+}>;
+export declare const updateInsight: (projectId: string, id: string, attrs: Record<string, unknown>) => Promise<{
+    insight: SavedQuery;
+}>;
+export declare const deleteInsight: (projectId: string, id: string) => Promise<{
+    status: string;
+}>;
+export declare const executeInsight: (projectId: string, id: string) => Promise<{
+    query: SavedQuery;
+    results: unknown;
+}>;
+export declare const executeAdHocQuery: (projectId: string, query: Record<string, unknown>) => Promise<{
+    results: unknown;
+}>;
+export declare const listFunnels: (projectId: string) => Promise<{
+    funnels: Funnel[];
+}>;
+export declare const getFunnel: (projectId: string, id: string) => Promise<{
+    funnel: Funnel;
+}>;
+export declare const createFunnel: (projectId: string, attrs: Record<string, unknown>) => Promise<{
+    funnel: Funnel;
+}>;
+export declare const updateFunnel: (projectId: string, id: string, attrs: Record<string, unknown>) => Promise<{
+    funnel: Funnel;
+}>;
+export declare const deleteFunnel: (projectId: string, id: string) => Promise<{
+    status: string;
+}>;
+export declare const executeFunnel: (projectId: string, id: string) => Promise<{
+    funnel: Funnel;
+    results: unknown;
+}>;
+export declare const executeAdHocFunnel: (projectId: string, funnel: Record<string, unknown>) => Promise<{
+    results: unknown;
+}>;
+export declare const listRetentions: (projectId: string) => Promise<{
+    retentions: Retention[];
+}>;
+export declare const getRetention: (projectId: string, id: string) => Promise<{
+    retention: Retention;
+}>;
+export declare const createRetention: (projectId: string, attrs: Record<string, unknown>) => Promise<{
+    retention: Retention;
+}>;
+export declare const updateRetention: (projectId: string, id: string, attrs: Record<string, unknown>) => Promise<{
+    retention: Retention;
+}>;
+export declare const deleteRetention: (projectId: string, id: string) => Promise<{
+    status: string;
+}>;
+export declare const executeRetention: (projectId: string, id: string) => Promise<{
+    retention: Retention;
+    results: unknown;
+}>;
+export declare const executeAdHocRetention: (projectId: string, retention: Record<string, unknown>) => Promise<{
+    results: unknown;
+}>;
+export declare const listExperiments: (projectId: string) => Promise<{
+    experiments: Experiment[];
+}>;
+export declare const getExperiment: (projectId: string, id: string, params?: Record<string, string>) => Promise<{
+    experiment: Experiment;
+    results?: unknown;
+}>;
+export declare const createExperiment: (projectId: string, attrs: Record<string, unknown>) => Promise<{
+    experiment: Experiment;
+}>;
+export declare const updateExperiment: (projectId: string, id: string, attrs: Record<string, unknown>) => Promise<{
+    experiment: Experiment;
+}>;
+export declare const deleteExperiment: (projectId: string, id: string) => Promise<{
+    status: string;
+}>;
+export declare const startExperiment: (projectId: string, id: string) => Promise<{
+    experiment: Experiment;
+}>;
+export declare const stopExperiment: (projectId: string, id: string) => Promise<{
+    experiment: Experiment;
+}>;
+export declare const listWidgets: (projectId: string) => Promise<{
+    widgets: Widget[];
+}>;
+export declare const createWidget: (projectId: string, attrs: Record<string, unknown>) => Promise<{
+    widget: Widget;
+}>;
+export declare const updateWidget: (projectId: string, id: string, attrs: Record<string, unknown>) => Promise<{
+    widget: Widget;
+}>;
+export declare const deleteWidget: (projectId: string, id: string) => Promise<{
+    status: string;
+}>;
+export declare const resetWidgets: (projectId: string) => Promise<{
+    widgets: Widget[];
+}>;
+export interface User {
+    id: string;
+    email: string;
+    confirmed_at: string | null;
+    is_admin: boolean;
+}
+export interface Org {
+    id: string;
+    name: string;
+    slug: string;
+    plan?: string;
+    role?: string;
+    events_per_month_limit?: number;
+}
+export interface Project {
+    id: string;
+    name: string;
+    slug?: string;
+    timezone: string;
+    organization_id?: string;
+}
+export interface ApiKey {
+    id: string;
+    name: string;
+    key_prefix?: string;
+    last_used_at?: string;
+    created_at?: string;
+}
+export interface DashboardResponse {
+    stats: {
+        total_events: number;
+        unique_users: number;
+        events_trend: number;
+        users_trend: number;
+    };
+    events_by_day: {
+        date: string;
+        count: number;
+    }[];
+    top_events: {
+        name: string;
+        count: number;
+    }[];
+}
+export interface FiltersResponse {
+    event_names: string[];
+    platforms: string[];
+    environments: string[];
+    countries?: string[];
+    app_versions?: string[];
+}
+export interface Event {
+    id: string;
+    name: string;
+    user_id?: string;
+    properties?: Record<string, unknown>;
+    timestamp: string;
+}
+export interface EventType {
+    name: string;
+    count: number;
+}
+export interface EventDefinition {
+    id: string;
+    name: string;
+    description?: string;
+}
+export interface SavedQuery {
+    id: string;
+    name: string;
+    description?: string;
+    visualization?: string;
+    query_definition?: Record<string, unknown>;
+    last_run_at?: string;
+    run_count?: number;
+}
+export interface Funnel {
+    id: string;
+    name: string;
+    steps: {
+        event_name: string;
+        name?: string;
+    }[];
+    conversion_window_minutes?: number;
+    date_range?: string;
+}
+export interface Retention {
+    id: string;
+    name: string;
+    cohort_event: string;
+    retention_event?: string | null;
+    cohort_grain: string;
+    retention_days: number[];
+    date_range?: string;
+}
+export interface Experiment {
+    id: string;
+    name: string;
+    variants: string[];
+    goal_event: string;
+    status?: string;
+}
+export interface Widget {
+    id: string;
+    widget_type: string;
+    position?: number;
+    size?: string;
+}