@opsrev/acculynx-cli 1.6.1 → 1.8.0

package/README.md

@@ -20,26 +20,12 @@ cp .env.example .env
 
 Your `.env` is gitignored and will never be committed.
 
-### Official API
-
 | Env Var | Flag | Description |
 |---------|------|-------------|
 | `ACCULYNX_API_KEY` | `--api-key` | AccuLynx API key (required) |
 
 API keys are created by your AccuLynx account administrator under Account Settings.
 
-### Unofficial Web API
-
-The `unofficial` commands use cookie-based authentication against AccuLynx's internal web APIs. These provide access to features not available in the official API (job documents, messages, etc.).
-
-| Env Var | Flag | Description |
-|---------|------|-------------|
-| `ACCULYNX_EMAIL` | `--email` | Your AccuLynx login email |
-| `ACCULYNX_PASSWORD` | `--password` | Your AccuLynx password |
-| `ACCULYNX_COMPANY_ID` | `--company-id` | Company GUID from location selector |
-
-> **Note:** These endpoints are reverse-engineered from the AccuLynx web app and may break without notice.
-
 ## Commands
 
 ```
@@ -68,95 +54,6 @@ acculynx estimates section <estimateId> <secId> # Get section details
 acculynx estimates items <estimateId> <secId>   # List items in a section
 ```
 
-### Unofficial commands
-
-Requires `ACCULYNX_EMAIL`, `ACCULYNX_PASSWORD`, and `ACCULYNX_COMPANY_ID` in your `.env` (or passed as flags).
-
-```
-acculynx unofficial companies                          # List available companies (discover your company ID)
-acculynx unofficial login                              # Authenticate and cache session
-acculynx unofficial logout                             # Remove cached session
-acculynx unofficial sessions                           # List cached sessions
-acculynx unofficial documents list <jobId>             # List all document folders/files for a job
-acculynx unofficial documents download <jobId> <fileId> [--output ./file.pdf]  # Download a document
-acculynx unofficial messages list <jobId>              # List all messages/comments for a job
-acculynx unofficial messages list <jobId> --type Email # Filter by type: Comment, Email, or Signatures
-acculynx unofficial messages list <jobId> --count-only # Get message count only
-acculynx unofficial messages post <jobId> <message>    # Post a comment to a job
-acculynx unofficial messages post <jobId> <message> --notify <userId,...>  # Post and notify users
-acculynx unofficial milestones list <jobId>            # List workflow milestones/statuses for a job
-acculynx unofficial milestones set <jobId> <status>    # Set a job's milestone/status by name
-acculynx unofficial milestones set <jobId> <status> --message "note"  # Set with comment
-acculynx unofficial jobs list                          # List jobs (unofficial)
-acculynx unofficial jobs list --status <name>           # Filter by workflow status name
-acculynx unofficial jobs list --milestone <name>        # Filter by milestone name
-```
-
-#### Messages
-
-List all messages, comments, and emails on a job. HTML email content is automatically converted to lightweight markdown (headers, links, lists preserved; images and styles stripped) for clean AI agent consumption.
-
-```bash
-acculynx unofficial messages list <jobId>                          # all messages, newest first
-acculynx unofficial messages list <jobId> --sort "createdDate|asc" # oldest first
-acculynx unofficial messages list <jobId> --type Email             # only emails
-acculynx unofficial messages list <jobId> --count-only             # just the count
-```
-
-Post a comment to a job, optionally notifying (tagging) users:
-
-```bash
-acculynx unofficial messages post <jobId> "Your message here"
-acculynx unofficial messages post <jobId> "Check this out" --notify "userId1,userId2"
-```
-
-User IDs for `--notify` come from the official users API (`/api/v2/users`).
-
-#### Milestones
-
-AccuLynx workflows have milestones (Lead, Prospect, Approved, etc.) that contain custom statuses (Estimate Sent, Contract Signed, etc.). The official API only filters by top-level milestones. The unofficial milestones commands let you work with the granular workflow statuses.
-
-List all milestones and their statuses for a job:
-
-```bash
-acculynx unofficial milestones list <jobId>
-```
-
-Set a job to a specific workflow status by name (case-insensitive):
-
-```bash
-acculynx unofficial milestones set <jobId> "Estimate Sent"
-acculynx unofficial milestones set <jobId> "OpsRev: Estimate Ready for Review"
-acculynx unofficial milestones set <jobId> "Contract Signed" --message "Moving to contract phase"
-```
-
-If the status name doesn't match, the command returns the list of available statuses.
-
-#### Jobs (unofficial)
-
-The official `jobs list --milestones` filter only accepts top-level milestone names (Lead, Prospect, Approved, etc.). The unofficial `jobs list` command supports filtering by custom workflow status names.
-
-```bash
-acculynx unofficial jobs list --status "Estimate Sent"                    # jobs in a specific status
-acculynx unofficial jobs list --status "OpsRev: Estimate Ready for Review" # custom status names work
-acculynx unofficial jobs list --milestone Prospect                        # filter by milestone
-acculynx unofficial jobs list --status "Estimate Sent" --query "Smith"    # combine with search
-acculynx unofficial jobs list --sort "lastTouched|desc" --page 2          # sort and paginate
-```
-
-The `--status` flag resolves the status name (case-insensitive) to a GUID via the company workflow configuration, then queries the internal job list API. If the name doesn't match, the command returns the list of available statuses.
-
-**Getting started:** If you don't know your company ID, run `companies` first -- it logs in and returns all companies available to your account:
-
-```bash
-npm run dev -- unofficial companies
-# [{"id":"f104ba56-...","name":"My Roofing Co"},{"id":"7749e90f-...","name":"Sandbox"}]
-```
-
-Copy the `id` into your `.env` as `ACCULYNX_COMPANY_ID`, then run `login` to cache the session.
-
-Login caches session cookies to `~/.config/acculynx-cli/sessions/` so you only need to re-authenticate when the session expires. Multiple accounts/companies are supported -- each gets its own cached session.
-
 ### Pagination
 
 All list commands default to **25 results**. Use `--limit <n>` for a custom count or `--all` to fetch everything:
@@ -220,8 +117,6 @@ npm run build         # build to dist/
 The `npm run dev` script automatically loads your `.env` file via Node's `--env-file` flag (Node 20.6+). Examples:
 
 ```bash
-npm run dev -- unofficial login
-npm run dev -- unofficial documents list <jobId>
 npm run dev -- jobs list --limit 5
 ```
 

package/dist/index.js

@@ -310,724 +310,6 @@ function registerEstimatesCommands(parentCmd, getClient2) {
   });
 }
 
-// src/unofficial/session-store.ts
-import {
-  existsSync,
-  readFileSync as readFileSync2,
-  writeFileSync,
-  mkdirSync,
-  readdirSync,
-  unlinkSync
-} from "fs";
-import { join } from "path";
-import { homedir } from "os";
-
-// src/unofficial/cookie-jar.ts
-var CookieJar = class _CookieJar {
-  cookies = /* @__PURE__ */ new Map();
-  /** Extract and store cookies from a response's Set-Cookie headers. */
-  capture(url, response) {
-    const domain = new URL(url).hostname;
-    const jar = this.cookies.get(domain) ?? /* @__PURE__ */ new Map();
-    for (const header of response.headers.getSetCookie()) {
-      const [pair] = header.split(";");
-      const eqIdx = pair.indexOf("=");
-      if (eqIdx === -1) continue;
-      jar.set(pair.slice(0, eqIdx).trim(), pair.slice(eqIdx + 1).trim());
-    }
-    this.cookies.set(domain, jar);
-  }
-  /** Get a specific cookie value by name for a given URL. */
-  getCookie(url, name) {
-    const domain = new URL(url).hostname;
-    for (const [d, jar] of this.cookies) {
-      if (domain === d || domain.endsWith("." + d)) {
-        if (jar.has(name)) return jar.get(name);
-      }
-    }
-    return void 0;
-  }
-  /** Build a Cookie header string for a given URL. */
-  headerFor(url) {
-    const domain = new URL(url).hostname;
-    const parts = [];
-    for (const [d, jar] of this.cookies) {
-      if (domain === d || domain.endsWith("." + d)) {
-        for (const [k, v] of jar) parts.push(`${k}=${v}`);
-      }
-    }
-    return parts.join("; ");
-  }
-  /** Serialize for disk caching. */
-  toJSON() {
-    const out = {};
-    for (const [d, jar] of this.cookies) {
-      out[d] = Object.fromEntries(jar);
-    }
-    return out;
-  }
-  /** Restore from disk cache. */
-  static fromJSON(data) {
-    const jar = new _CookieJar();
-    for (const [d, pairs] of Object.entries(data)) {
-      jar.cookies.set(d, new Map(Object.entries(pairs)));
-    }
-    return jar;
-  }
-};
-
-// src/unofficial/session-store.ts
-var CONFIG_DIR = join(
-  process.env.XDG_CONFIG_HOME ?? join(homedir(), ".config"),
-  "acculynx-cli"
-);
-var SESSIONS_DIR = join(CONFIG_DIR, "sessions");
-function sessionKey(email, companyId) {
-  const slug = email.replace(/[@.]/g, "-").toLowerCase();
-  const prefix = companyId.slice(0, 8);
-  return `${slug}--${prefix}.json`;
-}
-function loadSession(email, companyId) {
-  const file = join(SESSIONS_DIR, sessionKey(email, companyId));
-  if (!existsSync(file)) return null;
-  try {
-    const data = JSON.parse(readFileSync2(file, "utf-8"));
-    return {
-      jar: CookieJar.fromJSON(data.cookies),
-      companyId: data.companyId,
-      email: data.email
-    };
-  } catch {
-    return null;
-  }
-}
-function saveSession(session) {
-  mkdirSync(SESSIONS_DIR, { recursive: true, mode: 448 });
-  writeFileSync(
-    join(SESSIONS_DIR, sessionKey(session.email, session.companyId)),
-    JSON.stringify(
-      {
-        email: session.email,
-        companyId: session.companyId,
-        cookies: session.jar.toJSON()
-      },
-      null,
-      2
-    ),
-    { mode: 384 }
-  );
-}
-function deleteSession(email, companyId) {
-  const file = join(SESSIONS_DIR, sessionKey(email, companyId));
-  if (!existsSync(file)) return false;
-  unlinkSync(file);
-  return true;
-}
-function listSessions() {
-  if (!existsSync(SESSIONS_DIR)) return [];
-  return readdirSync(SESSIONS_DIR).filter((f) => f.endsWith(".json")).map((f) => {
-    try {
-      const data = JSON.parse(
-        readFileSync2(join(SESSIONS_DIR, f), "utf-8")
-      );
-      return { email: data.email, companyId: data.companyId, file: f };
-    } catch {
-      return null;
-    }
-  }).filter(Boolean);
-}
-
-// src/unofficial/unofficial-client.ts
-function createUnofficialClient(session) {
-  const base = "https://my.acculynx.com";
-  async function doGet(path) {
-    const url = `${base}${path}`;
-    const resp = await fetch(url, {
-      headers: {
-        Cookie: session.jar.headerFor(url),
-        Accept: "application/json"
-      }
-    });
-    if (resp.status === 401 || resp.status === 302) {
-      throw new Error(
-        "Session expired \u2014 run `acculynx unofficial login` to re-authenticate"
-      );
-    }
-    if (!resp.ok) {
-      throw new Error(
-        `Unofficial API error (${resp.status}): ${await resp.text()}`
-      );
-    }
-    return resp.json();
-  }
-  async function doPost(path, body) {
-    const url = `${base}${path}`;
-    const headers = {
-      Cookie: session.jar.headerFor(url),
-      Accept: "application/json",
-      "Content-Type": "application/json"
-    };
-    const xsrf = session.jar.getCookie(url, "XSRF-TOKEN");
-    if (xsrf) {
-      headers["X-XSRF-TOKEN"] = xsrf;
-    }
-    const resp = await fetch(url, {
-      method: "POST",
-      headers,
-      body: JSON.stringify(body)
-    });
-    if (resp.status === 401 || resp.status === 302) {
-      throw new Error(
-        "Session expired \u2014 run `acculynx unofficial login` to re-authenticate"
-      );
-    }
-    if (!resp.ok) {
-      throw new Error(
-        `Unofficial API error (${resp.status}): ${await resp.text()}`
-      );
-    }
-    const text = await resp.text();
-    if (!text) return {};
-    return JSON.parse(text);
-  }
-  async function doGetBuffer(url) {
-    const fullUrl = url.startsWith("http") ? url : `${base}${url}`;
-    const resp = await fetch(fullUrl, {
-      headers: { Cookie: session.jar.headerFor(fullUrl) }
-    });
-    if (!resp.ok) {
-      throw new Error(`Download failed (${resp.status}): ${fullUrl}`);
-    }
-    return Buffer.from(await resp.arrayBuffer());
-  }
-  return { get: doGet, post: doPost, getBuffer: doGetBuffer };
-}
-
-// src/unofficial/session.ts
-async function fetchFollowingCookies(jar, url, init) {
-  let currentUrl = url;
-  let response;
-  for (let i = 0; i < 10; i++) {
-    response = await fetch(currentUrl, {
-      ...init,
-      redirect: "manual",
-      headers: {
-        ...Object.fromEntries(
-          Object.entries(init?.headers ?? {})
-        ),
-        Cookie: jar.headerFor(currentUrl)
-      }
-    });
-    jar.capture(currentUrl, response);
-    const location = response.headers.get("Location");
-    if (!location || response.status < 300 || response.status >= 400) {
-      return response;
-    }
-    currentUrl = new URL(location, currentUrl).href;
-    init = { redirect: "manual" };
-  }
-  throw new Error("Too many redirects");
-}
-async function authenticate(email, password) {
-  const jar = new CookieJar();
-  const signinResp = await fetchFollowingCookies(
-    jar,
-    "https://my.acculynx.com/signin/"
-  );
-  const html = await signinResp.text();
-  const actionMatch = html.match(/<form[^>]*action="([^"]*)"/);
-  if (!actionMatch) throw new Error("Could not find login form action");
-  const formAction = actionMatch[1].replace(/&amp;/g, "&");
-  const thumbprint = html.match(/name="DeviceThumbprint"[^>]*value="([^"]*)"/)?.[1] ?? "";
-  const deviceName = html.match(/name="DeviceName"[^>]*value="([^"]*)"/)?.[1] ?? "Node.js CLI";
-  const body = new URLSearchParams({
-    Email: email,
-    Password: password,
-    DeviceThumbprint: thumbprint,
-    DeviceName: deviceName
-  });
-  const loginResp = await fetchFollowingCookies(jar, formAction, {
-    method: "POST",
-    headers: { "Content-Type": "application/x-www-form-urlencoded" },
-    body: body.toString()
-  });
-  const locationResp = await fetchFollowingCookies(
-    jar,
-    "https://my.acculynx.com/signin/LocationSelector"
-  );
-  const locationHtml = await locationResp.text();
-  return { jar, locationHtml };
-}
-async function listCompanies(email, password) {
-  const { locationHtml } = await authenticate(email, password);
-  const companyPattern = /SwitchCompany\?CompanyID=([0-9a-f-]+)"[^>]*>([^<]+)/gi;
-  const companies = [];
-  let match;
-  while ((match = companyPattern.exec(locationHtml)) !== null) {
-    companies.push({ id: match[1], name: match[2].trim() });
-  }
-  return companies;
-}
-async function login(email, password, companyId) {
-  const { jar } = await authenticate(email, password);
-  await fetchFollowingCookies(
-    jar,
-    `https://my.acculynx.com/signin/SwitchCompany?CompanyID=${companyId}`
-  );
-  return { jar, companyId, email };
-}
-
-// src/unofficial/commands/login.ts
-function getCredentials(opts) {
-  const email = opts.email ?? process.env.ACCULYNX_EMAIL;
-  const password = opts.password ?? process.env.ACCULYNX_PASSWORD;
-  const companyId = opts.companyId ?? process.env.ACCULYNX_COMPANY_ID;
-  if (!email) {
-    throw new Error(
-      "Missing email: pass --email or set ACCULYNX_EMAIL"
-    );
-  }
-  if (!password) {
-    throw new Error(
-      "Missing password: pass --password or set ACCULYNX_PASSWORD"
-    );
-  }
-  if (!companyId) {
-    throw new Error(
-      "Missing company ID: pass --company-id or set ACCULYNX_COMPANY_ID"
-    );
-  }
-  return { email, password, companyId };
-}
-function registerLoginCommands(parentCmd) {
-  parentCmd.command("login").description("Authenticate and cache session cookies").option("--email <email>", "AccuLynx email (env: ACCULYNX_EMAIL)").option(
-    "--password <password>",
-    "AccuLynx password (env: ACCULYNX_PASSWORD)"
-  ).option(
-    "--company-id <id>",
-    "Company GUID (env: ACCULYNX_COMPANY_ID)"
-  ).action(async (opts) => {
-    const { email, password, companyId } = getCredentials(opts);
-    const session = await login(email, password, companyId);
-    saveSession(session);
-    console.log(
-      JSON.stringify({
-        status: "ok",
-        email,
-        companyId,
-        message: "Session cached successfully"
-      })
-    );
-  });
-  parentCmd.command("companies").description(
-    "List available companies for your account (discovers company IDs)"
-  ).option("--email <email>", "AccuLynx email (env: ACCULYNX_EMAIL)").option(
-    "--password <password>",
-    "AccuLynx password (env: ACCULYNX_PASSWORD)"
-  ).action(async (opts) => {
-    const email = opts.email ?? process.env.ACCULYNX_EMAIL;
-    const password = opts.password ?? process.env.ACCULYNX_PASSWORD;
-    if (!email) {
-      throw new Error(
-        "Missing email: pass --email or set ACCULYNX_EMAIL"
-      );
-    }
-    if (!password) {
-      throw new Error(
-        "Missing password: pass --password or set ACCULYNX_PASSWORD"
-      );
-    }
-    const companies = await listCompanies(email, password);
-    console.log(JSON.stringify(companies));
-  });
-  parentCmd.command("sessions").description("List cached sessions").action(() => {
-    const sessions = listSessions();
-    console.log(JSON.stringify(sessions));
-  });
-  parentCmd.command("logout").description("Remove a cached session").option("--email <email>", "AccuLynx email (env: ACCULYNX_EMAIL)").option(
-    "--company-id <id>",
-    "Company GUID (env: ACCULYNX_COMPANY_ID)"
-  ).action((opts) => {
-    const email = opts.email ?? process.env.ACCULYNX_EMAIL;
-    const companyId = opts.companyId ?? process.env.ACCULYNX_COMPANY_ID;
-    if (!email || !companyId) {
-      throw new Error(
-        "Both --email and --company-id are required (or set env vars)"
-      );
-    }
-    const removed = deleteSession(email, companyId);
-    console.log(
-      JSON.stringify({
-        status: removed ? "removed" : "not_found",
-        email,
-        companyId
-      })
-    );
-  });
-}
-
-// src/unofficial/commands/documents.ts
-import { writeFileSync as writeFileSync2 } from "fs";
-function registerDocumentsCommands(parentCmd, getClient2) {
-  const docs = parentCmd.command("documents").description("Job document operations");
-  docs.command("list").argument("<jobId>", "Job ID (GUID)").description("List all document folders and files for a job").action(async (jobId) => {
-    const folders = await getClient2().get(
-      `/api/v4/job-documents/${jobId}/job-document-folders`
-    );
-    const result = folders.map((folder) => ({
-      folder: folder.Name,
-      folderId: folder.Id,
-      fileCount: folder.FileCount,
-      files: folder.Files.map((f) => ({
-        id: f.Id,
-        name: f.Name,
-        extension: f.Extension,
-        size: f.Size,
-        mimeType: f.MIMEType,
-        href: f.Href,
-        createdBy: f.CreatedByDisplayName,
-        modifiedDate: f.ModifiedDateUTC
-      }))
-    }));
-    console.log(JSON.stringify(result));
-  });
-  docs.command("download").argument("<jobId>", "Job ID (GUID)").argument("<fileId>", "File ID (GUID)").option("--output <path>", "Write to file instead of stdout").description("Download a document file").action(async (jobId, fileId, opts) => {
-    const folders = await getClient2().get(
-      `/api/v4/job-documents/${jobId}/job-document-folders`
-    );
-    let targetFile;
-    for (const folder of folders) {
-      targetFile = folder.Files.find((f) => f.Id === fileId);
-      if (targetFile) break;
-    }
-    if (!targetFile) {
-      throw new Error(
-        `File ${fileId} not found in job ${jobId} documents`
-      );
-    }
-    const buffer = await getClient2().getBuffer(targetFile.Href);
-    if (opts.output) {
-      writeFileSync2(opts.output, buffer);
-      console.error(
-        JSON.stringify({
-          status: "ok",
-          file: targetFile.Name,
-          size: buffer.length,
-          output: opts.output
-        })
-      );
-    } else {
-      process.stdout.write(buffer);
-    }
-  });
-}
-
-// src/unofficial/commands/messages.ts
-import TurndownService from "turndown";
-function createTurndown() {
-  const td = new TurndownService({
-    headingStyle: "atx",
-    bulletListMarker: "-"
-  });
-  td.addRule("removeImages", {
-    filter: "img",
-    replacement: () => ""
-  });
-  td.addRule("removeStyle", {
-    filter: ["style", "script"],
-    replacement: () => ""
-  });
-  return td;
-}
-var looksLikeHtml = /<[a-z][\s\S]*?>/i;
-function cleanMessage(html) {
-  if (!looksLikeHtml.test(html)) return html;
-  const td = createTurndown();
-  return td.turndown(html).replace(/\n{3,}/g, "\n\n").trim();
-}
-function registerMessagesCommands(parentCmd, getClient2) {
-  const messages = parentCmd.command("messages").description("Job message/comment operations");
-  messages.command("list").argument("<jobId>", "Job ID (GUID)").option(
-    "--sort <sort>",
-    "Sort field and direction (field|asc or field|desc)",
-    "createdDate|desc"
-  ).option("--count-only", "Return only the total count of messages").option(
-    "--type <type>",
-    "Filter by message type: Comment, Email, or Signatures"
-  ).description("List all messages and comments for a job").action(async (jobId, opts) => {
-    const params = new URLSearchParams({ sort: opts.sort });
-    if (opts.countOnly) {
-      params.set("countOnly", "true");
-    }
-    if (opts.type) {
-      params.append("filters", `type=${opts.type}`);
-    }
-    const data = await getClient2().get(
-      `/api/jobs/${jobId}/JobMessageFeed?${params.toString()}`
-    );
-    if (opts.countOnly) {
-      console.log(JSON.stringify({ totalRecords: data.TotalRecords }));
-      return;
-    }
-    const result = {
-      totalRecords: data.TotalRecords,
-      currentPage: data.CurrentPage,
-      totalPages: data.TotalPages,
-      messages: data.results.map((msg) => ({
-        id: msg.id,
-        jobId: msg.JobId,
-        type: msg.Type,
-        messageType: msg.MessageType,
-        message: cleanMessage(msg.Message),
-        subject: msg.Subject,
-        createdBy: msg.CreatedBy,
-        createdById: msg.CreatedByID,
-        createdDate: msg.CreatedDate,
-        latestMessage: msg.LatestMessage,
-        parentMessageId: msg.ParentMessageId,
-        attachmentOnly: msg.AttachmentOnly,
-        replyEmail: msg.ReplyEmail,
-        sentDate: msg.SentDate,
-        recipients: msg.Recipients.map((r) => ({
-          id: r.id,
-          companyUserId: r.companyUserId,
-          sent: r.Sent,
-          sentDate: r.SentDate,
-          delivered: r.Delivered,
-          deliveredDate: r.DeliveredDate,
-          failed: r.Failed,
-          failedDate: r.FailedDate,
-          failedDescription: r.FailedDescription
-        })),
-        attachments: msg.Attachments,
-        childMessageCount: msg.ChildMessages.length,
-        childMessages: msg.ChildMessages.map((child) => ({
-          id: child.id,
-          type: child.Type,
-          message: cleanMessage(child.Message),
-          createdBy: child.CreatedBy,
-          createdDate: child.CreatedDate
-        }))
-      }))
-    };
-    console.log(JSON.stringify(result));
-  });
-  messages.command("post").argument("<jobId>", "Job ID (GUID)").argument("<message>", "Message text to post").option(
-    "--notify <userIds>",
-    "Comma-separated user IDs (GUIDs) to notify"
-  ).description("Post a comment/message to a job, optionally notifying users").action(async (jobId, message, opts) => {
-    const emailRecipients = opts.notify ? opts.notify.split(",").map((id) => id.trim()) : [];
-    const data = await getClient2().post(
-      `/api/jobs/${jobId}/Messages`,
-      {
-        JobId: jobId,
-        Message: message,
-        RoleId: "1111111",
-        MessageType: "General Comment",
-        emailRecipients,
-        index: -1
-      }
-    );
-    console.log(
-      JSON.stringify({
-        id: data.JobMessageId,
-        jobId: data.JobId,
-        message: data.Message,
-        messageType: data.MessageType,
-        createdDate: data.CreatedDate,
-        notified: emailRecipients.length
-      })
-    );
-  });
-}
-
-// src/unofficial/commands/milestones.ts
-function registerMilestonesCommands(parentCmd, getClient2) {
-  const milestones = parentCmd.command("milestones").description("Job milestone/status operations");
-  milestones.command("list").argument("<jobId>", "Job ID (GUID)").description("List all milestones and statuses for a job's workflow").action(async (jobId) => {
-    const data = await getClient2().get(
-      `/api/v3/job-workflows/${jobId}`
-    );
-    const result = data.Milestones.map((m) => ({
-      milestoneId: m.MilestoneId,
-      name: m.Name,
-      isCurrent: m.IsCurrent,
-      done: m.Done,
-      statuses: m.Statuses.map((s) => ({
-        statusId: s.StatusId,
-        name: s.Name.trim(),
-        isCurrent: s.IsCurrent,
-        done: s.Done
-      }))
-    }));
-    console.log(JSON.stringify(result));
-  });
-  milestones.command("set").argument("<jobId>", "Job ID (GUID)").argument("<statusName>", "Destination milestone/status name (case-insensitive)").option("--message <message>", "Optional comment when advancing", "").description("Set a job's milestone/status by name").action(async (jobId, statusName, opts) => {
-    const data = await getClient2().get(
-      `/api/v3/job-workflows/${jobId}`
-    );
-    const needle = statusName.toLowerCase().trim();
-    let matchedMilestoneId = null;
-    let matchedStatus = null;
-    for (const m of data.Milestones) {
-      if (m.Name.toLowerCase().trim() === needle) {
-        matchedMilestoneId = m.MilestoneId;
-        matchedStatus = m.Statuses[0] ?? null;
-        break;
-      }
-      for (const s of m.Statuses) {
-        if (s.Name.toLowerCase().trim() === needle) {
-          matchedMilestoneId = m.MilestoneId;
-          matchedStatus = s;
-          break;
-        }
-      }
-      if (matchedStatus) break;
-    }
-    if (!matchedMilestoneId || !matchedStatus) {
-      const available = data.Milestones.flatMap(
-        (m) => m.Statuses.map((s) => s.Name.trim())
-      );
-      console.error(
-        JSON.stringify({
-          error: `Status "${statusName}" not found`,
-          available
-        })
-      );
-      process.exitCode = 1;
-      return;
-    }
-    await getClient2().post(
-      `/api/v3/job-workflows/${jobId}/set-state`,
-      {
-        MilestoneId: matchedMilestoneId,
-        StatusId: matchedStatus.StatusId,
-        Message: opts.message
-      }
-    );
-    console.log(
-      JSON.stringify({
-        jobId,
-        milestoneId: matchedMilestoneId,
-        statusId: matchedStatus.StatusId,
-        statusName: matchedStatus.Name.trim(),
-        message: opts.message || null
-      })
-    );
-  });
-}
-
-// src/unofficial/commands/jobs.ts
-async function resolveStatusId(client, statusName) {
-  const workflow = await client.get(
-    "/api/v3/workflows"
-  );
-  const needle = statusName.toLowerCase().trim();
-  for (const m of workflow.Milestones) {
-    for (const s of m.Statuses) {
-      if (s.Name.toLowerCase().trim() === needle) {
-        return { statusId: s.StatusId, milestoneName: m.Name };
-      }
-    }
-  }
-  return null;
-}
-async function getAvailableStatuses(client) {
-  const workflow = await client.get(
-    "/api/v3/workflows"
-  );
-  return workflow.Milestones.flatMap(
-    (m) => m.Statuses.map((s) => s.Name.trim())
-  );
-}
-function registerUnofficialJobsCommands(parentCmd, getClient2) {
-  const jobs = parentCmd.command("jobs").description("Unofficial job search with workflow status filtering");
-  jobs.command("list").description("List jobs, optionally filtered by workflow status or milestone").option("--status <name>", "Filter by workflow status name (case-insensitive)").option("--milestone <name>", "Filter by milestone name (e.g. Prospect, Approved)").option("--query <text>", "Search term").option("--sort <field>", "Sort: milestoneStart|desc, lastTouched|desc, createdDate|desc", "milestoneStart|desc").option("--page <n>", "Page number", "1").action(async (opts) => {
-    const client = getClient2();
-    const params = new URLSearchParams();
-    if (opts.status) {
-      const resolved = await resolveStatusId(client, opts.status);
-      if (!resolved) {
-        const available = await getAvailableStatuses(client);
-        console.error(
-          JSON.stringify({
-            error: `Status "${opts.status}" not found`,
-            available
-          })
-        );
-        process.exitCode = 1;
-        return;
-      }
-      params.append("filters", `currentStatusId=${resolved.statusId}`);
-    }
-    if (opts.milestone) {
-      params.append("filters", `currentMilestoneList=${opts.milestone}`);
-    }
-    params.set("sort", opts.sort);
-    params.set("page", opts.page);
-    params.set("type", "2");
-    params.set("loadAll", "false");
-    if (opts.query) params.set("query", opts.query);
-    const data = await client.get(
-      `/api/joblist?${params.toString()}`
-    );
-    const result = {
-      totalRecords: data.TotalRecords,
-      currentPage: data.CurrentPage,
-      totalPages: data.TotalPages,
-      jobs: data.results.map((j) => ({
-        id: j.Id,
-        name: j.Name,
-        address: j.FullAddress,
-        cityState: j.CityState,
-        milestone: j.CurrentMilestone,
-        status: j.CurrentStatus,
-        salesPerson: j.SalesPerson,
-        createdDate: j.CreatedDate,
-        lastTouched: j.LastTouched,
-        workTypes: j.WorkTypes,
-        trades: j.Trades
-      }))
-    };
-    console.log(JSON.stringify(result));
-  });
-}
-
-// src/unofficial/commands/index.ts
-function getSessionFromEnv() {
-  const email = process.env.ACCULYNX_EMAIL;
-  const companyId = process.env.ACCULYNX_COMPANY_ID;
-  if (!email || !companyId) {
-    throw new Error(
-      "Set ACCULYNX_EMAIL and ACCULYNX_COMPANY_ID (or run `acculynx unofficial login` first)"
-    );
-  }
-  const session = loadSession(email, companyId);
-  if (!session) {
-    throw new Error(
-      `No cached session for ${email} / ${companyId}. Run \`acculynx unofficial login\` first.`
-    );
-  }
-  return session;
-}
-function registerUnofficialCommands(parentCmd) {
-  const unofficial = parentCmd.command("unofficial").description(
-    "Unofficial web API commands (cookie-based auth, reverse-engineered)"
-  );
-  registerLoginCommands(unofficial);
-  let _client2 = null;
-  function getClient2() {
-    if (!_client2) {
-      _client2 = createUnofficialClient(getSessionFromEnv());
-    }
-    return _client2;
-  }
-  registerDocumentsCommands(unofficial, getClient2);
-  registerMessagesCommands(unofficial, getClient2);
-  registerMilestonesCommands(unofficial, getClient2);
-  registerUnofficialJobsCommands(unofficial, getClient2);
-}
-
 // src/index.ts
 var require2 = createRequire(import.meta.url);
 var { version } = require2("../package.json");
@@ -1060,7 +342,11 @@ registerPingCommand(program, getClient);
 registerJobsCommands(program, getClient);
 registerContactsCommands(program, getClient);
 registerEstimatesCommands(program, getClient);
-registerUnofficialCommands(program);
+try {
+  const mod = await import("@opsrev/acculynx-cli-unofficial");
+  mod.registerExtendedCommands(program);
+} catch {
+}
 program.parseAsync().catch((err) => {
   if (err.message === "(outputHelp)" || err.message === "(version)") {
     return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opsrev/acculynx-cli",
-  "version": "1.6.1",
+  "version": "1.8.0",
   "description": "CLI for the AccuLynx roofing CRM API",
   "type": "module",
   "bin": {
@@ -28,12 +28,10 @@
     "dist"
   ],
   "dependencies": {
-    "commander": "^14.0.3",
-    "turndown": "^7.2.2"
+    "commander": "^14.0.3"
   },
   "devDependencies": {
     "@types/node": "^25.4.0",
-    "@types/turndown": "^5.0.6",
     "tsup": "^8.5.1",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",