salesprompter-cli 0.1.2 → 0.1.3

package/README.md

@@ -12,6 +12,25 @@
 - Analyze upstream lead-list and domain-enrichment bottlenecks
 - Replace opaque Pipedream logic with deterministic CLI workflows
 
+## Documentation
+
+This repository now includes a Mintlify docs site for the wider Salesprompter universe, including the app contract, CLI surface, Chrome extension contract, and the main warehouse-backed workflows.
+
+- Docs home: `./index.mdx`
+- Quickstart: `./quickstart.mdx`
+- Architecture: `./architecture.mdx`
+- App: `./platform/app.mdx`
+- CLI: `./platform/cli.mdx`
+- Chrome extension: `./platform/chrome-extension.mdx`
+- Domain finder: `./workflows/domain-finder.mdx`
+- Command reference: `./reference/cli.mdx`
+
+Run the docs locally with:
+
+```bash
+npm run docs:dev
+```
+
 ## Integration Contract
 
 This CLI is not a standalone toy. It is a production integration surface for the Salesprompter app.
@@ -39,11 +58,11 @@ Global output flags:
 The CLI stores a local session file at `~/.config/salesprompter/auth-session.json` (or `SALESPROMPTER_CONFIG_DIR`).
 
 ```bash
-# Device flow through Salesprompter backend (recommended)
-salesprompter auth:login
+# Production path: generate a short-lived CLI token in the Salesprompter app
+salesprompter auth:login --token "$SALESPROMPTER_TOKEN" --api-url "https://salesprompter.ai"
 
-# Direct login using app-issued bearer token
-salesprompter auth:login --token "$SALESPROMPTER_TOKEN"
+# Optional: use device flow only if your Salesprompter app exposes it
+salesprompter auth:login
 
 # Verify active identity with backend
 salesprompter auth:whoami --verify
@@ -54,7 +73,7 @@ salesprompter auth:logout
 
 Environment variables:
 
-- `SALESPROMPTER_API_BASE_URL`: override backend URL (default `https://app.salesprompter.com`)
+- `SALESPROMPTER_API_BASE_URL`: override backend URL (default `https://salesprompter.ai`)
 - `SALESPROMPTER_CONFIG_DIR`: override local config dir
 - `SALESPROMPTER_SKIP_AUTH=1`: bypass auth guard (tests/dev only)
 - `INSTANTLY_API_KEY`: required for real `sync:outreach --target instantly`
@@ -63,11 +82,12 @@ Environment variables:
 
 App compatibility:
 
-- If your app exposes `/api/cli/auth/device/start` and `/api/cli/auth/device/poll`, use `salesprompter auth:login`.
+- Current Salesprompter production uses app-issued CLI tokens.
+- If your app exposes `/api/cli/auth/device/start` and `/api/cli/auth/device/poll`, `salesprompter auth:login` will use device flow.
 - If device auth is not enabled, create a CLI token from the app endpoint `POST /api/cli/auth/token` and use:
 
 ```bash
-salesprompter auth:login --token "<token-from-app>"
+salesprompter auth:login --token "<token-from-app>" --api-url "https://salesprompter.ai"
 ```
 
 ## Why this shape works for humans and LLMs

package/dist/auth.js

@@ -2,7 +2,7 @@ import os from "node:os";
 import path from "node:path";
 import { access, mkdir, readFile, rm, writeFile } from "node:fs/promises";
 import { z } from "zod";
-const DEFAULT_API_BASE_URL = "https://app.salesprompter.com";
+const DEFAULT_API_BASE_URL = "https://salesprompter.ai";
 const CLIENT_HEADER = "salesprompter-cli/0.2";
 const DEFAULT_DEVICE_POLL_INTERVAL_SECONDS = 3;
 const DEFAULT_DEVICE_TIMEOUT_SECONDS = 180;
@@ -94,6 +94,18 @@ function normalizeApiBaseUrl(apiBaseUrl) {
     const value = (apiBaseUrl ?? process.env.SALESPROMPTER_API_BASE_URL ?? DEFAULT_API_BASE_URL).trim();
     return value.replace(/\/+$/, "");
 }
+function isDeviceFlowUnavailableError(message) {
+    if (message.includes("invalid JSON response")) {
+        return true;
+    }
+    return /request failed \((401|403|404|405|500|501|502|503|504)\)/.test(message);
+}
+function buildDeviceFlowUnavailableMessage(apiBaseUrl) {
+    return [
+        "device login is not configured on this Salesprompter app.",
+        `Generate a CLI token in the app and run \`salesprompter auth:login --token <token> --api-url "${apiBaseUrl}"\`.`
+    ].join(" ");
+}
 async function hasSessionFile() {
     try {
         await access(getSessionPath());
@@ -106,7 +118,18 @@ async function hasSessionFile() {
 async function httpJson(url, init, schema) {
     const response = await fetch(url, init);
     const text = await response.text();
-    const payload = text.length > 0 ? JSON.parse(text) : {};
+    let payload = {};
+    if (text.length > 0) {
+        try {
+            payload = JSON.parse(text);
+        }
+        catch {
+            if (!response.ok) {
+                throw new Error(`request failed (${response.status}) for ${url}`);
+            }
+            throw new Error(`invalid JSON response for ${url}`);
+        }
+    }
     if (!response.ok) {
         throw new Error(`request failed (${response.status}) for ${url}`);
     }
@@ -195,8 +218,8 @@ export async function loginWithDeviceFlow(options) {
     }
     catch (error) {
         const message = error instanceof Error ? error.message : String(error);
-        if (message.includes("(404)")) {
-            throw new Error("device login is not configured on this Salesprompter app. Generate a CLI token in the app and run `salesprompter auth:login --token <token>`.");
+        if (isDeviceFlowUnavailableError(message)) {
+            throw new Error(buildDeviceFlowUnavailableMessage(apiBaseUrl));
         }
         throw error;
     }

package/dist/cli.js

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+import { createRequire } from "node:module";
 import { Command } from "commander";
 import { z } from "zod";
 import { clearAuthSession, loginWithDeviceFlow, loginWithToken, requireAuthSession, shouldBypassAuth, verifySession } from "./auth.js";
@@ -11,6 +12,8 @@ import { buildHistoricalVendorIcp, buildVendorIcp } from "./icp-templates.js";
 import { InstantlySyncProvider } from "./instantly.js";
 import { buildLeadlistsFunnelQueries } from "./leadlists-funnel.js";
 import { readJsonFile, splitCsv, writeJsonFile, writeTextFile } from "./io.js";
+const require = createRequire(import.meta.url);
+const { version: packageVersion } = require("../package.json");
 const program = new Command();
 const leadProvider = new AccountLeadProvider(new HeuristicCompanyProvider(), new HeuristicPeopleSearchProvider());
 const enrichmentProvider = new HeuristicEnrichmentProvider();
@@ -166,14 +169,14 @@ async function fetchHistoricalQueryRows(tables) {
 program
     .name("salesprompter")
     .description("Sales workflow CLI for ICP definition, lead generation, enrichment, scoring, and sync.")
-    .version("0.1.1")
+    .version(packageVersion)
     .option("--json", "Emit compact machine-readable JSON output", false)
     .option("--quiet", "Suppress successful stdout output", false);
 program
     .command("auth:login")
-    .description("Authenticate CLI with Salesprompter app credentials.")
+    .description("Authenticate CLI with a Salesprompter app token, or device flow if the app supports it.")
     .option("--token <token>", "App-issued bearer token for direct login")
-    .option("--api-url <url>", "Salesprompter API base URL, defaults to SALESPROMPTER_API_BASE_URL or app.salesprompter.com")
+    .option("--api-url <url>", "Salesprompter API base URL, defaults to SALESPROMPTER_API_BASE_URL or salesprompter.ai")
     .option("--timeout-seconds <number>", "Device flow wait timeout in seconds", "180")
     .action(async (options) => {
     const timeoutSeconds = z.coerce.number().int().min(30).max(1800).parse(options.timeoutSeconds);
@@ -190,7 +193,9 @@ program
         return;
     }
     const startedAt = new Date().toISOString();
-    process.stderr.write("Starting device login flow. Complete login in the browser.\n");
+    if (!runtimeOutputOptions.json && !runtimeOutputOptions.quiet) {
+        process.stderr.write("Starting device login flow. Complete login in the browser.\n");
+    }
     const result = await loginWithDeviceFlow({
         apiBaseUrl: options.apiUrl,
         timeoutSeconds

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "salesprompter-cli",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "CLI for defining ICPs, generating leads, enriching them, scoring them, and syncing to GTM tools.",
   "type": "module",
   "bin": {
@@ -13,6 +13,9 @@
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "check": "tsc --noEmit -p tsconfig.json",
+    "docs:dev": "npx mint dev",
+    "docs:broken-links": "npx mint broken-links",
+    "docs:a11y": "npx mint a11y",
     "start": "node ./dist/cli.js",
     "test": "npm run build && tsc -p tsconfig.test.json && node --test dist-tests/tests/**/*.test.js"
   },