chore: Add integration test example

aklinker1 · aklinker1 · commit a746d13ee77e · 2026-02-01T10:05:23.000-06:00
diff --git a/.gitignore b/.gitignore
@@ -1,6 +1,7 @@
 node_modules
 dist
 .DS_Store
+data
 
 # Zola Docs
 #
diff --git a/bun.lock b/bun.lock
diff --git a/examples/README.md b/examples/README.md
@@ -5,3 +5,9 @@ To run an example, clone the repo and run the `examples/{name}/main.ts` file wit
 ```sh
 bun examples/request-logger/main.ts
 ```
+
+For examples with tests, run `bun test examples/{name}`:
+
+```sh
+bun test examples/integration-tests
+```
diff --git a/examples/integration-tests/app.test.ts b/examples/integration-tests/app.test.ts
@@ -0,0 +1,60 @@
+import { beforeEach, describe, expect, it, mock } from "bun:test";
+import { HttpStatus } from "../../src";
+import { openDb } from "./db";
+
+// Mock any external dependencies
+mock.module("./dependencies", async () => {
+  // In this case, use a real SQLite instance, but keep it in-memory
+  const db = await openDb(":memory:");
+
+  return { db };
+});
+
+describe("App", async () => {
+  // With bun:test, modules that depend on mocked modules or the mocked modules
+  // themselves must be dynamically imported after the call to `mock.module`.
+  const { app } = await import("./app");
+  const { db } = await import("./dependencies");
+
+  const fetch = app.build();
+
+  beforeEach(() => {
+    // Reset the DB before each test
+    db.run("DELETE FROM request_history");
+  });
+
+  it("should track all requests in SQLite", async () => {
+    const url1 = new URL("http://localhost/one");
+    const url2 = new URL("http://localhost/two");
+    const url3 = new URL("http://localhost/three");
+
+    // Make the fetch requests
+    await fetch(new Request(url1));
+    await fetch(new Request(url2));
+    await fetch(new Request(url3));
+
+    // Wait for onGlobalAfterResponse timeouts to be fired
+    await Bun.sleep(1);
+
+    const history = db
+      .query("SELECT method, path, status_code FROM request_history")
+      .all();
+
+    expect(history).toHaveLength(3);
+    expect(history).toContainEqual({
+      method: "GET",
+      path: "/one",
+      status_code: HttpStatus.Ok,
+    });
+    expect(history).toContainEqual({
+      method: "GET",
+      path: "/two",
+      status_code: HttpStatus.Ok,
+    });
+    expect(history).toContainEqual({
+      method: "GET",
+      path: "/three",
+      status_code: HttpStatus.NotFound,
+    });
+  });
+});
diff --git a/examples/integration-tests/app.ts b/examples/integration-tests/app.ts
@@ -0,0 +1,27 @@
+import { createApp } from "@aklinker1/zeta";
+import { db } from "./dependencies";
+
+export const app = createApp()
+  .onGlobalRequest(() => ({ startTime: new Date() }))
+  .onGlobalAfterResponse(({ method, path, response, startTime }) => {
+    db.run(
+      `
+        INSERT INTO request_history (id, start_time, path, method, status_code)
+        VALUES (?, ?, ?, ?, ?)
+      `,
+      [
+        crypto.randomUUID(),
+        startTime.toISOString(),
+        path,
+        method,
+        response.status,
+      ],
+    );
+  })
+  .get("/", () =>
+    db
+      .query("SELECT * FROM request_history ORDER BY datetime(start_time) DESC")
+      .all(),
+  )
+  .get("/one", () => "OK")
+  .get("/two", () => "OK");
diff --git a/examples/integration-tests/db.ts b/examples/integration-tests/db.ts
@@ -0,0 +1,26 @@
+import { Database } from "bun:sqlite";
+import { mkdir } from "node:fs/promises";
+import { dirname } from "node:path";
+
+export async function openDb(
+  filename = "data/integration-tests-app.db",
+): Promise<Database> {
+  console.log({ filename });
+  if (filename !== ":memory:") {
+    await mkdir(dirname(filename), { recursive: true });
+  }
+
+  const db = new Database(filename);
+
+  db.run(`
+    CREATE TABLE IF NOT EXISTS request_history (
+      id TEXT PRIMARY KEY,
+      start_time TEXT NOT NULL,
+      path TEXT NOT NULL,
+      method TEXT NOT NULL,
+      status_code INTEGER NOT NULL
+    )
+  `);
+
+  return db;
+}
diff --git a/examples/integration-tests/dependencies.ts b/examples/integration-tests/dependencies.ts
@@ -0,0 +1,3 @@
+import { openDb } from "./db";
+
+export const db = await openDb();
diff --git a/examples/integration-tests/main.ts b/examples/integration-tests/main.ts
@@ -0,0 +1,14 @@
+import dedent from "dedent";
+import { app } from "./app";
+
+app.listen(3000, () => {
+  console.log(dedent`
+    Integration test example started.
+
+    - Visit http://localhost:3000 to view request history.
+    - Visit other endpoints to populate the history:
+       - http://localhost:3000/one
+       - http://localhost:3000/two
+       - http://localhost:3000/three
+  `);
+});
diff --git a/package.json b/package.json
@@ -62,6 +62,7 @@
     "@typescript/native-preview": "^7.0.0-dev.20251114.1",
     "changelogen": "^0.6.2",
     "cookie": "^1.1.1",
+    "dedent": "^1.7.1",
     "elysia": "^1.4.19",
     "expect-type": "^1.2.1",
     "hono": "^4.11.2",

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,7 @@`
`1`	`1`	`node_modules`
`2`	`2`	`dist`
`3`	`3`	`.DS_Store`
	`4`	`+data`
`4`	`5`
`5`	`6`	`# Zola Docs`
`6`	`7`	`#`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+import { openDb } from "./db";`
	`2`	`+`
	`3`	`+export const db = await openDb();`