@getvision/server 0.4.3-d4c761e-develop → 0.4.4-44d79d9-develop

package/{src/index.ts → dist/index.d.ts}

@@ -1,6 +1,6 @@
 /**
  * @getvision/server - Meta-framework with built-in observability
- * 
+ *
  * Features:
  * - Built on Hono (ultra-fast, edge-ready)
  * - Built-in Vision Dashboard (tracing, logging)
@@ -8,12 +8,12 @@
  * - Pub/Sub & Cron via BullMQ (automatic)
  * - Service builder pattern
  * - c.span() for custom tracing
- * 
+ *
  * @example
  * ```ts
  * import { Vision } from '@getvision/server'
  * import { z } from 'zod'
- * 
+ *
  * const app = new Vision({
  *   service: {
  *     name: 'My API',
@@ -27,7 +27,7 @@
  *     }
  *   }
  * })
- * 
+ *
  * const userService = app.service('users')
  *   .endpoint('GET', '/users/:id', schema, async (data, c) => {
  *     // c.span() is built-in!
@@ -39,30 +39,16 @@
  *   .on('user/created', async (event) => {
  *     console.log('User created:', event.data)
  *   })
- * 
+ *
  * app.start(3000)
  * ```
  */
-
-// Main Vision class
-export { Vision, getVisionContext } from './vision-app'
-export type { VisionConfig } from './vision-app'
-
-// Service builder (usually accessed via app.service())
-export { ServiceBuilder } from './service'
-
-// Event bus
-export { EventBus } from './event-bus'
-export type { EventBusConfig } from './event-bus'
-
-// Types
-export type { 
-  EndpointConfig, 
-  Handler, 
-  VisionContext,
-  ExtendedContext
-} from './types'
-
-// Re-export from core for convenience
-export { VisionCore } from '@getvision/core'
-export type * from '@getvision/core'
+export { Vision, getVisionContext } from './vision-app';
+export type { VisionConfig } from './vision-app';
+export { ServiceBuilder } from './service';
+export { EventBus } from './event-bus';
+export type { EventBusConfig } from './event-bus';
+export type { EndpointConfig, Handler, VisionContext, ExtendedContext } from './types';
+export { VisionCore } from '@getvision/core';
+export type * from '@getvision/core';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AAGH,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AACvD,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAGhD,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAG1C,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACtC,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAGjD,YAAY,EACV,cAAc,EACd,OAAO,EACP,aAAa,EACb,eAAe,EAChB,MAAM,SAAS,CAAA;AAGhB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,mBAAmB,iBAAiB,CAAA"}

package/dist/index.js

@@ -0,0 +1,33 @@
+import { createRequire } from "node:module";
+var __create = Object.create;
+var __getProtoOf = Object.getPrototypeOf;
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __toESM = (mod, isNodeMode, target) => {
+  target = mod != null ? __create(__getProtoOf(mod)) : {};
+  const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
+  for (let key of __getOwnPropNames(mod))
+    if (!__hasOwnProp.call(to, key))
+      __defProp(to, key, {
+        get: () => mod[key],
+        enumerable: true
+      });
+  return to;
+};
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+
+// src/index.ts
+import { Vision, getVisionContext } from "./vision-app";
+import { ServiceBuilder } from "./service";
+import { EventBus } from "./event-bus";
+import { VisionCore } from "@getvision/core";
+export {
+  getVisionContext,
+  VisionCore,
+  Vision,
+  ServiceBuilder,
+  EventBus
+};
+
+//# debugId=141F5DC62996839464756E2164756E21

package/dist/index.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/index.ts"],
+  "sourcesContent": [
+    "/**\n * @getvision/server - Meta-framework with built-in observability\n * \n * Features:\n * - Built on Hono (ultra-fast, edge-ready)\n * - Built-in Vision Dashboard (tracing, logging)\n * - Type-safe Zod validation\n * - Pub/Sub & Cron via BullMQ (automatic)\n * - Service builder pattern\n * - c.span() for custom tracing\n * \n * @example\n * ```ts\n * import { Vision } from '@getvision/server'\n * import { z } from 'zod'\n * \n * const app = new Vision({\n *   service: {\n *     name: 'My API',\n *     version: '1.0.0'\n *   },\n *   pubsub: {\n *     schemas: {\n *       'user/created': {\n *         data: z.object({ userId: z.string() })\n *       }\n *     }\n *   }\n * })\n * \n * const userService = app.service('users')\n *   .endpoint('GET', '/users/:id', schema, async (data, c) => {\n *     // c.span() is built-in!\n *     const user = c.span('db.select', { 'db.table': 'users' }, () => {\n *       return db.users.findOne(data.id)\n *     })\n *     return user\n *   })\n *   .on('user/created', async (event) => {\n *     console.log('User created:', event.data)\n *   })\n * \n * app.start(3000)\n * ```\n */\n\n// Main Vision class\nexport { Vision, getVisionContext } from './vision-app'\nexport type { VisionConfig } from './vision-app'\n\n// Service builder (usually accessed via app.service())\nexport { ServiceBuilder } from './service'\n\n// Event bus\nexport { EventBus } from './event-bus'\nexport type { EventBusConfig } from './event-bus'\n\n// Types\nexport type { \n  EndpointConfig, \n  Handler, \n  VisionContext,\n  ExtendedContext\n} from './types'\n\n// Re-export from core for convenience\nexport { VisionCore } from '@getvision/core'\nexport type * from '@getvision/core'\n"
+  ],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AA+CA;AAIA;AAGA;AAYA;",
+  "debugId": "141F5DC62996839464756E2164756E21",
+  "names": []
+}

package/dist/router.d.ts

@@ -0,0 +1,16 @@
+import type { Hono } from 'hono';
+import type { EventBus } from './event-bus';
+/**
+ * Autoload Vision/Hono sub-apps from a directory structure like app/routes/.../index.ts
+ * Each folder becomes a base path. Dynamic segments [id] are converted to :id.
+ *
+ * Examples:
+ * - app/routes/users/index.ts        -> /users
+ * - app/routes/users/[id]/index.ts   -> /users/:id
+ * - app/routes/index.ts              -> /
+ */
+export declare function loadSubApps(app: Hono, routesDir?: string, eventBus?: EventBus): Promise<Array<{
+    name: string;
+    routes: any[];
+}>>;
+//# sourceMappingURL=router.d.ts.map

package/dist/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAIhC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAE3C;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,IAAI,EAAE,SAAS,GAAE,MAAuB,EAAE,QAAQ,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,GAAG,EAAE,CAAA;CAAE,CAAC,CAAC,CAsGrJ"}

package/dist/router.js

@@ -0,0 +1,117 @@
+import { createRequire } from "node:module";
+var __create = Object.create;
+var __getProtoOf = Object.getPrototypeOf;
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __toESM = (mod, isNodeMode, target) => {
+  target = mod != null ? __create(__getProtoOf(mod)) : {};
+  const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
+  for (let key of __getOwnPropNames(mod))
+    if (!__hasOwnProp.call(to, key))
+      __defProp(to, key, {
+        get: () => mod[key],
+        enumerable: true
+      });
+  return to;
+};
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+
+// src/router.ts
+import { readdirSync, statSync } from "fs";
+import { join, resolve, relative, sep } from "path";
+import { pathToFileURL } from "url";
+async function loadSubApps(app, routesDir = "./app/routes", eventBus) {
+  const mounted = [];
+  const allSubAppSummaries = [];
+  function toBasePath(dirPath) {
+    const rel = relative(resolve(routesDir), resolve(dirPath));
+    if (!rel || rel === "" || rel === ".")
+      return "/";
+    const segments = rel.split(sep).filter(Boolean).map((s) => {
+      if (s.startsWith("[") && s.endsWith("]"))
+        return `:${s.slice(1, -1)}`;
+      return s;
+    });
+    return "/" + segments.join("/");
+  }
+  function isDynamicSegment(name) {
+    return name.startsWith("[") && name.endsWith("]");
+  }
+  async function scan(dir) {
+    const entries = readdirSync(dir);
+    const hasTs = entries.includes("index.ts");
+    const hasJs = entries.includes("index.js");
+    if (hasTs || hasJs) {
+      const indexFile = resolve(dir, hasTs ? "index.ts" : "index.js");
+      const modUrl = pathToFileURL(indexFile).href;
+      const mod = await import(modUrl);
+      const subApp = mod?.default;
+      if (subApp) {
+        if (eventBus && typeof subApp?.setEventBus === "function") {
+          subApp.setEventBus(eventBus);
+        }
+        const base = toBasePath(dir);
+        try {
+          if (typeof subApp?.service === "function") {
+            await subApp.buildAllServices?.();
+            const summaries = subApp.getServiceSummaries?.();
+            if (Array.isArray(summaries) && summaries.length > 0) {
+              const prefixedSummaries = summaries.map((s) => ({
+                ...s,
+                routes: s.routes.map((r) => ({
+                  ...r,
+                  path: base === "/" ? r.path : base + (r.path === "/" ? "" : r.path)
+                }))
+              }));
+              allSubAppSummaries.push(...prefixedSummaries);
+            }
+          }
+        } catch (e) {
+          console.error(`❌ Error preparing sub-app ${dir}:`, e?.message || e);
+        }
+        const routes = subApp?.routes;
+        if (Array.isArray(routes)) {
+          app.route(base, subApp);
+          mounted.push({ base });
+        }
+      }
+    }
+    const sortedEntries = [...entries].sort((a, b) => {
+      const aIsDynamic = isDynamicSegment(a);
+      const bIsDynamic = isDynamicSegment(b);
+      if (aIsDynamic && !bIsDynamic)
+        return 1;
+      if (!aIsDynamic && bIsDynamic)
+        return -1;
+      return a.localeCompare(b);
+    });
+    for (const name of sortedEntries) {
+      const full = join(dir, name);
+      const st = statSync(full);
+      if (st.isDirectory())
+        await scan(full);
+    }
+  }
+  try {
+    statSync(routesDir);
+  } catch {
+    return [];
+  }
+  await scan(routesDir);
+  const mergedServices = new Map;
+  for (const summary of allSubAppSummaries) {
+    if (mergedServices.has(summary.name)) {
+      const existing = mergedServices.get(summary.name);
+      existing.routes.push(...summary.routes);
+    } else {
+      mergedServices.set(summary.name, { name: summary.name, routes: [...summary.routes] });
+    }
+  }
+  return Array.from(mergedServices.values());
+}
+export {
+  loadSubApps
+};
+
+//# debugId=69C3F80F4267D85A64756E2164756E21

package/dist/router.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/router.ts"],
+  "sourcesContent": [
+    "import type { Hono } from 'hono'\nimport { readdirSync, statSync } from 'fs'\nimport { join, resolve, relative, sep } from 'path'\nimport { pathToFileURL } from 'url'\nimport type { EventBus } from './event-bus'\n\n/**\n * Autoload Vision/Hono sub-apps from a directory structure like app/routes/.../index.ts\n * Each folder becomes a base path. Dynamic segments [id] are converted to :id.\n *\n * Examples:\n * - app/routes/users/index.ts        -> /users\n * - app/routes/users/[id]/index.ts   -> /users/:id\n * - app/routes/index.ts              -> /\n */\nexport async function loadSubApps(app: Hono, routesDir: string = './app/routes', eventBus?: EventBus): Promise<Array<{ name: string; routes: any[] }>> {\n  const mounted: Array<{ base: string }> = []\n  const allSubAppSummaries: Array<{ name: string; routes: any[] }> = []\n\n  function toBasePath(dirPath: string): string {\n    const rel = relative(resolve(routesDir), resolve(dirPath))\n    if (!rel || rel === '' || rel === '.' ) return '/'\n    const segments = rel.split(sep).filter(Boolean).map((s) => {\n      if (s.startsWith('[') && s.endsWith(']')) return `:${s.slice(1, -1)}`\n      return s\n    })\n    return '/' + segments.join('/')\n  }\n\n  function isDynamicSegment(name: string): boolean {\n    return name.startsWith('[') && name.endsWith(']')\n  }\n\n  async function scan(dir: string) {\n    const entries = readdirSync(dir)\n    // If folder contains index.ts or index.js, treat it as a sub-app root\n    const hasTs = entries.includes('index.ts')\n    const hasJs = entries.includes('index.js')\n    if (hasTs || hasJs) {\n      const indexFile = resolve(dir, hasTs ? 'index.ts' : 'index.js')\n      const modUrl = pathToFileURL(indexFile).href\n      const mod: any = await import(modUrl)\n      const subApp = mod?.default\n      if (subApp) {\n        // Inject EventBus into sub-app if it's a Vision instance\n        if (eventBus && typeof subApp?.setEventBus === 'function') {\n          subApp.setEventBus(eventBus)\n        }\n        const base = toBasePath(dir)\n        // If it's a Vision sub-app, build its services before mounting\n        try {\n          if (typeof (subApp as any)?.service === 'function') {\n            await (subApp as any).buildAllServices?.()\n            // Collect sub-app services/routes for bulk registration later\n            const summaries = (subApp as any).getServiceSummaries?.()\n            if (Array.isArray(summaries) && summaries.length > 0) {\n              // Prefix all route paths with the base path\n              const prefixedSummaries = summaries.map(s => ({\n                ...s,\n                routes: s.routes.map((r: any) => ({\n                  ...r,\n                  path: base === '/' ? r.path : base + (r.path === '/' ? '' : r.path)\n                }))\n              }))\n              allSubAppSummaries.push(...prefixedSummaries)\n            }\n          }\n        } catch (e) {\n          console.error(`❌ Error preparing sub-app ${dir}:`, (e as any)?.message || e)\n        }\n        // Mount the sub-app only if it looks like a Hono/Vision instance with routes\n        const routes = (subApp as any)?.routes\n        if (Array.isArray(routes)) {\n          ;(app as any).route(base, subApp)\n          mounted.push({ base })\n        }\n      }\n    }\n    // Recurse into child directories\n    // Sort entries: static folders first, then dynamic [param] folders\n    // This ensures static routes have priority over dynamic routes\n    const sortedEntries = [...entries].sort((a, b) => {\n      const aIsDynamic = isDynamicSegment(a)\n      const bIsDynamic = isDynamicSegment(b)\n      if (aIsDynamic && !bIsDynamic) return 1  // dynamic after static\n      if (!aIsDynamic && bIsDynamic) return -1 // static before dynamic\n      return a.localeCompare(b) // alphabetical within same type\n    })\n    for (const name of sortedEntries) {\n      const full = join(dir, name)\n      const st = statSync(full)\n      if (st.isDirectory()) await scan(full)\n    }\n  }\n\n  // Only scan if directory exists\n  try {\n    statSync(routesDir)\n  } catch {\n    return []\n  }\n\n  await scan(routesDir)\n  \n  // Merge services by name (combine routes from same service name)\n  const mergedServices = new Map<string, { name: string; routes: any[] }>()\n  for (const summary of allSubAppSummaries) {\n    if (mergedServices.has(summary.name)) {\n      const existing = mergedServices.get(summary.name)!\n      existing.routes.push(...summary.routes)\n    } else {\n      mergedServices.set(summary.name, { name: summary.name, routes: [...summary.routes] })\n    }\n  }\n  \n  // Return merged services (don't register here - let caller handle it)\n  return Array.from(mergedServices.values())\n}\n"
+  ],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AACA;AACA;AACA;AAYA,eAAsB,WAAW,CAAC,KAAW,YAAoB,gBAAgB,UAAsE;AAAA,EACrJ,MAAM,UAAmC,CAAC;AAAA,EAC1C,MAAM,qBAA6D,CAAC;AAAA,EAEpE,SAAS,UAAU,CAAC,SAAyB;AAAA,IAC3C,MAAM,MAAM,SAAS,QAAQ,SAAS,GAAG,QAAQ,OAAO,CAAC;AAAA,IACzD,IAAI,CAAC,OAAO,QAAQ,MAAM,QAAQ;AAAA,MAAM,OAAO;AAAA,IAC/C,MAAM,WAAW,IAAI,MAAM,GAAG,EAAE,OAAO,OAAO,EAAE,IAAI,CAAC,MAAM;AAAA,MACzD,IAAI,EAAE,WAAW,GAAG,KAAK,EAAE,SAAS,GAAG;AAAA,QAAG,OAAO,IAAI,EAAE,MAAM,GAAG,EAAE;AAAA,MAClE,OAAO;AAAA,KACR;AAAA,IACD,OAAO,MAAM,SAAS,KAAK,GAAG;AAAA;AAAA,EAGhC,SAAS,gBAAgB,CAAC,MAAuB;AAAA,IAC/C,OAAO,KAAK,WAAW,GAAG,KAAK,KAAK,SAAS,GAAG;AAAA;AAAA,EAGlD,eAAe,IAAI,CAAC,KAAa;AAAA,IAC/B,MAAM,UAAU,YAAY,GAAG;AAAA,IAE/B,MAAM,QAAQ,QAAQ,SAAS,UAAU;AAAA,IACzC,MAAM,QAAQ,QAAQ,SAAS,UAAU;AAAA,IACzC,IAAI,SAAS,OAAO;AAAA,MAClB,MAAM,YAAY,QAAQ,KAAK,QAAQ,aAAa,UAAU;AAAA,MAC9D,MAAM,SAAS,cAAc,SAAS,EAAE;AAAA,MACxC,MAAM,MAAW,MAAa;AAAA,MAC9B,MAAM,SAAS,KAAK;AAAA,MACpB,IAAI,QAAQ;AAAA,QAEV,IAAI,YAAY,OAAO,QAAQ,gBAAgB,YAAY;AAAA,UACzD,OAAO,YAAY,QAAQ;AAAA,QAC7B;AAAA,QACA,MAAM,OAAO,WAAW,GAAG;AAAA,QAE3B,IAAI;AAAA,UACF,IAAI,OAAQ,QAAgB,YAAY,YAAY;AAAA,YAClD,MAAO,OAAe,mBAAmB;AAAA,YAEzC,MAAM,YAAa,OAAe,sBAAsB;AAAA,YACxD,IAAI,MAAM,QAAQ,SAAS,KAAK,UAAU,SAAS,GAAG;AAAA,cAEpD,MAAM,oBAAoB,UAAU,IAAI,QAAM;AAAA,mBACzC;AAAA,gBACH,QAAQ,EAAE,OAAO,IAAI,CAAC,OAAY;AAAA,qBAC7B;AAAA,kBACH,MAAM,SAAS,MAAM,EAAE,OAAO,QAAQ,EAAE,SAAS,MAAM,KAAK,EAAE;AAAA,gBAChE,EAAE;AAAA,cACJ,EAAE;AAAA,cACF,mBAAmB,KAAK,GAAG,iBAAiB;AAAA,YAC9C;AAAA,UACF;AAAA,UACA,OAAO,GAAG;AAAA,UACV,QAAQ,MAAM,6BAA4B,QAAS,GAAW,WAAW,CAAC;AAAA;AAAA,QAG5E,MAAM,SAAU,QAAgB;AAAA,QAChC,IAAI,MAAM,QAAQ,MAAM,GAAG;AAAA,UACvB,IAAY,MAAM,MAAM,MAAM;AAAA,UAChC,QAAQ,KAAK,EAAE,KAAK,CAAC;AAAA,QACvB;AAAA,MACF;AAAA,IACF;AAAA,IAIA,MAAM,gBAAgB,CAAC,GAAG,OAAO,EAAE,KAAK,CAAC,GAAG,MAAM;AAAA,MAChD,MAAM,aAAa,iBAAiB,CAAC;AAAA,MACrC,MAAM,aAAa,iBAAiB,CAAC;AAAA,MACrC,IAAI,cAAc,CAAC;AAAA,QAAY,OAAO;AAAA,MACtC,IAAI,CAAC,cAAc;AAAA,QAAY,OAAO;AAAA,MACtC,OAAO,EAAE,cAAc,CAAC;AAAA,KACzB;AAAA,IACD,WAAW,QAAQ,eAAe;AAAA,MAChC,MAAM,OAAO,KAAK,KAAK,IAAI;AAAA,MAC3B,MAAM,KAAK,SAAS,IAAI;AAAA,MACxB,IAAI,GAAG,YAAY;AAAA,QAAG,MAAM,KAAK,IAAI;AAAA,IACvC;AAAA;AAAA,EAIF,IAAI;AAAA,IACF,SAAS,SAAS;AAAA,IAClB,MAAM;AAAA,IACN,OAAO,CAAC;AAAA;AAAA,EAGV,MAAM,KAAK,SAAS;AAAA,EAGpB,MAAM,iBAAiB,IAAI;AAAA,EAC3B,WAAW,WAAW,oBAAoB;AAAA,IACxC,IAAI,eAAe,IAAI,QAAQ,IAAI,GAAG;AAAA,MACpC,MAAM,WAAW,eAAe,IAAI,QAAQ,IAAI;AAAA,MAChD,SAAS,OAAO,KAAK,GAAG,QAAQ,MAAM;AAAA,IACxC,EAAO;AAAA,MACL,eAAe,IAAI,QAAQ,MAAM,EAAE,MAAM,QAAQ,MAAM,QAAQ,CAAC,GAAG,QAAQ,MAAM,EAAE,CAAC;AAAA;AAAA,EAExF;AAAA,EAGA,OAAO,MAAM,KAAK,eAAe,OAAO,CAAC;AAAA;",
+  "debugId": "69C3F80F4267D85A64756E2164756E21",
+  "names": []
+}

package/dist/service.d.ts

@@ -0,0 +1,151 @@
+import type { Hono, Context, MiddlewareHandler, Env, Input } from 'hono';
+import type { z } from 'zod';
+import { VisionCore } from '@getvision/core';
+import type { EndpointConfig, Handler } from './types';
+import type { EventBus } from './event-bus';
+/**
+ * Event schema map - accumulates event types as they're registered
+ */
+type EventSchemaMap = Record<string, z.ZodSchema<any>>;
+/**
+ * ServiceBuilder - Builder pattern API for defining services
+ *
+ * Automatically infers event types from Zod schemas passed to .on()
+ *
+ * @example
+ * ```ts
+ * const userService = app.service('users')
+ *   .use(logger())
+ *   .endpoint('GET', '/users/:id', { input, output }, handler)
+ *   .on('user/created', {
+ *     schema: z.object({ userId: z.string(), email: z.string() }),
+ *     handler: async (event) => {
+ *       // event is fully typed: { userId: string, email: string }
+ *     }
+ *   })
+ * ```
+ */
+export declare class ServiceBuilder<TEvents extends EventSchemaMap = {}, E extends Env = Env, I extends Input = {}> {
+    private name;
+    private eventBus;
+    private visionCore?;
+    private endpoints;
+    private eventHandlers;
+    private cronJobs;
+    private globalMiddleware;
+    private eventSchemas;
+    constructor(name: string, eventBus: EventBus, visionCore?: VisionCore | undefined);
+    /**
+     * Add global middleware for all endpoints in this service
+     */
+    use(...middleware: MiddlewareHandler<E, string, any, any>[]): this;
+    /**
+     * Get service name (capitalized) and route metadata without registering
+     */
+    getRoutesMetadata(): Array<{
+        method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+        path: string;
+        queryParams?: any;
+        requestBody?: any;
+        responseBody?: any;
+    }>;
+    getDisplayName(): string;
+    /**
+     * Define an HTTP endpoint with Zod validation
+     *
+     * @example
+     * ```ts
+     * service.endpoint(
+     *   'GET',
+     *   '/users/:id',
+     *   {
+     *     input: z.object({ id: z.string() }),
+     *     output: z.object({ id: z.string(), name: z.string() })
+     *   },
+     *   async ({ id }, c) => {
+     *     return { id, name: 'John' }
+     *   },
+     *   { middleware: [authMiddleware] }
+     * )
+     * ```
+     */
+    endpoint<TInputSchema extends z.ZodType, TOutputSchema extends z.ZodType | undefined, PPath extends string>(method: EndpointConfig['method'], path: PPath, schema: {
+        input: TInputSchema;
+        output?: TOutputSchema;
+    }, handler: Handler<z.infer<TInputSchema>, TOutputSchema extends z.ZodType ? z.infer<TOutputSchema> : any, TEvents, E, PPath, I>, config?: Partial<EndpointConfig>): this;
+    /**
+     * Subscribe to events with Zod schema validation
+     *
+     * Automatically infers the event type from the Zod schema.
+     * TypeScript will ensure that c.emit() calls match the registered schema.
+     *
+     * @example
+     * ```ts
+     * service.on('user/created', {
+     *   schema: z.object({
+     *     userId: z.string().uuid(),
+     *     email: z.string().email()
+     *   }),
+     *   description: 'User account created',
+     *   icon: '👤',
+     *   tags: ['user', 'auth'],
+     *   handler: async (event) => {
+     *     // event is fully typed: { userId: string, email: string }
+     *     console.log('User created:', event.email)
+     *   }
+     * })
+     * ```
+     */
+    on<K extends string, T extends Record<string, any>>(eventName: K, config: {
+        schema: z.ZodSchema<T>;
+        description?: string;
+        icon?: string;
+        tags?: string[];
+        /**
+         * Max number of concurrent jobs this handler will process.
+         * Falls back to EventBus config.workerConcurrency (or 1).
+         */
+        concurrency?: number;
+        handler: (event: T, c: Context<E, any, I>) => Promise<void>;
+    }): ServiceBuilder<TEvents & {
+        [key in K]: T;
+    }, E, I>;
+    /**
+     * Schedule a cron job using BullMQ Repeatable
+     *
+     * @example
+     * ```ts
+     * service.cron('0 0 * * *', {
+     *   description: 'Daily cleanup',
+     *   icon: '🧹',
+     *   tags: ['maintenance'],
+     *   handler: async (c) => {
+     *     console.log('Daily cleanup')
+     *   }
+     * })
+     * ```
+     */
+    cron(schedule: string, config: {
+        description?: string;
+        icon?: string;
+        tags?: string[];
+        handler: (context: any) => Promise<void>;
+    }): this;
+    /**
+     * Setup BullMQ repeatable job for cron
+     */
+    private setupCronJob;
+    /**
+     * Build and register all endpoints with Hono
+     */
+    build(app: Hono, servicesAccumulator?: Array<{
+        name: string;
+        routes: any[];
+    }>): {
+        endpoints: any[];
+        eventHandlers: any[];
+        cronJobs: any[];
+    };
+}
+export {};
+//# sourceMappingURL=service.d.ts.map

package/dist/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,iBAAiB,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,MAAM,CAAA;AACxE,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAC5B,OAAO,EAAE,UAAU,EAAoB,MAAM,iBAAiB,CAAA;AAM9D,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAGtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAkF3C;;GAEG;AACH,KAAK,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAA;AAEtD;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,cAAc,CACzB,OAAO,SAAS,cAAc,GAAG,EAAE,EACnC,CAAC,SAAS,GAAG,GAAG,GAAG,EACnB,CAAC,SAAS,KAAK,GAAG,EAAE;IASlB,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,UAAU,CAAC;IATrB,OAAO,CAAC,SAAS,CAA8B;IAC/C,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,gBAAgB,CAA+C;IACvE,OAAO,CAAC,YAAY,CAAqB;gBAG/B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,QAAQ,EAClB,UAAU,CAAC,EAAE,UAAU,YAAA;IAGjC;;OAEG;IACH,GAAG,CAAC,GAAG,UAAU,EAAE,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE;IAK3D;;OAEG;IACI,iBAAiB,IAAI,KAAK,CAAC;QAChC,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAA;QACnD,IAAI,EAAE,MAAM,CAAA;QACZ,WAAW,CAAC,EAAE,GAAG,CAAA;QACjB,WAAW,CAAC,EAAE,GAAG,CAAA;QACjB,YAAY,CAAC,EAAE,GAAG,CAAA;KACnB,CAAC;IAgDK,cAAc,IAAI,MAAM;IAI/B;;;;;;;;;;;;;;;;;;OAkBG;IACH,QAAQ,CACN,YAAY,SAAS,CAAC,CAAC,OAAO,EAC9B,aAAa,SAAS,CAAC,CAAC,OAAO,GAAG,SAAS,EAC3C,KAAK,SAAS,MAAM,EAEpB,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC,EAChC,IAAI,EAAE,KAAK,EACX,MAAM,EAAE;QACN,KAAK,EAAE,YAAY,CAAA;QACnB,MAAM,CAAC,EAAE,aAAa,CAAA;KACvB,EACD,OAAO,EAAE,OAAO,CACd,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,EACrB,aAAa,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,GAAG,GAAG,EAC9D,OAAO,EACP,CAAC,EACD,KAAK,EACL,CAAC,CACF,EACD,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC;IAalC;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,EAAE,CACA,CAAC,SAAS,MAAM,EAChB,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAE7B,SAAS,EAAE,CAAC,EACZ,MAAM,EAAE;QACN,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;QACtB,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;QACf;;;WAGG;QACH,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;KAC5D,GACA,cAAc,CAAC,OAAO,GAAG;SAAG,GAAG,IAAI,CAAC,GAAG,CAAC;KAAE,EAAE,CAAC,EAAE,CAAC,CAAC;IAqCpD;;;;;;;;;;;;;;OAcG;IACH,IAAI,CACF,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE;QACN,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;QACf,OAAO,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;KACzC;IAuBH;;OAEG;YACW,YAAY;IAyB1B;;OAEG;IACH,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,mBAAmB,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,GAAG,EAAE,CAAA;KAAE,CAAC;;;;;CAkN9E"}