conduyt 1.0.0

package/README.md

@@ -0,0 +1,50 @@
+# conduyt
+
+Command-line interface for [Conduyt CRM](https://conduyt.app) — manage contacts, deals, pipelines, and run AI insight queries from your terminal.
+
+## Install
+
+```bash
+npm install -g conduyt
+# or run without installing
+npx conduyt --help
+```
+
+## Authentication
+
+Generate an API key in Conduyt under **Settings → API** (keys start with `cdy_`), then either save it:
+
+```bash
+conduyt config set --key cdy_your_key_here
+```
+
+or set environment variables (these override the saved config):
+
+```bash
+export CONDUYT_API_KEY=cdy_your_key_here
+export CONDUYT_API_URL=https://conduyt.app   # optional, defaults to https://conduyt.app
+```
+
+The saved config lives at `~/.conduyt/config.json` and is written owner-only (`chmod 600`).
+
+## Commands
+
+```bash
+conduyt whoami                          # show the authenticated user
+conduyt contacts list --limit 25        # list contacts (supports --cursor, --query)
+conduyt contacts get <id>               # fetch one contact
+conduyt deals list --pipeline <id>      # list deals
+conduyt pipelines                       # list pipelines and stages
+conduyt search "acme corp"              # search across the CRM
+conduyt insights summary                # run an AI insight query
+conduyt api GET /api/v1/companies       # raw authenticated request (escape hatch)
+conduyt config show                     # show resolved config (key masked)
+```
+
+Pass `--input '{"...":"..."}'` to `insights` and `--body '{"...":"..."}'` to `api` to send a JSON payload.
+
+All output is JSON, ready to pipe into `jq`.
+
+## License
+
+MIT

package/dist/client.js

@@ -0,0 +1,57 @@
+import { requireAuth } from "./config.js";
+export class ConduytClient {
+    baseUrl;
+    apiKey;
+    constructor() {
+        const cfg = requireAuth();
+        this.baseUrl = cfg.apiUrl.replace(/\/+$/, "");
+        this.apiKey = cfg.apiKey;
+    }
+    async request(method, path, body) {
+        const url = `${this.baseUrl}${path.startsWith("/") ? path : `/${path}`}`;
+        const res = await fetch(url, {
+            method,
+            headers: {
+                Authorization: `Bearer ${this.apiKey}`,
+                "Content-Type": "application/json",
+            },
+            body: body !== undefined ? JSON.stringify(body) : undefined,
+        });
+        const text = await res.text();
+        const json = text ? safeParse(text) : null;
+        if (!res.ok) {
+            const msg = json?.error || res.statusText || `HTTP ${res.status}`;
+            throw new Error(`Conduyt API ${res.status}: ${msg}`);
+        }
+        return json;
+    }
+    get(path) {
+        return this.request("GET", path);
+    }
+    post(path, body) {
+        return this.request("POST", path, body);
+    }
+    patch(path, body) {
+        return this.request("PATCH", path, body);
+    }
+    del(path) {
+        return this.request("DELETE", path);
+    }
+}
+function safeParse(text) {
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return text;
+    }
+}
+export function buildQuery(params) {
+    const usp = new URLSearchParams();
+    for (const [k, v] of Object.entries(params)) {
+        if (v !== undefined && v !== "")
+            usp.set(k, String(v));
+    }
+    const qs = usp.toString();
+    return qs ? `?${qs}` : "";
+}

package/dist/config.js

@@ -0,0 +1,57 @@
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { mkdirSync, readFileSync, writeFileSync, existsSync, chmodSync } from "node:fs";
+const CONFIG_DIR = join(homedir(), ".conduyt");
+const CONFIG_PATH = join(CONFIG_DIR, "config.json");
+const DEFAULT_API_URL = "https://conduyt.app";
+export function configPath() {
+    return CONFIG_PATH;
+}
+function readFile() {
+    if (!existsSync(CONFIG_PATH))
+        return {};
+    try {
+        return JSON.parse(readFileSync(CONFIG_PATH, "utf8"));
+    }
+    catch {
+        return {};
+    }
+}
+export function saveConfig(update) {
+    const current = readFile();
+    const next = {
+        apiUrl: update.apiUrl ?? current.apiUrl ?? DEFAULT_API_URL,
+        apiKey: update.apiKey ?? current.apiKey ?? "",
+    };
+    mkdirSync(CONFIG_DIR, { recursive: true });
+    writeFileSync(CONFIG_PATH, JSON.stringify(next, null, 2));
+    // Config holds an API key — keep it owner-only.
+    try {
+        chmodSync(CONFIG_PATH, 0o600);
+    }
+    catch {
+        // best effort on platforms without POSIX perms
+    }
+    return next;
+}
+/**
+ * Resolve config from environment first (CONDUYT_API_URL / CONDUYT_API_KEY),
+ * falling back to the saved config file.
+ */
+export function resolveConfig() {
+    const file = readFile();
+    return {
+        apiUrl: process.env.CONDUYT_API_URL ?? file.apiUrl ?? DEFAULT_API_URL,
+        apiKey: process.env.CONDUYT_API_KEY ?? file.apiKey ?? "",
+    };
+}
+export function requireAuth() {
+    const cfg = resolveConfig();
+    if (!cfg.apiKey) {
+        throw new Error("No API key configured. Run `conduyt config set --key cdy_...` or set CONDUYT_API_KEY.");
+    }
+    if (!cfg.apiKey.startsWith("cdy_")) {
+        throw new Error("CONDUYT_API_KEY must start with 'cdy_'. Generate one at Settings > API in Conduyt.");
+    }
+    return cfg;
+}

package/dist/index.js

@@ -0,0 +1,124 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { ConduytClient, buildQuery } from "./client.js";
+import { saveConfig, resolveConfig, configPath } from "./config.js";
+import { print, fail } from "./output.js";
+const program = new Command();
+program
+    .name("conduyt")
+    .description("Command-line interface for Conduyt CRM — manage contacts, deals, pipelines, and run insight queries from your terminal.")
+    .version("1.0.0");
+// ---- config ----
+const config = program.command("config").description("Manage CLI configuration");
+config
+    .command("set")
+    .description("Save your API key and (optionally) API URL")
+    .option("--key <apiKey>", "API key (starts with cdy_)")
+    .option("--url <apiUrl>", "API base URL")
+    .action((opts) => {
+    if (!opts.key && !opts.url)
+        fail("Nothing to set. Pass --key and/or --url.");
+    const next = saveConfig({ apiKey: opts.key, apiUrl: opts.url });
+    process.stdout.write(`Saved to ${configPath()}\n`);
+    print({ apiUrl: next.apiUrl, apiKey: mask(next.apiKey) });
+});
+config
+    .command("show")
+    .description("Show the resolved configuration (API key masked)")
+    .action(() => {
+    const cfg = resolveConfig();
+    print({ apiUrl: cfg.apiUrl, apiKey: mask(cfg.apiKey), source: configPath() });
+});
+// ---- whoami ----
+program
+    .command("whoami")
+    .description("Show the authenticated user")
+    .action(run(async (client) => client.get("/api/v1/users/me")));
+// ---- contacts ----
+const contacts = program.command("contacts").description("Manage contacts");
+contacts
+    .command("list")
+    .description("List contacts")
+    .option("--limit <n>", "max results")
+    .option("--cursor <cursor>", "pagination cursor")
+    .option("--query <q>", "search query")
+    .action(run(async (client, opts) => client.get(`/api/v1/contacts${buildQuery({ limit: opts.limit, cursor: opts.cursor, query: opts.query })}`)));
+contacts
+    .command("get <id>")
+    .description("Get a single contact by id")
+    .action(run(async (client, id) => client.get(`/api/v1/contacts/${encodeURIComponent(id)}`)));
+// ---- deals ----
+const deals = program.command("deals").description("Manage deals");
+deals
+    .command("list")
+    .description("List deals")
+    .option("--limit <n>", "max results")
+    .option("--cursor <cursor>", "pagination cursor")
+    .option("--pipeline <id>", "filter by pipeline id")
+    .action(run(async (client, opts) => client.get(`/api/v1/deals${buildQuery({ limit: opts.limit, cursor: opts.cursor, pipelineId: opts.pipeline })}`)));
+// ---- pipelines ----
+program
+    .command("pipelines")
+    .description("List pipelines and their stages")
+    .action(run(async (client) => client.get("/api/v1/pipelines")));
+// ---- search ----
+program
+    .command("search <query>")
+    .description("Search across the CRM")
+    .option("--limit <n>", "max results")
+    .action(run(async (client, query, opts) => client.get(`/api/v1/search${buildQuery({ q: query, limit: opts.limit })}`)));
+// ---- insights ----
+program
+    .command("insights <type>")
+    .description("Run an AI insight query (e.g. summary, forecast)")
+    .option("--input <json>", "JSON payload to send with the request")
+    .action(run(async (client, type, opts) => {
+    let extra = {};
+    if (opts.input) {
+        try {
+            extra = JSON.parse(opts.input);
+        }
+        catch {
+            fail("--input must be valid JSON");
+        }
+    }
+    return client.post("/api/v1/ai/insights", { type, ...extra });
+}));
+// ---- raw escape hatch ----
+program
+    .command("api <method> <path>")
+    .description("Make a raw authenticated API request (escape hatch)")
+    .option("--body <json>", "JSON request body")
+    .action(run(async (client, method, path, opts) => {
+    let body;
+    if (opts.body) {
+        try {
+            body = JSON.parse(opts.body);
+        }
+        catch {
+            fail("--body must be valid JSON");
+        }
+    }
+    return client.request(method.toUpperCase(), path, body);
+}));
+program.parseAsync(process.argv).catch(fail);
+// helpers
+function run(handler) {
+    return async (...args) => {
+        try {
+            const client = new ConduytClient();
+            const res = await handler(client, ...args);
+            print(res);
+        }
+        catch (err) {
+            fail(err);
+        }
+    };
+}
+function mask(key) {
+    if (!key)
+        return "(not set)";
+    if (key.length <= 12)
+        return "cdy_***";
+    return `${key.slice(0, 8)}…${key.slice(-4)}`;
+}

package/dist/output.js

@@ -0,0 +1,16 @@
+/** Unwrap the standard `{ data: ... }` API envelope when present. */
+export function unwrap(res) {
+    if (res && typeof res === "object" && "data" in res) {
+        return res.data;
+    }
+    return res;
+}
+export function print(res) {
+    const data = unwrap(res);
+    process.stdout.write(JSON.stringify(data, null, 2) + "\n");
+}
+export function fail(err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    process.stderr.write(`Error: ${msg}\n`);
+    process.exit(1);
+}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "conduyt",
+  "version": "1.0.0",
+  "description": "Command-line interface for Conduyt CRM — manage contacts, deals, pipelines, and run insight queries from your terminal.",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "conduyt": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "start": "tsx src/index.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "conduyt",
+    "crm",
+    "cli",
+    "sales",
+    "ai",
+    "api"
+  ],
+  "homepage": "https://conduyt.app",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ptaramona/conduyt-cli.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ptaramona/conduyt-cli/issues"
+  },
+  "license": "MIT",
+  "author": "Conduyt",
+  "dependencies": {
+    "commander": "^12.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.5.0",
+    "tsx": "^4.19.0",
+    "@types/node": "^22.0.0"
+  }
+}