@opally/cli 0.1.2 → 0.2.0

package/dist/bin/opally.js

@@ -8,15 +8,17 @@ const emails_js_1 = require("../commands/emails.js");
 const chats_js_1 = require("../commands/chats.js");
 const voice_js_1 = require("../commands/voice.js");
 const analytics_js_1 = require("../commands/analytics.js");
+const doctor_js_1 = require("../commands/doctor.js");
 const program = new commander_1.Command();
 program
     .name("opally")
     .description("CLI for the Opally API")
-    .version("0.1.2");
+    .version("0.2.0");
 program.addCommand(config_js_1.configCommand);
 program.addCommand(leads_js_1.leadsCommand);
 program.addCommand(emails_js_1.emailsCommand);
 program.addCommand(chats_js_1.chatsCommand);
 program.addCommand(voice_js_1.voiceCommand);
 program.addCommand(analytics_js_1.analyticsCommand);
+program.addCommand(doctor_js_1.doctorCommand);
 program.parse();

package/dist/commands/analytics.js

@@ -13,11 +13,12 @@ exports.analyticsCommand
     .option("--to <date>", "End date (ISO 8601)")
     .option("--json", "Output as JSON")
     .action(async (opts) => {
+    const fmt = (0, output_js_1.getFormat)(opts);
     const res = await (0, client_js_1.api)("/analytics/overview", {
         from: opts.from,
         to: opts.to,
     });
-    if (opts.json) {
+    if (fmt === "json") {
         (0, output_js_1.output)(res, "json");
         return;
     }
@@ -58,6 +59,7 @@ function addTimeSeriesCommand(name, path, description, extraFilters) {
         }
     }
     cmd.action(async (opts) => {
+        const fmt = (0, output_js_1.getFormat)(opts);
         const params = {
             from: opts.from,
             to: opts.to,
@@ -70,7 +72,7 @@ function addTimeSeriesCommand(name, path, description, extraFilters) {
             }
         }
         const res = await (0, client_js_1.api)(path, params);
-        if (opts.json) {
+        if (fmt === "json") {
             (0, output_js_1.output)(res, "json");
             return;
         }

package/dist/commands/chats.js

@@ -16,6 +16,7 @@ exports.chatsCommand
     .option("--cursor <cursor>", "Pagination cursor")
     .option("--json", "Output as JSON")
     .action(async (opts) => {
+    const fmt = (0, output_js_1.getFormat)(opts);
     const res = await (0, client_js_1.api)("/conversations/chats", {
         from: opts.from,
         to: opts.to,
@@ -23,14 +24,14 @@ exports.chatsCommand
         limit: opts.limit,
         cursor: opts.cursor,
     });
-    (0, output_js_1.output)(res.data, opts.json ? "json" : "table", [
+    (0, output_js_1.output)(res.data, fmt, [
         "id",
         "title",
         "platform",
         "language",
         "created_at",
     ]);
-    if (res.pagination.has_more) {
+    if (fmt === "table" && res.pagination.has_more) {
         console.log(`\nMore results available. Use --cursor ${res.pagination.next_cursor}`);
     }
 });
@@ -39,9 +40,10 @@ exports.chatsCommand
     .description("Get chat conversation details")
     .option("--json", "Output as JSON")
     .action(async (id, opts) => {
+    const fmt = (0, output_js_1.getFormat)(opts);
     const res = await (0, client_js_1.api)(`/conversations/chats/${(0, client_js_1.validateId)(id)}`);
     const data = res.data;
-    if (opts.json) {
+    if (fmt === "json") {
         (0, output_js_1.output)(data, "json");
         return;
     }
@@ -57,9 +59,10 @@ exports.chatsCommand
     .description("Get messages in a chat conversation")
     .option("--json", "Output as JSON")
     .action(async (id, opts) => {
+    const fmt = (0, output_js_1.getFormat)(opts);
     const res = await (0, client_js_1.api)(`/conversations/chats/${(0, client_js_1.validateId)(id)}/messages`);
     const messages = res.data.messages;
-    if (opts.json) {
+    if (fmt === "json") {
         (0, output_js_1.output)(messages, "json");
         return;
     }

package/dist/commands/config.js

@@ -8,7 +8,7 @@ exports.configCommand = new commander_1.Command("config")
 exports.configCommand
     .command("set-key <key>")
     .description("Save your Opally API key")
-    .action((key) => {
+    .action(async (key) => {
     if (!key.startsWith("op_live_") && !key.startsWith("op_test_")) {
         console.error("Invalid key format. Expected op_live_* or op_test_*");
         process.exit(1);
@@ -17,6 +17,23 @@ exports.configCommand
         console.error("Invalid key format. Key is too short.");
         process.exit(1);
     }
+    // Validate key against the API
+    const baseUrl = (0, config_js_1.getBaseUrl)();
+    try {
+        const res = await fetch(new URL("/v1/analytics/overview", baseUrl).toString(), {
+            headers: { Authorization: `Bearer ${key}` },
+        });
+        if (res.status === 401 || res.status === 403) {
+            console.error("Invalid API key. The key was rejected by the Opally API.");
+            process.exit(1);
+        }
+        if (!res.ok) {
+            console.error(`Warning: Could not validate key (HTTP ${res.status}). Saving anyway.`);
+        }
+    }
+    catch {
+        console.error("Warning: Could not reach the Opally API to validate key. Saving anyway.");
+    }
     const config = (0, config_js_1.loadConfig)();
     config.api_key = key;
     (0, config_js_1.saveConfig)(config);

package/dist/commands/doctor.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const doctorCommand: Command;

package/dist/commands/doctor.js

@@ -0,0 +1,107 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.doctorCommand = void 0;
+const commander_1 = require("commander");
+const config_js_1 = require("../config.js");
+const output_js_1 = require("../output.js");
+const VERSION = "0.2.0";
+exports.doctorCommand = new commander_1.Command("doctor")
+    .description("Run environment diagnostics")
+    .option("--json", "Output as JSON")
+    .action(async (opts) => {
+    const checks = [];
+    const isJson = opts.json || !process.stdout.isTTY;
+    // 1. CLI Version
+    checks.push({
+        name: "CLI Version",
+        status: "pass",
+        message: `v${VERSION}`,
+    });
+    // 2. API Key
+    const envKey = process.env.OPALLY_API_KEY;
+    const config = (0, config_js_1.loadConfig)();
+    const key = envKey || config.api_key;
+    if (key) {
+        const source = envKey ? "env" : "config";
+        const masked = key.slice(0, 12) + "..." + key.slice(-4);
+        checks.push({
+            name: "API Key",
+            status: "pass",
+            message: `${masked} (source: ${source})`,
+        });
+    }
+    else {
+        checks.push({
+            name: "API Key",
+            status: "fail",
+            message: "No API key found. Run: opally config set-key <key>",
+        });
+    }
+    // 3. Base URL
+    const baseUrl = (0, config_js_1.getBaseUrl)();
+    checks.push({
+        name: "Base URL",
+        status: "pass",
+        message: baseUrl,
+    });
+    // 4. API Connection
+    if (key) {
+        try {
+            const res = await fetch(new URL("/v1/analytics/overview", baseUrl).toString(), {
+                headers: { Authorization: `Bearer ${key}` },
+            });
+            if (res.ok) {
+                checks.push({
+                    name: "API Connection",
+                    status: "pass",
+                    message: "Connected",
+                });
+            }
+            else if (res.status === 401 || res.status === 403) {
+                checks.push({
+                    name: "API Connection",
+                    status: "fail",
+                    message: "API key rejected (401/403)",
+                });
+            }
+            else {
+                checks.push({
+                    name: "API Connection",
+                    status: "warn",
+                    message: `Unexpected response (HTTP ${res.status})`,
+                });
+            }
+        }
+        catch (err) {
+            checks.push({
+                name: "API Connection",
+                status: "fail",
+                message: `Could not reach ${baseUrl}`,
+            });
+        }
+    }
+    else {
+        checks.push({
+            name: "API Connection",
+            status: "fail",
+            message: "Skipped (no API key)",
+        });
+    }
+    // Output
+    const ok = checks.every((c) => c.status !== "fail");
+    if (isJson) {
+        (0, output_js_1.json)({ ok, checks });
+    }
+    else {
+        console.log("\n  Opally Doctor\n");
+        for (const check of checks) {
+            const icon = check.status === "pass" ? "\x1b[32m✔\x1b[0m"
+                : check.status === "warn" ? "\x1b[33m!\x1b[0m"
+                    : "\x1b[31m✖\x1b[0m";
+            console.log(`  ${icon} ${check.name}: ${check.message}`);
+        }
+        console.log();
+    }
+    if (!ok)
+        process.exit(1);
+});

package/dist/commands/emails.js

@@ -16,6 +16,7 @@ exports.emailsCommand
     .option("--cursor <cursor>", "Pagination cursor")
     .option("--json", "Output as JSON")
     .action(async (opts) => {
+    const fmt = (0, output_js_1.getFormat)(opts);
     const res = await (0, client_js_1.api)("/conversations/emails", {
         from: opts.from,
         to: opts.to,
@@ -23,14 +24,14 @@ exports.emailsCommand
         limit: opts.limit,
         cursor: opts.cursor,
     });
-    (0, output_js_1.output)(res.data, opts.json ? "json" : "table", [
+    (0, output_js_1.output)(res.data, fmt, [
         "id",
         "subject",
         "sender",
         "status",
         "timestamp",
     ]);
-    if (res.pagination.has_more) {
+    if (fmt === "table" && res.pagination.has_more) {
         console.log(`\nMore results available. Use --cursor ${res.pagination.next_cursor}`);
     }
 });
@@ -39,9 +40,10 @@ exports.emailsCommand
     .description("Get email details with draft")
     .option("--json", "Output as JSON")
     .action(async (id, opts) => {
+    const fmt = (0, output_js_1.getFormat)(opts);
     const res = await (0, client_js_1.api)(`/conversations/emails/${(0, client_js_1.validateId)(id)}`);
     const data = res.data;
-    if (opts.json) {
+    if (fmt === "json") {
         (0, output_js_1.output)(data, "json");
         return;
     }

package/dist/commands/leads.js

@@ -16,6 +16,7 @@ exports.leadsCommand
     .option("--cursor <cursor>", "Pagination cursor")
     .option("--json", "Output as JSON")
     .action(async (opts) => {
+    const fmt = (0, output_js_1.getFormat)(opts);
     const res = await (0, client_js_1.api)("/leads", {
         from: opts.from,
         to: opts.to,
@@ -23,14 +24,14 @@ exports.leadsCommand
         limit: opts.limit,
         cursor: opts.cursor,
     });
-    (0, output_js_1.output)(res.data, opts.json ? "json" : "table", [
+    (0, output_js_1.output)(res.data, fmt, [
         "id",
         "name",
         "email",
         "source",
         "created_at",
     ]);
-    if (res.pagination.has_more) {
+    if (fmt === "table" && res.pagination.has_more) {
         console.log(`\nMore results available. Use --cursor ${res.pagination.next_cursor}`);
     }
 });
@@ -40,5 +41,5 @@ exports.leadsCommand
     .option("--json", "Output as JSON")
     .action(async (id, opts) => {
     const res = await (0, client_js_1.api)(`/leads/${(0, client_js_1.validateId)(id)}`);
-    (0, output_js_1.output)(res.data, opts.json ? "json" : "table");
+    (0, output_js_1.output)(res.data, (0, output_js_1.getFormat)(opts));
 });

package/dist/commands/voice.js

@@ -15,13 +15,14 @@ exports.voiceCommand
     .option("--cursor <cursor>", "Pagination cursor")
     .option("--json", "Output as JSON")
     .action(async (opts) => {
+    const fmt = (0, output_js_1.getFormat)(opts);
     const res = await (0, client_js_1.api)("/conversations/voice", {
         from: opts.from,
         to: opts.to,
         limit: opts.limit,
         cursor: opts.cursor,
     });
-    (0, output_js_1.output)(res.data, opts.json ? "json" : "table", [
+    (0, output_js_1.output)(res.data, fmt, [
         "id",
         "from_number",
         "to_number",
@@ -29,7 +30,7 @@ exports.voiceCommand
         "status",
         "started_at",
     ]);
-    if (res.pagination.has_more) {
+    if (fmt === "table" && res.pagination.has_more) {
         console.log(`\nMore results available. Use --cursor ${res.pagination.next_cursor}`);
     }
 });
@@ -38,9 +39,10 @@ exports.voiceCommand
     .description("Get voice call details")
     .option("--json", "Output as JSON")
     .action(async (id, opts) => {
+    const fmt = (0, output_js_1.getFormat)(opts);
     const res = await (0, client_js_1.api)(`/conversations/voice/${(0, client_js_1.validateId)(id)}`);
     const data = res.data;
-    if (opts.json) {
+    if (fmt === "json") {
         (0, output_js_1.output)(data, "json");
         return;
     }

package/dist/output.d.ts

@@ -1,3 +1,10 @@
 export declare function table(rows: Record<string, unknown>[], columns?: string[]): void;
 export declare function json(data: unknown): void;
+/**
+ * Resolve output format: --json flag wins, otherwise auto-detect
+ * based on whether stdout is a TTY (terminal = table, piped = json).
+ */
+export declare function getFormat(opts: {
+    json?: boolean;
+}): "table" | "json";
 export declare function output(data: unknown, format: "table" | "json", columns?: string[]): void;

package/dist/output.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.table = table;
 exports.json = json;
+exports.getFormat = getFormat;
 exports.output = output;
 function table(rows, columns) {
     if (rows.length === 0) {
@@ -27,6 +28,15 @@ function table(rows, columns) {
 function json(data) {
     console.log(JSON.stringify(data, null, 2));
 }
+/**
+ * Resolve output format: --json flag wins, otherwise auto-detect
+ * based on whether stdout is a TTY (terminal = table, piped = json).
+ */
+function getFormat(opts) {
+    if (opts.json)
+        return "json";
+    return process.stdout.isTTY ? "table" : "json";
+}
 function output(data, format, columns) {
     if (format === "json") {
         json(data);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opally/cli",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "CLI for the Opally API — query guest conversations, emails, voice calls, leads, and analytics.",
   "bin": {
     "opally": "./dist/bin/opally.js"