feat(compiler): emit browser api bindings only where the client calls them

2026-08-20 07:19:55 +05:30
parent 9dec811069
commit 712a6d3d8c
4 changed files with 136 additions and 8 deletions
@@ -0,0 +1,60 @@
+import { expect, test } from "bun:test";
+import { parse } from "@wrnexus/syntax";
+import { generateTargets } from "../src/targets.ts";
+
+const withCalls = (calls: string) => `page Probe {
+  apis {
+    used POST /api/used {
+      request { body { name?: string } }
+      response { return data.users }
+    }
+
+    unused GET /api/unused {
+      response { return data.secretShape }
+    }
+  }
+
+  functions {
+    client async function go(): Promise<void> {
+${calls}
+    }
+  }
+
+  view { <main><button @click="go()">x</button></main> }
+}
+`;
+
+test("a block the client calls is emitted into the browser module", () => {
+  const browser = generateTargets(parse(withCalls(`      await api.used({ name: "a" })`))).browser;
+
+  expect(browser).toContain("used");
+  expect(browser).toContain('"/api/used"');
+});
+
+test("a block the client never calls is NOT emitted into the browser module", () => {
+  // Server-only transforms must not ship. This is the point of usage-driven emission.
+  const browser = generateTargets(parse(withCalls(`      await api.used({ name: "a" })`))).browser;
+
+  expect(browser).not.toContain("secretShape");
+  expect(browser).not.toContain('"/api/unused"');
+});
+
+test("no api object at all when the client calls none", () => {
+  const browser = generateTargets(parse(withCalls(`      console.log("nothing")`))).browser;
+
+  expect(browser).not.toContain("const api =");
+});
+
+test("the emitted browser module is valid JavaScript", () => {
+  const browser = generateTargets(parse(withCalls(`      await api.used({ name: "a" })`))).browser;
+
+  expect(() => {
+    new Function(browser.replace(/^\s*import[^\n]*$/gm, "").replace(/\bexport\s+/g, ""));
+  }).not.toThrow();
+});
+
+test("declared field types never reach the browser module", () => {
+  const browser = generateTargets(parse(withCalls(`      await api.used({ name: "a" })`))).browser;
+
+  expect(browser).not.toContain("name?: string");
+});