@surelycrm/cli 1.0.0 → 1.2.0

package/README.md

@@ -45,12 +45,14 @@ Configuration is stored in `~/.surecli/config.json`.
 |---------|-------------|
 | `sure-cli config` | Show stored configuration |
 | `sure-cli create-customer` | Create a new customer |
-| `sure-cli get-customer --id {guid}` | Get a customer by GUID |
-| `sure-cli get-customer-by-reference --reference {ref}` | Get a customer by reference number |
+| `sure-cli get-customer --id {guid}` | Get a customer by GUID, email, or reference |
 | `sure-cli update-customer --id {guid}` | Update an existing customer |
 | `sure-cli change-status --customer-id {guid} --status-id {guid}` | Change a customer's status |
 | `sure-cli start-workflow --customer-id {guid} --workflow-name {name}` | Start a workflow for a customer |
 | `sure-cli get-customers-by-age --age {age} --comparison {comparison}` | Filter customers by age |
+| `sure-cli get-support-tickets --new` | Get new/open support tickets |
+| `sure-cli get-support-tickets --recently-replied --hours {hours}` | Get recently replied support tickets |
+| `sure-cli reply-to-ticket --id {guid} --message {message}` | Reply to a support ticket |
 
 Use `--help` on any command for details.
 
@@ -61,6 +63,7 @@ JSON templates for complex payloads are in the `templates/` directory:
 - `customer.json` — customer create/update payload
 - `status-change.json` — status change payload
 - `workflow-start.json` — workflow start payload
+- `support-reply.json` — support ticket reply payload
 
 ## Documentation
 

package/bin/sure-cli.js

@@ -7,7 +7,7 @@ const { loadConfig, saveConfig, requireConfig } = require('../lib/config');
 const { request, handleResponse } = require('../lib/api');
 
 const program = new Command();
-program.name('sure-cli').description('CLI wrapper for the SurelyCrm API').version('1.0.0');
+program.name('sure-cli').description('CLI wrapper for the SurelyCrm API').version('1.1.0');
 
 const TEMPLATES_DIR = path.join(__dirname, '..', 'templates');
 
@@ -107,23 +107,33 @@ program
 
 program
     .command('get-customer')
-    .description('Get a customer by GUID')
-    .requiredOption('--id <guid>', 'Customer GUID')
+    .description('Get a customer by GUID, email address, or reference number')
+    .option('--id <guid>', 'Customer GUID')
+    .option('--email <email>', 'Customer email address')
+    .option('--reference <reference>', 'Customer reference number')
     .action(run(async (options) => {
         const config = requireConfig();
-        const id = getRequiredOption(options, 'id');
-        const response = await request(config.baseUrl, config.apiKey, 'GET', `Api/customer/${id}`);
-        handleResponse(response);
-    }));
 
-program
-    .command('get-customer-by-reference')
-    .description('Get a customer by reference number')
-    .requiredOption('--reference <reference>', 'Customer reference number')
-    .action(run(async (options) => {
-        const config = requireConfig();
-        const reference = getRequiredOption(options, 'reference');
-        const response = await request(config.baseUrl, config.apiKey, 'GET', `Api/customer/reference/${encodeURIComponent(reference)}`);
+        const provided = [options.id, options.email, options.reference].filter(Boolean);
+        if (provided.length === 0) {
+            console.error('One of --id, --email, or --reference is required');
+            process.exit(1);
+        }
+        if (provided.length > 1) {
+            console.error('Only one of --id, --email, or --reference can be provided');
+            process.exit(1);
+        }
+
+        let path;
+        if (options.id) {
+            path = `Api/customer/${options.id}`;
+        } else if (options.email) {
+            path = `Api/customer/byEmail/${encodeURIComponent(options.email)}`;
+        } else {
+            path = `Api/customer/reference/${encodeURIComponent(options.reference)}`;
+        }
+
+        const response = await request(config.baseUrl, config.apiKey, 'GET', path);
         handleResponse(response);
     }));
 
@@ -199,4 +209,76 @@ program
         handleResponse(response);
     }));
 
+program
+    .command('get-support-tickets')
+    .description('Get support tickets')
+    .option('--new', 'Get new/open support tickets')
+    .option('--recently-replied', 'Get support tickets with replies in the recent period')
+    .option('--hours <hours>', 'Number of hours to look back for recently replied tickets', '24')
+    .option('--page <page>', 'Page number', '1')
+    .option('--page-size <pageSize>', 'Page size', '25')
+    .action(run(async (options) => {
+        const config = requireConfig();
+
+        if (!options.new && !options.recentlyReplied) {
+            console.error('Either --new or --recently-replied is required');
+            process.exit(1);
+        }
+
+        if (options.new && options.recentlyReplied) {
+            console.error('Cannot use both --new and --recently-replied at the same time');
+            process.exit(1);
+        }
+
+        const params = new URLSearchParams();
+        if (options.new) {
+            params.append('newTickets', 'true');
+        } else if (options.recentlyReplied) {
+            params.append('recentlyReplied', 'true');
+            params.append('hours', options.hours);
+        }
+        params.append('page', options.page);
+        params.append('pageSize', options.pageSize);
+
+        const response = await request(config.baseUrl, config.apiKey, 'GET', `Api/support/tickets?${params.toString()}`);
+        handleResponse(response);
+    }));
+
+program
+    .command('reply-to-ticket')
+    .description('Reply to a support ticket')
+    .requiredOption('--id <guid>', 'Support ticket GUID')
+    .option('--message <message>', 'Reply message text')
+    .option('--template <file>', 'Path to a JSON reply template')
+    .option('--data <json>', 'Inline JSON reply payload')
+    .option('--internal', 'Mark the reply as internal-only', false)
+    .option('--close', 'Close the ticket after replying', false)
+    .action(run(async (options) => {
+        const config = requireConfig();
+        const id = getRequiredOption(options, 'id');
+
+        let body = parseDataInput(options);
+        if (!body) {
+            body = loadTemplate('support-reply');
+        }
+
+        if (options.message) {
+            body.message = options.message;
+        }
+        if (options.internal) {
+            body.isInternal = true;
+        }
+        if (options.close) {
+            body.closeAfterReply = true;
+        }
+
+        if (!body.message) {
+            console.error('A message is required. Use --message, --template, or --data.');
+            process.exit(1);
+        }
+
+        const response = await request(config.baseUrl, config.apiKey, 'POST', `Api/support/tickets/${id}/reply`, body);
+        handleResponse(response);
+    }));
+
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@surelycrm/cli",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "CLI wrapper for the SurelyCrm API",
   "main": "index.js",
   "bin": {

package/templates/support-reply.json

@@ -0,0 +1,5 @@
+{
+  "message": "",
+  "isInternal": false,
+  "closeAfterReply": false
+}