@hasna/microservices 0.0.20 → 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;
@@ -2383,6 +2384,8 @@ var {
 
 // src/lib/installer.ts
 import { execFileSync, execSync } from "child_process";
+import { accessSync, constants } from "fs";
+import { join } from "path";
 
 // src/lib/registry.ts
 var MICROSERVICES = [
@@ -2808,23 +2811,41 @@ function searchMicroservices(query) {
 }
 
 // src/lib/installer.ts
-function microserviceExists(name) {
+function getBunGlobalBinDir(env2 = process.env) {
+  const bunInstall = env2.BUN_INSTALL?.trim();
+  if (bunInstall) {
+    return join(bunInstall, "bin");
+  }
+  const home = env2.HOME?.trim();
+  if (!home) {
+    throw new Error("Unable to determine Bun global bin path: HOME is not set.");
+  }
+  return join(home, ".bun", "bin");
+}
+function resolveMicroserviceBinary(name) {
   const meta = getMicroservice(name);
   if (!meta)
-    return false;
-  try {
-    execSync(`which ${meta.binary}`, { stdio: "ignore" });
-    return true;
-  } catch {
-    return false;
+    return null;
+  const binDir = getBunGlobalBinDir();
+  const accessMode = process.platform === "win32" ? constants.F_OK : constants.X_OK;
+  const candidates = process.platform === "win32" ? [join(binDir, `${meta.binary}.cmd`), join(binDir, `${meta.binary}.exe`)] : [join(binDir, meta.binary)];
+  for (const candidate of candidates) {
+    try {
+      accessSync(candidate, accessMode);
+      return candidate;
+    } catch {}
   }
+  return null;
+}
+function microserviceExists(name) {
+  return resolveMicroserviceBinary(name) !== null;
 }
 function getMicroserviceVersion(name) {
-  const meta = getMicroservice(name);
-  if (!meta)
+  const binaryPath = resolveMicroserviceBinary(name);
+  if (!binaryPath)
     return null;
   try {
-    const out = execFileSync(meta.binary, ["--version"], {
+    const out = execFileSync(binaryPath, ["--version"], {
       encoding: "utf8"
     }).trim();
     return out || null;
@@ -2882,13 +2903,13 @@ function getMicroserviceStatus(name) {
 
 // src/lib/package-info.ts
 import { existsSync, readFileSync } from "fs";
-import { dirname, join, resolve } from "path";
+import { dirname, join as join2, resolve } from "path";
 import { fileURLToPath } from "url";
 var DEFAULT_VERSION = "0.0.1";
 function findNearestPackageJson(startDir) {
   let dir = resolve(startDir);
   while (true) {
-    const candidate = join(dir, "package.json");
+    const candidate = join2(dir, "package.json");
     if (existsSync(candidate)) {
       return candidate;
     }
@@ -2928,12 +2949,21 @@ async function runMicroserviceCommand(name, args, timeout = 30000) {
     return {
       success: false,
       stdout: "",
-      stderr: `microservice-${name} is not installed. Run: bun install -g ${meta.package}`,
+      stderr: `${meta.binary} is not installed. Run: bun install -g ${meta.package}`,
+      exitCode: 1
+    };
+  }
+  const binaryPath = resolveMicroserviceBinary(name);
+  if (!binaryPath) {
+    return {
+      success: false,
+      stdout: "",
+      stderr: `Could not resolve global binary for ${meta.binary}.`,
       exitCode: 1
     };
   }
   return new Promise((resolve2) => {
-    execFile(meta.binary, args, { timeout, maxBuffer: 10 * 1024 * 1024 }, (error, stdout, stderr) => {
+    execFile(binaryPath, args, { timeout, maxBuffer: 10 * 1024 * 1024 }, (error, stdout, stderr) => {
       if (error && "killed" in error && error.killed) {
         resolve2({
           success: false,
@@ -2956,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) => {
@@ -2988,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(", ") ?? "";
@@ -3019,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;
@@ -3154,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)}`);
@@ -3175,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/bin/mcp.js

@@ -19476,6 +19476,8 @@ class StdioServerTransport {
 
 // src/lib/installer.ts
 import { execFileSync, execSync } from "child_process";
+import { accessSync, constants } from "fs";
+import { join } from "path";
 
 // src/lib/registry.ts
 var MICROSERVICES = [
@@ -19901,23 +19903,41 @@ function searchMicroservices(query) {
 }
 
 // src/lib/installer.ts
-function microserviceExists(name) {
+function getBunGlobalBinDir(env = process.env) {
+  const bunInstall = env.BUN_INSTALL?.trim();
+  if (bunInstall) {
+    return join(bunInstall, "bin");
+  }
+  const home = env.HOME?.trim();
+  if (!home) {
+    throw new Error("Unable to determine Bun global bin path: HOME is not set.");
+  }
+  return join(home, ".bun", "bin");
+}
+function resolveMicroserviceBinary(name) {
   const meta = getMicroservice(name);
   if (!meta)
-    return false;
-  try {
-    execSync(`which ${meta.binary}`, { stdio: "ignore" });
-    return true;
-  } catch {
-    return false;
+    return null;
+  const binDir = getBunGlobalBinDir();
+  const accessMode = process.platform === "win32" ? constants.F_OK : constants.X_OK;
+  const candidates = process.platform === "win32" ? [join(binDir, `${meta.binary}.cmd`), join(binDir, `${meta.binary}.exe`)] : [join(binDir, meta.binary)];
+  for (const candidate of candidates) {
+    try {
+      accessSync(candidate, accessMode);
+      return candidate;
+    } catch {}
   }
+  return null;
+}
+function microserviceExists(name) {
+  return resolveMicroserviceBinary(name) !== null;
 }
 function getMicroserviceVersion(name) {
-  const meta = getMicroservice(name);
-  if (!meta)
+  const binaryPath = resolveMicroserviceBinary(name);
+  if (!binaryPath)
     return null;
   try {
-    const out = execFileSync(meta.binary, ["--version"], {
+    const out = execFileSync(binaryPath, ["--version"], {
       encoding: "utf8"
     }).trim();
     return out || null;
@@ -19972,13 +19992,13 @@ function getMicroserviceStatus(name) {
 
 // src/lib/package-info.ts
 import { existsSync, readFileSync } from "fs";
-import { dirname, join, resolve } from "path";
+import { dirname, join as join2, resolve } from "path";
 import { fileURLToPath } from "url";
 var DEFAULT_VERSION = "0.0.1";
 function findNearestPackageJson(startDir) {
   let dir = resolve(startDir);
   while (true) {
-    const candidate = join(dir, "package.json");
+    const candidate = join2(dir, "package.json");
     if (existsSync(candidate)) {
       return candidate;
     }
@@ -20018,12 +20038,21 @@ async function runMicroserviceCommand(name, args, timeout = 30000) {
     return {
       success: false,
       stdout: "",
-      stderr: `microservice-${name} is not installed. Run: bun install -g ${meta.package}`,
+      stderr: `${meta.binary} is not installed. Run: bun install -g ${meta.package}`,
+      exitCode: 1
+    };
+  }
+  const binaryPath = resolveMicroserviceBinary(name);
+  if (!binaryPath) {
+    return {
+      success: false,
+      stdout: "",
+      stderr: `Could not resolve global binary for ${meta.binary}.`,
       exitCode: 1
     };
   }
   return new Promise((resolve2) => {
-    execFile(meta.binary, args, { timeout, maxBuffer: 10 * 1024 * 1024 }, (error2, stdout, stderr) => {
+    execFile(binaryPath, args, { timeout, maxBuffer: 10 * 1024 * 1024 }, (error2, stdout, stderr) => {
       if (error2 && "killed" in error2 && error2.killed) {
         resolve2({
           success: false,

package/dist/index.js

@@ -1,6 +1,8 @@
 // @bun
 // src/lib/installer.ts
 import { execFileSync, execSync } from "child_process";
+import { accessSync, constants } from "fs";
+import { join } from "path";
 
 // src/lib/registry.ts
 var CATEGORIES = [
@@ -440,23 +442,41 @@ function searchMicroservices(query) {
 }
 
 // src/lib/installer.ts
-function microserviceExists(name) {
+function getBunGlobalBinDir(env = process.env) {
+  const bunInstall = env.BUN_INSTALL?.trim();
+  if (bunInstall) {
+    return join(bunInstall, "bin");
+  }
+  const home = env.HOME?.trim();
+  if (!home) {
+    throw new Error("Unable to determine Bun global bin path: HOME is not set.");
+  }
+  return join(home, ".bun", "bin");
+}
+function resolveMicroserviceBinary(name) {
   const meta = getMicroservice(name);
   if (!meta)
-    return false;
-  try {
-    execSync(`which ${meta.binary}`, { stdio: "ignore" });
-    return true;
-  } catch {
-    return false;
+    return null;
+  const binDir = getBunGlobalBinDir();
+  const accessMode = process.platform === "win32" ? constants.F_OK : constants.X_OK;
+  const candidates = process.platform === "win32" ? [join(binDir, `${meta.binary}.cmd`), join(binDir, `${meta.binary}.exe`)] : [join(binDir, meta.binary)];
+  for (const candidate of candidates) {
+    try {
+      accessSync(candidate, accessMode);
+      return candidate;
+    } catch {}
   }
+  return null;
+}
+function microserviceExists(name) {
+  return resolveMicroserviceBinary(name) !== null;
 }
 function getMicroserviceVersion(name) {
-  const meta = getMicroservice(name);
-  if (!meta)
+  const binaryPath = resolveMicroserviceBinary(name);
+  if (!binaryPath)
     return null;
   try {
-    const out = execFileSync(meta.binary, ["--version"], {
+    const out = execFileSync(binaryPath, ["--version"], {
       encoding: "utf8"
     }).trim();
     return out || null;
@@ -530,12 +550,21 @@ async function runMicroserviceCommand(name, args, timeout = 30000) {
     return {
       success: false,
       stdout: "",
-      stderr: `microservice-${name} is not installed. Run: bun install -g ${meta.package}`,
+      stderr: `${meta.binary} is not installed. Run: bun install -g ${meta.package}`,
+      exitCode: 1
+    };
+  }
+  const binaryPath = resolveMicroserviceBinary(name);
+  if (!binaryPath) {
+    return {
+      success: false,
+      stdout: "",
+      stderr: `Could not resolve global binary for ${meta.binary}.`,
       exitCode: 1
     };
   }
   return new Promise((resolve) => {
-    execFile(meta.binary, args, { timeout, maxBuffer: 10 * 1024 * 1024 }, (error, stdout, stderr) => {
+    execFile(binaryPath, args, { timeout, maxBuffer: 10 * 1024 * 1024 }, (error, stdout, stderr) => {
       if (error && "killed" in error && error.killed) {
         resolve({
           success: false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/microservices",
-  "version": "0.0.20",
+  "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": {