@wild-framework/testing 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Wild Framework contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,39 @@
+# @wild-framework/testing
+
+Testing helpers for [Wild Framework](https://github.com/KhandaSoftware/wild-framework).
+
+Fakes and a test application builder so features can be tested without
+real infrastructure — mock events, queue, and mail via the container.
+
+## Install
+
+```bash
+pnpm add -D @wild-framework/testing
+```
+
+## Quick start
+
+```ts
+import { createTestApplication, FakeEventBus, FakeQueue, FakeMail } from "@wild-framework/testing";
+import { OrderService, OrderPlaced } from "./features/orders/index.js";
+import { OrderProvider } from "./features/orders/order-provider.js";
+
+const app = await createTestApplication({ providers: [OrderProvider] });
+
+const events = app.resolve(FakeEventBus);  // or FakeQueue / FakeMail
+await app.resolve(OrderService).place(...);
+
+expect(events.wasDispatched(OrderPlaced)).toBe(true);
+```
+
+## What it provides
+
+- **`FakeEventBus`** — captures dispatched events (`dispatchedOf`, `wasDispatched`, `dispatchCount`)
+- **`FakeQueue`** — captures dispatched jobs without running them
+- **`FakeMail`** — captures sent messages (`sentWithSubject`, `sentCount`)
+- **`createTestApplication()`** — boots a container-wired app and binds the
+  fakes under both the fake tokens and the real `EventBus`/`Queue`/`Mail`
+  tokens, so your feature code gets the fakes automatically
+
+Pass `realEvents: true`, `realQueue: true`, or `realMail: true` to use the
+real providers instead.

package/dist/create-test-application.d.ts

@@ -0,0 +1,30 @@
+import { type Application, type ProviderConstructor } from "@wild-framework/core";
+/**
+ * Options for the test application builder.
+ */
+export interface TestAppOptions {
+    /** Use the real EventProvider/EventBus instead of the fake. */
+    realEvents?: boolean;
+    /** Use the real QueueProvider/Queue instead of the fake. */
+    realQueue?: boolean;
+    /** Use the real MailProvider/Mail instead of the fake. */
+    realMail?: boolean;
+    /** Additional providers to register (e.g. your feature providers). */
+    providers?: ProviderConstructor[];
+}
+/**
+ * Build a booted application for testing.
+ *
+ * Binds `FakeEventBus`, `FakeQueue`, and `FakeMail` into the container
+ * (under both the fake token and the real `EventBus`/`Queue`/`Mail`
+ * tokens), so feature code uses the fakes and tests can resolve them:
+ *
+ * ```ts
+ * const app = await createTestApplication({ providers: [MyFeatureProvider] });
+ * const events = app.resolve(FakeEventBus);
+ * await myService.doSomething();
+ * expect(events.wasDispatched(UserRegistered)).toBe(true);
+ * ```
+ */
+export declare function createTestApplication(options?: TestAppOptions): Promise<Application>;
+//# sourceMappingURL=create-test-application.d.ts.map

package/dist/create-test-application.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-test-application.d.ts","sourceRoot":"","sources":["../src/create-test-application.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,WAAW,EAAiB,KAAK,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AASpH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B,+DAA+D;IAC/D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sEAAsE;IACtE,SAAS,CAAC,EAAE,mBAAmB,EAAE,CAAC;CACrC;AA+BD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,WAAW,CAAC,CAgC9F"}

package/dist/create-test-application.js

@@ -0,0 +1,81 @@
+import { createApplication } from "@wild-framework/core";
+import { ContainerProvider, Container } from "@wild-framework/container";
+import { EventProvider, EventBus } from "@wild-framework/events";
+import { QueueProvider, Queue } from "@wild-framework/queue";
+import { MailProvider, Mail } from "@wild-framework/mail";
+import { FakeEventBus } from "./fake-events.js";
+import { FakeQueue } from "./fake-queue.js";
+import { FakeMail } from "./fake-mail.js";
+/**
+ * A provider that binds the test fakes into the container, so feature
+ * code resolving `EventBus`/`Queue`/`Mail` gets the fake automatically.
+ *
+ * The class is declared inside `createTestApplication` so it closes over
+ * the fakes while still being a no-arg constructor (core instantiates
+ * providers with `new ProviderCtor()`).
+ */
+function fakeProviderFor(fakes) {
+    return class FakeProvider {
+        register(app) {
+            const container = app.resolve(Container);
+            if (fakes.events) {
+                container.singleton(EventBus, () => fakes.events);
+                container.singleton(FakeEventBus, () => fakes.events);
+            }
+            if (fakes.queue) {
+                container.singleton(Queue, () => fakes.queue);
+                container.singleton(FakeQueue, () => fakes.queue);
+            }
+            if (fakes.mail) {
+                container.singleton(Mail, () => fakes.mail);
+                container.singleton(FakeMail, () => fakes.mail);
+            }
+        }
+    };
+}
+/**
+ * Build a booted application for testing.
+ *
+ * Binds `FakeEventBus`, `FakeQueue`, and `FakeMail` into the container
+ * (under both the fake token and the real `EventBus`/`Queue`/`Mail`
+ * tokens), so feature code uses the fakes and tests can resolve them:
+ *
+ * ```ts
+ * const app = await createTestApplication({ providers: [MyFeatureProvider] });
+ * const events = app.resolve(FakeEventBus);
+ * await myService.doSomething();
+ * expect(events.wasDispatched(UserRegistered)).toBe(true);
+ * ```
+ */
+export async function createTestApplication(options = {}) {
+    const app = createApplication();
+    const fakes = {};
+    app.register(ContainerProvider);
+    if (options.realEvents) {
+        app.register(EventProvider);
+    }
+    else {
+        fakes.events = new FakeEventBus();
+    }
+    if (options.realQueue) {
+        app.register(QueueProvider);
+    }
+    else {
+        fakes.queue = new FakeQueue();
+    }
+    if (options.realMail) {
+        app.register(MailProvider);
+    }
+    else {
+        fakes.mail = new FakeMail();
+    }
+    if (!options.realEvents || !options.realQueue || !options.realMail) {
+        app.register(fakeProviderFor(fakes));
+    }
+    for (const provider of options.providers ?? []) {
+        app.register(provider);
+    }
+    await app.boot();
+    return app;
+}
+//# sourceMappingURL=create-test-application.js.map

package/dist/create-test-application.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-test-application.js","sourceRoot":"","sources":["../src/create-test-application.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAA6D,MAAM,sBAAsB,CAAC;AACpH,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAgB1C;;;;;;;GAOG;AACH,SAAS,eAAe,CAAC,KAAoE;IACzF,OAAO,MAAM,YAAY;QACrB,QAAQ,CAAC,GAAgB;YACrB,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAY,SAAS,CAAC,CAAC;YAEpD,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;gBACf,SAAS,CAAC,SAAS,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,MAA6B,CAAC,CAAC;gBACzE,SAAS,CAAC,SAAS,CAAC,YAAY,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,MAAsB,CAAC,CAAC;YAC1E,CAAC;YACD,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;gBACd,SAAS,CAAC,SAAS,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,KAAyB,CAAC,CAAC;gBAClE,SAAS,CAAC,SAAS,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,KAAkB,CAAC,CAAC;YACnE,CAAC;YACD,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;gBACb,SAAS,CAAC,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,IAAuB,CAAC,CAAC;gBAC/D,SAAS,CAAC,SAAS,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,IAAgB,CAAC,CAAC;YAChE,CAAC;QACL,CAAC;KACJ,CAAC;AACN,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,UAA0B,EAAE;IACpE,MAAM,GAAG,GAAG,iBAAiB,EAAE,CAAC;IAChC,MAAM,KAAK,GAAkE,EAAE,CAAC;IAEhF,GAAG,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC;IAEhC,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;QACrB,GAAG,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;IAChC,CAAC;SAAM,CAAC;QACJ,KAAK,CAAC,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;IACtC,CAAC;IACD,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACpB,GAAG,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;IAChC,CAAC;SAAM,CAAC;QACJ,KAAK,CAAC,KAAK,GAAG,IAAI,SAAS,EAAE,CAAC;IAClC,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACnB,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IAC/B,CAAC;SAAM,CAAC;QACJ,KAAK,CAAC,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAC;IAChC,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,UAAU,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QACjE,GAAG,CAAC,QAAQ,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,MAAM,QAAQ,IAAI,OAAO,CAAC,SAAS,IAAI,EAAE,EAAE,CAAC;QAC7C,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC3B,CAAC;IAED,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IACjB,OAAO,GAAG,CAAC;AACf,CAAC"}

package/dist/fake-events.d.ts

@@ -0,0 +1,26 @@
+/**
+ * A test double for the EventBus.
+ *
+ * Records dispatched events so tests can assert on them, instead of
+ * relying on side-effect listeners. Shares the same public shape as
+ * the real EventBus (`listen`, `dispatch`, `remove`, `has`).
+ */
+export declare class FakeEventBus {
+    private listeners;
+    private dispatched;
+    listen<T>(eventClass: new (...args: any[]) => T, listener: (event: T) => void | Promise<void>): void;
+    dispatch<T extends object>(event: T): Promise<void>;
+    remove<T>(eventClass: new (...args: any[]) => T, listener: (event: T) => void | Promise<void>): void;
+    has<T>(eventClass: new (...args: any[]) => T): boolean;
+    /** All dispatched events, in order. */
+    dispatchedEvents(): unknown[];
+    /** Dispatched events of a specific class. */
+    dispatchedOf<T>(eventClass: new (...args: any[]) => T): T[];
+    /** Whether a given event class was dispatched at least once. */
+    wasDispatched<T>(eventClass: new (...args: any[]) => T): boolean;
+    /** Number of events dispatched so far. */
+    dispatchCount(): number;
+    /** Reset captured state (keeps listeners). */
+    clear(): void;
+}
+//# sourceMappingURL=fake-events.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fake-events.d.ts","sourceRoot":"","sources":["../src/fake-events.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,qBAAa,YAAY;IACrB,OAAO,CAAC,SAAS,CAAyF;IAC1G,OAAO,CAAC,UAAU,CAA8E;IAEhG,MAAM,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAS9F,QAAQ,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAUzD,MAAM,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAIpG,GAAG,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,OAAO;IAQtD,uCAAuC;IACvC,gBAAgB,IAAI,OAAO,EAAE;IAI7B,6CAA6C;IAC7C,YAAY,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE;IAM3D,gEAAgE;IAChE,aAAa,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,OAAO;IAIhE,0CAA0C;IAC1C,aAAa,IAAI,MAAM;IAIvB,8CAA8C;IAC9C,KAAK,IAAI,IAAI;CAGhB"}

package/dist/fake-events.js

@@ -0,0 +1,60 @@
+/**
+ * A test double for the EventBus.
+ *
+ * Records dispatched events so tests can assert on them, instead of
+ * relying on side-effect listeners. Shares the same public shape as
+ * the real EventBus (`listen`, `dispatch`, `remove`, `has`).
+ */
+export class FakeEventBus {
+    listeners = new Map();
+    dispatched = [];
+    listen(eventClass, listener) {
+        let set = this.listeners.get(eventClass);
+        if (!set) {
+            set = new Set();
+            this.listeners.set(eventClass, set);
+        }
+        set.add(listener);
+    }
+    async dispatch(event) {
+        this.dispatched.push({ eventClass: event.constructor, event });
+        const listeners = this.listeners.get(event.constructor);
+        if (!listeners)
+            return;
+        for (const listener of listeners) {
+            await listener(event);
+        }
+    }
+    remove(eventClass, listener) {
+        this.listeners.get(eventClass)?.delete(listener);
+    }
+    has(eventClass) {
+        return (this.listeners.get(eventClass)?.size ?? 0) > 0;
+    }
+    // ------------------------------------------------------------------
+    // Test helpers
+    // ------------------------------------------------------------------
+    /** All dispatched events, in order. */
+    dispatchedEvents() {
+        return this.dispatched.map((d) => d.event);
+    }
+    /** Dispatched events of a specific class. */
+    dispatchedOf(eventClass) {
+        return this.dispatched
+            .filter((d) => d.eventClass === eventClass)
+            .map((d) => d.event);
+    }
+    /** Whether a given event class was dispatched at least once. */
+    wasDispatched(eventClass) {
+        return this.dispatched.some((d) => d.eventClass === eventClass);
+    }
+    /** Number of events dispatched so far. */
+    dispatchCount() {
+        return this.dispatched.length;
+    }
+    /** Reset captured state (keeps listeners). */
+    clear() {
+        this.dispatched = [];
+    }
+}
+//# sourceMappingURL=fake-events.js.map

package/dist/fake-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake-events.js","sourceRoot":"","sources":["../src/fake-events.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,OAAO,YAAY;IACb,SAAS,GAAG,IAAI,GAAG,EAA8E,CAAC;IAClG,UAAU,GAA2E,EAAE,CAAC;IAEhG,MAAM,CAAI,UAAqC,EAAE,QAA4C;QACzF,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACzC,IAAI,CAAC,GAAG,EAAE,CAAC;YACP,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;YAChB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QACxC,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,QAAQ,CAAmB,KAAQ;QACrC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,WAA8C,EAAE,KAAK,EAAE,CAAC,CAAC;QAElG,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,WAA8C,CAAC,CAAC;QAC3F,IAAI,CAAC,SAAS;YAAE,OAAO;QACvB,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YAC/B,MAAM,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;IACL,CAAC;IAED,MAAM,CAAI,UAAqC,EAAE,QAA4C;QACzF,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IACrD,CAAC;IAED,GAAG,CAAI,UAAqC;QACxC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IAC3D,CAAC;IAED,qEAAqE;IACrE,eAAe;IACf,qEAAqE;IAErE,uCAAuC;IACvC,gBAAgB;QACZ,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC/C,CAAC;IAED,6CAA6C;IAC7C,YAAY,CAAI,UAAqC;QACjD,OAAO,IAAI,CAAC,UAAU;aACjB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,UAAU,CAAC;aAC1C,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAU,CAAC,CAAC;IAClC,CAAC;IAED,gEAAgE;IAChE,aAAa,CAAI,UAAqC;QAClD,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC;IACpE,CAAC;IAED,0CAA0C;IAC1C,aAAa;QACT,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;IAClC,CAAC;IAED,8CAA8C;IAC9C,KAAK;QACD,IAAI,CAAC,UAAU,GAAG,EAAE,CAAC;IACzB,CAAC;CACJ"}

package/dist/fake-mail.d.ts

@@ -0,0 +1,21 @@
+import type { MailMessage } from "@wild-framework/mail";
+/**
+ * A test double for Mail — a real `Mail` facade backed by the
+ * in-memory driver, which captures messages instead of sending them.
+ */
+export declare class FakeMail {
+    private mail;
+    private driver;
+    constructor();
+    /** Delegate to the underlying Mail facade. */
+    send(message: MailMessage): Promise<void>;
+    /** Messages sent so far. */
+    sent(): MailMessage[];
+    /** Whether a message with the given subject was sent. */
+    sentWithSubject(subject: string): MailMessage | undefined;
+    /** Number of messages sent so far. */
+    sentCount(): number;
+    /** Reset captured state. */
+    clear(): void;
+}
+//# sourceMappingURL=fake-mail.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fake-mail.d.ts","sourceRoot":"","sources":["../src/fake-mail.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD;;;GAGG;AACH,qBAAa,QAAQ;IACjB,OAAO,CAAC,IAAI,CAAO;IACnB,OAAO,CAAC,MAAM,CAAqB;;IAOnC,8CAA8C;IAC9C,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAQzC,4BAA4B;IAC5B,IAAI,IAAI,WAAW,EAAE;IAIrB,yDAAyD;IACzD,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIzD,sCAAsC;IACtC,SAAS,IAAI,MAAM;IAInB,4BAA4B;IAC5B,KAAK,IAAI,IAAI;CAGhB"}

package/dist/fake-mail.js

@@ -0,0 +1,37 @@
+import { Mail, InMemoryMailDriver } from "@wild-framework/mail";
+/**
+ * A test double for Mail — a real `Mail` facade backed by the
+ * in-memory driver, which captures messages instead of sending them.
+ */
+export class FakeMail {
+    mail;
+    driver;
+    constructor() {
+        this.driver = new InMemoryMailDriver();
+        this.mail = new Mail(this.driver);
+    }
+    /** Delegate to the underlying Mail facade. */
+    send(message) {
+        return this.mail.send(message);
+    }
+    // ------------------------------------------------------------------
+    // Test helpers
+    // ------------------------------------------------------------------
+    /** Messages sent so far. */
+    sent() {
+        return [...this.driver.sent];
+    }
+    /** Whether a message with the given subject was sent. */
+    sentWithSubject(subject) {
+        return this.driver.sent.find((m) => m.subject === subject);
+    }
+    /** Number of messages sent so far. */
+    sentCount() {
+        return this.driver.sent.length;
+    }
+    /** Reset captured state. */
+    clear() {
+        this.driver.clear();
+    }
+}
+//# sourceMappingURL=fake-mail.js.map

package/dist/fake-mail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake-mail.js","sourceRoot":"","sources":["../src/fake-mail.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAGhE;;;GAGG;AACH,MAAM,OAAO,QAAQ;IACT,IAAI,CAAO;IACX,MAAM,CAAqB;IAEnC;QACI,IAAI,CAAC,MAAM,GAAG,IAAI,kBAAkB,EAAE,CAAC;QACvC,IAAI,CAAC,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC;IAED,8CAA8C;IAC9C,IAAI,CAAC,OAAoB;QACrB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAED,qEAAqE;IACrE,eAAe;IACf,qEAAqE;IAErE,4BAA4B;IAC5B,IAAI;QACA,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,yDAAyD;IACzD,eAAe,CAAC,OAAe;QAC3B,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC;IAC/D,CAAC;IAED,sCAAsC;IACtC,SAAS;QACL,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;IACnC,CAAC;IAED,4BAA4B;IAC5B,KAAK;QACD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;CACJ"}

package/dist/fake-queue.d.ts

@@ -0,0 +1,32 @@
+/**
+ * A test double for the Queue.
+ *
+ * Captures dispatched jobs instead of running them, so tests can assert
+ * on what was queued. Shares the same public `dispatch` shape as the
+ * real Queue.
+ */
+export interface FakeDispatchedJob<TPayload = unknown> {
+    job: new (...args: any[]) => {
+        handle(payload: TPayload): void | Promise<void>;
+    };
+    payload: TPayload;
+}
+export declare class FakeQueue {
+    private jobs;
+    dispatch<TPayload>(job: new (...args: any[]) => {
+        handle(payload: TPayload): void | Promise<void>;
+    }, payload: TPayload): Promise<void>;
+    /** All dispatched jobs, in order. */
+    dispatchedJobs(): FakeDispatchedJob[];
+    /** Dispatched jobs of a specific job class. */
+    dispatchedOf<TPayload>(jobClass: new (...args: any[]) => {
+        handle(payload: TPayload): void | Promise<void>;
+    }): FakeDispatchedJob<TPayload>[];
+    /** Whether a given job class was dispatched at least once. */
+    wasDispatched(jobClass: new (...args: any[]) => unknown): boolean;
+    /** Number of jobs dispatched so far. */
+    dispatchCount(): number;
+    /** Reset captured state. */
+    clear(): void;
+}
+//# sourceMappingURL=fake-queue.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fake-queue.d.ts","sourceRoot":"","sources":["../src/fake-queue.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB,CAAC,QAAQ,GAAG,OAAO;IACjD,GAAG,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK;QAAE,MAAM,CAAC,OAAO,EAAE,QAAQ,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAC;IACjF,OAAO,EAAE,QAAQ,CAAC;CACrB;AAED,qBAAa,SAAS;IAClB,OAAO,CAAC,IAAI,CAA2B;IAEjC,QAAQ,CAAC,QAAQ,EACnB,GAAG,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK;QAAE,MAAM,CAAC,OAAO,EAAE,QAAQ,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,EAChF,OAAO,EAAE,QAAQ,GAClB,OAAO,CAAC,IAAI,CAAC;IAQhB,qCAAqC;IACrC,cAAc,IAAI,iBAAiB,EAAE;IAIrC,+CAA+C;IAC/C,YAAY,CAAC,QAAQ,EACjB,QAAQ,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK;QAAE,MAAM,CAAC,OAAO,EAAE,QAAQ,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,GACtF,iBAAiB,CAAC,QAAQ,CAAC,EAAE;IAIhC,8DAA8D;IAC9D,aAAa,CAAC,QAAQ,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,GAAG,OAAO;IAIjE,wCAAwC;IACxC,aAAa,IAAI,MAAM;IAIvB,4BAA4B;IAC5B,KAAK,IAAI,IAAI;CAGhB"}

package/dist/fake-queue.js

@@ -0,0 +1,30 @@
+export class FakeQueue {
+    jobs = [];
+    async dispatch(job, payload) {
+        this.jobs.push({ job, payload });
+    }
+    // ------------------------------------------------------------------
+    // Test helpers
+    // ------------------------------------------------------------------
+    /** All dispatched jobs, in order. */
+    dispatchedJobs() {
+        return [...this.jobs];
+    }
+    /** Dispatched jobs of a specific job class. */
+    dispatchedOf(jobClass) {
+        return this.jobs.filter((j) => j.job === jobClass);
+    }
+    /** Whether a given job class was dispatched at least once. */
+    wasDispatched(jobClass) {
+        return this.jobs.some((j) => j.job === jobClass);
+    }
+    /** Number of jobs dispatched so far. */
+    dispatchCount() {
+        return this.jobs.length;
+    }
+    /** Reset captured state. */
+    clear() {
+        this.jobs = [];
+    }
+}
+//# sourceMappingURL=fake-queue.js.map

package/dist/fake-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake-queue.js","sourceRoot":"","sources":["../src/fake-queue.ts"],"names":[],"mappings":"AAYA,MAAM,OAAO,SAAS;IACV,IAAI,GAAwB,EAAE,CAAC;IAEvC,KAAK,CAAC,QAAQ,CACV,GAAgF,EAChF,OAAiB;QAEjB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;IACrC,CAAC;IAED,qEAAqE;IACrE,eAAe;IACf,qEAAqE;IAErE,qCAAqC;IACrC,cAAc;QACV,OAAO,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,+CAA+C;IAC/C,YAAY,CACR,QAAqF;QAErF,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,QAAQ,CAAkC,CAAC;IACxF,CAAC;IAED,8DAA8D;IAC9D,aAAa,CAAC,QAAyC;QACnD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC;IACrD,CAAC;IAED,wCAAwC;IACxC,aAAa;QACT,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;IAC5B,CAAC;IAED,4BAA4B;IAC5B,KAAK;QACD,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC;IACnB,CAAC;CACJ"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { FakeEventBus } from "./fake-events.js";
+export { FakeQueue, type FakeDispatchedJob } from "./fake-queue.js";
+export { FakeMail } from "./fake-mail.js";
+export { createTestApplication, type TestAppOptions } from "./create-test-application.js";
+//# 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,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,qBAAqB,EAAE,KAAK,cAAc,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { FakeEventBus } from "./fake-events.js";
+export { FakeQueue } from "./fake-queue.js";
+export { FakeMail } from "./fake-mail.js";
+export { createTestApplication } from "./create-test-application.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,SAAS,EAA0B,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,qBAAqB,EAAuB,MAAM,8BAA8B,CAAC"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@wild-framework/testing",
+  "version": "0.1.1",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "author": "Sphah",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/KhandaSoftware/wild-framework.git"
+  },
+  "description": "Testing helpers for Wild Framework — fake events, queue, mail, and a test application builder.",
+  "keywords": [
+    "wild",
+    "framework",
+    "testing",
+    "test",
+    "fake",
+    "mock"
+  ],
+  "dependencies": {
+    "@wild-framework/core": "0.1.1",
+    "@wild-framework/container": "0.1.1",
+    "@wild-framework/events": "0.1.1",
+    "@wild-framework/queue": "0.1.1",
+    "@wild-framework/mail": "0.1.1"
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "test": "vitest run"
+  }
+}