@cinnabun/testing 0.0.1 → 0.0.7

package/README.md

@@ -0,0 +1,70 @@
+# @cinnabun/testing
+
+Testing utilities for Cinnabun. Bootstrap test apps with HTTP helpers and provider overrides.
+
+## Installation
+
+```bash
+bun add -D @cinnabun/testing (or @cinnabun/core workspace:*)
+```
+
+## createTestApp
+
+Full HTTP server on a random port with `get`, `post`, `put`, `delete` helpers:
+
+```typescript
+import { describe, it, expect, afterEach } from "bun:test";
+import { resolveModuleTree } from "@cinnabun/core";
+import { createTestApp, type TestApp } from "@cinnabun/testing";
+import { DevDashboardModule } from "@cinnabun/dev-dashboard";
+
+describe("Dashboard", () => {
+  let app: TestApp;
+
+  afterEach(async () => {
+    await app.close();
+  });
+
+  it("GET /__cinnabun returns HTML", async () => {
+    const mod = DevDashboardModule.forRoot({ enabled: true, path: "/__cinnabun" });
+    const { controllers, providers } = await resolveModuleTree(mod);
+    app = await createTestApp({ controllers, providers });
+
+    const res = await app.get("/__cinnabun");
+    expect(res.status).toBe(200);
+    expect(res.headers.get("Content-Type")).toContain("text/html");
+  });
+});
+```
+
+## createTestingModule
+
+DI-only bootstrap (no HTTP). Useful for unit testing services:
+
+```typescript
+import { createTestingModule } from "@cinnabun/testing";
+
+const { container, resolve } = await createTestingModule({
+  providers: [UserService, MockUserRepository],
+  overrides: [
+    { provide: UserRepository, useValue: mockRepo },
+  ],
+});
+
+const userService = resolve(UserService);
+```
+
+## mockProviders
+
+Generate stub overrides for providers:
+
+```typescript
+import { mockProviders } from "@cinnabun/testing";
+
+const overrides = mockProviders(EmailService, NotificationService);
+// Use with createTestingModule overrides
+```
+
+## License
+
+MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cinnabun/testing",
-  "version": "0.0.1",
+  "version": "0.0.7",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",