@easycustomerfeedback/cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Michael Bonner
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,101 @@
+# @easycustomerfeedback/cli
+
+`ecf` is the command-line interface for [EasyCustomerFeedback](https://easycustomerfeedback.com). Triage feedback submissions, update statuses, and leave internal comments from your terminal.
+
+## Install
+
+```sh
+npm install -g @easycustomerfeedback/cli
+```
+
+Or run without installing:
+
+```sh
+npx @easycustomerfeedback/cli --help
+```
+
+Requires Node.js 18 or newer.
+
+## Getting started
+
+1. In the EasyCustomerFeedback dashboard, open **Integrations → Personal API tokens** and create a token. Copy it — tokens are only shown once.
+2. Log in:
+
+    ```sh
+    ecf login
+    ```
+
+    You'll be prompted for the server URL (defaults to `https://easycustomerfeedback.com`) and the token. Credentials are saved to `~/.config/ecf/config.json`.
+3. If you belong to multiple workspaces, pick a default:
+
+    ```sh
+    ecf workspace list
+    ecf workspace use <workspaceId>
+    ```
+
+## Commands
+
+### Authentication
+
+| Command | What it does |
+| --- | --- |
+| `ecf login` | Configure server URL and API token. Auto-selects the workspace if you only have one. |
+
+### Workspaces
+
+| Command | What it does |
+| --- | --- |
+| `ecf workspace list` | Show the workspaces you belong to (marks the active one). |
+| `ecf workspace use <id>` | Set the default workspace for future commands. |
+
+### Submissions
+
+| Command | What it does |
+| --- | --- |
+| `ecf submissions list [options]` | List submissions in the active workspace. |
+| `ecf submissions get <id> [--json]` | Show details for a submission. |
+| `ecf submissions status <id> <status>` | Update a submission's status. |
+| `ecf submissions comment <id> [body]` | Add an internal comment (body may come from stdin). |
+
+`ecf submissions list` options:
+
+- `--status <s>` — filter by status (repeatable: `untriaged`, `open`, `in_progress`, `resolved`, `closed`)
+- `--type <t>` — filter by type (`bug`, `feature_request`, `general_feedback`)
+- `--project <id>` — filter by project
+- `--limit <n>` — 1..200 (default 50)
+- `--workspace <id>` — override the active workspace
+- `--json` — output raw JSON
+
+Valid status values for `ecf submissions status`: `untriaged`, `open`, `in_progress`, `resolved`, `closed`.
+
+## Examples
+
+List open bugs, piped to your pager:
+
+```sh
+ecf submissions list --status open --type bug | less
+```
+
+Pipe a longer comment in from a file:
+
+```sh
+cat review.md | ecf submissions comment sub_abc123
+```
+
+Resolve a submission:
+
+```sh
+ecf submissions status sub_abc123 resolved
+```
+
+## Configuration
+
+Configuration lives at `~/.config/ecf/config.json` and is created by `ecf login`. Delete the file to reset.
+
+## API reference
+
+The CLI is a thin wrapper around the public REST API. See [the API docs](https://easycustomerfeedback.com/docs/api) for everything the CLI exposes and more.
+
+## License
+
+[MIT](./LICENSE)

package/dist/index.js

@@ -0,0 +1,344 @@
+#!/usr/bin/env node
+
+// src/commands/login.ts
+import { createInterface } from "node:readline/promises";
+
+// src/api.ts
+class ApiError extends Error {
+  status;
+  constructor(message, status) {
+    super(message);
+    this.status = status;
+  }
+}
+async function apiFetch(config, path, init = {}) {
+  const url = new URL(path, config.baseUrl).toString();
+  const headers = new Headers(init.headers);
+  headers.set("authorization", `Bearer ${config.apiKey}`);
+  if (init.body && !headers.has("content-type")) {
+    headers.set("content-type", "application/json");
+  }
+  const res = await fetch(url, { ...init, headers });
+  const text = await res.text();
+  let body = null;
+  if (text) {
+    try {
+      body = JSON.parse(text);
+    } catch {
+      body = text;
+    }
+  }
+  if (!res.ok) {
+    const message = typeof body === "object" && body !== null && "error" in body ? String(body.error) : `Request failed with status ${res.status}`;
+    throw new ApiError(message, res.status);
+  }
+  return body;
+}
+
+// src/config.ts
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+var CONFIG_DIR = join(homedir(), ".config", "ecf");
+var CONFIG_PATH = join(CONFIG_DIR, "config.json");
+function loadConfig() {
+  if (!existsSync(CONFIG_PATH))
+    return null;
+  try {
+    const raw = readFileSync(CONFIG_PATH, "utf8");
+    const parsed = JSON.parse(raw);
+    if (typeof parsed?.baseUrl !== "string" || typeof parsed?.apiKey !== "string")
+      return null;
+    return parsed;
+  } catch {
+    return null;
+  }
+}
+function saveConfig(config) {
+  mkdirSync(dirname(CONFIG_PATH), { recursive: true });
+  writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2) + `
+`, { mode: 384 });
+}
+function requireConfig() {
+  const config = loadConfig();
+  if (!config) {
+    console.error("Not logged in. Run: ecf login");
+    process.exit(1);
+  }
+  return config;
+}
+
+// src/commands/login.ts
+async function prompt(rl, question, def) {
+  const suffix = def ? ` [${def}]` : "";
+  const answer = (await rl.question(`${question}${suffix}: `)).trim();
+  return answer || def || "";
+}
+async function login() {
+  const existing = loadConfig();
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  try {
+    const baseUrl = await prompt(rl, "Server URL", existing?.baseUrl ?? "https://easycustomerfeedback.com");
+    const apiKey = await prompt(rl, "API token (ecf_…)");
+    if (!baseUrl || !apiKey) {
+      console.error("Server URL and API token are both required.");
+      process.exit(1);
+    }
+    const config = { baseUrl, apiKey, workspaceId: existing?.workspaceId };
+    const { workspaces } = await apiFetch(config, "/api/v1/workspaces");
+    if (workspaces.length === 1) {
+      config.workspaceId = workspaces[0].id;
+    }
+    saveConfig(config);
+    console.log(`
+Saved to ${CONFIG_PATH}`);
+    console.log(`You belong to ${workspaces.length} workspace(s):`);
+    for (const w of workspaces) {
+      const marker = w.id === config.workspaceId ? "* " : "  ";
+      console.log(`${marker}${w.id}  ${w.name}`);
+    }
+    if (workspaces.length === 1) {
+      console.log(`
+Active workspace set to ${workspaces[0].name}.`);
+    } else if (!config.workspaceId && workspaces.length > 1) {
+      console.log("\nTip: pick a default with `ecf workspace use <id>`");
+    }
+  } finally {
+    rl.close();
+  }
+}
+
+// src/commands/submissions.ts
+import { parseArgs } from "node:util";
+function resolveWorkspace(config, override) {
+  const id = override ?? config.workspaceId;
+  if (!id) {
+    console.error("No workspace selected. Pass --workspace <id> or set a default with `ecf workspace use <id>`.");
+    process.exit(1);
+  }
+  return id;
+}
+async function readStdin() {
+  const chunks = [];
+  for await (const chunk of process.stdin) {
+    chunks.push(typeof chunk === "string" ? Buffer.from(chunk) : chunk);
+  }
+  return Buffer.concat(chunks).toString("utf8").trim();
+}
+async function submissionsCommand(args) {
+  const [sub, ...rest] = args;
+  if (sub === "list")
+    return list(rest);
+  if (sub === "get")
+    return get(rest);
+  if (sub === "status")
+    return status(rest);
+  if (sub === "comment")
+    return comment(rest);
+  console.error("Usage: ecf submissions <list|get|status|comment>");
+  process.exit(1);
+}
+async function list(args) {
+  const { values } = parseArgs({
+    args,
+    options: {
+      status: { type: "string", multiple: true },
+      type: { type: "string" },
+      project: { type: "string" },
+      limit: { type: "string" },
+      workspace: { type: "string" },
+      json: { type: "boolean" }
+    },
+    allowPositionals: false
+  });
+  const config = requireConfig();
+  const workspaceId = resolveWorkspace(config, values.workspace);
+  const params = new URLSearchParams({ workspaceId });
+  for (const s of values.status ?? [])
+    params.append("status", s);
+  if (values.type)
+    params.set("type", values.type);
+  if (values.project)
+    params.set("projectId", values.project);
+  if (values.limit)
+    params.set("limit", values.limit);
+  const { submissions } = await apiFetch(config, `/api/v1/submissions?${params.toString()}`);
+  if (values.json) {
+    console.log(JSON.stringify(submissions, null, 2));
+    return;
+  }
+  if (submissions.length === 0) {
+    console.log("No submissions match.");
+    return;
+  }
+  for (const s of submissions) {
+    const submitter = s.submitterName ?? s.submitterEmail ?? "anonymous";
+    console.log(`${s.id}  [${s.status.padEnd(11)}] ${s.type.padEnd(18)} ${s.projectName} · ${s.title}  (${submitter})`);
+  }
+}
+async function get(args) {
+  const { values, positionals } = parseArgs({
+    args,
+    options: { json: { type: "boolean" } },
+    allowPositionals: true
+  });
+  const [id] = positionals;
+  if (!id) {
+    console.error("Usage: ecf submissions get <id> [--json]");
+    process.exit(1);
+  }
+  const config = requireConfig();
+  const { submission } = await apiFetch(config, `/api/v1/submissions/${encodeURIComponent(id)}`);
+  if (values.json) {
+    console.log(JSON.stringify(submission, null, 2));
+    return;
+  }
+  console.log(`# ${submission.title}`);
+  console.log(`id: ${submission.id}  type: ${submission.type}  status: ${submission.status}  priority: ${submission.priority}`);
+  console.log(`project: ${submission.projectName}  workspace: ${submission.workspaceName}`);
+  const submitter = submission.submitterName ?? submission.submitterEmail ?? "anonymous";
+  console.log(`from: ${submitter}  created: ${submission.createdAt}`);
+  if (submission.sourceUrl)
+    console.log(`url: ${submission.sourceUrl}`);
+  if (submission.assignee) {
+    console.log(`assigned: ${submission.assignee.name ?? submission.assignee.email}`);
+  }
+  console.log("");
+  console.log(submission.description);
+  if (submission.comments.length > 0) {
+    console.log(`
+— comments —`);
+    for (const c of submission.comments) {
+      const who = c.author.name ?? c.author.email ?? "unknown";
+      console.log(`
+${who}  ${c.createdAt}`);
+      console.log(c.body);
+    }
+  }
+  if (submission.attachments.length > 0) {
+    console.log(`
+— attachments —`);
+    for (const a of submission.attachments) {
+      console.log(`${a.fileName}  ${a.downloadUrl}`);
+    }
+  }
+}
+async function status(args) {
+  const [id, newStatus] = args;
+  if (!id || !newStatus) {
+    console.error("Usage: ecf submissions status <id> <untriaged|open|in_progress|resolved|closed>");
+    process.exit(1);
+  }
+  const config = requireConfig();
+  await apiFetch(config, `/api/v1/submissions/${encodeURIComponent(id)}`, {
+    method: "PATCH",
+    body: JSON.stringify({ status: newStatus })
+  });
+  console.log(`Updated ${id} → ${newStatus}`);
+}
+async function comment(args) {
+  const [id, ...bodyParts] = args;
+  if (!id) {
+    console.error("Usage: ecf submissions comment <id> [body]   (body may also come via stdin)");
+    process.exit(1);
+  }
+  let body = bodyParts.join(" ").trim();
+  if (!body && !process.stdin.isTTY) {
+    body = await readStdin();
+  }
+  if (!body) {
+    console.error("Comment body is required (positional arg or stdin).");
+    process.exit(1);
+  }
+  const config = requireConfig();
+  const result = await apiFetch(config, `/api/v1/submissions/${encodeURIComponent(id)}/comments`, { method: "POST", body: JSON.stringify({ body }) });
+  console.log(`Added comment ${result.comment.id}`);
+}
+
+// src/commands/workspace.ts
+async function workspaceCommand(args) {
+  const [sub, ...rest] = args;
+  if (sub === "list") {
+    const config = requireConfig();
+    const { workspaces } = await apiFetch(config, "/api/v1/workspaces");
+    if (workspaces.length === 0) {
+      console.log("No workspaces.");
+      return;
+    }
+    const activeId = config.workspaceId;
+    for (const w of workspaces) {
+      const marker = w.id === activeId ? "* " : "  ";
+      console.log(`${marker}${w.id}  ${w.name}`);
+    }
+    return;
+  }
+  if (sub === "use") {
+    const config = requireConfig();
+    const [workspaceId] = rest;
+    if (!workspaceId) {
+      console.error("Usage: ecf workspace use <workspaceId>");
+      process.exit(1);
+    }
+    saveConfig({ ...config, workspaceId });
+    console.log(`Active workspace set to ${workspaceId}`);
+    return;
+  }
+  console.error("Usage: ecf workspace <list|use>");
+  process.exit(1);
+}
+
+// src/index.ts
+var USAGE = `ecf — EasyCustomerFeedback CLI
+
+Usage:
+  ecf login                                  Configure API token and server
+  ecf workspace list                         List workspaces you belong to
+  ecf workspace use <workspaceId>            Set the default workspace
+
+  ecf submissions list [options]             List submissions in the active workspace
+    --status <s>     (repeatable: untriaged|open|in_progress|resolved|closed)
+    --type <t>       bug | feature_request | general_feedback
+    --project <id>   Filter by project id
+    --limit <n>      1..200 (default 50)
+    --workspace <id> Override active workspace
+    --json           Output raw JSON
+
+  ecf submissions get <id> [--json]          Show details for a submission
+  ecf submissions status <id> <status>       Update a submission's status
+  ecf submissions comment <id> [body]        Add an internal comment
+    (if body is omitted, reads from stdin)
+`;
+async function main() {
+  const argv = process.argv.slice(2);
+  const [command, ...rest] = argv;
+  if (!command || command === "help" || command === "--help" || command === "-h") {
+    process.stdout.write(USAGE);
+    return;
+  }
+  try {
+    switch (command) {
+      case "login":
+        await login();
+        return;
+      case "workspace":
+        await workspaceCommand(rest);
+        return;
+      case "submissions":
+        await submissionsCommand(rest);
+        return;
+      default:
+        console.error(`Unknown command: ${command}
+`);
+        process.stdout.write(USAGE);
+        process.exit(1);
+    }
+  } catch (err) {
+    if (err instanceof Error) {
+      console.error(`Error: ${err.message}`);
+    } else {
+      console.error("Unknown error", err);
+    }
+    process.exit(1);
+  }
+}
+await main();

package/package.json

@@ -0,0 +1,47 @@
+{
+	"name": "@easycustomerfeedback/cli",
+	"version": "0.1.0",
+	"description": "Command-line interface for EasyCustomerFeedback — list, triage, and comment on feedback submissions from your terminal.",
+	"license": "MIT",
+	"type": "module",
+	"bin": {
+		"ecf": "./dist/index.js"
+	},
+	"main": "./dist/index.js",
+	"files": [
+		"dist",
+		"README.md",
+		"LICENSE"
+	],
+	"engines": {
+		"node": ">=18"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/michaelbonner/easycustomerfeedback.git",
+		"directory": "packages/cli"
+	},
+	"homepage": "https://easycustomerfeedback.com",
+	"bugs": {
+		"url": "https://github.com/michaelbonner/easycustomerfeedback/issues"
+	},
+	"keywords": [
+		"easycustomerfeedback",
+		"ecf",
+		"cli",
+		"feedback",
+		"customer-feedback"
+	],
+	"scripts": {
+		"dev": "bun run src/index.ts",
+		"build": "bun run build.ts",
+		"typecheck": "tsc --noEmit",
+		"prepublishOnly": "bun run build"
+	},
+	"devDependencies": {
+		"typescript": "^6.0.2"
+	}
+}