@hasna/microservices 0.0.17 → 0.0.18

package/bin/index.js

@@ -2474,6 +2474,90 @@ var MICROSERVICES = [
     tags: ["jobs", "queues", "background", "cron", "scheduling", "workers", "retry"],
     requiredEnv: ["DATABASE_URL"],
     optionalEnv: ["JOBS_PORT", "JOBS_WORKER_CONCURRENCY"]
+  },
+  {
+    name: "llm",
+    displayName: "LLM",
+    description: "LLM gateway: multi-provider routing (OpenAI/Anthropic/Groq), per-workspace rate limiting, token cost tracking, response caching, and fallback chains.",
+    category: "AI",
+    package: "@hasna/microservice-llm",
+    binary: "microservice-llm",
+    schemaPrefix: "llm",
+    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"]
+  },
+  {
+    name: "memory",
+    displayName: "Memory",
+    description: "Persistent agent memory with pgvector semantic search, full-text fallback, importance scoring, collections, and per-user/workspace recall.",
+    category: "AI",
+    package: "@hasna/microservice-memory",
+    binary: "microservice-memory",
+    schemaPrefix: "memory",
+    tags: ["memory", "embeddings", "pgvector", "semantic-search", "rag", "ai-agents", "recall"],
+    requiredEnv: ["DATABASE_URL"],
+    optionalEnv: ["OPENAI_API_KEY", "MEMORY_PORT"]
+  },
+  {
+    name: "search",
+    displayName: "Search",
+    description: "Full-text + semantic/vector search (pgvector) across any data collection. Hybrid BM25+cosine scoring. Works without API keys (text-only mode).",
+    category: "AI",
+    package: "@hasna/microservice-search",
+    binary: "microservice-search",
+    schemaPrefix: "search",
+    tags: ["search", "full-text", "semantic", "vector", "pgvector", "hybrid", "rag"],
+    requiredEnv: ["DATABASE_URL"],
+    optionalEnv: ["OPENAI_API_KEY", "SEARCH_PORT"]
+  },
+  {
+    name: "usage",
+    displayName: "Usage",
+    description: "Usage metering for API calls, tokens, storage, or any custom metric. Quota enforcement, daily/monthly aggregates, overage detection.",
+    category: "Observability",
+    package: "@hasna/microservice-usage",
+    binary: "microservice-usage",
+    schemaPrefix: "usage",
+    tags: ["usage", "metering", "quotas", "billing", "limits", "analytics"],
+    requiredEnv: ["DATABASE_URL"],
+    optionalEnv: ["USAGE_PORT"]
+  },
+  {
+    name: "webhooks",
+    displayName: "Webhooks",
+    description: "Reliable outbound webhook delivery with HMAC signing, retries (exponential backoff), delivery logs, and endpoint health tracking.",
+    category: "Infrastructure",
+    package: "@hasna/microservice-webhooks",
+    binary: "microservice-webhooks",
+    schemaPrefix: "webhooks",
+    tags: ["webhooks", "outbound", "delivery", "retry", "signing", "integrations"],
+    requiredEnv: ["DATABASE_URL"],
+    optionalEnv: ["WEBHOOKS_PORT"]
+  },
+  {
+    name: "onboarding",
+    displayName: "Onboarding",
+    description: "User activation flows with checklist step tracking, required vs optional steps, completion percentage, and per-user/workspace progress.",
+    category: "Growth",
+    package: "@hasna/microservice-onboarding",
+    binary: "microservice-onboarding",
+    schemaPrefix: "onboarding",
+    tags: ["onboarding", "activation", "checklists", "flows", "user-journey"],
+    requiredEnv: ["DATABASE_URL"],
+    optionalEnv: ["ONBOARDING_PORT"]
+  },
+  {
+    name: "waitlist",
+    displayName: "Waitlist",
+    description: "Waitlist management with referral codes, priority scoring, batch invite logic, and per-campaign tracking. Standard for AI product launches.",
+    category: "Growth",
+    package: "@hasna/microservice-waitlist",
+    binary: "microservice-waitlist",
+    schemaPrefix: "waitlist",
+    tags: ["waitlist", "referral", "invites", "launch", "growth"],
+    requiredEnv: ["DATABASE_URL"],
+    optionalEnv: ["WAITLIST_PORT"]
   }
 ];
 function getMicroservice(name) {

package/bin/mcp.js

@@ -19570,6 +19570,90 @@ var MICROSERVICES = [
     tags: ["jobs", "queues", "background", "cron", "scheduling", "workers", "retry"],
     requiredEnv: ["DATABASE_URL"],
     optionalEnv: ["JOBS_PORT", "JOBS_WORKER_CONCURRENCY"]
+  },
+  {
+    name: "llm",
+    displayName: "LLM",
+    description: "LLM gateway: multi-provider routing (OpenAI/Anthropic/Groq), per-workspace rate limiting, token cost tracking, response caching, and fallback chains.",
+    category: "AI",
+    package: "@hasna/microservice-llm",
+    binary: "microservice-llm",
+    schemaPrefix: "llm",
+    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"]
+  },
+  {
+    name: "memory",
+    displayName: "Memory",
+    description: "Persistent agent memory with pgvector semantic search, full-text fallback, importance scoring, collections, and per-user/workspace recall.",
+    category: "AI",
+    package: "@hasna/microservice-memory",
+    binary: "microservice-memory",
+    schemaPrefix: "memory",
+    tags: ["memory", "embeddings", "pgvector", "semantic-search", "rag", "ai-agents", "recall"],
+    requiredEnv: ["DATABASE_URL"],
+    optionalEnv: ["OPENAI_API_KEY", "MEMORY_PORT"]
+  },
+  {
+    name: "search",
+    displayName: "Search",
+    description: "Full-text + semantic/vector search (pgvector) across any data collection. Hybrid BM25+cosine scoring. Works without API keys (text-only mode).",
+    category: "AI",
+    package: "@hasna/microservice-search",
+    binary: "microservice-search",
+    schemaPrefix: "search",
+    tags: ["search", "full-text", "semantic", "vector", "pgvector", "hybrid", "rag"],
+    requiredEnv: ["DATABASE_URL"],
+    optionalEnv: ["OPENAI_API_KEY", "SEARCH_PORT"]
+  },
+  {
+    name: "usage",
+    displayName: "Usage",
+    description: "Usage metering for API calls, tokens, storage, or any custom metric. Quota enforcement, daily/monthly aggregates, overage detection.",
+    category: "Observability",
+    package: "@hasna/microservice-usage",
+    binary: "microservice-usage",
+    schemaPrefix: "usage",
+    tags: ["usage", "metering", "quotas", "billing", "limits", "analytics"],
+    requiredEnv: ["DATABASE_URL"],
+    optionalEnv: ["USAGE_PORT"]
+  },
+  {
+    name: "webhooks",
+    displayName: "Webhooks",
+    description: "Reliable outbound webhook delivery with HMAC signing, retries (exponential backoff), delivery logs, and endpoint health tracking.",
+    category: "Infrastructure",
+    package: "@hasna/microservice-webhooks",
+    binary: "microservice-webhooks",
+    schemaPrefix: "webhooks",
+    tags: ["webhooks", "outbound", "delivery", "retry", "signing", "integrations"],
+    requiredEnv: ["DATABASE_URL"],
+    optionalEnv: ["WEBHOOKS_PORT"]
+  },
+  {
+    name: "onboarding",
+    displayName: "Onboarding",
+    description: "User activation flows with checklist step tracking, required vs optional steps, completion percentage, and per-user/workspace progress.",
+    category: "Growth",
+    package: "@hasna/microservice-onboarding",
+    binary: "microservice-onboarding",
+    schemaPrefix: "onboarding",
+    tags: ["onboarding", "activation", "checklists", "flows", "user-journey"],
+    requiredEnv: ["DATABASE_URL"],
+    optionalEnv: ["ONBOARDING_PORT"]
+  },
+  {
+    name: "waitlist",
+    displayName: "Waitlist",
+    description: "Waitlist management with referral codes, priority scoring, batch invite logic, and per-campaign tracking. Standard for AI product launches.",
+    category: "Growth",
+    package: "@hasna/microservice-waitlist",
+    binary: "microservice-waitlist",
+    schemaPrefix: "waitlist",
+    tags: ["waitlist", "referral", "invites", "launch", "growth"],
+    requiredEnv: ["DATABASE_URL"],
+    optionalEnv: ["WAITLIST_PORT"]
   }
 ];
 function getMicroservice(name) {

package/dist/index.js

@@ -8,7 +8,8 @@ var CATEGORIES = [
   "Storage",
   "Observability",
   "Growth",
-  "Infrastructure"
+  "Infrastructure",
+  "AI"
 ];
 var MICROSERVICES = [
   {
@@ -106,6 +107,90 @@ var MICROSERVICES = [
     tags: ["jobs", "queues", "background", "cron", "scheduling", "workers", "retry"],
     requiredEnv: ["DATABASE_URL"],
     optionalEnv: ["JOBS_PORT", "JOBS_WORKER_CONCURRENCY"]
+  },
+  {
+    name: "llm",
+    displayName: "LLM",
+    description: "LLM gateway: multi-provider routing (OpenAI/Anthropic/Groq), per-workspace rate limiting, token cost tracking, response caching, and fallback chains.",
+    category: "AI",
+    package: "@hasna/microservice-llm",
+    binary: "microservice-llm",
+    schemaPrefix: "llm",
+    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"]
+  },
+  {
+    name: "memory",
+    displayName: "Memory",
+    description: "Persistent agent memory with pgvector semantic search, full-text fallback, importance scoring, collections, and per-user/workspace recall.",
+    category: "AI",
+    package: "@hasna/microservice-memory",
+    binary: "microservice-memory",
+    schemaPrefix: "memory",
+    tags: ["memory", "embeddings", "pgvector", "semantic-search", "rag", "ai-agents", "recall"],
+    requiredEnv: ["DATABASE_URL"],
+    optionalEnv: ["OPENAI_API_KEY", "MEMORY_PORT"]
+  },
+  {
+    name: "search",
+    displayName: "Search",
+    description: "Full-text + semantic/vector search (pgvector) across any data collection. Hybrid BM25+cosine scoring. Works without API keys (text-only mode).",
+    category: "AI",
+    package: "@hasna/microservice-search",
+    binary: "microservice-search",
+    schemaPrefix: "search",
+    tags: ["search", "full-text", "semantic", "vector", "pgvector", "hybrid", "rag"],
+    requiredEnv: ["DATABASE_URL"],
+    optionalEnv: ["OPENAI_API_KEY", "SEARCH_PORT"]
+  },
+  {
+    name: "usage",
+    displayName: "Usage",
+    description: "Usage metering for API calls, tokens, storage, or any custom metric. Quota enforcement, daily/monthly aggregates, overage detection.",
+    category: "Observability",
+    package: "@hasna/microservice-usage",
+    binary: "microservice-usage",
+    schemaPrefix: "usage",
+    tags: ["usage", "metering", "quotas", "billing", "limits", "analytics"],
+    requiredEnv: ["DATABASE_URL"],
+    optionalEnv: ["USAGE_PORT"]
+  },
+  {
+    name: "webhooks",
+    displayName: "Webhooks",
+    description: "Reliable outbound webhook delivery with HMAC signing, retries (exponential backoff), delivery logs, and endpoint health tracking.",
+    category: "Infrastructure",
+    package: "@hasna/microservice-webhooks",
+    binary: "microservice-webhooks",
+    schemaPrefix: "webhooks",
+    tags: ["webhooks", "outbound", "delivery", "retry", "signing", "integrations"],
+    requiredEnv: ["DATABASE_URL"],
+    optionalEnv: ["WEBHOOKS_PORT"]
+  },
+  {
+    name: "onboarding",
+    displayName: "Onboarding",
+    description: "User activation flows with checklist step tracking, required vs optional steps, completion percentage, and per-user/workspace progress.",
+    category: "Growth",
+    package: "@hasna/microservice-onboarding",
+    binary: "microservice-onboarding",
+    schemaPrefix: "onboarding",
+    tags: ["onboarding", "activation", "checklists", "flows", "user-journey"],
+    requiredEnv: ["DATABASE_URL"],
+    optionalEnv: ["ONBOARDING_PORT"]
+  },
+  {
+    name: "waitlist",
+    displayName: "Waitlist",
+    description: "Waitlist management with referral codes, priority scoring, batch invite logic, and per-campaign tracking. Standard for AI product launches.",
+    category: "Growth",
+    package: "@hasna/microservice-waitlist",
+    binary: "microservice-waitlist",
+    schemaPrefix: "waitlist",
+    tags: ["waitlist", "referral", "invites", "launch", "growth"],
+    requiredEnv: ["DATABASE_URL"],
+    optionalEnv: ["WAITLIST_PORT"]
   }
 ];
 function getMicroservice(name) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@hasna/microservices",
-  "version": "0.0.17",
-  "description": "Production-grade microservice building blocks for SaaS apps — auth, teams, billing, notify, files, audit, flags, jobs. Each with PostgreSQL, HTTP API, MCP server, and CLI.",
+  "version": "0.0.18",
+  "description": "Production-grade microservice building blocks for SaaS apps — 15 services covering identity, billing, AI, storage, search, and more. Each with PostgreSQL, HTTP API, MCP server, and CLI.",
   "type": "module",
   "bin": {
     "microservices": "./bin/index.js",
@@ -32,16 +32,19 @@
   "keywords": [
     "microservices",
     "saas",
+    "ai-agents",
     "auth",
     "billing",
     "stripe",
     "postgresql",
+    "pgvector",
+    "llm-gateway",
     "feature-flags",
     "background-jobs",
+    "vector-search",
     "mcp",
     "model-context-protocol",
     "ai",
-    "agent",
     "cli"
   ],
   "author": "Hasna",
@@ -64,7 +67,14 @@
     "@hasna/microservice-files": "^0.0.1",
     "@hasna/microservice-audit": "^0.0.1",
     "@hasna/microservice-flags": "^0.0.1",
-    "@hasna/microservice-jobs": "^0.0.1"
+    "@hasna/microservice-jobs": "^0.0.1",
+    "@hasna/microservice-llm": "^0.0.1",
+    "@hasna/microservice-memory": "^0.0.1",
+    "@hasna/microservice-search": "^0.0.1",
+    "@hasna/microservice-usage": "^0.0.1",
+    "@hasna/microservice-webhooks": "^0.0.1",
+    "@hasna/microservice-onboarding": "^0.0.1",
+    "@hasna/microservice-waitlist": "^0.0.1"
   },
   "engines": {
     "bun": ">=1.0.0"