maintouch 0.1.0

package/dist/request.js

@@ -0,0 +1,338 @@
+import { getBoolean, getRepeatedStrings, getString, getStringList } from "./args.js";
+const DEFAULT_TIMEOUT_MS = 30000;
+const QUERY_KEYS = [
+    "limit",
+    "offset",
+    "status",
+    "url",
+    "type",
+    "llmPlatform",
+    "topicId",
+    "timeRange",
+    "period",
+    "query",
+    "aggregateBy",
+    "sortBy",
+    "sortOrder",
+    "sortMode",
+    "maintouchOnly",
+    "startDate",
+    "endDate",
+    "refresh",
+    "search",
+    "competitors",
+    "starredOnly",
+    "starredFirst",
+    "usedOnly",
+    "newOnly",
+    "includedKeywords",
+    "excludedKeywords",
+    "minDifficulty",
+    "maxDifficulty",
+    "minCompetitorRank",
+    "maxCompetitorRank",
+    "minCompetitorCount",
+    "minWords",
+    "maxWords",
+];
+export function buildRequestPlan(parsed) {
+    const [group, command, ...rest] = parsed.positional;
+    if (group === "request")
+        return buildRawRequest(parsed);
+    if (group === "auth" && command === "validate") {
+        return { method: "GET", path: "/v0/auth/validate" };
+    }
+    if (isPostsGroup(group) && command === "export") {
+        return { method: "GET", path: "/v1/blogs/public-export", query: pickQuery(parsed, ["status"]) };
+    }
+    if (isPostsGroup(group) && command === "get") {
+        const [id] = rest;
+        requireValue(id, "Post ID is required.");
+        return { method: "GET", path: `/v1/blogs/public-export/${encodeURIComponent(id)}` };
+    }
+    if (isPostsGroup(group) && command === "mark-published") {
+        const [id] = rest;
+        const publishedUrl = getString(parsed.options, "url") ?? getString(parsed.options, "publishedUrl");
+        requireValue(id, "Post ID is required.");
+        requireValue(publishedUrl, "--url is required.");
+        return {
+            method: "POST",
+            path: `/v1/blogs/${encodeURIComponent(id)}/mark-published`,
+            body: { publishedUrl },
+        };
+    }
+    if (group === "on-page" && command === "actions") {
+        return { method: "GET", path: "/v1/on-page/actions", query: pickQuery(parsed, ["url", "type", "limit", "offset"]) };
+    }
+    if (group === "on-page" && command === "mark-resolved") {
+        const actionIds = rest.length > 0 ? rest : getStringList(parsed.options, "actionIds");
+        requireList(actionIds, "At least one action ID is required.");
+        return { method: "POST", path: "/v1/on-page/actions/mark-resolved", body: { actionIds } };
+    }
+    if (group === "on-page" && command === "generate-suggestions") {
+        return actionIdsBodyRequest(parsed, "/v1/on-page/actions/generate-suggestions");
+    }
+    if (group === "on-page" && command === "accept-suggestion") {
+        return actionIdsBodyRequest(parsed, "/v1/on-page/actions/accept-suggestion");
+    }
+    if (group === "on-page" && command === "ignore") {
+        return actionIdsBodyRequest(parsed, "/v1/on-page/actions/ignore");
+    }
+    if (group === "on-page" && command === "ignore-page") {
+        const url = getString(parsed.options, "url") ?? rest[0];
+        requireValue(url, "Page URL is required.");
+        return { method: "POST", path: "/v1/on-page/actions/ignore-page", body: { urls: [url] } };
+    }
+    if (group === "ai" && command === "prompts") {
+        return { method: "GET", path: "/v1/ai-visibility/prompts", query: pickQuery(parsed, ["limit", "offset", "llmPlatform", "topicId"]) };
+    }
+    if (group === "ai" && command === "prompt") {
+        const [id] = rest;
+        requireValue(id, "Prompt ID is required.");
+        return { method: "GET", path: `/v1/ai-visibility/prompts/${encodeURIComponent(id)}` };
+    }
+    if (group === "ai" && command === "stats") {
+        return { method: "GET", path: "/v1/ai-visibility/stats", query: pickQuery(parsed, ["timeRange", "llmPlatform"]) };
+    }
+    if (group === "ai" && command === "highlights") {
+        return { method: "GET", path: "/v1/ai-visibility/highlights", query: pickQuery(parsed, ["llmPlatform"]) };
+    }
+    if (group === "ai" && command === "fan-out-queries") {
+        return { method: "GET", path: "/v1/ai-visibility/fan-out-queries", query: pickKnownQuery(parsed) };
+    }
+    if (group === "keyword-gaps" && command === "competitors") {
+        return { method: "GET", path: "/v1/keyword-gaps/competitors" };
+    }
+    if (group === "keyword-gaps" && command === "start") {
+        const competitorDomains = getStringList(parsed.options, "competitor")
+            .concat(getStringList(parsed.options, "competitors"))
+            .concat(getStringList(parsed.options, "competitorDomains"));
+        requireList(competitorDomains, "Pass at least one --competitor.");
+        return {
+            method: "POST",
+            path: "/v1/keyword-gaps/start-job",
+            body: {
+                competitorDomains,
+                ...pickNumberBody(parsed, ["minCompetitorRank", "maxCompetitorRank", "minDifficulty", "maxDifficulty"]),
+            },
+        };
+    }
+    if (group === "keyword-gaps" && command === "jobs") {
+        return { method: "GET", path: "/v1/keyword-gaps/jobs", query: pickQuery(parsed, ["limit", "offset", "status"]) };
+    }
+    if (group === "keyword-gaps" && command === "job") {
+        const [id] = rest;
+        requireValue(id, "Job ID is required.");
+        return { method: "GET", path: `/v1/keyword-gaps/jobs/${encodeURIComponent(id)}` };
+    }
+    if (group === "keyword-gaps" && command === "gaps") {
+        return { method: "GET", path: "/v1/keyword-gaps/gaps", query: pickKnownQuery(parsed) };
+    }
+    if (group === "performance" && ["summary", "pages", "queries", "live"].includes(command ?? "")) {
+        return { method: "GET", path: `/v1/performance/${command}`, query: pickKnownQuery(parsed) };
+    }
+    if (group === "content-ideas" && command === "create") {
+        const data = getString(parsed.options, "data");
+        if (data)
+            return { method: "POST", path: "/v1/content-ideas", body: parseJson(data, "--data") };
+        const title = getString(parsed.options, "title");
+        const keywords = getStringList(parsed.options, "keyword").concat(getStringList(parsed.options, "keywords"));
+        requireValue(title, "--title is required unless --data is provided.");
+        requireList(keywords, "Pass at least one --keyword unless --data is provided.");
+        return {
+            method: "POST",
+            path: "/v1/content-ideas",
+            body: {
+                ideas: [
+                    {
+                        title,
+                        keywords,
+                        primarySeoUrl: getString(parsed.options, "primarySeoUrl"),
+                        type: getString(parsed.options, "type"),
+                        rationale: getString(parsed.options, "rationale"),
+                        instructions: getString(parsed.options, "instructions"),
+                    },
+                ],
+                queuePosition: getString(parsed.options, "queuePosition"),
+            },
+        };
+    }
+    throw new CliError(`Unknown command: ${parsed.positional.join(" ") || "(none)"}`, 2);
+}
+export function buildUrl(baseUrl, plan) {
+    const url = new URL(plan.path, normalizeBaseUrl(baseUrl));
+    for (const [key, value] of Object.entries(plan.query ?? {})) {
+        if (value === undefined || value === false)
+            continue;
+        if (Array.isArray(value)) {
+            for (const item of value)
+                url.searchParams.append(key, item);
+            continue;
+        }
+        url.searchParams.set(key, String(value));
+    }
+    return url;
+}
+export async function sendRequest(plan, config) {
+    const fetchImpl = config.fetchImpl ?? fetch;
+    const url = buildUrl(config.baseUrl, plan);
+    const timeoutMs = config.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), timeoutMs);
+    const headers = {
+        Authorization: `Bearer ${config.apiKey}`,
+    };
+    if (plan.body !== undefined) {
+        headers["Content-Type"] = "application/json";
+    }
+    let response;
+    try {
+        response = await fetchImpl(url, {
+            method: plan.method,
+            headers,
+            signal: controller.signal,
+            body: plan.body === undefined ? undefined : JSON.stringify(stripUndefined(plan.body)),
+        });
+    }
+    catch (error) {
+        if (error instanceof Error && error.name === "AbortError") {
+            throw new CliError(`Request timed out after ${timeoutMs}ms.`, 1);
+        }
+        throw error;
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+    const text = await response.text();
+    const payload = parseResponsePayload(text, response.headers.get("content-type"));
+    if (!response.ok) {
+        const message = extractErrorMessage(payload) ?? textSnippet(text) ?? response.statusText;
+        throw new CliError(`Maintouch API returned ${response.status}: ${message}`, 1);
+    }
+    return payload;
+}
+function buildRawRequest(parsed) {
+    const [, rawMethod, rawPath] = parsed.positional;
+    requireValue(rawMethod, "HTTP method is required.");
+    requireValue(rawPath, "Path is required.");
+    const method = rawMethod.toUpperCase();
+    if (!["GET", "POST", "PUT", "PATCH", "DELETE"].includes(method)) {
+        throw new CliError(`Unsupported method: ${rawMethod}`, 2);
+    }
+    const query = {};
+    for (const pair of getRepeatedStrings(parsed.options, "query")) {
+        const [key, ...rest] = pair.split("=");
+        requireValue(key, "--query values must look like key=value.");
+        query[key] = [...(query[key] ?? []), rest.join("=")];
+    }
+    const data = getString(parsed.options, "data");
+    return {
+        method: method,
+        path: rawPath.startsWith("/") ? rawPath : `/${rawPath}`,
+        query,
+        body: data === undefined ? undefined : parseJson(data, "--data"),
+    };
+}
+function actionIdsBodyRequest(parsed, path) {
+    const ids = parsed.positional.slice(2).concat(getStringList(parsed.options, "actionIds"));
+    requireList(ids, "At least one action ID is required.");
+    return { method: "POST", path, body: { actionIds: ids } };
+}
+function isPostsGroup(group) {
+    return group === "posts" || group === "blogs";
+}
+function pickKnownQuery(parsed) {
+    return pickQuery(parsed, [...QUERY_KEYS]);
+}
+function pickQuery(parsed, keys) {
+    const query = {};
+    for (const key of keys) {
+        const stringValue = getString(parsed.options, key);
+        if (stringValue !== undefined)
+            query[key] = stringValue;
+        if (getBoolean(parsed.options, key))
+            query[key] = true;
+    }
+    return query;
+}
+function pickNumberBody(parsed, keys) {
+    const body = {};
+    for (const key of keys) {
+        const value = getString(parsed.options, key);
+        if (value === undefined)
+            continue;
+        const numberValue = Number(value);
+        if (!Number.isInteger(numberValue))
+            throw new CliError(`--${toKebabCase(key)} must be an integer.`, 2);
+        body[key] = numberValue;
+    }
+    return body;
+}
+function toKebabCase(value) {
+    return value.replace(/[A-Z]/g, letter => `-${letter.toLowerCase()}`);
+}
+function requireValue(value, message) {
+    if (value === undefined || value === null || value === "") {
+        throw new CliError(message, 2);
+    }
+}
+function requireList(value, message) {
+    if (value.length === 0)
+        throw new CliError(message, 2);
+}
+function parseJson(value, label) {
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        throw new CliError(`Invalid JSON in ${label}.`, 2);
+    }
+}
+function parseResponsePayload(text, contentType) {
+    if (text.length === 0)
+        return null;
+    // parse json when the api or proxy says it is json
+    if (contentType?.toLowerCase().includes("json"))
+        return parseJson(text, "response");
+    // tolerate plain text/html error pages from proxies
+    const trimmed = text.trimStart();
+    if (trimmed.startsWith("{") || trimmed.startsWith("["))
+        return parseJson(text, "response");
+    return text;
+}
+function textSnippet(text) {
+    const normalized = text.replace(/\s+/g, " ").trim();
+    if (!normalized)
+        return undefined;
+    return normalized.length > 240 ? `${normalized.slice(0, 240)}...` : normalized;
+}
+function normalizeBaseUrl(baseUrl) {
+    return baseUrl.endsWith("/") ? baseUrl : `${baseUrl}/`;
+}
+function stripUndefined(value) {
+    if (Array.isArray(value))
+        return value.map(stripUndefined);
+    if (value && typeof value === "object") {
+        return Object.fromEntries(Object.entries(value)
+            .filter(([, entry]) => entry !== undefined)
+            .map(([key, entry]) => [key, stripUndefined(entry)]));
+    }
+    return value;
+}
+function extractErrorMessage(payload) {
+    if (!payload || typeof payload !== "object")
+        return undefined;
+    if ("message" in payload && typeof payload.message === "string")
+        return payload.message;
+    if ("error" in payload && typeof payload.error === "string")
+        return payload.error;
+    return undefined;
+}
+export class CliError extends Error {
+    constructor(message, exitCode) {
+        super(message);
+        this.name = "CliError";
+        this.exitCode = exitCode;
+    }
+}
+//# sourceMappingURL=request.js.map

package/dist/request.js.map

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

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "maintouch",
+  "version": "0.1.0",
+  "description": "Command-line interface for the Maintouch public API.",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/maintouch/maintouch.git",
+    "directory": "packages/cli"
+  },
+  "bin": {
+    "maintouch": "./dist/index.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "rm -rf dist && tsc && chmod +x dist/index.js",
+    "test": "pnpm build && node --test test/*.test.mjs",
+    "typecheck": "tsc --noEmit --incremental --tsBuildInfoFile .cache/tsc.tsbuildinfo"
+  },
+  "keywords": [
+    "maintouch",
+    "cli",
+    "api"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "devDependencies": {
+    "@types/node": "22.19.17",
+    "typescript": "~5.7.2"
+  }
+}