@rudderjs/core 0.0.8

package/dist/di.js

@@ -0,0 +1,228 @@
+import 'reflect-metadata';
+let _AsyncLocalStorage;
+if (typeof globalThis.process !== 'undefined') {
+    import(/* @vite-ignore */ 'node:async_hooks').then(m => { _AsyncLocalStorage = m.AsyncLocalStorage; }).catch(() => { });
+}
+// ─── Decorators ────────────────────────────────────────────
+const INJECTABLE_METADATA = 'rudderjs:injectable';
+const INJECT_METADATA = 'rudderjs:inject';
+/** Mark a class as injectable (auto-resolved by the container) */
+export function Injectable() {
+    return target => {
+        Reflect.defineMetadata(INJECTABLE_METADATA, true, target);
+    };
+}
+/** Inject a specific token into a constructor parameter */
+export function Inject(token) {
+    return (target, _, index) => {
+        const existing = Reflect.getMetadata(INJECT_METADATA, target) ?? [];
+        Reflect.defineMetadata(INJECT_METADATA, [...existing, { index, token }], target);
+    };
+}
+// ─── Container ─────────────────────────────────────────────
+export class Container {
+    bindings = new Map();
+    instances = new Map();
+    aliases = new Map();
+    // ── Scoped bindings (per-request via ALS) ─────────────────
+    // Lazy-initialized so the class can be loaded in the browser bundle without
+    // triggering a node:async_hooks import error.
+    _scopeAlsInstance = null;
+    get _scopeAls() {
+        if (!this._scopeAlsInstance) {
+            if (!_AsyncLocalStorage) {
+                throw new Error('[RudderJS] AsyncLocalStorage is not available — runScoped() and scoped bindings require Node.js (node:async_hooks).');
+            }
+            this._scopeAlsInstance = new _AsyncLocalStorage();
+        }
+        return this._scopeAlsInstance;
+    }
+    // ── Contextual bindings ───────────────────────────────────
+    _contextual = new Map();
+    // ── Missing handler (for deferred providers) ──────────────
+    _missingHandler = null;
+    reset() {
+        this.bindings.clear();
+        this.instances.clear();
+        this.aliases.clear();
+        this._contextual.clear();
+        this._missingHandler = null;
+        return this;
+    }
+    bind(token, factory) {
+        this.bindings.set(this.toToken(token), { factory, singleton: false });
+        return this;
+    }
+    singleton(token, factory) {
+        this.bindings.set(this.toToken(token), { factory, singleton: true });
+        return this;
+    }
+    /**
+     * Register a scoped binding — like singleton but per-request.
+     * The factory runs once per `runScoped()` call and is cached for that scope.
+     */
+    scoped(token, factory) {
+        this.bindings.set(this.toToken(token), { factory, singleton: false, scoped: true });
+        return this;
+    }
+    /**
+     * Execute `fn` inside a fresh scope. Scoped bindings resolved within
+     * this call are cached and automatically discarded when `fn` completes.
+     */
+    runScoped(fn) {
+        return this._scopeAls.run(new Map(), fn);
+    }
+    instance(token, value) {
+        const key = this.toToken(token);
+        this.instances.set(key, value);
+        return this;
+    }
+    alias(from, to) {
+        this.aliases.set(from, to);
+        return this;
+    }
+    make(token) {
+        const key = this.resolveAlias(this.toToken(token));
+        if (this.instances.has(key)) {
+            return this.instances.get(key);
+        }
+        const binding = this.bindings.get(key);
+        if (binding) {
+            // Scoped binding: cache per-request in ALS store
+            if (binding.scoped) {
+                const scope = this._scopeAls.getStore();
+                if (!scope) {
+                    throw new Error(`[RudderJS] Cannot resolve scoped binding outside of a request scope.\n` +
+                        `  Wrap the call in container.runScoped() or add ScopeMiddleware().`);
+                }
+                if (scope.has(key))
+                    return scope.get(key);
+                const value = binding.factory(this);
+                scope.set(key, value);
+                return value;
+            }
+            const value = binding.factory(this);
+            if (binding.singleton)
+                this.instances.set(key, value);
+            return value;
+        }
+        if (typeof token === 'function') {
+            return this.autoResolve(token);
+        }
+        // Deferred provider hook — give the missing handler a chance to register the binding
+        if (this._missingHandler) {
+            this._missingHandler(key);
+            // Retry after handler may have registered the binding
+            if (this.instances.has(key))
+                return this.instances.get(key);
+            const retryBinding = this.bindings.get(key);
+            if (retryBinding) {
+                const value = retryBinding.factory(this);
+                if (retryBinding.singleton)
+                    this.instances.set(key, value);
+                return value;
+            }
+        }
+        const label = typeof key === 'symbol' ? key.toString() : `"${String(key)}"`;
+        throw new Error(`[RudderJS] Cannot resolve ${label} from the DI container.\n` +
+            `  Did you forget to add @Injectable() to the class, or register it in a ServiceProvider?`);
+    }
+    has(token) {
+        const key = this.resolveAlias(this.toToken(token));
+        return this.bindings.has(key) || this.instances.has(key);
+    }
+    forget(token) {
+        const key = this.toToken(token);
+        this.bindings.delete(key);
+        this.instances.delete(key);
+        return this;
+    }
+    /**
+     * Set a handler called when `make()` cannot find a binding.
+     * Used by Application to lazily boot deferred providers.
+     */
+    setMissingHandler(fn) {
+        this._missingHandler = fn;
+        return this;
+    }
+    /**
+     * Contextual binding — when resolving `concrete`, override a dependency.
+     *
+     * @example
+     * container.when(PhotoController).needs('storage').give(() => new S3Storage())
+     */
+    when(concrete) {
+        return new ContextualBindingBuilder(this, concrete);
+    }
+    /** @internal — called by ContextualBindingBuilder */
+    _addContextualBinding(concrete, need, factory) {
+        const name = this.toToken(concrete);
+        let map = this._contextual.get(name);
+        if (!map) {
+            map = new Map();
+            this._contextual.set(name, map);
+        }
+        map.set(need, factory);
+    }
+    autoResolve(target) {
+        if (typeof Reflect === 'undefined' || typeof Reflect.getMetadata !== 'function') {
+            throw new Error(`[RudderJS] reflect-metadata is not loaded.\n` +
+                `  Add: import 'reflect-metadata' at the top of your bootstrap/app.ts`);
+        }
+        const isInjectable = Reflect.getMetadata(INJECTABLE_METADATA, target);
+        if (!isInjectable) {
+            throw new Error(`[RudderJS] "${target.name}" is not decorated with @Injectable().\n` +
+                `  Add @Injectable() above the class declaration to enable auto-resolution.`);
+        }
+        const paramTypes = Reflect.getMetadata('design:paramtypes', target) ?? [];
+        const tokenOverrides = Reflect.getMetadata(INJECT_METADATA, target) ?? [];
+        // Check contextual bindings for this target class
+        const ctxMap = this._contextual.get(target.name);
+        const args = paramTypes.map((type, i) => {
+            const override = tokenOverrides.find(o => o.index === i);
+            const needToken = override ? override.token : this.toToken(type);
+            // Contextual override takes priority
+            if (ctxMap) {
+                const ctxFactory = ctxMap.get(needToken);
+                if (ctxFactory)
+                    return ctxFactory(this);
+            }
+            return override ? this.make(override.token) : this.make(type);
+        });
+        return new target(...args);
+    }
+    toToken(token) {
+        return typeof token === 'function' ? token.name : token;
+    }
+    resolveAlias(key) {
+        if (typeof key === 'string') {
+            return this.aliases.get(key) ?? key;
+        }
+        return key;
+    }
+}
+// ─── Contextual Binding Builder ───────────────────────────
+export class ContextualBindingBuilder {
+    _container;
+    _concrete;
+    constructor(_container, _concrete) {
+        this._container = _container;
+        this._concrete = _concrete;
+    }
+    needs(token) {
+        return {
+            give: (factoryOrValue) => {
+                const factory = typeof factoryOrValue === 'function'
+                    ? (c) => factoryOrValue(c)
+                    : () => factoryOrValue;
+                this._container._addContextualBinding(this._concrete, resolveToken(token), factory);
+            },
+        };
+    }
+}
+function resolveToken(token) {
+    return typeof token === 'function' ? token.name : token;
+}
+// ─── Global container singleton ────────────────────────────
+export const container = new Container();
+//# sourceMappingURL=di.js.map

package/dist/di.js.map

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

package/dist/events-fake.d.ts

@@ -0,0 +1,40 @@
+export interface DispatchedEvent {
+    event: string;
+    payload: unknown;
+}
+/**
+ * Testing fake for @rudderjs/core events.
+ *
+ * Replaces the global EventDispatcher's dispatch method to record events
+ * without invoking real listeners.
+ *
+ * @example
+ * const fake = EventFake.fake()
+ *
+ * await dispatch(new UserRegistered(user))
+ *
+ * fake.assertDispatched('UserRegistered')
+ * fake.assertDispatchedTimes('UserRegistered', 1)
+ * fake.restore()
+ */
+export declare class EventFake {
+    private readonly _dispatched;
+    private readonly _originalDispatch;
+    constructor();
+    /** Assert that an event was dispatched, optionally matching a predicate on the payload. */
+    assertDispatched(event: string, predicate?: (payload: unknown) => boolean): void;
+    /** Assert that an event was dispatched exactly N times. */
+    assertDispatchedTimes(event: string, count: number): void;
+    /** Assert that an event was NOT dispatched. */
+    assertNotDispatched(event: string): void;
+    /** Assert that nothing was dispatched. */
+    assertNothingDispatched(): void;
+    /** Get all dispatched events, optionally filtered by event name. */
+    dispatched(event?: string): DispatchedEvent[];
+    /** Restore the original EventDispatcher.dispatch() method. */
+    restore(): void;
+    /** Install the fake — replaces dispatcher.dispatch() to record instead of invoking listeners. */
+    static fake(): EventFake;
+    private _matching;
+}
+//# sourceMappingURL=events-fake.d.ts.map

package/dist/events-fake.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events-fake.d.ts","sourceRoot":"","sources":["../src/events-fake.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,OAAO,CAAA;CACjB;AAID;;;;;;;;;;;;;;GAcG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAwB;IACpD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA6B;;IAQ/D,2FAA2F;IAC3F,gBAAgB,CACd,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,GACxC,IAAI;IAQP,2DAA2D;IAC3D,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IASzD,+CAA+C;IAC/C,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IASxC,0CAA0C;IAC1C,uBAAuB,IAAI,IAAI;IAU/B,oEAAoE;IACpE,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,eAAe,EAAE;IAO7C,8DAA8D;IAC9D,OAAO,IAAI,IAAI;IAMf,iGAAiG;IACjG,MAAM,CAAC,IAAI,IAAI,SAAS;IAaxB,OAAO,CAAC,SAAS;CAUlB"}

package/dist/events-fake.js

@@ -0,0 +1,78 @@
+import assert from 'node:assert/strict';
+import { dispatcher } from './events.js';
+// ─── Event Fake ────────────────────────────────────────────
+/**
+ * Testing fake for @rudderjs/core events.
+ *
+ * Replaces the global EventDispatcher's dispatch method to record events
+ * without invoking real listeners.
+ *
+ * @example
+ * const fake = EventFake.fake()
+ *
+ * await dispatch(new UserRegistered(user))
+ *
+ * fake.assertDispatched('UserRegistered')
+ * fake.assertDispatchedTimes('UserRegistered', 1)
+ * fake.restore()
+ */
+export class EventFake {
+    _dispatched = [];
+    _originalDispatch;
+    constructor() {
+        this._originalDispatch = dispatcher.dispatch.bind(dispatcher);
+    }
+    // ─── Assertions ──────────────────────────────────────────
+    /** Assert that an event was dispatched, optionally matching a predicate on the payload. */
+    assertDispatched(event, predicate) {
+        const matching = this._matching(event, predicate);
+        assert.ok(matching.length > 0, `[RudderJS Event] Expected event "${event}" to be dispatched, but it was not.`);
+    }
+    /** Assert that an event was dispatched exactly N times. */
+    assertDispatchedTimes(event, count) {
+        const matching = this._matching(event);
+        assert.strictEqual(matching.length, count, `[RudderJS Event] Expected event "${event}" to be dispatched ${count} time(s), but it was dispatched ${matching.length} time(s).`);
+    }
+    /** Assert that an event was NOT dispatched. */
+    assertNotDispatched(event) {
+        const matching = this._matching(event);
+        assert.strictEqual(matching.length, 0, `[RudderJS Event] Expected event "${event}" not to be dispatched, but it was dispatched ${matching.length} time(s).`);
+    }
+    /** Assert that nothing was dispatched. */
+    assertNothingDispatched() {
+        assert.strictEqual(this._dispatched.length, 0, `[RudderJS Event] Expected no events to be dispatched, but ${this._dispatched.length} were dispatched.`);
+    }
+    // ─── Access ──────────────────────────────────────────────
+    /** Get all dispatched events, optionally filtered by event name. */
+    dispatched(event) {
+        if (!event)
+            return [...this._dispatched];
+        return this._dispatched.filter((entry) => entry.event === event);
+    }
+    // ─── Cleanup ─────────────────────────────────────────────
+    /** Restore the original EventDispatcher.dispatch() method. */
+    restore() {
+        dispatcher.dispatch = this._originalDispatch;
+    }
+    // ─── Install ─────────────────────────────────────────────
+    /** Install the fake — replaces dispatcher.dispatch() to record instead of invoking listeners. */
+    static fake() {
+        const fake = new EventFake();
+        dispatcher.dispatch = async (event) => {
+            const name = event.constructor.name;
+            fake._dispatched.push({ event: name, payload: event });
+        };
+        return fake;
+    }
+    // ─── Internal ────────────────────────────────────────────
+    _matching(event, predicate) {
+        return this._dispatched.filter((entry) => {
+            if (entry.event !== event)
+                return false;
+            if (predicate && !predicate(entry.payload))
+                return false;
+            return true;
+        });
+    }
+}
+//# sourceMappingURL=events-fake.js.map

package/dist/events-fake.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events-fake.js","sourceRoot":"","sources":["../src/events-fake.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAA;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAUxC,8DAA8D;AAE9D;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,SAAS;IACH,WAAW,GAAsB,EAAE,CAAA;IACnC,iBAAiB,CAA6B;IAE/D;QACE,IAAI,CAAC,iBAAiB,GAAG,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IAC/D,CAAC;IAED,4DAA4D;IAE5D,2FAA2F;IAC3F,gBAAgB,CACd,KAAa,EACb,SAAyC;QAEzC,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,CAAA;QACjD,MAAM,CAAC,EAAE,CACP,QAAQ,CAAC,MAAM,GAAG,CAAC,EACnB,oCAAoC,KAAK,qCAAqC,CAC/E,CAAA;IACH,CAAC;IAED,2DAA2D;IAC3D,qBAAqB,CAAC,KAAa,EAAE,KAAa;QAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;QACtC,MAAM,CAAC,WAAW,CAChB,QAAQ,CAAC,MAAM,EACf,KAAK,EACL,oCAAoC,KAAK,sBAAsB,KAAK,mCAAmC,QAAQ,CAAC,MAAM,WAAW,CAClI,CAAA;IACH,CAAC;IAED,+CAA+C;IAC/C,mBAAmB,CAAC,KAAa;QAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;QACtC,MAAM,CAAC,WAAW,CAChB,QAAQ,CAAC,MAAM,EACf,CAAC,EACD,oCAAoC,KAAK,iDAAiD,QAAQ,CAAC,MAAM,WAAW,CACrH,CAAA;IACH,CAAC;IAED,0CAA0C;IAC1C,uBAAuB;QACrB,MAAM,CAAC,WAAW,CAChB,IAAI,CAAC,WAAW,CAAC,MAAM,EACvB,CAAC,EACD,6DAA6D,IAAI,CAAC,WAAW,CAAC,MAAM,mBAAmB,CACxG,CAAA;IACH,CAAC;IAED,4DAA4D;IAE5D,oEAAoE;IACpE,UAAU,CAAC,KAAc;QACvB,IAAI,CAAC,KAAK;YAAE,OAAO,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,CAAA;QACxC,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,CAAA;IAClE,CAAC;IAED,4DAA4D;IAE5D,8DAA8D;IAC9D,OAAO;QACL,UAAU,CAAC,QAAQ,GAAG,IAAI,CAAC,iBAAiB,CAAA;IAC9C,CAAC;IAED,4DAA4D;IAE5D,iGAAiG;IACjG,MAAM,CAAC,IAAI;QACT,MAAM,IAAI,GAAG,IAAI,SAAS,EAAE,CAAA;QAE5B,UAAU,CAAC,QAAQ,GAAG,KAAK,EAAoB,KAAQ,EAAiB,EAAE;YACxE,MAAM,IAAI,GAAG,KAAK,CAAC,WAAW,CAAC,IAAI,CAAA;YACnC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAA;QACxD,CAAC,CAAA;QAED,OAAO,IAAI,CAAA;IACb,CAAC;IAED,4DAA4D;IAEpD,SAAS,CACf,KAAa,EACb,SAAyC;QAEzC,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;YACvC,IAAI,KAAK,CAAC,KAAK,KAAK,KAAK;gBAAE,OAAO,KAAK,CAAA;YACvC,IAAI,SAAS,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC;gBAAE,OAAO,KAAK,CAAA;YACxD,OAAO,IAAI,CAAA;QACb,CAAC,CAAC,CAAA;IACJ,CAAC;CACF"}

package/dist/events.d.ts

@@ -0,0 +1,40 @@
+import type { Application } from './index.js';
+import { ServiceProvider } from './service-provider.js';
+export interface Listener<T = unknown> {
+    handle(event: T): void | Promise<void>;
+}
+export declare class EventDispatcher {
+    private readonly map;
+    /**
+     * Register one or more listeners for an event class name.
+     * Use `'*'` to listen to every dispatched event.
+     */
+    register(eventName: string, ...listeners: Listener<unknown>[]): void;
+    /**
+     * Dispatch an event to all matching listeners, then to wildcard (`'*'`) listeners.
+     * Listeners are awaited in registration order.
+     */
+    dispatch<T extends object>(event: T): Promise<void>;
+    /** Number of listeners registered for a given event name (or `'*'`). */
+    count(eventName: string): number;
+    /** Returns true if at least one listener is registered for the event name. */
+    hasListeners(eventName: string): boolean;
+    /**
+     * Returns a snapshot of all registered event names and their listener counts.
+     * Useful for `event:list` commands and introspection.
+     */
+    list(): Record<string, number>;
+    /** @internal — clears all listeners. Used for testing and hot-reload. */
+    reset(): void;
+}
+export declare const dispatcher: EventDispatcher;
+/** Dispatch an event through the global dispatcher */
+export declare function dispatch<T extends object>(event: T): Promise<void>;
+/** Maps event class names to arrays of Listener classes */
+export type ListenMap = Record<string, (new () => Listener<never>)[]>;
+/**
+ * Returns an EventServiceProvider class that registers the given listener map
+ * into the global EventDispatcher on boot.
+ */
+export declare function events(listen: ListenMap): new (app: Application) => ServiceProvider;
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAIvD,MAAM,WAAW,QAAQ,CAAC,CAAC,GAAG,OAAO;IACnC,MAAM,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACvC;AAID,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAyC;IAE7D;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,GAAG,IAAI;IAKpE;;;OAGG;IACG,QAAQ,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IASzD,wEAAwE;IACxE,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAIhC,8EAA8E;IAC9E,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIxC;;;OAGG;IACH,IAAI,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAQ9B,yEAAyE;IACzE,KAAK,IAAI,IAAI;CAGd;AAID,eAAO,MAAM,UAAU,iBAAwB,CAAA;AAE/C,sDAAsD;AACtD,wBAAgB,QAAQ,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAElE;AAID,2DAA2D;AAC3D,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,UAAU,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAA;AAIrE;;;GAGG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,KAAK,GAAG,EAAE,WAAW,KAAK,eAAe,CAanF"}

package/dist/events.js

@@ -0,0 +1,72 @@
+import { ServiceProvider } from './service-provider.js';
+// ─── Event Dispatcher ──────────────────────────────────────
+export class EventDispatcher {
+    map = new Map();
+    /**
+     * Register one or more listeners for an event class name.
+     * Use `'*'` to listen to every dispatched event.
+     */
+    register(eventName, ...listeners) {
+        const existing = this.map.get(eventName) ?? [];
+        this.map.set(eventName, [...existing, ...listeners]);
+    }
+    /**
+     * Dispatch an event to all matching listeners, then to wildcard (`'*'`) listeners.
+     * Listeners are awaited in registration order.
+     */
+    async dispatch(event) {
+        const name = event.constructor.name;
+        const specific = this.map.get(name) ?? [];
+        const wildcards = this.map.get('*') ?? [];
+        for (const listener of [...specific, ...wildcards]) {
+            await listener.handle(event);
+        }
+    }
+    /** Number of listeners registered for a given event name (or `'*'`). */
+    count(eventName) {
+        return this.map.get(eventName)?.length ?? 0;
+    }
+    /** Returns true if at least one listener is registered for the event name. */
+    hasListeners(eventName) {
+        return this.count(eventName) > 0;
+    }
+    /**
+     * Returns a snapshot of all registered event names and their listener counts.
+     * Useful for `event:list` commands and introspection.
+     */
+    list() {
+        const result = {};
+        for (const [name, listeners] of this.map.entries()) {
+            result[name] = listeners.length;
+        }
+        return result;
+    }
+    /** @internal — clears all listeners. Used for testing and hot-reload. */
+    reset() {
+        this.map.clear();
+    }
+}
+// ─── Global Dispatcher Singleton ───────────────────────────
+export const dispatcher = new EventDispatcher();
+/** Dispatch an event through the global dispatcher */
+export function dispatch(event) {
+    return dispatcher.dispatch(event);
+}
+// ─── Service Provider Factory ──────────────────────────────
+/**
+ * Returns an EventServiceProvider class that registers the given listener map
+ * into the global EventDispatcher on boot.
+ */
+export function events(listen) {
+    class EventServiceProvider extends ServiceProvider {
+        register() { }
+        boot() {
+            for (const [eventName, listenerClasses] of Object.entries(listen)) {
+                const instances = listenerClasses.map((LC) => new LC());
+                dispatcher.register(eventName, ...instances);
+            }
+        }
+    }
+    return EventServiceProvider;
+}
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAQvD,8DAA8D;AAE9D,MAAM,OAAO,eAAe;IACT,GAAG,GAAG,IAAI,GAAG,EAA+B,CAAA;IAE7D;;;OAGG;IACH,QAAQ,CAAC,SAAiB,EAAE,GAAG,SAA8B;QAC3D,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAA;QAC9C,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,GAAG,QAAQ,EAAE,GAAG,SAAS,CAAC,CAAC,CAAA;IACtD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,QAAQ,CAAmB,KAAQ;QACvC,MAAM,IAAI,GAAQ,KAAK,CAAC,WAAW,CAAC,IAAI,CAAA;QACxC,MAAM,QAAQ,GAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAA;QAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,IAAK,EAAE,CAAA;QAC1C,KAAK,MAAM,QAAQ,IAAI,CAAC,GAAG,QAAQ,EAAE,GAAG,SAAS,CAAC,EAAE,CAAC;YACnD,MAAM,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QAC9B,CAAC;IACH,CAAC;IAED,wEAAwE;IACxE,KAAK,CAAC,SAAiB;QACrB,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC,CAAA;IAC7C,CAAC;IAED,8EAA8E;IAC9E,YAAY,CAAC,SAAiB;QAC5B,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAA;IAClC,CAAC;IAED;;;OAGG;IACH,IAAI;QACF,MAAM,MAAM,GAA2B,EAAE,CAAA;QACzC,KAAK,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC;YACnD,MAAM,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,MAAM,CAAA;QACjC,CAAC;QACD,OAAO,MAAM,CAAA;IACf,CAAC;IAED,yEAAyE;IACzE,KAAK;QACH,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAA;IAClB,CAAC;CACF;AAED,8DAA8D;AAE9D,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAA;AAE/C,sDAAsD;AACtD,MAAM,UAAU,QAAQ,CAAmB,KAAQ;IACjD,OAAO,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;AACnC,CAAC;AAOD,8DAA8D;AAE9D;;;GAGG;AACH,MAAM,UAAU,MAAM,CAAC,MAAiB;IACtC,MAAM,oBAAqB,SAAQ,eAAe;QAChD,QAAQ,KAAU,CAAC;QAEnB,IAAI;YACF,KAAK,MAAM,CAAC,SAAS,EAAE,eAAe,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAClE,MAAM,SAAS,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,CAAwB,CAAA;gBAC9E,UAAU,CAAC,QAAQ,CAAC,SAAS,EAAE,GAAG,SAAS,CAAC,CAAA;YAC9C,CAAC;QACH,CAAC;KACF;IAED,OAAO,oBAAoB,CAAA;AAC7B,CAAC"}

package/dist/exceptions.d.ts

@@ -0,0 +1,28 @@
+import type { AppRequest } from '@rudderjs/contracts';
+export declare class HttpException extends Error {
+    readonly statusCode: number;
+    readonly headers: Record<string, string>;
+    constructor(statusCode: number, message?: string, headers?: Record<string, string>);
+}
+export declare function abort(status: number, message?: string, headers?: Record<string, string>): never;
+export declare function abort_if(condition: boolean, status: number, message?: string, headers?: Record<string, string>): void;
+export declare function abort_unless(condition: boolean, status: number, message?: string, headers?: Record<string, string>): void;
+type ReporterFn = (err: unknown) => void;
+/**
+ * Override the global exception reporter.
+ *
+ * Called by `@rudderjs/log`'s service provider automatically when the log
+ * package is installed, routing all unhandled exceptions through the log
+ * channel. Can also be called in bootstrap/app.ts via `e.reportUsing(fn)`.
+ */
+export declare function setExceptionReporter(fn: ReporterFn): void;
+/** Report an exception to the configured reporter (default: console.error). */
+export declare function report(err: unknown): void;
+/** Conditionally report an exception. */
+export declare function report_if(condition: boolean, err: unknown): void;
+/** @internal — render an HttpException as a Response. */
+export declare function renderHttpException(err: HttpException, req: AppRequest): Response;
+/** @internal — render an unhandled error as a 500 Response. */
+export declare function renderServerError(req: AppRequest, debug: boolean, err: unknown): Response;
+export {};
+//# sourceMappingURL=exceptions.d.ts.map

package/dist/exceptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exceptions.d.ts","sourceRoot":"","sources":["../src/exceptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAmCrD,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;gBAGtC,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM;CAOvC;AAID,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,KAAK,CAE/F;AAED,wBAAgB,QAAQ,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAErH;AAED,wBAAgB,YAAY,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAEzH;AAID,KAAK,UAAU,GAAG,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAA;AAMxC;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,UAAU,GAAG,IAAI,CAEzD;AAED,+EAA+E;AAC/E,wBAAgB,MAAM,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAEzC;AAED,yCAAyC;AACzC,wBAAgB,SAAS,CAAC,SAAS,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CAEhE;AA2CD,yDAAyD;AACzD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,UAAU,GAAG,QAAQ,CAYjF;AAED,+DAA+D;AAC/D,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,GAAG,QAAQ,CAkBzF"}