test(integration): add integration test setup pointing to local API

package.json

@@ -11,6 +11,7 @@
     "dev": "tsc --watch",
     "start": "node dist/index.js",
     "test": "vitest run",
+    "test:integration": "vitest run tests/integration/",
     "test:watch": "vitest",
     "lint": "tsc --noEmit",
     "prepublishOnly": "npm run build"

tests/integration/setup.ts

@@ -0,0 +1,8 @@
+import { OSTClient } from "../../src/client.js";
+
+const INTEGRATION_API_URL =
+  process.env.OST_API_URL || "http://localhost:8000";
+
+export function createIntegrationClient(): OSTClient {
+  return new OSTClient(INTEGRATION_API_URL);
+}

tests/integration/smoke.test.ts

@@ -0,0 +1,27 @@
+import { describe, it, expect } from "vitest";
+import { createIntegrationClient } from "./setup.js";
+
+const client = createIntegrationClient();
+
+describe("Integration smoke tests", () => {
+  it("lists categories from the local API", async () => {
+    const categories = await client.listCategories();
+
+    expect(Array.isArray(categories)).toBe(true);
+    expect(categories.length).toBeGreaterThan(0);
+  });
+
+  it("lists domains from the local API", async () => {
+    const domains = await client.listDomains();
+
+    expect(Array.isArray(domains)).toBe(true);
+    expect(domains.length).toBeGreaterThan(0);
+  });
+
+  it("lists tech stacks from the local API", async () => {
+    const techStacks = await client.listTechStacks();
+
+    expect(Array.isArray(techStacks)).toBe(true);
+    expect(techStacks.length).toBeGreaterThan(0);
+  });
+});

vitest.config.ts

@@ -4,5 +4,6 @@ export default defineConfig({
   test: {
     globals: true,
     environment: "node",
+    exclude: ["tests/integration/**", "node_modules/**"],
   },
 });