terminalmarket 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 TerminalMarket
+
+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,41 @@
+# terminalmarket (CLI)
+
+TerminalMarket CLI client for `terminalmarket.app`.
+
+## Install (global)
+
+```bash
+npm i -g terminalmarket
+```
+
+## Configure API base (optional)
+
+Defaults to:
+
+- `https://terminalmarket.app/api`
+
+Change it:
+
+```bash
+tm config set api https://terminalmarket.app/api
+tm config get api
+```
+
+## Commands
+
+- `tm products [--limit N]`
+- `tm categories`
+- `tm category <category> [--limit N]`
+- `tm search <query> [--limit N]` *(client-side search over /products)*
+- `tm view <productId>`
+- `tm buy <productId> [--no-open]` *(posts /clicks, then opens product.buyUrl)*
+
+## Notes
+
+This CLI is built to match the current backend routes:
+
+- `GET /api/products`
+- `GET /api/products/:id`
+- `GET /api/products/category/:category`
+- `GET /api/categories`
+- `POST /api/clicks`

package/bin/tm.js

@@ -0,0 +1,209 @@
+#!/usr/bin/env node
+
+import { Command } from "commander";
+import chalk from "chalk";
+import open from "open";
+
+import { apiGet, apiPost } from "../src/api.js";
+import { getApiBase, setApiBase } from "../src/config.js";
+import { printTable, pickProductFields, containsQuery } from "../src/format.js";
+
+const program = new Command();
+
+program
+  .name("tm")
+  .description("TerminalMarket CLI — marketplace for developers")
+  .version("0.1.1");
+
+// -----------------
+// config
+// -----------------
+const config = program
+  .command("config")
+  .description("Get/set CLI config");
+
+config
+  .command("get <key>")
+  .description("Get a config value (e.g. api)")
+  .action((key) => {
+    if (key === "api") {
+      console.log(getApiBase());
+      return;
+    }
+    console.error(chalk.red(`Unknown key: ${key}`));
+    process.exitCode = 1;
+  });
+
+config
+  .command("set <key> <value>")
+  .description("Set a config value (e.g. api)")
+  .action((key, value) => {
+    if (key === "api") {
+      setApiBase(value);
+      console.log(chalk.green(`api = ${getApiBase()}`));
+      return;
+    }
+    console.error(chalk.red(`Unknown key: ${key}`));
+    process.exitCode = 1;
+  });
+
+// -----------------
+// categories
+// -----------------
+program
+  .command("categories")
+  .description("List categories")
+  .action(async () => {
+    try {
+      const cats = await apiGet("/categories");
+      const rows = (cats || []).map((c) => ({ category: String(c) }));
+      printTable(rows, [{ key: "category", title: "category" }]);
+    } catch (e) {
+      console.error(chalk.red(e?.message || String(e)));
+      process.exitCode = 1;
+    }
+  });
+
+// -----------------
+// products
+// -----------------
+program
+  .command("products")
+  .description("List products")
+  .option("-l, --limit <n>", "Limit results", "20")
+  .action(async (opts) => {
+    try {
+      const limit = Math.max(1, Math.min(200, Number.parseInt(opts.limit, 10) || 20));
+      const products = await apiGet("/products");
+      const rows = (products || []).slice(0, limit).map(pickProductFields);
+      printTable(rows, [
+        { key: "id", title: "id" },
+        { key: "name", title: "name" },
+        { key: "price", title: "price" },
+        { key: "category", title: "category" },
+      ]);
+    } catch (e) {
+      console.error(chalk.red(e?.message || String(e)));
+      process.exitCode = 1;
+    }
+  });
+
+program
+  .command("category <category>")
+  .description("List products in a category")
+  .option("-l, --limit <n>", "Limit results", "20")
+  .action(async (category, opts) => {
+    try {
+      const limit = Math.max(1, Math.min(200, Number.parseInt(opts.limit, 10) || 20));
+      const products = await apiGet(`/products/category/${encodeURIComponent(category)}`);
+      const rows = (products || []).slice(0, limit).map(pickProductFields);
+      printTable(rows, [
+        { key: "id", title: "id" },
+        { key: "name", title: "name" },
+        { key: "price", title: "price" },
+        { key: "category", title: "category" },
+      ]);
+    } catch (e) {
+      console.error(chalk.red(e?.message || String(e)));
+      process.exitCode = 1;
+    }
+  });
+
+program
+  .command("search <query>")
+  .description("Search products (client-side)")
+  .option("-l, --limit <n>", "Limit results", "20")
+  .action(async (query, opts) => {
+    try {
+      const limit = Math.max(1, Math.min(200, Number.parseInt(opts.limit, 10) || 20));
+      const products = await apiGet("/products");
+      const q = String(query || "").trim();
+      const matched = (products || []).filter((p) => containsQuery(p, q));
+      const rows = matched.slice(0, limit).map(pickProductFields);
+      printTable(rows, [
+        { key: "id", title: "id" },
+        { key: "name", title: "name" },
+        { key: "price", title: "price" },
+        { key: "category", title: "category" },
+      ]);
+      if (matched.length > limit) {
+        console.log(chalk.dim(`Showing ${limit} of ${matched.length}. Use --limit to show more.`));
+      }
+    } catch (e) {
+      console.error(chalk.red(e?.message || String(e)));
+      process.exitCode = 1;
+    }
+  });
+
+program
+  .command("view <productId>")
+  .description("View a product")
+  .action(async (productId) => {
+    try {
+      const p = await apiGet(`/products/${encodeURIComponent(productId)}`);
+      if (!p) {
+        console.error(chalk.red("Not found"));
+        process.exitCode = 1;
+        return;
+      }
+      console.log(chalk.bold(p.name || p.title || `Product ${productId}`));
+      if (p.description) console.log(p.description);
+      console.log("");
+      console.log(`${chalk.dim("id:")} ${p.id}`);
+      if (p.category) console.log(`${chalk.dim("category:")} ${p.category}`);
+      if (p.price) console.log(`${chalk.dim("price:")} ${p.price}`);
+      if (p.buyUrl) console.log(`${chalk.dim("buyUrl:")} ${p.buyUrl}`);
+      if (p.storeId) console.log(`${chalk.dim("storeId:")} ${p.storeId}`);
+    } catch (e) {
+      console.error(chalk.red(e?.message || String(e)));
+      process.exitCode = 1;
+    }
+  });
+
+program
+  .command("buy <productId>")
+  .description("Record a click then open product buyUrl")
+  .option("--no-open", "Do not open a browser")
+  .action(async (productId, opts) => {
+    try {
+      const p = await apiGet(`/products/${encodeURIComponent(productId)}`);
+      if (!p) {
+        console.error(chalk.red("Not found"));
+        process.exitCode = 1;
+        return;
+      }
+
+      // best-effort click tracking
+      try {
+        await apiPost("/clicks", {
+          source: "cli",
+          productId: p.id,
+          storeId: p.storeId ?? null,
+          offerId: null,
+        });
+      } catch {
+        // ignore tracking failures
+      }
+
+      const url = p.buyUrl;
+      if (!url) {
+        console.error(chalk.red("This product has no buyUrl."));
+        process.exitCode = 1;
+        return;
+      }
+
+      console.log(chalk.green("Opening:"), url);
+      if (opts.open !== false) {
+        await open(url);
+      }
+    } catch (e) {
+      console.error(chalk.red(e?.message || String(e)));
+      process.exitCode = 1;
+    }
+  });
+
+program.parse(process.argv);
+
+if (!process.argv.slice(2).length) {
+  program.outputHelp();
+}

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "terminalmarket",
+  "version": "0.1.1",
+  "description": "TerminalMarket CLI — marketplace for developers (client for terminalmarket.app)",
+  "bin": {
+    "tm": "./bin/tm.js"
+  },
+  "type": "module",
+  "keywords": [
+    "cli",
+    "marketplace",
+    "terminal",
+    "developers",
+    "food",
+    "subscription"
+  ],
+  "author": "TerminalMarket",
+  "license": "MIT",
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "conf": "^12.0.0",
+    "node-fetch": "^3.3.2",
+    "open": "^9.1.0"
+  }
+}

package/src/api.js

@@ -0,0 +1,34 @@
+import fetch from "node-fetch";
+import { getApiBase } from "./config.js";
+
+function joinUrl(base, path) {
+  if (!base) return path;
+  return base.replace(/\/$/, "") + "/" + path.replace(/^\//, "");
+}
+
+export async function apiGet(path) {
+  const url = joinUrl(getApiBase(), path);
+  const res = await fetch(url, { method: "GET" });
+  if (!res.ok) {
+    const text = await res.text().catch(() => "");
+    throw new Error(`GET ${url} failed: ${res.status} ${res.statusText}${text ? " — " + text : ""}`);
+  }
+  return res.json();
+}
+
+export async function apiPost(path, body) {
+  const url = joinUrl(getApiBase(), path);
+  const res = await fetch(url, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify(body ?? {})
+  });
+  if (!res.ok) {
+    const text = await res.text().catch(() => "");
+    throw new Error(`POST ${url} failed: ${res.status} ${res.statusText}${text ? " — " + text : ""}`);
+  }
+  // clicks endpoint can return empty or json
+  const ct = res.headers.get("content-type") || "";
+  if (ct.includes("application/json")) return res.json();
+  return { ok: true };
+}

package/src/config.js

@@ -0,0 +1,12 @@
+import Conf from "conf";
+
+const conf = new Conf({ projectName: "terminalmarket" });
+
+export function getApiBase() {
+  return conf.get("apiBase", "https://terminalmarket.app/api");
+}
+
+export function setApiBase(value) {
+  conf.set("apiBase", value);
+  return value;
+}

package/src/format.js

@@ -0,0 +1,37 @@
+import chalk from "chalk";
+
+export function printTable(rows, columns) {
+  if (!rows?.length) {
+    console.log(chalk.gray("No results."));
+    return;
+  }
+  const widths = {};
+  for (const col of columns) {
+    widths[col.key] = Math.max(col.title.length, ...rows.map(r => String(r[col.key] ?? "").length));
+  }
+  const header = columns.map(c => chalk.bold(String(c.title).padEnd(widths[c.key]))).join("  ");
+  console.log(header);
+  console.log(columns.map(c => "-".repeat(widths[c.key])).join("  "));
+  for (const r of rows) {
+    const line = columns.map(c => String(r[c.key] ?? "").padEnd(widths[c.key])).join("  ");
+    console.log(line);
+  }
+}
+
+export function pickProductFields(p) {
+  return {
+    id: p?.id ?? "",
+    name: p?.name ?? p?.title ?? "",
+    category: p?.category ?? "",
+    price: p?.price ? `$${p.price}` : (p?.priceDisplay ?? ""),
+    buyUrl: p?.buyUrl ?? ""
+  };
+}
+
+export function containsQuery(p, q) {
+  const hay = [
+    p?.name, p?.title, p?.description, p?.shortDescription, p?.category,
+    ...(Array.isArray(p?.tags) ? p.tags : [])
+  ].filter(Boolean).join(" ").toLowerCase();
+  return hay.includes(q);
+}