@hasna/microservices 0.0.19 → 0.0.21

package/dist/index.js

@@ -1,4 +1,9 @@
 // @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 = [
   "Identity",
@@ -20,9 +25,24 @@ var MICROSERVICES = [
     package: "@hasna/microservice-auth",
     binary: "microservice-auth",
     schemaPrefix: "auth",
-    tags: ["auth", "users", "sessions", "jwt", "oauth", "2fa", "api-keys", "magic-links"],
+    tags: [
+      "auth",
+      "users",
+      "sessions",
+      "jwt",
+      "oauth",
+      "2fa",
+      "api-keys",
+      "magic-links"
+    ],
     requiredEnv: ["DATABASE_URL", "JWT_SECRET"],
-    optionalEnv: ["GITHUB_CLIENT_ID", "GITHUB_CLIENT_SECRET", "GOOGLE_CLIENT_ID", "GOOGLE_CLIENT_SECRET", "AUTH_PORT"]
+    optionalEnv: [
+      "GITHUB_CLIENT_ID",
+      "GITHUB_CLIENT_SECRET",
+      "GOOGLE_CLIENT_ID",
+      "GOOGLE_CLIENT_SECRET",
+      "AUTH_PORT"
+    ]
   },
   {
     name: "teams",
@@ -32,7 +52,14 @@ var MICROSERVICES = [
     package: "@hasna/microservice-teams",
     binary: "microservice-teams",
     schemaPrefix: "teams",
-    tags: ["teams", "workspaces", "rbac", "invites", "permissions", "multi-tenancy"],
+    tags: [
+      "teams",
+      "workspaces",
+      "rbac",
+      "invites",
+      "permissions",
+      "multi-tenancy"
+    ],
     requiredEnv: ["DATABASE_URL"],
     optionalEnv: ["TEAMS_PORT"]
   },
@@ -44,7 +71,15 @@ var MICROSERVICES = [
     package: "@hasna/microservice-billing",
     binary: "microservice-billing",
     schemaPrefix: "billing",
-    tags: ["billing", "stripe", "subscriptions", "plans", "invoices", "usage", "webhooks"],
+    tags: [
+      "billing",
+      "stripe",
+      "subscriptions",
+      "plans",
+      "invoices",
+      "usage",
+      "webhooks"
+    ],
     requiredEnv: ["DATABASE_URL", "STRIPE_SECRET_KEY", "STRIPE_WEBHOOK_SECRET"],
     optionalEnv: ["BILLING_PORT"]
   },
@@ -56,9 +91,26 @@ var MICROSERVICES = [
     package: "@hasna/microservice-notify",
     binary: "microservice-notify",
     schemaPrefix: "notify",
-    tags: ["notifications", "email", "sms", "in-app", "webhooks", "templates", "sse"],
+    tags: [
+      "notifications",
+      "email",
+      "sms",
+      "in-app",
+      "webhooks",
+      "templates",
+      "sse"
+    ],
     requiredEnv: ["DATABASE_URL"],
-    optionalEnv: ["RESEND_API_KEY", "SMTP_HOST", "SMTP_PORT", "SMTP_USER", "SMTP_PASS", "TWILIO_ACCOUNT_SID", "TWILIO_AUTH_TOKEN", "NOTIFY_PORT"]
+    optionalEnv: [
+      "RESEND_API_KEY",
+      "SMTP_HOST",
+      "SMTP_PORT",
+      "SMTP_USER",
+      "SMTP_PASS",
+      "TWILIO_ACCOUNT_SID",
+      "TWILIO_AUTH_TOKEN",
+      "NOTIFY_PORT"
+    ]
   },
   {
     name: "files",
@@ -68,9 +120,24 @@ var MICROSERVICES = [
     package: "@hasna/microservice-files",
     binary: "microservice-files",
     schemaPrefix: "files",
-    tags: ["files", "uploads", "s3", "storage", "images", "presigned-urls", "cdn"],
+    tags: [
+      "files",
+      "uploads",
+      "s3",
+      "storage",
+      "images",
+      "presigned-urls",
+      "cdn"
+    ],
     requiredEnv: ["DATABASE_URL"],
-    optionalEnv: ["S3_BUCKET", "S3_REGION", "AWS_ACCESS_KEY_ID", "AWS_SECRET_ACCESS_KEY", "FILES_STORAGE", "FILES_PORT"]
+    optionalEnv: [
+      "S3_BUCKET",
+      "S3_REGION",
+      "AWS_ACCESS_KEY_ID",
+      "AWS_SECRET_ACCESS_KEY",
+      "FILES_STORAGE",
+      "FILES_PORT"
+    ]
   },
   {
     name: "audit",
@@ -92,7 +159,13 @@ var MICROSERVICES = [
     package: "@hasna/microservice-flags",
     binary: "microservice-flags",
     schemaPrefix: "flags",
-    tags: ["feature-flags", "experiments", "rollouts", "ab-testing", "targeting"],
+    tags: [
+      "feature-flags",
+      "experiments",
+      "rollouts",
+      "ab-testing",
+      "targeting"
+    ],
     requiredEnv: ["DATABASE_URL"],
     optionalEnv: ["FLAGS_PORT"]
   },
@@ -104,7 +177,15 @@ var MICROSERVICES = [
     package: "@hasna/microservice-jobs",
     binary: "microservice-jobs",
     schemaPrefix: "jobs",
-    tags: ["jobs", "queues", "background", "cron", "scheduling", "workers", "retry"],
+    tags: [
+      "jobs",
+      "queues",
+      "background",
+      "cron",
+      "scheduling",
+      "workers",
+      "retry"
+    ],
     requiredEnv: ["DATABASE_URL"],
     optionalEnv: ["JOBS_PORT", "JOBS_WORKER_CONCURRENCY"]
   },
@@ -116,9 +197,23 @@ var MICROSERVICES = [
     package: "@hasna/microservice-llm",
     binary: "microservice-llm",
     schemaPrefix: "llm",
-    tags: ["llm", "openai", "anthropic", "groq", "ai", "gateway", "cost-tracking", "rate-limiting"],
+    tags: [
+      "llm",
+      "openai",
+      "anthropic",
+      "groq",
+      "ai",
+      "gateway",
+      "cost-tracking",
+      "rate-limiting"
+    ],
     requiredEnv: ["DATABASE_URL"],
-    optionalEnv: ["OPENAI_API_KEY", "ANTHROPIC_API_KEY", "GROQ_API_KEY", "LLM_PORT"]
+    optionalEnv: [
+      "OPENAI_API_KEY",
+      "ANTHROPIC_API_KEY",
+      "GROQ_API_KEY",
+      "LLM_PORT"
+    ]
   },
   {
     name: "memory",
@@ -128,7 +223,15 @@ var MICROSERVICES = [
     package: "@hasna/microservice-memory",
     binary: "microservice-memory",
     schemaPrefix: "memory",
-    tags: ["memory", "embeddings", "pgvector", "semantic-search", "rag", "ai-agents", "recall"],
+    tags: [
+      "memory",
+      "embeddings",
+      "pgvector",
+      "semantic-search",
+      "rag",
+      "ai-agents",
+      "recall"
+    ],
     requiredEnv: ["DATABASE_URL"],
     optionalEnv: ["OPENAI_API_KEY", "MEMORY_PORT"]
   },
@@ -140,7 +243,15 @@ var MICROSERVICES = [
     package: "@hasna/microservice-search",
     binary: "microservice-search",
     schemaPrefix: "search",
-    tags: ["search", "full-text", "semantic", "vector", "pgvector", "hybrid", "rag"],
+    tags: [
+      "search",
+      "full-text",
+      "semantic",
+      "vector",
+      "pgvector",
+      "hybrid",
+      "rag"
+    ],
     requiredEnv: ["DATABASE_URL"],
     optionalEnv: ["OPENAI_API_KEY", "SEARCH_PORT"]
   },
@@ -152,7 +263,15 @@ var MICROSERVICES = [
     package: "@hasna/microservice-knowledge",
     binary: "microservice-knowledge",
     schemaPrefix: "knowledge",
-    tags: ["knowledge", "rag", "chunking", "embeddings", "retrieval", "pgvector", "documents"],
+    tags: [
+      "knowledge",
+      "rag",
+      "chunking",
+      "embeddings",
+      "retrieval",
+      "pgvector",
+      "documents"
+    ],
     requiredEnv: ["DATABASE_URL"],
     optionalEnv: ["OPENAI_API_KEY", "KNOWLEDGE_PORT"]
   },
@@ -176,7 +295,14 @@ var MICROSERVICES = [
     package: "@hasna/microservice-webhooks",
     binary: "microservice-webhooks",
     schemaPrefix: "webhooks",
-    tags: ["webhooks", "outbound", "delivery", "retry", "signing", "integrations"],
+    tags: [
+      "webhooks",
+      "outbound",
+      "delivery",
+      "retry",
+      "signing",
+      "integrations"
+    ],
     requiredEnv: ["DATABASE_URL"],
     optionalEnv: ["WEBHOOKS_PORT"]
   },
@@ -212,7 +338,14 @@ var MICROSERVICES = [
     package: "@hasna/microservice-sessions",
     binary: "microservice-sessions",
     schemaPrefix: "sessions",
-    tags: ["sessions", "conversations", "chat", "messages", "context-window", "history"],
+    tags: [
+      "sessions",
+      "conversations",
+      "chat",
+      "messages",
+      "context-window",
+      "history"
+    ],
     requiredEnv: ["DATABASE_URL"],
     optionalEnv: ["SESSIONS_PORT"]
   },
@@ -224,22 +357,18 @@ var MICROSERVICES = [
     package: "@hasna/microservice-guardrails",
     binary: "microservice-guardrails",
     schemaPrefix: "guardrails",
-    tags: ["guardrails", "safety", "pii", "injection", "toxicity", "moderation", "policy"],
+    tags: [
+      "guardrails",
+      "safety",
+      "pii",
+      "injection",
+      "toxicity",
+      "moderation",
+      "policy"
+    ],
     requiredEnv: ["DATABASE_URL"],
     optionalEnv: ["GUARDRAILS_PORT"]
   },
-  {
-    name: "knowledge",
-    displayName: "Knowledge",
-    description: "RAG pipeline: document ingestion, chunking (fixed/paragraph/sentence/recursive), embedding via pgvector, retrieval with source attribution and scoring.",
-    category: "AI",
-    package: "@hasna/microservice-knowledge",
-    binary: "microservice-knowledge",
-    schemaPrefix: "knowledge",
-    tags: ["knowledge", "rag", "chunking", "ingestion", "retrieval", "documents", "pgvector"],
-    requiredEnv: ["DATABASE_URL"],
-    optionalEnv: ["OPENAI_API_KEY", "KNOWLEDGE_PORT"]
-  },
   {
     name: "traces",
     displayName: "Traces",
@@ -248,7 +377,15 @@ var MICROSERVICES = [
     package: "@hasna/microservice-traces",
     binary: "microservice-traces",
     schemaPrefix: "traces",
-    tags: ["traces", "tracing", "spans", "observability", "latency", "debugging", "agent-ops"],
+    tags: [
+      "traces",
+      "tracing",
+      "spans",
+      "observability",
+      "latency",
+      "debugging",
+      "agent-ops"
+    ],
     requiredEnv: ["DATABASE_URL"],
     optionalEnv: ["TRACES_PORT"]
   },
@@ -260,7 +397,15 @@ var MICROSERVICES = [
     package: "@hasna/microservice-agents",
     binary: "microservice-agents",
     schemaPrefix: "agents",
-    tags: ["agents", "registry", "orchestration", "routing", "multi-agent", "capabilities", "heartbeat"],
+    tags: [
+      "agents",
+      "registry",
+      "orchestration",
+      "routing",
+      "multi-agent",
+      "capabilities",
+      "heartbeat"
+    ],
     requiredEnv: ["DATABASE_URL"],
     optionalEnv: ["AGENTS_PORT"]
   },
@@ -272,7 +417,14 @@ var MICROSERVICES = [
     package: "@hasna/microservice-prompts",
     binary: "microservice-prompts",
     schemaPrefix: "prompts",
-    tags: ["prompts", "templates", "versioning", "ab-testing", "overrides", "rollback"],
+    tags: [
+      "prompts",
+      "templates",
+      "versioning",
+      "ab-testing",
+      "overrides",
+      "rollback"
+    ],
     requiredEnv: ["DATABASE_URL"],
     optionalEnv: ["PROMPTS_PORT"]
   }
@@ -288,25 +440,45 @@ function searchMicroservices(query) {
   const q = query.toLowerCase();
   return MICROSERVICES.filter((m) => m.name.includes(q) || m.displayName.toLowerCase().includes(q) || m.description.toLowerCase().includes(q) || m.category.toLowerCase().includes(q) || m.tags.some((t) => t.includes(q)));
 }
+
 // src/lib/installer.ts
-import { execSync, execFileSync } from "child_process";
-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"], { encoding: "utf8" }).trim();
+    const out = execFileSync(binaryPath, ["--version"], {
+      encoding: "utf8"
+    }).trim();
     return out || null;
   } catch {
     return null;
@@ -315,7 +487,11 @@ function getMicroserviceVersion(name) {
 function installMicroservice(name, options = {}) {
   const meta = getMicroservice(name);
   if (!meta) {
-    return { microservice: name, success: false, error: `Unknown microservice '${name}'` };
+    return {
+      microservice: name,
+      success: false,
+      error: `Unknown microservice '${name}'`
+    };
   }
   if (microserviceExists(name) && !options.force) {
     const version = getMicroserviceVersion(name);
@@ -363,20 +539,39 @@ import { execFile } from "child_process";
 async function runMicroserviceCommand(name, args, timeout = 30000) {
   const meta = getMicroservice(name);
   if (!meta) {
-    return { success: false, stdout: "", stderr: `Unknown microservice '${name}'`, exitCode: 1 };
+    return {
+      success: false,
+      stdout: "",
+      stderr: `Unknown microservice '${name}'`,
+      exitCode: 1
+    };
   }
   if (!microserviceExists(name)) {
     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, stdout: "", stderr: "Command timed out", exitCode: 1 });
+        resolve({
+          success: false,
+          stdout: "",
+          stderr: "Command timed out",
+          exitCode: 1
+        });
         return;
       }
       const exitCode = error?.code ? typeof error.code === "number" ? error.code : 1 : 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/microservices",
-  "version": "0.0.19",
+  "version": "0.0.21",
   "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": {
@@ -23,10 +23,18 @@
   "types": "./dist/index.d.ts",
   "scripts": {
     "build": "bun build ./src/cli/index.tsx --outfile ./bin/index.js --target bun && bun build ./src/mcp/index.ts --outfile ./bin/mcp.js --target bun && bun build ./src/index.ts --outdir ./dist --target bun",
+    "build:all": "bun run build && bun run --filter '*' build",
     "dev": "bun run ./src/cli/index.tsx",
+    "gateway": "bun run gateway.ts",
     "typecheck": "tsc --noEmit",
+    "typecheck:all": "bun run typecheck && bun run --filter '*' typecheck",
     "test": "bun test",
-    "prepublishOnly": "bun run build",
+    "test:all": "bun test && bun run --filter '*' test",
+    "lint": "bunx biome check .",
+    "format": "bunx biome format --write .",
+    "clean": "rm -rf dist bin microservices/*/dist microservices/*/bin node_modules microservices/*/node_modules",
+    "pre-commit": "bun run lint && bun run format",
+    "prepublishOnly": "bun run build:all",
     "postinstall": "true"
   },
   "keywords": [
@@ -50,6 +58,7 @@
   "author": "Hasna",
   "license": "Apache-2.0",
   "devDependencies": {
+    "@biomejs/biome": "^2.4.10",
     "@types/bun": "latest",
     "typescript": "^5"
   },
@@ -85,6 +94,9 @@
   "engines": {
     "bun": ">=1.0.0"
   },
+  "workspaces": [
+    "microservices/*"
+  ],
   "publishConfig": {
     "registry": "https://registry.npmjs.org",
     "access": "public"