@opsrev/acculynx-cli 1.0.0

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/index.js

@@ -0,0 +1,255 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { Command } from "commander";
+
+// src/config.ts
+var BASE_URL = "https://api.acculynx.com/api/v2";
+function getConfig(options) {
+  const apiKey = options.apiKey ?? process.env.ACCULYNX_API_KEY;
+  if (!apiKey) {
+    throw new Error(
+      "Missing required credential: ACCULYNX_API_KEY (set env var or pass --api-key)"
+    );
+  }
+  return {
+    baseUrl: BASE_URL,
+    apiKey
+  };
+}
+
+// src/api-client.ts
+var MAX_RETRIES = 3;
+var INITIAL_DELAY_MS = 1e3;
+async function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function fetchWithRetry(url, init, retries = MAX_RETRIES) {
+  const response = await fetch(url, init);
+  if (response.status === 429 && retries > 0) {
+    const retryAfter = response.headers.get("Retry-After");
+    const delay = retryAfter ? parseInt(retryAfter, 10) * 1e3 : INITIAL_DELAY_MS * Math.pow(2, MAX_RETRIES - retries);
+    await sleep(delay);
+    return fetchWithRetry(url, init, retries - 1);
+  }
+  return response;
+}
+function createApiClient(config) {
+  const headers = {
+    Authorization: `Bearer ${config.apiKey}`,
+    Accept: "application/json"
+  };
+  async function doGet(path, params) {
+    let url = `${config.baseUrl}${path}`;
+    if (params && Object.keys(params).length > 0) {
+      url += `?${new URLSearchParams(params).toString()}`;
+    }
+    const response = await fetchWithRetry(url, { headers });
+    if (!response.ok) {
+      const text = await response.text();
+      throw new Error(
+        `API error (${response.status} ${response.statusText}): ${text}`
+      );
+    }
+    return response.json();
+  }
+  async function doPost(path, body) {
+    const url = `${config.baseUrl}${path}`;
+    const response = await fetchWithRetry(url, {
+      method: "POST",
+      headers: { ...headers, "Content-Type": "application/json" },
+      body: JSON.stringify(body)
+    });
+    if (!response.ok) {
+      const text = await response.text();
+      throw new Error(
+        `API error (${response.status} ${response.statusText}): ${text}`
+      );
+    }
+    return response.json();
+  }
+  return {
+    get: doGet,
+    post: doPost
+  };
+}
+
+// src/commands/ping.ts
+function registerPingCommand(parentCmd, getClient2) {
+  parentCmd.command("ping").description("Health check \u2014 verify API key and connectivity").action(async () => {
+    const result = await getClient2().get("/diagnostics/ping");
+    console.log(JSON.stringify(result));
+  });
+}
+
+// src/api-helpers.ts
+var DEFAULT_PAGE_SIZE = 25;
+async function paginate(client, path, params, limit) {
+  const results = [];
+  let pageStartIndex = 0;
+  while (true) {
+    const pageParams = {
+      ...params,
+      pageSize: String(DEFAULT_PAGE_SIZE),
+      pageStartIndex: String(pageStartIndex)
+    };
+    const data = await client.get(path, pageParams);
+    results.push(...data.items);
+    if (limit && results.length >= limit) {
+      return results.slice(0, limit);
+    }
+    if (data.items.length < DEFAULT_PAGE_SIZE) {
+      break;
+    }
+    pageStartIndex += DEFAULT_PAGE_SIZE;
+  }
+  return results;
+}
+async function readStdin(stream = process.stdin) {
+  const chunks = [];
+  for await (const chunk of stream) {
+    chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+  }
+  const raw = Buffer.concat(chunks).toString("utf-8").trim();
+  if (!raw) {
+    throw new Error(
+      "No input provided on stdin. Pipe JSON body, e.g.: echo '{...}' | acculynx jobs create"
+    );
+  }
+  try {
+    return JSON.parse(raw);
+  } catch {
+    throw new Error("Invalid JSON on stdin");
+  }
+}
+
+// src/commands/jobs.ts
+function registerJobsCommands(parentCmd, getClient2) {
+  const jobs = parentCmd.command("jobs").description("Job operations");
+  jobs.command("list").description("List jobs (paginated)").option("--start-date <date>", "Start date (YYYY-MM-DD)").option("--end-date <date>", "End date (YYYY-MM-DD)").option("--date-filter-type <type>", "Date field to filter on").option("--milestones <milestones>", "Filter by milestones").option("--sort-by <field>", "Sort by: CreatedDate, MilestoneDate, ModifiedDate").option("--sort-order <order>", "Ascending or Descending").option("--includes <fields>", "Include: contact, initialAppointment").option("--limit <n>", "Max total results").action(async (opts) => {
+    const params = {};
+    if (opts.startDate) params.startDate = opts.startDate;
+    if (opts.endDate) params.endDate = opts.endDate;
+    if (opts.dateFilterType) params.dateFilterType = opts.dateFilterType;
+    if (opts.milestones) params.milestones = opts.milestones;
+    if (opts.sortBy) params.sortBy = opts.sortBy;
+    if (opts.sortOrder) params.sortOrder = opts.sortOrder;
+    if (opts.includes) params.includes = opts.includes;
+    const limit = opts.limit ? parseInt(opts.limit, 10) : void 0;
+    const result = await paginate(getClient2(), "/jobs", params, limit);
+    console.log(JSON.stringify(result));
+  });
+  jobs.command("get").argument("<jobId>", "Job ID").description("Get job details").action(async (jobId) => {
+    const result = await getClient2().get(`/jobs/${jobId}`);
+    console.log(JSON.stringify(result));
+  });
+  jobs.command("create").description("Create a job (pipe JSON body to stdin)").action(async () => {
+    const body = await readStdin();
+    const result = await getClient2().post("/jobs", body);
+    console.log(JSON.stringify(result));
+  });
+  jobs.command("search").description("Search jobs (pipe JSON search criteria to stdin)").action(async () => {
+    const body = await readStdin();
+    const result = await getClient2().post("/jobs/search", body);
+    console.log(JSON.stringify(result));
+  });
+  const subResources = [
+    { name: "contacts", path: "contacts", desc: "List job contacts" },
+    { name: "estimates", path: "estimates", desc: "List job estimates" },
+    { name: "financials", path: "financials", desc: "Get job financials" },
+    { name: "invoices", path: "invoices", desc: "List job invoices" },
+    { name: "milestones", path: "milestone-history", desc: "List job milestone history" },
+    { name: "payments", path: "payments", desc: "List job payments" },
+    { name: "history", path: "history", desc: "Get job history" }
+  ];
+  for (const sub of subResources) {
+    jobs.command(sub.name).argument("<jobId>", "Job ID").description(sub.desc).action(async (jobId) => {
+      const result = await getClient2().get(`/jobs/${jobId}/${sub.path}`);
+      console.log(JSON.stringify(result));
+    });
+  }
+}
+
+// src/commands/contacts.ts
+function registerContactsCommands(parentCmd, getClient2) {
+  const contacts = parentCmd.command("contacts").description("Contact operations");
+  contacts.command("list").description("List contacts (paginated)").option("--limit <n>", "Max total results").action(async (opts) => {
+    const limit = opts.limit ? parseInt(opts.limit, 10) : void 0;
+    const result = await paginate(getClient2(), "/contacts", {}, limit);
+    console.log(JSON.stringify(result));
+  });
+  contacts.command("get").argument("<contactId>", "Contact ID").description("Get contact details").action(async (contactId) => {
+    const result = await getClient2().get(`/contacts/${contactId}`);
+    console.log(JSON.stringify(result));
+  });
+  contacts.command("create").description("Create a contact (pipe JSON body to stdin)").action(async () => {
+    const body = await readStdin();
+    const result = await getClient2().post("/contacts", body);
+    console.log(JSON.stringify(result));
+  });
+  contacts.command("search").description("Search contacts (pipe JSON search criteria to stdin)").action(async () => {
+    const body = await readStdin();
+    const result = await getClient2().post("/contacts/search", body);
+    console.log(JSON.stringify(result));
+  });
+  contacts.command("emails").argument("<contactId>", "Contact ID").description("List contact email addresses").action(async (contactId) => {
+    const result = await getClient2().get(`/contacts/${contactId}/email-addresses`);
+    console.log(JSON.stringify(result));
+  });
+  contacts.command("phones").argument("<contactId>", "Contact ID").description("List contact phone numbers").action(async (contactId) => {
+    const result = await getClient2().get(`/contacts/${contactId}/phone-numbers`);
+    console.log(JSON.stringify(result));
+  });
+}
+
+// src/commands/estimates.ts
+function registerEstimatesCommands(parentCmd, getClient2) {
+  const estimates = parentCmd.command("estimates").description("Estimate operations");
+  estimates.command("list").description("List estimates (paginated)").option("--limit <n>", "Max total results").action(async (opts) => {
+    const limit = opts.limit ? parseInt(opts.limit, 10) : void 0;
+    const result = await paginate(getClient2(), "/estimates", {}, limit);
+    console.log(JSON.stringify(result));
+  });
+  estimates.command("get").argument("<estimateId>", "Estimate ID").description("Get estimate details").action(async (estimateId) => {
+    const result = await getClient2().get(`/estimates/${estimateId}`);
+    console.log(JSON.stringify(result));
+  });
+  estimates.command("sections").argument("<estimateId>", "Estimate ID").description("List sections for an estimate").action(async (estimateId) => {
+    const result = await getClient2().get(`/estimates/${estimateId}/sections`);
+    console.log(JSON.stringify(result));
+  });
+  estimates.command("section").argument("<estimateId>", "Estimate ID").argument("<sectionId>", "Section ID").description("Get estimate section details").action(async (estimateId, sectionId) => {
+    const result = await getClient2().get(`/estimates/${estimateId}/sections/${sectionId}`);
+    console.log(JSON.stringify(result));
+  });
+  estimates.command("items").argument("<estimateId>", "Estimate ID").argument("<sectionId>", "Section ID").description("List items in an estimate section").action(async (estimateId, sectionId) => {
+    const result = await getClient2().get(`/estimates/${estimateId}/sections/${sectionId}/items`);
+    console.log(JSON.stringify(result));
+  });
+}
+
+// src/index.ts
+var program = new Command();
+program.name("acculynx").description("AccuLynx CRM CLI for AI agents").version("0.1.0").exitOverride().configureOutput({
+  writeOut: (str) => process.stdout.write(str),
+  writeErr: (str) => process.stderr.write(JSON.stringify({ error: str.trim() }) + "\n")
+}).option("--api-key <key>", "AccuLynx API key (env: ACCULYNX_API_KEY)");
+var _client = null;
+function getConfigFromProgram() {
+  const opts = program.opts();
+  return getConfig({ apiKey: opts.apiKey });
+}
+function getClient() {
+  if (!_client) {
+    _client = createApiClient(getConfigFromProgram());
+  }
+  return _client;
+}
+registerPingCommand(program, getClient);
+registerJobsCommands(program, getClient);
+registerContactsCommands(program, getClient);
+registerEstimatesCommands(program, getClient);
+program.parseAsync().catch((err) => {
+  console.error(JSON.stringify({ error: err.message }));
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@opsrev/acculynx-cli",
+  "version": "1.0.0",
+  "description": "CLI for the AccuLynx roofing CRM API",
+  "type": "module",
+  "bin": {
+    "acculynx": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts --clean",
+    "dev": "tsx src/index.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "acculynx",
+    "cli",
+    "roofing",
+    "crm",
+    "api"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "commander": "^14.0.3"
+  },
+  "devDependencies": {
+    "@types/node": "^25.4.0",
+    "tsup": "^8.5.1",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  }
+}