maintouch 0.1.0

package/README.md

@@ -0,0 +1,75 @@
+# Maintouch CLI
+
+The Maintouch CLI wraps the public API in a script-friendly command line tool.
+
+```bash
+maintouch
+maintouch auth setup
+maintouch auth validate
+maintouch posts export --status scheduled
+maintouch performance summary --start-date 2026-01-01 --end-date 2026-03-31
+maintouch on-page actions --limit 25
+```
+
+## Install
+
+From this monorepo:
+
+```bash
+pnpm --filter maintouch build
+node packages/cli/dist/index.js help
+```
+
+When published:
+
+```bash
+npm install -g maintouch
+```
+
+## Auth
+
+Run `maintouch` to open the interactive shell. Inside the shell you can type commands without the `maintouch` prefix.
+
+```text
+maintouch › setup
+Maintouch API key:
+maintouch › posts export --status scheduled
+```
+
+Save your API key once.
+
+```bash
+maintouch auth setup
+```
+
+The CLI opens Maintouch in your browser, where you can create a CLI API key with one click. Copy the new key, return to the terminal, and paste it into the hidden prompt. The CLI stores credentials in `~/.config/maintouch/config.json` with `0600` permissions. `maintouch auth login` still works as an alias, but `auth setup` is the clearer command because this configures API-key access. Avoid passing live API keys with `--api-key` in a shell because that can leave the key in shell history.
+
+Check the active credential source.
+
+```bash
+maintouch auth status
+```
+
+Environment variables and flags still work as one-off overrides.
+
+```bash
+export MAINTOUCH_API_KEY="mt_live_YOUR_KEY_HERE"
+maintouch posts export
+```
+
+The default API URL is `https://api.maintouch.com`. Override it with `MAINTOUCH_API_URL` or `--base-url` only for trusted development endpoints. By default, the CLI refuses to send API keys to non-Maintouch hosts except localhost. Use `--allow-insecure-base-url` or `MAINTOUCH_ALLOW_INSECURE_API_URL=1` only when you control the target server.
+
+The browser login helper opens `https://app.maintouch.com` by default. Override it with `MAINTOUCH_APP_URL` for local development.
+
+Network requests time out after 30 seconds. Override this with `--timeout <milliseconds>` or `MAINTOUCH_TIMEOUT_MS`.
+
+## Commands
+
+Run `maintouch help` for the full command list.
+
+The CLI prints JSON by default. Use `--raw` when you want compact JSON.
+
+```bash
+maintouch keyword-gaps gaps --competitors acme.com,rival.io --limit 10
+maintouch request GET /v1/performance/pages --query period=3m --query limit=10
+```

package/dist/args.d.ts

@@ -0,0 +1,12 @@
+export type ParsedArgs = {
+    positional: string[];
+    options: Record<string, string | boolean | string[]>;
+};
+export declare function parseArgs(argv: string[]): ParsedArgs;
+export declare function splitCommandLine(input: string): string[];
+export declare function toCamelCase(value: string): string;
+export declare function getString(options: ParsedArgs["options"], key: string): string | undefined;
+export declare function getBoolean(options: ParsedArgs["options"], key: string): boolean;
+export declare function getStringList(options: ParsedArgs["options"], key: string): string[];
+export declare function getRepeatedStrings(options: ParsedArgs["options"], key: string): string[];
+//# sourceMappingURL=args.d.ts.map

package/dist/args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG;IACvB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,CAAC,CAAC;CACtD,CAAC;AAEF,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CA4CpD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAgDxD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjD;AAiBD,wBAAgB,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKzF;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAE/E;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,UAAU,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAQnF;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,UAAU,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAKxF"}

package/dist/args.js

@@ -0,0 +1,125 @@
+export function parseArgs(argv) {
+    const positional = [];
+    const options = {};
+    for (let index = 0; index < argv.length; index += 1) {
+        const arg = argv[index];
+        if (arg === "--") {
+            positional.push(...argv.slice(index + 1));
+            break;
+        }
+        if (!arg.startsWith("-") || arg === "-") {
+            positional.push(arg);
+            continue;
+        }
+        if (arg.startsWith("--no-")) {
+            options[toCamelCase(arg.slice(5))] = false;
+            continue;
+        }
+        const option = arg.startsWith("--") ? arg.slice(2) : arg.slice(1);
+        const equalsIndex = option.indexOf("=");
+        const rawKey = equalsIndex === -1 ? option : option.slice(0, equalsIndex);
+        const key = toCamelCase(rawKey);
+        const inlineValue = equalsIndex === -1 ? undefined : option.slice(equalsIndex + 1);
+        if (inlineValue !== undefined) {
+            addOption(options, key, inlineValue);
+            continue;
+        }
+        const next = argv[index + 1];
+        if (next !== undefined && (!next.startsWith("-") || next === "-")) {
+            addOption(options, key, next);
+            index += 1;
+            continue;
+        }
+        addOption(options, key, true);
+    }
+    return { positional, options };
+}
+export function splitCommandLine(input) {
+    const args = [];
+    let current = "";
+    let quote;
+    let escaping = false;
+    for (const char of input.trim()) {
+        if (escaping) {
+            current += char;
+            escaping = false;
+            continue;
+        }
+        if (char === "\\") {
+            escaping = true;
+            continue;
+        }
+        if (quote !== undefined) {
+            if (char === quote) {
+                quote = undefined;
+            }
+            else {
+                current += char;
+            }
+            continue;
+        }
+        if (char === "\"" || char === "'") {
+            quote = char;
+            continue;
+        }
+        if (/\s/.test(char)) {
+            if (current.length > 0) {
+                args.push(current);
+                current = "";
+            }
+            continue;
+        }
+        current += char;
+    }
+    if (escaping)
+        current += "\\";
+    if (quote !== undefined)
+        throw new Error(`Unclosed ${quote} quote.`);
+    if (current.length > 0)
+        args.push(current);
+    return args;
+}
+export function toCamelCase(value) {
+    return value.replace(/-([a-z])/g, (_, letter) => letter.toUpperCase());
+}
+function addOption(options, key, value) {
+    const current = options[key];
+    if (current === undefined) {
+        options[key] = value;
+        return;
+    }
+    if (Array.isArray(current)) {
+        current.push(String(value));
+        return;
+    }
+    options[key] = [String(current), String(value)];
+}
+export function getString(options, key) {
+    const value = options[key];
+    if (Array.isArray(value))
+        return value.at(-1);
+    if (typeof value === "string")
+        return value;
+    return undefined;
+}
+export function getBoolean(options, key) {
+    return options[key] === true;
+}
+export function getStringList(options, key) {
+    const value = options[key];
+    if (value === undefined || value === false)
+        return [];
+    const values = Array.isArray(value) ? value : [value];
+    return values
+        .flatMap(item => String(item).split(","))
+        .map(item => item.trim())
+        .filter(Boolean);
+}
+export function getRepeatedStrings(options, key) {
+    const value = options[key];
+    if (value === undefined || value === false)
+        return [];
+    const values = Array.isArray(value) ? value : [value];
+    return values.map(item => String(item));
+}
+//# sourceMappingURL=args.js.map

package/dist/args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"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"}

package/dist/ascii.d.ts

@@ -0,0 +1,4 @@
+export declare function colorize(value: string, color: "orange" | "bold" | "muted", enabled: boolean): string;
+export declare function renderHeader(enabled?: boolean, columns?: number): string;
+export declare function renderVersion(enabled?: boolean, columns?: number): string;
+//# sourceMappingURL=ascii.d.ts.map

package/dist/ascii.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ascii.d.ts","sourceRoot":"","sources":["../src/ascii.ts"],"names":[],"mappings":"AA8BA,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,MAAM,GAAG,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAKpG;AAED,wBAAgB,YAAY,CAAC,OAAO,UAAO,EAAE,OAAO,SAAK,GAAG,MAAM,CAUjE;AAED,wBAAgB,aAAa,CAAC,OAAO,UAAO,EAAE,OAAO,SAAK,GAAG,MAAM,CAElE"}

package/dist/ascii.js

@@ -0,0 +1,47 @@
+const RESET = "\x1b[0m";
+const BOLD = "\x1b[1m";
+const MUTED = "\x1b[2m";
+const ORANGE = "\x1b[38;2;255;101;0m";
+const WIDE_WORDMARK = String.raw `
+███╗   ███╗ █████╗ ██╗███╗   ██╗████████╗ ██████╗ ██╗   ██╗ ██████╗██╗  ██╗
+████╗ ████║██╔══██╗██║████╗  ██║╚══██╔══╝██╔═══██╗██║   ██║██╔════╝██║  ██║
+██╔████╔██║███████║██║██╔██╗ ██║   ██║   ██║   ██║██║   ██║██║     ███████║
+██║╚██╔╝██║██╔══██║██║██║╚██╗██║   ██║   ██║   ██║██║   ██║██║     ██╔══██║
+██║ ╚═╝ ██║██║  ██║██║██║ ╚████║   ██║   ╚██████╔╝╚██████╔╝╚██████╗██║  ██║
+╚═╝     ╚═╝╚═╝  ╚═╝╚═╝╚═╝  ╚═══╝   ╚═╝    ╚═════╝  ╚═════╝  ╚═════╝╚═╝  ╚═╝
+`.trim().split("\n");
+const COMPACT_WORDMARK = String.raw `
+███╗   ███╗ █████╗ ██╗███╗   ██╗████████╗
+████╗ ████║██╔══██╗██║████╗  ██║╚══██╔══╝
+██╔████╔██║███████║██║██╔██╗ ██║   ██║
+██║╚██╔╝██║██╔══██║██║██║╚██╗██║   ██║
+██║ ╚═╝ ██║██║  ██║██║██║ ╚████║   ██║
+╚═╝     ╚═╝╚═╝  ╚═╝╚═╝╚═╝  ╚═══╝   ╚═╝
+
+████████╗ ██████╗ ██╗   ██╗ ██████╗██╗  ██╗
+╚══██╔══╝██╔═══██╗██║   ██║██╔════╝██║  ██║
+   ██║   ██║   ██║██║   ██║██║     ███████║
+   ██║   ██║   ██║██║   ██║██║     ██╔══██║
+   ██║   ╚██████╔╝╚██████╔╝╚██████╗██║  ██║
+   ╚═╝    ╚═════╝  ╚═════╝  ╚═════╝╚═╝  ╚═╝
+`.trim().split("\n");
+export function colorize(value, color, enabled) {
+    if (!enabled)
+        return value;
+    const code = color === "orange" ? ORANGE : color === "bold" ? BOLD : MUTED;
+    return `${code}${value}${RESET}`;
+}
+export function renderHeader(enabled = true, columns = 80) {
+    const muted = (value) => colorize(value, "muted", enabled);
+    const wordmark = columns >= 79 ? WIDE_WORDMARK : COMPACT_WORDMARK;
+    return [
+        "",
+        ...wordmark.map(row => (row.length === 0 ? "" : ` ${colorize(row, "orange", enabled)}`)),
+        "",
+        ` ${colorize("✦", "orange", enabled)} ${colorize("Maintouch CLI", "bold", enabled)} ${muted("public API shell")}`,
+    ].join("\n");
+}
+export function renderVersion(enabled = true, columns = 80) {
+    return `${renderHeader(enabled, columns)}\n\n${colorize("maintouch", "bold", enabled)} 0.1.0\n`;
+}
+//# sourceMappingURL=ascii.js.map

package/dist/ascii.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ascii.js","sourceRoot":"","sources":["../src/ascii.ts"],"names":[],"mappings":"AAAA,MAAM,KAAK,GAAG,SAAS,CAAC;AACxB,MAAM,IAAI,GAAG,SAAS,CAAC;AACvB,MAAM,KAAK,GAAG,SAAS,CAAC;AACxB,MAAM,MAAM,GAAG,sBAAsB,CAAC;AAEtC,MAAM,aAAa,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;;;CAO/B,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAErB,MAAM,gBAAgB,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;CAclC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAErB,MAAM,UAAU,QAAQ,CAAC,KAAa,EAAE,KAAkC,EAAE,OAAgB;IAC1F,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAE3B,MAAM,IAAI,GAAG,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;IAC3E,OAAO,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,EAAE,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAO,GAAG,IAAI,EAAE,OAAO,GAAG,EAAE;IACvD,MAAM,KAAK,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACnE,MAAM,QAAQ,GAAG,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,gBAAgB,CAAC;IAElE,OAAO;QACL,EAAE;QACF,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,GAAG,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;QACxF,EAAE;QACF,IAAI,QAAQ,CAAC,GAAG,EAAE,QAAQ,EAAE,OAAO,CAAC,IAAI,QAAQ,CAAC,eAAe,EAAE,MAAM,EAAE,OAAO,CAAC,IAAI,KAAK,CAAC,kBAAkB,CAAC,EAAE;KAClH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAO,GAAG,IAAI,EAAE,OAAO,GAAG,EAAE;IACxD,OAAO,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC;AAClG,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,23 @@
+export type MaintouchConfig = {
+    apiKey?: string;
+    baseUrl?: string;
+};
+export declare const DEFAULT_BASE_URL = "https://api.maintouch.com";
+export declare const DEFAULT_APP_URL = "https://app.maintouch.com";
+export declare function getConfigPath(env: NodeJS.ProcessEnv): string;
+export declare function readConfig(env: NodeJS.ProcessEnv): MaintouchConfig;
+export declare function writeConfig(env: NodeJS.ProcessEnv, config: MaintouchConfig): string;
+export declare function deleteConfig(env: NodeJS.ProcessEnv): boolean;
+export declare function resolveCredentials(env: NodeJS.ProcessEnv, options: {
+    apiKey?: string;
+    baseUrl?: string;
+}): {
+    apiKey: string | undefined;
+    baseUrl: string;
+    source: string;
+    configPath: string;
+};
+export declare function resolveAppUrl(env: NodeJS.ProcessEnv): string;
+export declare function isSafeBaseUrl(baseUrl: string): boolean;
+export declare function redactKey(key: string | undefined): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,eAAO,MAAM,gBAAgB,8BAA8B,CAAC;AAC5D,eAAO,MAAM,eAAe,8BAA8B,CAAC;AAG3D,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAK5D;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,eAAe,CAelE;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,eAAe,GAAG,MAAM,CAMnF;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,OAAO,CAK5D;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,EAAE,OAAO,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;EAexG;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAE5D;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAYtD;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAIzD"}

package/dist/config.js

@@ -0,0 +1,87 @@
+import { chmodSync, existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+export const DEFAULT_BASE_URL = "https://api.maintouch.com";
+export const DEFAULT_APP_URL = "https://app.maintouch.com";
+const LOCAL_API_HOSTS = new Set(["localhost", "127.0.0.1", "::1", "[::1]"]);
+export function getConfigPath(env) {
+    if (env.MAINTOUCH_CONFIG)
+        return env.MAINTOUCH_CONFIG;
+    const configHome = env.XDG_CONFIG_HOME ?? join(homedir(), ".config");
+    return join(configHome, "maintouch", "config.json");
+}
+export function readConfig(env) {
+    const path = getConfigPath(env);
+    if (!existsSync(path))
+        return {};
+    try {
+        const parsed = JSON.parse(readFileSync(path, "utf8"));
+        if (!parsed || typeof parsed !== "object")
+            return {};
+        return {
+            apiKey: getStringField(parsed, "apiKey"),
+            baseUrl: getStringField(parsed, "baseUrl"),
+        };
+    }
+    catch {
+        return {};
+    }
+}
+export function writeConfig(env, config) {
+    const path = getConfigPath(env);
+    mkdirSync(dirname(path), { recursive: true, mode: 0o700 });
+    writeFileSync(path, `${JSON.stringify(config, null, 2)}\n`, { mode: 0o600 });
+    chmodSync(path, 0o600);
+    return path;
+}
+export function deleteConfig(env) {
+    const path = getConfigPath(env);
+    if (!existsSync(path))
+        return false;
+    rmSync(path);
+    return true;
+}
+export function resolveCredentials(env, options) {
+    const config = readConfig(env);
+    return {
+        apiKey: options.apiKey ?? env.MAINTOUCH_API_KEY ?? env.MT_API_KEY ?? config.apiKey,
+        baseUrl: options.baseUrl ?? env.MAINTOUCH_API_URL ?? config.baseUrl ?? DEFAULT_BASE_URL,
+        source: options.apiKey
+            ? "flag"
+            : env.MAINTOUCH_API_KEY || env.MT_API_KEY
+                ? "environment"
+                : config.apiKey
+                    ? "config"
+                    : "missing",
+        configPath: getConfigPath(env),
+    };
+}
+export function resolveAppUrl(env) {
+    return env.MAINTOUCH_APP_URL ?? DEFAULT_APP_URL;
+}
+export function isSafeBaseUrl(baseUrl) {
+    try {
+        const url = new URL(baseUrl);
+        const defaultUrl = new URL(DEFAULT_BASE_URL);
+        const isHttp = url.protocol === "http:" || url.protocol === "https:";
+        if (!isHttp)
+            return false;
+        // keep live api keys on maintouch or local dev origins by default
+        return url.origin === defaultUrl.origin || LOCAL_API_HOSTS.has(url.hostname);
+    }
+    catch {
+        return false;
+    }
+}
+export function redactKey(key) {
+    if (!key)
+        return "(not set)";
+    if (key.length <= 14)
+        return `${key.slice(0, 4)}...`;
+    return `${key.slice(0, 10)}...${key.slice(-4)}`;
+}
+function getStringField(value, key) {
+    const field = value[key];
+    return typeof field === "string" && field.length > 0 ? field : undefined;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/help.d.ts

@@ -0,0 +1,7 @@
+export declare function introText(color?: boolean, columns?: number): string;
+export declare function shellIntroText(color?: boolean, columns?: number): string;
+export declare function helpText(color?: boolean, columns?: number): string;
+export declare function commandsText(color?: boolean, columns?: number): string;
+export declare function workflowsText(color?: boolean, columns?: number): string;
+export declare function topicHelpText(topic: string | undefined, color?: boolean, columns?: number): string | undefined;
+//# sourceMappingURL=help.d.ts.map

package/dist/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":"AAEA,wBAAgB,SAAS,CAAC,KAAK,UAAO,EAAE,OAAO,SAAK,GAAG,MAAM,CAQ5D;AAED,wBAAgB,cAAc,CAAC,KAAK,UAAO,EAAE,OAAO,SAAK,GAAG,MAAM,CAOjE;AAED,wBAAgB,QAAQ,CAAC,KAAK,UAAO,EAAE,OAAO,SAAK,GAAG,MAAM,CAe3D;AAED,wBAAgB,YAAY,CAAC,KAAK,UAAO,EAAE,OAAO,SAAK,GAAG,MAAM,CAwC/D;AAED,wBAAgB,aAAa,CAAC,KAAK,UAAO,EAAE,OAAO,SAAK,GAAG,MAAM,CAiChE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,UAAO,EAAE,OAAO,SAAK,GAAG,MAAM,GAAG,SAAS,CA2FvG"}

package/dist/help.js

@@ -0,0 +1,196 @@
+import { colorize, renderHeader } from "./ascii.js";
+export function introText(color = true, columns = 80) {
+    const detail = (value) => colorize(value, "muted", color);
+    return `${renderHeader(color, columns)}
+
+  ${detail("Run")} maintouch ${detail("in a terminal to open the shell.")}
+  ${detail("Run")} maintouch help ${detail("to see commands.")}
+`;
+}
+export function shellIntroText(color = true, columns = 80) {
+    const detail = (value) => colorize(value, "muted", color);
+    return `${renderHeader(color, columns)}
+
+  ${detail("Type")} help ${detail("for commands,")} status ${detail("for auth,")} exit ${detail("to quit.")}
+`;
+}
+export function helpText(color = true, columns = 80) {
+    const section = (label) => colorize(label, "orange", color);
+    const detail = (value) => colorize(value, "muted", color);
+    void columns;
+    return `${section("Usage")}
+  maintouch <command> [options]
+
+${section("Start")}
+  maintouch                     ${detail("Open the interactive shell")}
+  maintouch auth setup          ${detail("Create and save your API key")}
+  maintouch commands            ${detail("List commands")}
+  maintouch workflows           ${detail("See common workflows")}
+  maintouch help <group>        ${detail("Show focused help")}
+`;
+}
+export function commandsText(color = true, columns = 80) {
+    const section = (label) => colorize(label, "orange", color);
+    const command = (value) => colorize(value.padEnd(34), "bold", color);
+    void columns;
+    return `${section("Commands")}
+  ${command("auth setup")}Create, save, and validate your API key
+  ${command("auth validate")}Check that your API key works
+  ${command("auth status")}Show the active credential source
+  ${command("auth logout")}Remove saved credentials
+  ${command("interactive")}Open the interactive shell
+  ${command("posts export")}Export scheduled or published posts
+  ${command("posts get")}Get one exported post by ID
+  ${command("posts mark-published")}Mark a post live after publishing
+  ${command("on-page actions")}List on-page SEO actions
+  ${command("on-page mark-resolved")}Resolve one or more SEO actions
+  ${command("on-page generate-suggestions")}Generate fixes for SEO actions
+  ${command("on-page accept-suggestion")}Accept a generated SEO suggestion
+  ${command("on-page ignore")}Ignore one or more SEO actions
+  ${command("on-page ignore-page")}Ignore actions for a page
+  ${command("ai prompts")}List tracked AI visibility prompts
+  ${command("ai prompt")}Get one tracked prompt
+  ${command("ai stats")}Get AI visibility rollups
+  ${command("ai highlights")}Show winning and at-risk prompts
+  ${command("keyword-gaps competitors")}List configured competitors
+  ${command("keyword-gaps start")}Start a keyword gap job
+  ${command("keyword-gaps jobs")}List keyword gap jobs
+  ${command("keyword-gaps job")}Get a keyword gap job
+  ${command("keyword-gaps gaps")}List keyword gap opportunities
+  ${command("performance summary")}Get dashboard summary metrics
+  ${command("performance pages")}Get page performance
+  ${command("performance queries")}Get query performance
+  ${command("performance live")}Get live performance data
+  ${command("content-ideas create")}Create queued content ideas
+  ${command("request")}Call any public API route
+
+${section("More Help")}
+  maintouch help <group>
+  maintouch workflows
+`;
+}
+export function workflowsText(color = true, columns = 80) {
+    const section = (label) => colorize(label, "orange", color);
+    void columns;
+    return `${section("Setup")}
+  maintouch auth setup
+  maintouch auth validate
+
+${section("Publishing")}
+  maintouch posts export --status scheduled
+  maintouch posts get <post-id>
+  maintouch posts mark-published <post-id> --url <published-url>
+
+${section("On-Page SEO")}
+  maintouch on-page actions --limit 25
+  maintouch on-page generate-suggestions <action-id>
+  maintouch on-page accept-suggestion <action-id>
+  maintouch on-page mark-resolved <action-id>
+
+${section("Performance")}
+  maintouch performance summary --start-date 2026-01-01 --end-date 2026-03-31
+  maintouch performance pages --period 3m --limit 25
+  maintouch performance queries --period 3m --limit 25
+
+${section("Keyword Gaps")}
+  maintouch keyword-gaps competitors
+  maintouch keyword-gaps start --competitor acme.com --competitor rival.io
+  maintouch keyword-gaps jobs --status completed
+  maintouch keyword-gaps gaps --competitors acme.com --limit 25
+
+${section("Content Queue")}
+  maintouch content-ideas create --title "How to improve page speed" --keyword "page speed"
+`;
+}
+export function topicHelpText(topic, color = true, columns = 80) {
+    const section = (label) => colorize(label, "orange", color);
+    void columns;
+    switch (topic) {
+        case "auth":
+            return `${section("auth")}
+  maintouch auth setup [--api-key <key>] [--base-url <url>]
+  maintouch auth login [--api-key <key>] [--base-url <url>]
+  maintouch auth validate
+  maintouch auth status
+  maintouch auth logout
+
+By default, setup stores credentials in ~/.config/maintouch/config.json.
+Setup opens Maintouch in your browser to create a CLI key.
+auth login is kept as an alias for auth setup.
+The API key prompt is hidden. Prefer MAINTOUCH_API_KEY for scripts.
+Use --api-key only when shell history is not a concern.
+Custom base URLs require --allow-insecure-base-url unless they are localhost.
+`;
+        case "interactive":
+        case "shell":
+            return `${section("interactive")}
+  maintouch
+  maintouch interactive
+  maintouch shell
+
+Inside the shell, type commands without the maintouch prefix.
+Aliases: setup, login, status, validate, logout, ?, exit.
+`;
+        case "posts":
+        case "blogs":
+            return `${section("posts")}
+  maintouch posts export [--status scheduled|published]
+  maintouch posts get <post-id>
+  maintouch posts mark-published <post-id> --url <published-url>
+
+Use this workflow to pull posts into your CMS and tell Maintouch when the post is live.
+The old "blogs" command group works as an alias.
+`;
+        case "on-page":
+            return `${section("on-page")}
+  maintouch on-page actions [--url <url>] [--type <type>] [--limit <n>] [--offset <n>]
+  maintouch on-page generate-suggestions <action-id...>
+  maintouch on-page accept-suggestion <action-id...>
+  maintouch on-page mark-resolved <action-id...>
+  maintouch on-page ignore <action-id...>
+  maintouch on-page ignore-page <url>
+`;
+        case "ai":
+            return `${section("ai")}
+  maintouch ai prompts [--limit <n>] [--offset <n>] [--llm-platform <provider>]
+  maintouch ai prompt <prompt-id>
+  maintouch ai stats [--time-range lastRun|7d|30d|90d|180d|365d]
+  maintouch ai highlights [--llm-platform <provider>]
+  maintouch ai fan-out-queries [public API query options]
+`;
+        case "keyword-gaps":
+            return `${section("keyword-gaps")}
+  maintouch keyword-gaps competitors
+  maintouch keyword-gaps start --competitor <domain> [--competitor <domain>]
+  maintouch keyword-gaps jobs [--status scheduled|processing|completed|failed]
+  maintouch keyword-gaps job <job-id>
+  maintouch keyword-gaps gaps [public API query options]
+`;
+        case "performance":
+            return `${section("performance")}
+  maintouch performance summary [--start-date YYYY-MM-DD] [--end-date YYYY-MM-DD] [--refresh]
+  maintouch performance pages [public API query options]
+  maintouch performance queries [public API query options]
+  maintouch performance live --start-date YYYY-MM-DD --end-date YYYY-MM-DD [public API query options]
+`;
+        case "content-ideas":
+            return `${section("content-ideas")}
+  maintouch content-ideas create --title <title> --keyword <keyword> [--keyword <keyword>]
+  maintouch content-ideas create --data '{"ideas":[...],"queuePosition":"tail"}'
+`;
+        case "request":
+            return `${section("request")}
+  maintouch request <method> <path> [--query key=value] [--data '{"json":true}']
+
+Use this escape hatch for public API routes that do not have a named command yet.
+Requests time out after 30 seconds. Override with --timeout <milliseconds>.
+`;
+        case "commands":
+            return commandsText(color, columns);
+        case "workflows":
+            return workflowsText(color, columns);
+        default:
+            return undefined;
+    }
+}
+//# sourceMappingURL=help.js.map

package/dist/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+export type CliIo = {
+    stdin?: NodeJS.ReadStream;
+    stdout: Pick<NodeJS.WriteStream, "write"> & {
+        columns?: number;
+    };
+    stderr: Pick<NodeJS.WriteStream, "write">;
+};
+export declare function runCli(argv: string[], env: NodeJS.ProcessEnv, io: CliIo, fetchImpl?: typeof fetch): Promise<number>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAYA,MAAM,MAAM,KAAK,GAAG;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAC1B,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,GAAG;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;CAC3C,CAAC;AAEF,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,OAAO,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CA8GzH"}