@opsrev/acculynx-cli 1.7.0 → 1.8.1

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

@@ -343,8 +343,9 @@ registerJobsCommands(program, getClient);
 registerContactsCommands(program, getClient);
 registerEstimatesCommands(program, getClient);
 try {
-  const mod = await import("@opsrev/acculynx-cli-unofficial");
-  mod.registerUnofficialCommands(program);
+  const resolved = require2.resolve("@opsrev/acculynx-cli-unofficial");
+  const mod = await import(resolved);
+  mod.registerExtendedCommands(program);
 } catch {
 }
 program.parseAsync().catch((err) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opsrev/acculynx-cli",
-  "version": "1.7.0",
+  "version": "1.8.1",
   "description": "CLI for the AccuLynx roofing CRM API",
   "type": "module",
   "bin": {