@kabyeon/nexusjs 0.6.5

package/dist/events/emitter.d.ts

@@ -0,0 +1,52 @@
+/**
+ * In-process event emitter with wildcard matching, priorities, and
+ * guards. Mirrors `@nestjs/event-emitter` and AdonisJS's emitter.
+ *
+ * Wildcards:
+ *   - star (single segment)        — `user.star` matches `user.created`
+ *   - double-star (multi segment)  — `star-star` matches `user.created` and `user.profile.updated`
+ *   - exact                       — `user.created` matches only itself
+ *
+ * Priority: lower runs first (default 5). When two listeners have the
+ * same priority, registration order is preserved (FIFO).
+ *
+ * Guards: a listener can register an `if(payload) → boolean` predicate;
+ * when it returns false, the listener is skipped.
+ *
+ * Errors: by default, a throwing listener does NOT stop the rest of
+ * the dispatch — errors are collected in `EmitResult.errors`. Set
+ * `EventsConfig.throwOnError: true` to make `emit()` reject instead.
+ */
+import type { EventName, EventPriority, EventListener, ListenerOptions, EmitResult, EventEmitter, EmitterEventListener, EventsConfig } from "./types.js";
+export declare class NexusEventEmitter implements EventEmitter {
+    #private;
+    constructor(config?: EventsConfig);
+    on<T = unknown>(pattern: EventName, listener: EventListener<T>, options?: ListenerOptions): string;
+    once<T = unknown>(pattern: EventName, listener: EventListener<T>, options?: Omit<ListenerOptions, "once">): string;
+    off(idOrPattern: string): number;
+    emit<T = unknown>(name: EventName, payload?: T): Promise<EmitResult>;
+    emitSync<T = unknown>(name: EventName, payload?: T): EmitResult;
+    listenerCount(pattern?: EventName): number;
+    listListeners(pattern?: EventName): Array<{
+        id: string;
+        pattern: string;
+        priority: EventPriority;
+        once: boolean;
+    }>;
+    removeAllListeners(): void;
+    /** Subscribe to emitter-internal events (registration, firing, etc.). */
+    onEmitterEvent(listener: EmitterEventListener): () => void;
+}
+/**
+ * Compile an event-name pattern into a RegExp. `null` means exact
+ * match (no wildcards).
+ *
+ * Strategy:
+ *   1. Replace `**` and `*` with sentinel placeholders that survive
+ *      regex escaping.
+ *   2. Escape all other regex metacharacters.
+ *   3. Replace placeholders with the actual regex fragments
+ *      (`**` → `.*`, `*` → `[^.]+`).
+ */
+export declare function compilePattern(pattern: string): RegExp | null;
+//# sourceMappingURL=emitter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"emitter.d.ts","sourceRoot":"","sources":["../../src/events/emitter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EACX,SAAS,EACT,aAAa,EACb,aAAa,EACb,eAAe,EACf,UAAU,EACV,YAAY,EAEZ,oBAAoB,EACpB,YAAY,EACZ,MAAM,YAAY,CAAC;AAapB,qBAAa,iBAAkB,YAAW,YAAY;;gBAQzC,MAAM,GAAE,YAAiB;IAUrC,EAAE,CAAC,CAAC,GAAG,OAAO,EACb,OAAO,EAAE,SAAS,EAClB,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAC1B,OAAO,GAAE,eAAoB,GAC3B,MAAM;IA8BT,IAAI,CAAC,CAAC,GAAG,OAAO,EACf,OAAO,EAAE,SAAS,EAClB,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAC1B,OAAO,GAAE,IAAI,CAAC,eAAe,EAAE,MAAM,CAAM,GACzC,MAAM;IAIT,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAc1B,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;IAmF1E,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG,UAAU;IAuE/D,aAAa,CAAC,OAAO,CAAC,EAAE,SAAS,GAAG,MAAM;IAK1C,aAAa,CAAC,OAAO,CAAC,EAAE,SAAS,GAAG,KAAK,CAAC;QACzC,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,aAAa,CAAC;QACxB,IAAI,EAAE,OAAO,CAAC;KACd,CAAC;IAaF,kBAAkB,IAAI,IAAI;IAQ1B,yEAAyE;IACzE,cAAc,CAAC,QAAQ,EAAE,oBAAoB,GAAG,MAAM,IAAI;CAiC1D;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAa7D"}

package/dist/events/event.service.d.ts

@@ -0,0 +1,27 @@
+/**
+ * `EventService` — DI-friendly facade over the emitter.
+ *
+ * Controllers and services inject this to emit events. Listeners
+ * can either:
+ *   - Call `event.on(pattern, fn)` directly
+ *   - Use the `@OnEvent(pattern)` decorator + `scanForListeners`
+ */
+import type { EventEmitter, EventListener, EventName, EmitResult, ListenerOptions, EventsConfig, EmitterEventListener } from './types.js';
+export declare class EventService {
+    #private;
+    private readonly config;
+    /** DI token — use with `@Inject(EventService.TOKEN)`. */
+    static readonly TOKEN: unique symbol;
+    readonly emitter: EventEmitter;
+    constructor(config?: EventsConfig);
+    on<T = unknown>(pattern: EventName, listener: EventListener<T>, options?: ListenerOptions): string;
+    once<T = unknown>(pattern: EventName, listener: EventListener<T>, options?: Omit<ListenerOptions, 'once'>): string;
+    off(idOrPattern: string): number;
+    emit<T = unknown>(name: EventName, payload?: T): Promise<EmitResult>;
+    emitSync<T = unknown>(name: EventName, payload?: T): EmitResult;
+    listenerCount(pattern?: EventName): number;
+    listListeners(pattern?: EventName): ReturnType<EventEmitter['listListeners']>;
+    removeAllListeners(): void;
+    onEmitterEvent(listener: EmitterEventListener): () => void;
+}
+//# sourceMappingURL=event.service.d.ts.map

package/dist/events/event.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.service.d.ts","sourceRoot":"","sources":["../../src/events/event.service.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,EACX,YAAY,EACZ,aAAa,EACb,SAAS,EACT,UAAU,EACV,eAAe,EACf,YAAY,EAEZ,oBAAoB,EACpB,MAAM,YAAY,CAAC;AAEpB,qBACa,YAAY;;IAMa,OAAO,CAAC,QAAQ,CAAC,MAAM;IAL5D,yDAAyD;IACzD,MAAM,CAAC,QAAQ,CAAC,KAAK,gBAAoC;IAEzD,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;gBAEuB,MAAM,GAAE,YAAiB;IAQ/E,EAAE,CAAC,CAAC,GAAG,OAAO,EACb,OAAO,EAAE,SAAS,EAClB,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAC1B,OAAO,CAAC,EAAE,eAAe,GACvB,MAAM;IAIT,IAAI,CAAC,CAAC,GAAG,OAAO,EACf,OAAO,EAAE,SAAS,EAClB,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAC1B,OAAO,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,MAAM,CAAC,GACrC,MAAM;IAIT,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAIhC,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;IAIpE,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG,UAAU;IAI/D,aAAa,CAAC,OAAO,CAAC,EAAE,SAAS,GAAG,MAAM;IAI1C,aAAa,CAAC,OAAO,CAAC,EAAE,SAAS,GAAG,UAAU,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC;IAI7E,kBAAkB,IAAI,IAAI;IAI1B,cAAc,CAAC,QAAQ,EAAE,oBAAoB,GAAG,MAAM,IAAI;CAuB1D"}

package/dist/events/events.module.d.ts

@@ -0,0 +1,35 @@
+/**
+ * `EventsModule` — drop-in module for adding pub/sub to a NexusJS app.
+ *
+ * Usage:
+ *   // src/app/app.module.ts
+ *   @Module({
+ *     imports: [EventsModule.forRoot()],
+ *   })
+ *   export class AppModule {}
+ *
+ *   // any service
+ *   @Injectable()
+ *   class EmailListeners {
+ *     constructor(@Inject(EventService.TOKEN) private events: EventService) {}
+ *
+ *     @OnEvent('user.created')
+ *     async onUserCreated(p: { email: string }) {
+ *       await sendEmail(p.email, 'welcome');
+ *     }
+ *   }
+ *
+ *   // bootstrap
+ *   const app = new Application(AppModule);
+ *   const events = app.container.resolve(EventService);
+ *   scanForListeners(emailListenersInstance, events);
+ *   await events.emit('user.created', { email: 'a@b.c' });
+ */
+import "reflect-metadata";
+import type { EventsConfig } from "./types.js";
+export declare class EventsModule {
+    static forRoot(config?: EventsConfig): {
+        new (): {};
+    };
+}
+//# sourceMappingURL=events.module.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"events.module.d.ts","sourceRoot":"","sources":["../../src/events/events.module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,kBAAkB,CAAC;AAG1B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,qBAOa,YAAY;IACxB,MAAM,CAAC,OAAO,CAAC,MAAM,GAAE,YAAiB;;;CAiBxC"}

package/dist/events/index.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Public API for the NexusJS events module.
+ *
+ * Mirrors `@nestjs/event-emitter` and AdonisJS's emitter:
+ *   - `emit(name, payload)` to dispatch
+ *   - `@OnEvent(pattern)` to subscribe
+ *   - Wildcards: `*` (single segment) and `**` (multi-segment)
+ *   - Priorities, guards, one-shot listeners
+ *
+ * Quick start:
+ *
+ *   // src/app/app.module.ts
+ *   import { Module } from 'nexusjs';
+ *   import { EventsModule } from 'nexusjs/events';
+ *
+ *   @Module({ imports: [EventsModule.forRoot()] })
+ *   export class AppModule {}
+ *
+ *   // any service
+ *   import { EventService, OnEvent, scanForListeners } from 'nexusjs/events';
+ *
+ *   @Injectable()
+ *   class EmailListeners {
+ *     constructor(@Inject(EventService.TOKEN) private events: EventService) {}
+ *
+ *     @OnEvent('user.created')
+ *     async onUserCreated(p: { userId: string; email: string }) {
+ *       await this.sendWelcome(p.email);
+ *     }
+ *   }
+ *
+ *   // bootstrap
+ *   const app = new Application(AppModule);
+ *   const events = app.container.resolve(EventService);
+ *   scanForListeners(emailListenersInstance, events);
+ *   await events.emit('user.created', { userId: '1', email: 'a@b.c' });
+ */
+export * from "./types.js";
+export { NexusEventEmitter, compilePattern } from "./emitter.js";
+export { EventService } from "./event.service.js";
+export { EventsModule } from "./events.module.js";
+export { OnEvent, scanForListeners, getOnEventHooks, } from "./decorators/on-event.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EACN,OAAO,EACP,gBAAgB,EAChB,eAAe,GACf,MAAM,0BAA0B,CAAC"}