@kabyeon/nexusjs 0.6.5

package/dist/events/index.js.map

@@ -0,0 +1,23 @@
+{
+  "version": 3,
+  "sources": ["../src/core/constants.ts", "../src/core/decorators/controller.ts", "../src/core/decorators/http-methods.ts", "../src/core/decorators/params.ts", "../src/core/decorators/validate.ts", "../src/events/emitter.ts", "../src/core/decorators/module.ts", "../src/core/decorators/index.ts", "../src/core/decorators/injectable.ts", "../src/core/decorators/repository.ts", "../src/core/decorators/metadata.ts", "../src/events/event.service.ts", "../src/events/events.module.ts", "../src/events/decorators/on-event.ts"],
+  "sourcesContent": [
+    "/**\n * Metadata keys used by reflect-metadata for storing decorator data.\n *\n * These constants are the contract between decorators and the framework\n * core (DI container, router, validator).\n */\nexport const METADATA_KEY = {\n\t/** Marks a class as a Nest-style controller, stores route prefix. */\n\tCONTROLLER: \"nexus:controller\",\n\n\t/** Marks a class as an injectable provider. */\n\tINJECTABLE: \"nexus:injectable\",\n\n\t/** Marks a class as a repository. */\n\tREPOSITORY: \"nexus:repository\",\n\n\t/** Marks a class as a module. Stores module options. */\n\tMODULE: \"nexus:module\",\n\n\t/** HTTP method routes registered on a controller (Get/Post/...). */\n\tROUTES: \"nexus:routes\",\n\n\t/** Method parameter type metadata (body/query/param/headers/ctx). */\n\tPARAMS: \"nexus:params\",\n\n\t/** Validation schema per method (Zod schema or class). */\n\tVALIDATE: \"nexus:validate\",\n\n\t/** Class-level design:paramtypes (built-in). */\n\tPARAMTYPES: \"design:paramtypes\",\n\n\t/** Class-level design:type (built-in). */\n\tTYPE: \"design:type\",\n\n\t/** Class-level design:returntype (built-in). */\n\tRETURNTYPE: \"design:returntype\",\n\n\t/** Provider token to inject for a parameter (for custom tokens). */\n\tINJECT: \"nexus:inject\",\n} as const;\n\nexport type MetadataKey = (typeof METADATA_KEY)[keyof typeof METADATA_KEY];\n\n/** Available parameter decorator locations. */\nexport const PARAM_TYPES = {\n\tREQUEST: 0,\n\tRESPONSE: 1,\n\tNEXT: 2,\n\tBODY: 3,\n\tQUERY: 4,\n\tPARAM: 5,\n\tHEADERS: 6,\n\tCTX: 7,\n\tUSER: 8,\n} as const;\n\nexport type ParamType = (typeof PARAM_TYPES)[keyof typeof PARAM_TYPES];\n\n/** HTTP methods supported by the router. */\nexport const HTTP_METHODS = [\n\t\"GET\",\n\t\"POST\",\n\t\"PUT\",\n\t\"DELETE\",\n\t\"PATCH\",\n\t\"OPTIONS\",\n\t\"HEAD\",\n] as const;\nexport type HttpMethod = (typeof HTTP_METHODS)[number];\n",
+    "/**\n * @Controller decorator.\n *\n * Marks a class as a controller and registers a route prefix.\n * Routes inside the controller class are decorated with @Get/@Post/etc.\n *\n * @example\n * ```ts\n * @Controller('/users')\n * class UserController {\n *   @Get('/')\n *   list() { ... }\n * }\n * ```\n */\nimport \"reflect-metadata\";\nimport { METADATA_KEY } from \"../constants.js\";\nimport type { ControllerMetadata } from \"../di/tokens.js\";\n\nexport function Controller(prefix: string = \"/\"): ClassDecorator {\n\treturn (target: object) => {\n\t\tconst normalized = normalizePrefix(prefix);\n\t\tconst meta: ControllerMetadata = { prefix: normalized };\n\t\tReflect.defineMetadata(METADATA_KEY.CONTROLLER, meta, target);\n\t};\n}\n\nexport function getControllerMetadata(target: any): ControllerMetadata {\n\treturn (\n\t\tReflect.getMetadata(METADATA_KEY.CONTROLLER, target) ?? { prefix: \"/\" }\n\t);\n}\n\nexport function isController(target: any): boolean {\n\treturn Reflect.hasMetadata(METADATA_KEY.CONTROLLER, target);\n}\n\n/**\n * Normalize a prefix so we can safely concatenate it with handler paths.\n * - Empty string becomes '/'.\n * - Trailing slashes are trimmed (we re-add them on the join).\n * - No leading slash is added; the router always joins with `/`.\n */\nfunction normalizePrefix(prefix: string): string {\n\tif (!prefix) return \"\";\n\tif (prefix !== \"/\" && prefix.endsWith(\"/\")) {\n\t\treturn prefix.slice(0, -1);\n\t}\n\treturn prefix;\n}\n",
+    "/**\n * HTTP method decorators.\n *\n * `@Get`, `@Post`, `@Put`, `@Delete`, `@Patch`, `@Options`, `@Head` mark a\n * controller method as a route handler. The path argument is appended to\n * the controller's prefix.\n *\n * @example\n * ```ts\n * @Controller('/users')\n * class UserController {\n *   @Get('/')\n *   list() {}\n *\n *   @Post('/')\n *   create(@Body() body: CreateUserDto) {}\n * }\n * ```\n */\nimport \"reflect-metadata\";\nimport { HTTP_METHODS, METADATA_KEY, type HttpMethod } from \"../constants.js\";\nimport type { RouteMetadata } from \"../di/tokens.js\";\n\nfunction defineRoute(method: HttpMethod, path: string): MethodDecorator {\n\treturn (\n\t\ttarget: object,\n\t\tpropertyKey: string | symbol,\n\t\tdescriptor: PropertyDescriptor,\n\t) => {\n\t\tconst routes: RouteMetadata[] =\n\t\t\tReflect.getMetadata(METADATA_KEY.ROUTES, target.constructor) ?? [];\n\n\t\troutes.push({\n\t\t\tmethod,\n\t\t\tpath: normalizePath(path),\n\t\t\tpropertyKey,\n\t\t\thandler: descriptor.value,\n\t\t});\n\n\t\tReflect.defineMetadata(METADATA_KEY.ROUTES, routes, target.constructor);\n\t};\n}\n\nfunction normalizePath(path: string): string {\n\tif (!path || path === \"/\") return \"/\";\n\treturn path.startsWith(\"/\") ? path : `/${path}`;\n}\n\nexport const Get = (path: string = \"/\") => defineRoute(\"GET\", path);\nexport const Post = (path: string = \"/\") => defineRoute(\"POST\", path);\nexport const Put = (path: string = \"/\") => defineRoute(\"PUT\", path);\nexport const Delete = (path: string = \"/\") => defineRoute(\"DELETE\", path);\nexport const Patch = (path: string = \"/\") => defineRoute(\"PATCH\", path);\nexport const Options = (path: string = \"/\") => defineRoute(\"OPTIONS\", path);\nexport const Head = (path: string = \"/\") => defineRoute(\"HEAD\", path);\n\nexport function getRoutes(target: any): RouteMetadata[] {\n\treturn Reflect.getMetadata(METADATA_KEY.ROUTES, target) ?? [];\n}\n\nexport { HTTP_METHODS };\nexport type { RouteMetadata };\n",
+    "/**\n * Parameter decorators.\n *\n * These mark a controller method argument as a source of request data:\n *   - `@Req()`        → Hono context\n *   - `@Res()`        → Response helper\n *   - `@Next()`       → next() callback (for middleware-style handlers)\n *   - `@Body()`       → request body (parsed)\n *   - `@Query('key')` → a single query param, or full query object\n *   - `@Param('key')` → a single path param, or full params object\n *   - `@Headers('k')` → a single header, or full headers object\n *   - `@Ctx()`        → Hono context (alias for @Req)\n *   - `@User()`       → authenticated user (resolved via auth provider)\n *\n * The metadata is read by the router at mount time to build the\n * handler invocation list.\n */\nimport \"reflect-metadata\";\nimport { METADATA_KEY, PARAM_TYPES } from \"../constants.js\";\nimport type { ParamMetadata } from \"../di/tokens.js\";\n\nexport function createParamDecorator(\n\ttype: number,\n\tdata?: string | object,\n): ParameterDecorator {\n\treturn (\n\t\ttarget: object,\n\t\tpropertyKey: string | symbol | undefined,\n\t\tparameterIndex: number,\n\t) => {\n\t\t// Method parameter: target is the prototype, propertyKey is the method name.\n\t\t// Constructor parameter: target is the class, propertyKey is undefined.\n\t\tif (propertyKey !== undefined) {\n\t\t\tconst params: ParamMetadata[] =\n\t\t\t\tReflect.getMetadata(METADATA_KEY.PARAMS, target, propertyKey) ?? [];\n\t\t\tparams.push({\n\t\t\t\tindex: parameterIndex,\n\t\t\t\ttype,\n\t\t\t\tname: typeof data === \"string\" ? data : undefined,\n\t\t\t\tdata: typeof data === \"object\" ? data : undefined,\n\t\t\t});\n\t\t\tReflect.defineMetadata(METADATA_KEY.PARAMS, params, target, propertyKey);\n\t\t} else {\n\t\t\tconst params: ParamMetadata[] =\n\t\t\t\tReflect.getMetadata(METADATA_KEY.PARAMS, target) ?? [];\n\t\t\tparams.push({\n\t\t\t\tindex: parameterIndex,\n\t\t\t\ttype,\n\t\t\t\tname: typeof data === \"string\" ? data : undefined,\n\t\t\t\tdata: typeof data === \"object\" ? data : undefined,\n\t\t\t});\n\t\t\tReflect.defineMetadata(METADATA_KEY.PARAMS, params, target);\n\t\t}\n\t};\n}\n\nexport const Req = () => createParamDecorator(PARAM_TYPES.REQUEST);\nexport const Res = () => createParamDecorator(PARAM_TYPES.RESPONSE);\nexport const Next = () => createParamDecorator(PARAM_TYPES.NEXT);\nexport const Body = (key?: string) =>\n\tcreateParamDecorator(PARAM_TYPES.BODY, key);\nexport const Query = (key?: string) =>\n\tcreateParamDecorator(PARAM_TYPES.QUERY, key);\nexport const Param = (key?: string) =>\n\tcreateParamDecorator(PARAM_TYPES.PARAM, key);\nexport const Headers = (key?: string) =>\n\tcreateParamDecorator(PARAM_TYPES.HEADERS, key);\nexport const Ctx = () => createParamDecorator(PARAM_TYPES.CTX);\nexport const User = () => createParamDecorator(PARAM_TYPES.USER);\n\nexport function getParamMetadata(\n\ttarget: any,\n\tpropertyKey: string | symbol,\n): ParamMetadata[] {\n\treturn Reflect.getMetadata(METADATA_KEY.PARAMS, target, propertyKey) ?? [];\n}\n\nexport { PARAM_TYPES };\n",
+    "/**\n * @Validate decorator.\n *\n * Attaches Zod schemas (or class validators) to a route handler. Each\n * schema is run against the corresponding request part before the handler\n * executes; failed validation throws or returns a 400 response.\n *\n * @example\n * ```ts\n * const UserSchema = z.object({ name: z.string(), email: z.email() });\n *\n * @Post('/')\n * @Validate({ body: UserSchema })\n * create(@Body() body: z.infer<typeof UserSchema>) { ... }\n * ```\n */\nimport \"reflect-metadata\";\nimport { METADATA_KEY } from \"../constants.js\";\nimport type { ValidationMetadata } from \"../di/tokens.js\";\n\nexport function Validate(options: ValidationMetadata): MethodDecorator {\n\treturn (\n\t\ttarget: object,\n\t\tpropertyKey: string | symbol,\n\t\tdescriptor: PropertyDescriptor,\n\t) => {\n\t\tReflect.defineMetadata(\n\t\t\tMETADATA_KEY.VALIDATE,\n\t\t\toptions,\n\t\t\ttarget.constructor,\n\t\t\tpropertyKey,\n\t\t);\n\t};\n}\n\nexport function getValidationMetadata(\n\ttarget: any,\n\tpropertyKey: string | symbol,\n): ValidationMetadata | undefined {\n\treturn Reflect.getMetadata(METADATA_KEY.VALIDATE, target, propertyKey);\n}\n",
+    "/**\n * In-process event emitter with wildcard matching, priorities, and\n * guards. Mirrors `@nestjs/event-emitter` and AdonisJS's emitter.\n *\n * Wildcards:\n *   - star (single segment)        — `user.star` matches `user.created`\n *   - double-star (multi segment)  — `star-star` matches `user.created` and `user.profile.updated`\n *   - exact                       — `user.created` matches only itself\n *\n * Priority: lower runs first (default 5). When two listeners have the\n * same priority, registration order is preserved (FIFO).\n *\n * Guards: a listener can register an `if(payload) → boolean` predicate;\n * when it returns false, the listener is skipped.\n *\n * Errors: by default, a throwing listener does NOT stop the rest of\n * the dispatch — errors are collected in `EmitResult.errors`. Set\n * `EventsConfig.throwOnError: true` to make `emit()` reject instead.\n */\n\nimport type {\n\tEventName,\n\tEventPriority,\n\tEventListener,\n\tListenerOptions,\n\tEmitResult,\n\tEventEmitter,\n\tEmitterEvent,\n\tEmitterEventListener,\n\tEventsConfig,\n} from \"./types.js\";\n\ninterface InternalListener {\n\tid: string;\n\tpattern: string;\n\tregex: RegExp | null; // null = exact match\n\tpriority: EventPriority;\n\tguard?: (payload: any) => boolean | Promise<boolean>;\n\tonce: boolean;\n\tlistener: EventListener;\n\tcreatedAt: number;\n}\n\nexport class NexusEventEmitter implements EventEmitter {\n\t#listeners: InternalListener[] = [];\n\t#emitterListeners = new Set<EmitterEventListener>();\n\t#maxPerPattern: number;\n\t#throwOnError: boolean;\n\t#defaultPriority: EventPriority;\n\t#nextId = 1;\n\n\tconstructor(config: EventsConfig = {}) {\n\t\tthis.#maxPerPattern = config.maxListenersPerPattern ?? 10;\n\t\tthis.#throwOnError = config.throwOnError ?? false;\n\t\tthis.#defaultPriority = config.defaultPriority ?? 5;\n\t}\n\n\t// ===========================================================================\n\t// Public API\n\t// ===========================================================================\n\n\ton<T = unknown>(\n\t\tpattern: EventName,\n\t\tlistener: EventListener<T>,\n\t\toptions: ListenerOptions = {},\n\t): string {\n\t\tconst existing = this.#listeners.filter((l) => l.pattern === pattern);\n\t\tif (existing.length >= this.#maxPerPattern) {\n\t\t\tthrow new Error(\n\t\t\t\t`[events] Too many listeners registered for \"${pattern}\" ` +\n\t\t\t\t\t`(max ${this.#maxPerPattern}). Increase \\`maxListenersPerPattern\\` ` +\n\t\t\t\t\t`or call \\`off()\\` on stale listeners.`,\n\t\t\t);\n\t\t}\n\t\tconst id = this.#allocateId();\n\t\tconst internal: InternalListener = {\n\t\t\tid,\n\t\t\tpattern,\n\t\t\tregex: compilePattern(pattern),\n\t\t\tpriority: options.priority ?? this.#defaultPriority,\n\t\t\tonce: options.once ?? false,\n\t\t\tlistener: listener as EventListener,\n\t\t\tcreatedAt: Date.now(),\n\t\t};\n\t\tif (options.if !== undefined) {\n\t\t\tinternal.guard = options.if as (\n\t\t\t\tpayload: any,\n\t\t\t) => boolean | Promise<boolean>;\n\t\t}\n\t\tthis.#listeners.push(internal);\n\t\tthis.#sortListeners();\n\t\tthis.#emitEmitterEvent({ kind: \"listener:registered\", id, pattern });\n\t\treturn id;\n\t}\n\n\tonce<T = unknown>(\n\t\tpattern: EventName,\n\t\tlistener: EventListener<T>,\n\t\toptions: Omit<ListenerOptions, \"once\"> = {},\n\t): string {\n\t\treturn this.on(pattern, listener, { ...options, once: true });\n\t}\n\n\toff(idOrPattern: string): number {\n\t\tconst before = this.#listeners.length;\n\t\tconst removed: InternalListener[] = [];\n\t\tthis.#listeners = this.#listeners.filter((l) => {\n\t\t\tconst match = l.id === idOrPattern || l.pattern === idOrPattern;\n\t\t\tif (match) removed.push(l);\n\t\t\treturn !match;\n\t\t});\n\t\tfor (const r of removed) {\n\t\t\tthis.#emitEmitterEvent({ kind: \"listener:removed\", id: r.id });\n\t\t}\n\t\treturn before - this.#listeners.length;\n\t}\n\n\tasync emit<T = unknown>(name: EventName, payload?: T): Promise<EmitResult> {\n\t\tconst result: EmitResult = {\n\t\t\tname,\n\t\t\tmatched: 0,\n\t\t\tcompleted: 0,\n\t\t\tfailed: 0,\n\t\t\terrors: [],\n\t\t};\n\t\tconst matches = this.#matchingListeners(name);\n\t\tresult.matched = matches.length;\n\t\tif (matches.length === 0) return result;\n\n\t\t// Run guards in parallel (they're cheap), then dispatch in priority order.\n\t\tconst eligible: Array<{ listener: InternalListener; payload: any }> = [];\n\t\tfor (const l of matches) {\n\t\t\tif (l.guard) {\n\t\t\t\ttry {\n\t\t\t\t\tconst ok = await l.guard(payload);\n\t\t\t\t\tif (!ok) {\n\t\t\t\t\t\tthis.#emitEmitterEvent({\n\t\t\t\t\t\t\tkind: \"listener:skipped\",\n\t\t\t\t\t\t\tid: l.id,\n\t\t\t\t\t\t\tpattern: l.pattern,\n\t\t\t\t\t\t\treason: \"guard\",\n\t\t\t\t\t\t});\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\t\t\t\t} catch {\n\t\t\t\t\t// Guard threw — skip.\n\t\t\t\t\tthis.#emitEmitterEvent({\n\t\t\t\t\t\tkind: \"listener:skipped\",\n\t\t\t\t\t\tid: l.id,\n\t\t\t\t\t\tpattern: l.pattern,\n\t\t\t\t\t\treason: \"guard\",\n\t\t\t\t\t});\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t}\n\t\t\teligible.push({ listener: l, payload });\n\t\t}\n\n\t\t// Dispatch eligible listeners in priority order.\n\t\t// `once` listeners are removed on success or failure.\n\t\tconst toRemove: InternalListener[] = [];\n\t\tfor (const { listener, payload: p } of eligible) {\n\t\t\tconst start = Date.now();\n\t\t\ttry {\n\t\t\t\tawait listener.listener(p);\n\t\t\t\tresult.completed++;\n\t\t\t\tthis.#emitEmitterEvent({\n\t\t\t\t\tkind: \"listener:fired\",\n\t\t\t\t\tid: listener.id,\n\t\t\t\t\tpattern: listener.pattern,\n\t\t\t\t\tdurationMs: Date.now() - start,\n\t\t\t\t});\n\t\t\t} catch (err) {\n\t\t\t\tresult.failed++;\n\t\t\t\tconst error = err instanceof Error ? err : new Error(String(err));\n\t\t\t\tresult.errors.push({\n\t\t\t\t\tlistenerId: listener.id,\n\t\t\t\t\tlistenerName: listener.pattern,\n\t\t\t\t\terror: error.message,\n\t\t\t\t});\n\t\t\t\tthis.#emitEmitterEvent({\n\t\t\t\t\tkind: \"listener:failed\",\n\t\t\t\t\tid: listener.id,\n\t\t\t\t\tpattern: listener.pattern,\n\t\t\t\t\terror,\n\t\t\t\t});\n\t\t\t\tif (this.#throwOnError) {\n\t\t\t\t\tthrow error;\n\t\t\t\t}\n\t\t\t} finally {\n\t\t\t\tif (listener.once) toRemove.push(listener);\n\t\t\t}\n\t\t}\n\t\tif (toRemove.length > 0) {\n\t\t\tconst ids = new Set(toRemove.map((l) => l.id));\n\t\t\tthis.#listeners = this.#listeners.filter((l) => !ids.has(l.id));\n\t\t}\n\t\treturn result;\n\t}\n\n\temitSync<T = unknown>(name: EventName, payload?: T): EmitResult {\n\t\tconst result: EmitResult = {\n\t\t\tname,\n\t\t\tmatched: 0,\n\t\t\tcompleted: 0,\n\t\t\tfailed: 0,\n\t\t\terrors: [],\n\t\t};\n\t\tconst matches = this.#matchingListeners(name);\n\t\tresult.matched = matches.length;\n\t\tif (matches.length === 0) return result;\n\n\t\tconst toRemove: InternalListener[] = [];\n\t\tfor (const l of matches) {\n\t\t\tif (l.guard) {\n\t\t\t\tlet ok: boolean;\n\t\t\t\ttry {\n\t\t\t\t\tok = l.guard(payload) as boolean;\n\t\t\t\t} catch {\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t\tif (!ok) continue;\n\t\t\t}\n\t\t\tconst start = Date.now();\n\t\t\ttry {\n\t\t\t\tconst ret = l.listener(payload);\n\t\t\t\tif (ret && typeof (ret as Promise<unknown>).then === \"function\") {\n\t\t\t\t\t// Promise — fire-and-forget; not awaited in sync mode.\n\t\t\t\t\t(ret as Promise<unknown>).then(\n\t\t\t\t\t\t() => {\n\t\t\t\t\t\t\tresult.completed++;\n\t\t\t\t\t\t\tif (l.once) toRemove.push(l);\n\t\t\t\t\t\t},\n\t\t\t\t\t\t(err: unknown) => {\n\t\t\t\t\t\t\tresult.failed++;\n\t\t\t\t\t\t\tresult.errors.push({\n\t\t\t\t\t\t\t\tlistenerId: l.id,\n\t\t\t\t\t\t\t\tlistenerName: l.pattern,\n\t\t\t\t\t\t\t\terror: err instanceof Error ? err.message : String(err),\n\t\t\t\t\t\t\t});\n\t\t\t\t\t\t\tif (l.once) toRemove.push(l);\n\t\t\t\t\t\t},\n\t\t\t\t\t);\n\t\t\t\t} else {\n\t\t\t\t\tresult.completed++;\n\t\t\t\t\tif (l.once) toRemove.push(l);\n\t\t\t\t}\n\t\t\t\tthis.#emitEmitterEvent({\n\t\t\t\t\tkind: \"listener:fired\",\n\t\t\t\t\tid: l.id,\n\t\t\t\t\tpattern: l.pattern,\n\t\t\t\t\tdurationMs: Date.now() - start,\n\t\t\t\t});\n\t\t\t} catch (err) {\n\t\t\t\tresult.failed++;\n\t\t\t\tconst error = err instanceof Error ? err : new Error(String(err));\n\t\t\t\tresult.errors.push({\n\t\t\t\t\tlistenerId: l.id,\n\t\t\t\t\tlistenerName: l.pattern,\n\t\t\t\t\terror: error.message,\n\t\t\t\t});\n\t\t\t\tif (l.once) toRemove.push(l);\n\t\t\t}\n\t\t}\n\t\tif (toRemove.length > 0) {\n\t\t\tconst ids = new Set(toRemove.map((l) => l.id));\n\t\t\tthis.#listeners = this.#listeners.filter((l) => !ids.has(l.id));\n\t\t}\n\t\treturn result;\n\t}\n\n\tlistenerCount(pattern?: EventName): number {\n\t\tif (pattern === undefined) return this.#listeners.length;\n\t\treturn this.#listeners.filter((l) => l.pattern === pattern).length;\n\t}\n\n\tlistListeners(pattern?: EventName): Array<{\n\t\tid: string;\n\t\tpattern: string;\n\t\tpriority: EventPriority;\n\t\tonce: boolean;\n\t}> {\n\t\tconst list =\n\t\t\tpattern === undefined\n\t\t\t\t? this.#listeners\n\t\t\t\t: this.#listeners.filter((l) => l.pattern === pattern);\n\t\treturn list.map((l) => ({\n\t\t\tid: l.id,\n\t\t\tpattern: l.pattern,\n\t\t\tpriority: l.priority,\n\t\t\tonce: l.once,\n\t\t}));\n\t}\n\n\tremoveAllListeners(): void {\n\t\tconst ids = this.#listeners.map((l) => l.id);\n\t\tthis.#listeners = [];\n\t\tfor (const id of ids) {\n\t\t\tthis.#emitEmitterEvent({ kind: \"listener:removed\", id });\n\t\t}\n\t}\n\n\t/** Subscribe to emitter-internal events (registration, firing, etc.). */\n\tonEmitterEvent(listener: EmitterEventListener): () => void {\n\t\tthis.#emitterListeners.add(listener);\n\t\treturn () => this.#emitterListeners.delete(listener);\n\t}\n\n\t// ===========================================================================\n\t// Internal\n\t// ===========================================================================\n\n\t#allocateId(): string {\n\t\treturn `evt-${this.#nextId++}`;\n\t}\n\n\t#matchingListeners(name: EventName): InternalListener[] {\n\t\treturn this.#listeners.filter((l) => {\n\t\t\tif (l.regex === null) return l.pattern === name;\n\t\t\treturn l.regex.test(name);\n\t\t});\n\t}\n\n\t#sortListeners(): void {\n\t\t// Stable sort: by priority asc, then createdAt asc.\n\t\tthis.#listeners.sort((a, b) => {\n\t\t\tif (a.priority !== b.priority) return a.priority - b.priority;\n\t\t\treturn a.createdAt - b.createdAt;\n\t\t});\n\t}\n\n\t#emitEmitterEvent(event: EmitterEvent): void {\n\t\tfor (const l of this.#emitterListeners) {\n\t\t\tvoid Promise.resolve(l(event));\n\t\t}\n\t}\n}\n\n// ---------------------------------------------------------------------------\n// Pattern compiler\n// ---------------------------------------------------------------------------\n\n/**\n * Compile an event-name pattern into a RegExp. `null` means exact\n * match (no wildcards).\n *\n * Strategy:\n *   1. Replace `**` and `*` with sentinel placeholders that survive\n *      regex escaping.\n *   2. Escape all other regex metacharacters.\n *   3. Replace placeholders with the actual regex fragments\n *      (`**` → `.*`, `*` → `[^.]+`).\n */\nexport function compilePattern(pattern: string): RegExp | null {\n\tif (!pattern.includes(\"*\")) return null;\n\n\tconst DOUBLE = \"\\x00DOUBLE\\x00\";\n\tconst SINGLE = \"\\x00SINGLE\\x00\";\n\tlet p = pattern.split(\"**\").join(DOUBLE).split(\"*\").join(SINGLE);\n\n\t// Escape regex metacharacters (except our placeholders, which are\n\t// control characters that have no regex meaning).\n\tp = p.replace(/[.+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n\n\tp = p.split(DOUBLE).join(\".*\").split(SINGLE).join(\"[^.]+\");\n\treturn new RegExp(`^${p}$`);\n}\n",
+    "/**\n * @Module decorator.\n *\n * Marks a class as a Nest-style module: a logical grouping of\n * controllers and providers with explicit imports/exports.\n *\n * @example\n * ```ts\n * @Module({\n *   imports: [UserModule],\n *   controllers: [UserController],\n *   providers: [UserService],\n *   exports: [UserService],\n * })\n * class AppModule {}\n * ```\n */\nimport \"reflect-metadata\";\nimport { METADATA_KEY } from \"../constants.js\";\nimport type { ModuleOptions, Type } from \"../di/tokens.js\";\n\nexport function Module(options: ModuleOptions = {}): ClassDecorator {\n\treturn (target: object) => {\n\t\tReflect.defineMetadata(METADATA_KEY.MODULE, options, target);\n\t};\n}\n\n/** Read the @Module options from a class. */\nexport function getModuleOptions(target: Type<any>): ModuleOptions {\n\treturn Reflect.getMetadata(METADATA_KEY.MODULE, target) ?? {};\n}\n",
+    "/**\n * Convenience barrel for all decorators.\n */\nexport * from \"./module.js\";\nexport * from \"./controller.js\";\nexport * from \"./injectable.js\";\nexport * from \"./http-methods.js\";\nexport * from \"./params.js\";\nexport * from \"./validate.js\";\nexport * from \"./repository.js\";\nexport * from \"./metadata.js\";\n",
+    "/**\n * @Injectable decorator.\n *\n * Marks a class as available for DI. The container uses reflect-metadata's\n * `design:paramtypes` to read constructor parameter types and resolve them\n * automatically.\n *\n * @example\n * ```ts\n * @Injectable()\n * class UserService {\n *   constructor(private repo: UserRepository) {}\n * }\n *\n * @Injectable({ scope: 'request' })\n * class RequestContext {\n *   constructor(@Inject(REQUEST) private req: any) {}\n * }\n * ```\n */\nimport \"reflect-metadata\";\nimport { METADATA_KEY } from \"../constants.js\";\n\nexport interface InjectableOptions {\n\tscope?: \"singleton\" | \"request\" | \"transient\";\n}\n\nexport function Injectable(options: InjectableOptions = {}): ClassDecorator {\n\treturn (target: object) => {\n\t\tReflect.defineMetadata(METADATA_KEY.INJECTABLE, true, target);\n\t\tif (options.scope) {\n\t\t\tReflect.defineMetadata(\n\t\t\t\t\"nexus:di:scope\",\n\t\t\t\toptions.scope,\n\t\t\t\ttarget,\n\t\t\t);\n\t\t}\n\t};\n}\n\nexport function isInjectable(target: any): boolean {\n\treturn Reflect.hasMetadata(METADATA_KEY.INJECTABLE, target);\n}\n\n/**\n * Read the scope declared on a class via `@Injectable({ scope })`.\n * Returns undefined when no scope is declared (defaults to singleton).\n */\nexport function getScope(\n\ttarget: any,\n): \"singleton\" | \"request\" | \"transient\" | undefined {\n\treturn Reflect.getMetadata(\"nexus:di:scope\", target);\n}\n\n/**\n * Mark a parameter as resolved by a specific token instead of its declared\n * type. Useful for interfaces, abstract classes, or string tokens.\n *\n * @example\n * ```ts\n * constructor(@Inject('CONFIG') private config: AppConfig) {}\n * ```\n */\nexport function Inject<T = any>(token: any): ParameterDecorator {\n\treturn (\n\t\ttarget: object,\n\t\tpropertyKey: string | symbol | undefined,\n\t\tparameterIndex: number,\n\t) => {\n\t\tconst existing: Map<number, any> =\n\t\t\tReflect.getMetadata(METADATA_KEY.INJECT, target) ?? new Map();\n\t\texisting.set(parameterIndex, token);\n\t\tReflect.defineMetadata(METADATA_KEY.INJECT, existing, target);\n\t};\n}",
+    "/**\n * @Repository decorator.\n *\n * Marks a class as a Spring-style repository. Repositories are normal\n * `@Injectable()` classes; the decorator is a marker so the framework\n * can register them with a database adapter (Drizzle/Prisma) and emit\n * a friendly error if you forget to wire one.\n *\n * @example\n * ```ts\n * @Repository()\n * class UserRepository {\n *   findAll() { return db.select().from(users); }\n * }\n * ```\n */\nimport \"reflect-metadata\";\nimport { METADATA_KEY } from \"../constants.js\";\nimport type { InjectionToken } from \"../di/tokens.js\";\n\nexport function Repository(entityToken?: InjectionToken<any>): ClassDecorator {\n\treturn (target: object) => {\n\t\tReflect.defineMetadata(\n\t\t\tMETADATA_KEY.REPOSITORY,\n\t\t\t{ entity: entityToken },\n\t\t\ttarget,\n\t\t);\n\t\tReflect.defineMetadata(METADATA_KEY.INJECTABLE, true, target);\n\t};\n}\n\nexport function getRepositoryMetadata(\n\ttarget: any,\n): { entity?: InjectionToken<any> } | undefined {\n\treturn Reflect.getMetadata(METADATA_KEY.REPOSITORY, target);\n}\n\nexport function isRepository(target: any): boolean {\n\treturn Reflect.hasMetadata(METADATA_KEY.REPOSITORY, target);\n}\n",
+    "/**\n * Reflect-metadata helper. Centralizes the keys the framework uses so\n * decorator files stay clean.\n */\nexport { METADATA_KEY, PARAM_TYPES, HTTP_METHODS } from \"../constants.js\";\nexport type { MetadataKey, ParamType, HttpMethod } from \"../constants.js\";\n",
+    "/**\n * `EventService` — DI-friendly facade over the emitter.\n *\n * Controllers and services inject this to emit events. Listeners\n * can either:\n *   - Call `event.on(pattern, fn)` directly\n *   - Use the `@OnEvent(pattern)` decorator + `scanForListeners`\n */\n\nimport { Inject, Injectable } from '../core/decorators/index.js';\nimport {\n\tNexusEventEmitter,\n\tcompilePattern,\n} from './emitter.js';\nimport type {\n\tEventEmitter,\n\tEventListener,\n\tEventName,\n\tEmitResult,\n\tListenerOptions,\n\tEventsConfig,\n\tEmitterEvent,\n\tEmitterEventListener,\n} from './types.js';\n\n@Injectable()\nexport class EventService {\n\t/** DI token — use with `@Inject(EventService.TOKEN)`. */\n\tstatic readonly TOKEN = Symbol.for('nexus:EventService');\n\n\treadonly emitter: EventEmitter;\n\n\tconstructor(@Inject('EVENTS_CONFIG') private readonly config: EventsConfig = {}) {\n\t\tthis.emitter = new NexusEventEmitter(config);\n\t}\n\n\t// ===========================================================================\n\t// Public API\n\t// ===========================================================================\n\n\ton<T = unknown>(\n\t\tpattern: EventName,\n\t\tlistener: EventListener<T>,\n\t\toptions?: ListenerOptions,\n\t): string {\n\t\treturn this.emitter.on(pattern, listener, options);\n\t}\n\n\tonce<T = unknown>(\n\t\tpattern: EventName,\n\t\tlistener: EventListener<T>,\n\t\toptions?: Omit<ListenerOptions, 'once'>,\n\t): string {\n\t\treturn this.emitter.once(pattern, listener, options);\n\t}\n\n\toff(idOrPattern: string): number {\n\t\treturn this.emitter.off(idOrPattern);\n\t}\n\n\temit<T = unknown>(name: EventName, payload?: T): Promise<EmitResult> {\n\t\treturn this.emitter.emit(name, payload);\n\t}\n\n\temitSync<T = unknown>(name: EventName, payload?: T): EmitResult {\n\t\treturn this.emitter.emitSync(name, payload);\n\t}\n\n\tlistenerCount(pattern?: EventName): number {\n\t\treturn this.emitter.listenerCount(pattern);\n\t}\n\n\tlistListeners(pattern?: EventName): ReturnType<EventEmitter['listListeners']> {\n\t\treturn this.emitter.listListeners(pattern);\n\t}\n\n\tremoveAllListeners(): void {\n\t\tthis.emitter.removeAllListeners();\n\t}\n\n\tonEmitterEvent(listener: EmitterEventListener): () => void {\n\t\tconst internal = this.emitter as NexusEventEmitter;\n\t\tif (typeof internal.onEmitterEvent === 'function') {\n\t\t\treturn internal.onEmitterEvent(listener);\n\t\t}\n\t\treturn () => {};\n\t}\n\n\t// ===========================================================================\n\t// Internal\n\t// ===========================================================================\n\n\t#bridgeEmitterEvents(): void {\n\t\t// Forward emitter events through our public EventService — useful\n\t\t// for testing / debugging.\n\t\tconst internal = this.emitter as NexusEventEmitter;\n\t\tif (typeof internal.onEmitterEvent === 'function') {\n\t\t\tinternal.onEmitterEvent((event: EmitterEvent) => {\n\t\t\t\t// Reserved for future log/metric integration.\n\t\t\t\tvoid event;\n\t\t\t});\n\t\t}\n\t}\n}",
+    "/**\n * `EventsModule` — drop-in module for adding pub/sub to a NexusJS app.\n *\n * Usage:\n *   // src/app/app.module.ts\n *   @Module({\n *     imports: [EventsModule.forRoot()],\n *   })\n *   export class AppModule {}\n *\n *   // any service\n *   @Injectable()\n *   class EmailListeners {\n *     constructor(@Inject(EventService.TOKEN) private events: EventService) {}\n *\n *     @OnEvent('user.created')\n *     async onUserCreated(p: { email: string }) {\n *       await sendEmail(p.email, 'welcome');\n *     }\n *   }\n *\n *   // bootstrap\n *   const app = new Application(AppModule);\n *   const events = app.container.resolve(EventService);\n *   scanForListeners(emailListenersInstance, events);\n *   await events.emit('user.created', { email: 'a@b.c' });\n */\n\nimport \"reflect-metadata\";\nimport { Module } from \"../core/decorators/module.js\";\nimport { EventService } from \"./event.service.js\";\nimport type { EventsConfig } from \"./types.js\";\n\n@Module({\n\tproviders: [\n\t\tEventService,\n\t\t{ provide: EventService.TOKEN, useExisting: EventService },\n\t],\n\texports: [EventService, EventService.TOKEN],\n})\nexport class EventsModule {\n\tstatic forRoot(config: EventsConfig = {}) {\n\t\t@Module({\n\t\t\tproviders: [\n\t\t\t\tEventService,\n\t\t\t\t{ provide: EventService.TOKEN, useExisting: EventService },\n\t\t\t\t{ provide: \"EVENTS_CONFIG\", useValue: config },\n\t\t\t],\n\t\t\texports: [EventService, EventService.TOKEN],\n\t\t})\n\t\tclass ConfiguredEventsModule {}\n\n\t\tObject.defineProperty(ConfiguredEventsModule, \"name\", {\n\t\t\tvalue: \"ConfiguredEventsModule\",\n\t\t});\n\n\t\treturn ConfiguredEventsModule;\n\t}\n}\n",
+    "/**\n * `@OnEvent(pattern)` — register a method as an event listener.\n *\n * Mirrors `@nestjs/event-emitter`. Pair with\n * `EventModule.scanForListeners(instance, service)` at boot to wire\n * up all decorated methods.\n *\n * Usage:\n *   @Injectable()\n *   class UserListeners {\n *     constructor(@Inject(EventService.TOKEN) private events: EventService) {}\n *\n *     @OnEvent('user.created')\n *     async onUserCreated(payload: { userId: string; email: string }) {\n *       await this.sendWelcome(payload.email);\n *     }\n *\n *     @OnEvent('user.*', { priority: 1 })\n *     async onAnyUser(payload: any) {\n *       // logger\n *     }\n *\n *     @OnEvent('order.shipped', { once: true })\n *     async onFirstShip(payload: any) {\n *       // ...\n *     }\n *   }\n */\n\nimport \"reflect-metadata\";\nimport type { EventService } from \"../event.service.js\";\nimport type { EventName, ListenerOptions, EventListener } from \"../types.js\";\n\nconst ON_EVENT_META = \"nexus:events:on-event\";\n\ninterface StoredHook {\n\tmethod: string;\n\tpattern: EventName;\n\toptions: ListenerOptions;\n}\n\n/**\n * Mark a method as an event listener.\n */\nexport function OnEvent(\n\tpattern: EventName,\n\toptions: ListenerOptions = {},\n): MethodDecorator {\n\treturn (target, propertyKey, descriptor) => {\n\t\tif (!descriptor || typeof descriptor.value !== \"function\") {\n\t\t\tthrow new Error(\"@OnEvent can only decorate methods.\");\n\t\t}\n\t\tconst ctor = target.constructor as object;\n\t\tconst hooks: StoredHook[] =\n\t\t\t(Reflect.getMetadata(ON_EVENT_META, ctor) as StoredHook[] | undefined) ??\n\t\t\t[];\n\t\thooks.push({ method: String(propertyKey), pattern, options });\n\t\tReflect.defineMetadata(ON_EVENT_META, hooks, ctor);\n\t};\n}\n\n/** Get the on-event hooks declared on a class. */\nexport function getOnEventHooks(target: unknown): StoredHook[] {\n\tconst ctor =\n\t\t(target as { constructor?: object }).constructor ?? (target as object);\n\treturn (\n\t\t(Reflect.getMetadata(ON_EVENT_META, ctor) as StoredHook[] | undefined) ?? []\n\t);\n}\n\n/**\n * Scan an instance for `@OnEvent` hooks and register them with the\n * `EventService`. Returns the assigned listener ids.\n */\nexport function scanForListeners(\n\tinstance: object,\n\tservice: EventService,\n): string[] {\n\tconst ids: string[] = [];\n\tfor (const h of getOnEventHooks(instance)) {\n\t\tconst fn = (instance as Record<string, unknown>)[h.method] as\n\t\t\t| EventListener\n\t\t\t| undefined;\n\t\tif (typeof fn !== \"function\") continue;\n\t\tconst id = service.on(h.pattern, fn.bind(instance), {\n\t\t\tpriority: h.options.priority,\n\t\t\tonce: h.options.once,\n\t\t\tif: h.options.if as\n\t\t\t\t| ((payload: any) => boolean | Promise<boolean>)\n\t\t\t\t| undefined,\n\t\t});\n\t\tids.push(id);\n\t}\n\treturn ids;\n}\n\n// Re-export.\nexport type { EventService };\n"
+  ],
+  "mappings": "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",
+  "debugId": "CC457D1178A415F864756E2164756E21",
+  "names": []
+}

package/dist/events/types.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Event System types — the public contract for `nexusjs/events`.
+ *
+ * Mirrors `@nestjs/event-emitter` and AdonisJS's emitter:
+ *   - `emit(name, payload)` to dispatch an event
+ *   - `@OnEvent(name)` to subscribe
+ *   - Wildcards: `*` (single segment) and `**` (multi-segment)
+ *   - Priorities (lower runs first; default 5)
+ *   - Guards (`if` predicate) for conditional handling
+ *   - Sync and async listeners
+ *
+ * The events module is separate from `nexusjs/core` and ships as its
+ * own bundle entry point.
+ */
+/**
+ * An event name. Convention: `domain.action` (e.g. `user.created`,
+ * `order.shipped`). Wildcards:
+ *
+ *   - star — matches a single segment (`user.star` → user.created)
+ *   - double-star — matches one or more segments (`star-star`)
+ *   - exact — matches only the literal name
+ */
+export type EventName = string;
+/** Listener priority. Lower runs first. Default: 5. */
+export type EventPriority = number;
+/** A listener function. Sync or async. */
+export type EventListener<T = unknown> = (payload: T) => void | Promise<void>;
+/** Options attached to a listener registration. */
+export interface ListenerOptions {
+    /** Lower runs first. Default: 5. */
+    priority?: EventPriority;
+    /** Skip this listener unless the predicate returns true. */
+    if?: (payload: any) => boolean | Promise<boolean>;
+    /** Mark the listener as a one-shot — auto-removed after the first match. */
+    once?: boolean;
+}
+/** Result of a single `emit()` call. */
+export interface EmitResult {
+    name: EventName;
+    /** Number of listeners that matched the pattern. */
+    matched: number;
+    /** Number of listeners that completed (sync or async) without throwing. */
+    completed: number;
+    /** Number of listeners that threw or rejected. */
+    failed: number;
+    /** Per-listener error messages (if any). */
+    errors: Array<{
+        listenerId: string;
+        listenerName: string;
+        error: string;
+    }>;
+}
+/**
+ * Emitter contract — every backend (we ship one for now: in-process)
+ * implements this. The `EventService` is the user-facing facade.
+ */
+export interface EventEmitter {
+    /** Register a listener. Returns the assigned listener id. */
+    on<T = unknown>(pattern: EventName, listener: EventListener<T>, options?: ListenerOptions): string;
+    /** Register a one-shot listener. Returns the assigned listener id. */
+    once<T = unknown>(pattern: EventName, listener: EventListener<T>, options?: Omit<ListenerOptions, "once">): string;
+    /** Remove a listener by id (or by pattern — all matching listeners). */
+    off(idOrPattern: string): number;
+    /** Emit an event. Returns the dispatch result. */
+    emit<T = unknown>(name: EventName, payload?: T): Promise<EmitResult>;
+    /** Synchronous variant — only awaits already-resolved listeners. */
+    emitSync<T = unknown>(name: EventName, payload?: T): EmitResult;
+    /** Number of registered listeners. */
+    listenerCount(pattern?: EventName): number;
+    /** List registered listeners (for debugging). */
+    listListeners(pattern?: EventName): Array<{
+        id: string;
+        pattern: string;
+        priority: EventPriority;
+        once: boolean;
+    }>;
+    /** Remove every listener. */
+    removeAllListeners(): void;
+}
+/** Internal events emitted by the emitter itself (not user-facing). */
+export type EmitterEvent = {
+    kind: "listener:registered";
+    id: string;
+    pattern: string;
+} | {
+    kind: "listener:removed";
+    id: string;
+} | {
+    kind: "listener:fired";
+    id: string;
+    pattern: string;
+    durationMs: number;
+} | {
+    kind: "listener:failed";
+    id: string;
+    pattern: string;
+    error: Error;
+} | {
+    kind: "listener:skipped";
+    id: string;
+    pattern: string;
+    reason: "guard" | "once" | "pattern";
+};
+export type EmitterEventListener = (event: EmitterEvent) => void | Promise<void>;
+export interface EventsConfig {
+    /**
+     * Maximum number of listeners that can be registered for a single
+     * pattern. Default: 10. Helps catch leaks.
+     */
+    maxListenersPerPattern?: number;
+    /**
+     * When true, `emit()` rejects (throws AggregateError-like) if any
+     * listener rejects. When false (default), errors are collected in
+     * `EmitResult.errors` and dispatch continues.
+     */
+    throwOnError?: boolean;
+    /** Default priority for new listeners. Default: 5. */
+    defaultPriority?: EventPriority;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/events/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/events/types.ts"],"names":[],"mappings":"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"}

package/dist/grpc/decorators.d.ts

@@ -0,0 +1,34 @@
+/**
+ * gRPC decorators.
+ *
+ *   @Injectable()
+ *   @GrpcService("UserService")
+ *   class UserServiceImpl {
+ *     @GrpcMethod("FindById")
+ *     async findById(request: { id: number }) {
+ *       return { name: "Alice", email: "alice@example.com" };
+ *     }
+ *   }
+ *
+ * The framework reads the metadata at start time and wires
+ * each method to the corresponding gRPC handler. The method
+ * name in the decorator must match the .proto file's method
+ * name (e.g. `FindById`, not `findById`).
+ */
+/**
+ * Mark a class as a gRPC service implementation. The `name`
+ * must match a `service` declaration in the .proto file.
+ */
+export declare function GrpcService(name: string): ClassDecorator;
+/**
+ * Mark a method as a gRPC handler. The `name` must match the
+ * method name in the .proto file. The method receives the
+ * request object and must return a `Promise<TResponse>` (for
+ * unary methods).
+ */
+export declare function GrpcMethod(name: string): MethodDecorator;
+/** Read the gRPC service name. Internal. */
+export declare function getGrpcServiceName(target: object): string | undefined;
+/** Read the bound method names for a gRPC service. Internal. */
+export declare function getGrpcMethodNames(target: object): Record<string, string>;
+//# sourceMappingURL=decorators.d.ts.map

package/dist/grpc/decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../src/grpc/decorators.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAKH;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAKxD;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAaxD;AAED,4CAA4C;AAC5C,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKrE;AAED,gEAAgE;AAChE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOzE"}

package/dist/grpc/index.d.ts

@@ -0,0 +1,70 @@
+/**
+ * `nexusjs/grpc` — gRPC integration for the Bun-native stack.
+ *
+ * Public API:
+ * - `GrpcService` — the main service. Owns the @grpc/grpc-js server
+ *   and the loaded proto definition.
+ * - `GrpcModule.forRoot(config)` — wires the service into the DI
+ *   container, registers service implementations, and prepares the
+ *   handlers. The user calls `start()` to bind the server to a
+ *   port.
+ * - `@GrpcService(name)` — class decorator marking an impl class.
+ * - `@GrpcMethod(name)` — method decorator binding a method to a
+ *   gRPC method declared in the `.proto` file.
+ * - `client<T>(name, { url })` — build a typed client for a gRPC
+ *   service. Methods return Promises.
+ *
+ * Optional peer dependencies:
+ *   - `@grpc/grpc-js` (^1.10.0)  — the server runtime
+ *   - `@grpc/proto-loader` (^0.7.0) — loads `.proto` files
+ *
+ * Install with:
+ *   bun add @grpc/grpc-js @grpc/proto-loader
+ *
+ * Quick start:
+ *
+ *   // user.proto
+ *   syntax = "proto3";
+ *   package user;
+ *   service UserService {
+ *     rpc FindById (UserRequest) returns (UserResponse);
+ *   }
+ *   message UserRequest { int32 id = 1; }
+ *   message UserResponse { string name = 1; string email = 2; }
+ *
+ *   // user.grpc.ts
+ *   @Injectable()
+ *   @GrpcService("UserService")
+ *   class UserServiceImpl {
+ *     @GrpcMethod("FindById")
+ *     async findById(req: { id: number }) {
+ *       return { name: "Alice", email: "alice@example.com" };
+ *     }
+ *   }
+ *
+ *   // app.module.ts
+ *   @Module({
+ *     imports: [GrpcModule.forRoot({
+ *       protoPath: "./proto/user.proto",
+ *       services: [UserServiceImpl],
+ *     })],
+ *   })
+ *   class AppModule {}
+ *
+ *   // main.ts
+ *   const app = new Application(AppModule);
+ *   const grpc = app.container.resolve(GrpcService);
+ *   await grpc.start();  // binds to 0.0.0.0:50051
+ *
+ *   // client usage (e.g. in another service)
+ *   const userClient = grpc.client<{ findById(req: { id: number }): Promise<{ name: string; email: string }> }>("UserService");
+ *   const user = await userClient.findById({ id: 1 });
+ *
+ * Unary methods only for v1. Streaming (server / client / bidi)
+ * is a future addition.
+ */
+export { GrpcService, GRPC_SERVICE_TOKEN } from "./service.js";
+export { GrpcModule } from "./module.js";
+export { GrpcService as GrpcServiceDecorator, GrpcMethod, getGrpcServiceName, getGrpcMethodNames, } from "./decorators.js";
+export type { GrpcConfig, GrpcMethodMeta, GrpcClient, GrpcClientOptions, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/grpc/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/grpc/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgEG;AAEH,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EACN,WAAW,IAAI,oBAAoB,EACnC,UAAU,EACV,kBAAkB,EAClB,kBAAkB,GAClB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACX,UAAU,EACV,cAAc,EACd,UAAU,EACV,iBAAiB,GACjB,MAAM,YAAY,CAAC"}