@hasna/microservices 0.0.21 → 0.0.22

package/bin/index.js

@@ -1875,6 +1875,7 @@ var require_commander = __commonJS((exports) => {
 // src/cli/index.tsx
 import fs from "fs";
 import path from "path";
+import { createInterface } from "readline/promises";
 
 // node_modules/.bun/chalk@5.6.2/node_modules/chalk/source/vendor/ansi-styles/index.js
 var ANSI_BACKGROUND_OFFSET = 10;
@@ -2985,17 +2986,58 @@ async function runMicroserviceCommand(name, args, timeout = 30000) {
 
 // src/cli/index.tsx
 var program2 = new Command;
+function printJson(value) {
+  process.stdout.write(`${JSON.stringify(value, null, 2)}
+`);
+}
 program2.name("microservices").description("Production-grade microservice building blocks for SaaS apps").version(getPackageVersion());
-program2.command("list").description("List all available microservices").option("--installed", "Show only installed microservices").action((opts) => {
-  const services = opts.installed ? MICROSERVICES.filter((m) => microserviceExists(m.name)) : MICROSERVICES;
+program2.command("list").description("List all available microservices").option("--installed", "Show only installed microservices").option("--category <name>", "Filter by category (case-insensitive)").option("--limit <n>", "Limit number of results").option("--offset <n>", "Skip the first N results").option("--json", "Print machine-readable JSON output").action((opts) => {
+  const limit = opts.limit === undefined ? null : Number(opts.limit);
+  const offset = opts.offset === undefined ? 0 : Number(opts.offset);
+  if (limit !== null && (!Number.isInteger(limit) || limit < 0)) {
+    console.error(source_default.red("--limit must be a non-negative integer"));
+    process.exit(1);
+  }
+  if (!Number.isInteger(offset) || offset < 0) {
+    console.error(source_default.red("--offset must be a non-negative integer"));
+    process.exit(1);
+  }
+  const categoryFilter = opts.category?.trim().toLowerCase();
+  let services = opts.installed ? MICROSERVICES.filter((m) => microserviceExists(m.name)) : MICROSERVICES;
+  if (categoryFilter) {
+    services = services.filter((m) => m.category.toLowerCase() === categoryFilter);
+  }
+  const start = offset;
+  const end = limit === null ? undefined : offset + limit;
+  const page = services.slice(start, end);
+  const payload = page.map((m) => ({
+    name: m.name,
+    displayName: m.displayName,
+    binary: m.binary,
+    package: m.package,
+    category: m.category,
+    installed: microserviceExists(m.name),
+    description: m.description
+  }));
+  if (opts.json) {
+    printJson({
+      total: services.length,
+      count: payload.length,
+      offset,
+      limit,
+      category: opts.category ?? null,
+      services: payload
+    });
+    return;
+  }
   console.log(source_default.bold(`
 Available microservices:
 `));
-  for (const m of services) {
-    const installed = microserviceExists(m.name);
-    const status = installed ? source_default.green("\u2713 installed") : source_default.gray("  available");
+  for (const m of payload) {
+    const status = m.installed ? source_default.green("\u2713 installed") : source_default.gray("  available");
     console.log(`  ${status}  ${source_default.cyan(m.binary.padEnd(22))}  ${m.description.slice(0, 60)}`);
   }
+  console.log(source_default.gray(`Showing ${payload.length} of ${services.length} result(s) (offset ${offset}${limit === null ? "" : `, limit ${limit}`}).`));
   console.log();
 });
 program2.command("install [names...]").description("Install microservices globally via bun").option("--all", "Install all microservices").option("--force", "Reinstall even if already installed").action(async (names, opts) => {
@@ -3017,20 +3059,44 @@ Installing ${targets.length} microservice(s)...
   }
   console.log();
 });
-program2.command("remove <name>").description("Remove an installed microservice").action((name) => {
+program2.command("remove <name>").description("Remove an installed microservice").option("-y, --yes", "Skip confirmation prompt").action(async (name, opts) => {
+  if (!opts.yes) {
+    if (!process.stdin.isTTY || !process.stdout.isTTY) {
+      console.error(source_default.red("Refusing to remove without confirmation in non-interactive mode. Re-run with --yes."));
+      process.exit(1);
+    }
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    try {
+      const answer = await rl.question(`Remove ${name} from your global Bun installation? [y/N] `);
+      const confirmed = ["y", "yes"].includes(answer.trim().toLowerCase());
+      if (!confirmed) {
+        console.log(source_default.yellow("Cancelled."));
+        process.exit(1);
+      }
+    } finally {
+      rl.close();
+    }
+  }
   const ok = removeMicroservice(name);
-  if (ok)
+  if (ok) {
     console.log(source_default.green(`\u2713 Removed ${name}`));
-  else
-    console.log(source_default.red(`\u2717 Failed to remove ${name} \u2014 is it installed?`));
+    return;
+  }
+  console.error(source_default.red(`\u2717 Failed to remove ${name} \u2014 is it installed?`));
+  process.exit(1);
 });
-program2.command("status [name]").description("Show installation status").action((name) => {
+program2.command("status [name]").description("Show installation status").option("--json", "Print machine-readable JSON output").action((name, opts) => {
   const targets = name ? [name] : MICROSERVICES.map((m) => m.name);
+  const payload = targets.map((n) => getMicroserviceStatus(n));
+  if (opts.json) {
+    printJson(name ? payload[0] ?? null : payload);
+    return;
+  }
   console.log(source_default.bold(`
 Microservice status:
 `));
-  for (const n of targets) {
-    const s = getMicroserviceStatus(n);
+  for (const [index, n] of targets.entries()) {
+    const s = payload[index];
     const icon = s.installed ? source_default.green("\u2713") : source_default.gray("\u2717");
     const ver = s.version ? source_default.gray(`v${s.version}`) : "";
     const env2 = s.meta?.requiredEnv.join(", ") ?? "";
@@ -3048,8 +3114,12 @@ program2.command("run <name> [args...]").description("Run a command on an instal
 `);
   process.exit(result.exitCode);
 });
-program2.command("search <query>").description("Search microservices by name or keyword").action((query) => {
+program2.command("search <query>").description("Search microservices by name or keyword").option("--json", "Print machine-readable JSON output").action((query, opts) => {
   const results = searchMicroservices(query);
+  if (opts.json) {
+    printJson(results);
+    return;
+  }
   if (results.length === 0) {
     console.log(source_default.gray(`No microservices matching "${query}"`));
     return;
@@ -3183,13 +3253,17 @@ Initializing ${installed.length} installed microservices...
     console.log(source_default.gray("  You can now run 'microservices serve-all' to start them."));
   }
 });
-program2.command("info <name>").description("Show detailed info about a microservice").action((name) => {
+program2.command("info <name>").description("Show detailed info about a microservice").option("--json", "Print machine-readable JSON output").action((name, opts) => {
   const m = getMicroservice(name);
   if (!m) {
     console.error(source_default.red(`Unknown microservice: ${name}`));
     process.exit(1);
   }
   const installed = microserviceExists(name);
+  if (opts.json) {
+    printJson({ ...m, installed });
+    return;
+  }
   console.log(source_default.bold(`
 ${m.displayName}`));
   console.log(`  Package:     ${source_default.cyan(m.package)}`);
@@ -3204,29 +3278,57 @@ ${m.displayName}`));
   console.log(`  Tags:        ${m.tags.join(", ")}`);
   console.log();
 });
-program2.command("check-env").description("Verify environment variables for all installed microservices").action(() => {
+program2.command("check-env").description("Verify environment variables for all installed microservices").option("--json", "Print machine-readable JSON output").action((opts) => {
   const installed = MICROSERVICES.filter((m) => microserviceExists(m.name));
   if (installed.length === 0) {
-    console.log(source_default.yellow("No microservices installed to check."));
+    if (opts.json) {
+      printJson({
+        summary: { installed: 0, totalMissingRequired: 0, allOk: true },
+        services: []
+      });
+    } else {
+      console.log(source_default.yellow("No microservices installed to check."));
+    }
+    return;
+  }
+  const report = installed.map((m) => {
+    const missingRequired = m.requiredEnv.filter((env2) => !process.env[env2]);
+    const missingOptional = (m.optionalEnv ?? []).filter((env2) => !process.env[env2]);
+    return {
+      name: m.name,
+      missingRequired,
+      missingOptional,
+      ok: missingRequired.length === 0
+    };
+  });
+  const totalMissing = report.reduce((sum, service) => sum + service.missingRequired.length, 0);
+  if (opts.json) {
+    printJson({
+      summary: {
+        installed: installed.length,
+        totalMissingRequired: totalMissing,
+        allOk: totalMissing === 0
+      },
+      services: report
+    });
+    if (totalMissing > 0) {
+      process.exit(1);
+    }
     return;
   }
   console.log(source_default.bold(`
 Checking environment for ${installed.length} microservices...
 `));
-  let totalMissing = 0;
-  for (const m of installed) {
-    const missingRequired = m.requiredEnv.filter((env2) => !process.env[env2]);
-    const missingOptional = (m.optionalEnv ?? []).filter((env2) => !process.env[env2]);
-    const status = missingRequired.length > 0 ? source_default.red("\u2717 Critical Missing") : missingOptional.length > 0 ? source_default.yellow("\u26A0 Warning") : source_default.green("\u2713 OK");
-    console.log(`${source_default.bold(m.name.padEnd(12))} [${status}]`);
-    if (missingRequired.length > 0) {
-      console.log(source_default.red(`  Required missing: ${missingRequired.join(", ")}`));
-      totalMissing += missingRequired.length;
+  for (const service of report) {
+    const status = service.missingRequired.length > 0 ? source_default.red("\u2717 Critical Missing") : service.missingOptional.length > 0 ? source_default.yellow("\u26A0 Warning") : source_default.green("\u2713 OK");
+    console.log(`${source_default.bold(service.name.padEnd(12))} [${status}]`);
+    if (service.missingRequired.length > 0) {
+      console.log(source_default.red(`  Required missing: ${service.missingRequired.join(", ")}`));
     }
-    if (missingOptional.length > 0) {
-      console.log(source_default.gray(`  Optional missing: ${missingOptional.join(", ")}`));
+    if (service.missingOptional.length > 0) {
+      console.log(source_default.gray(`  Optional missing: ${service.missingOptional.join(", ")}`));
     }
-    if (missingRequired.length === 0 && missingOptional.length === 0) {
+    if (service.missingRequired.length === 0 && service.missingOptional.length === 0) {
       console.log(source_default.gray("  All variables set."));
     }
     console.log();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/microservices",
-  "version": "0.0.21",
+  "version": "0.0.22",
   "description": "21 production-grade microservice building blocks for AI-native SaaS — auth, billing, LLM gateway, agent registry, RAG, guardrails, tracing, and more. Each with PostgreSQL, HTTP API, MCP server, and CLI.",
   "type": "module",
   "bin": {