Initial Commit

packages/api-stack/api/api-jobs-worker-proxy/tests/conformance/api-worker-rpc.conformance.test.ts

@@ -0,0 +1,37 @@
+/**
+ * §16 conformance proof — the worker-proxy package consumes the
+ * `@suaveplan/api-worker-rpc` contract directly (client + server +
+ * MessagePort transport). This test exercises the canonical
+ * `runWorkerRpcConformance` harness with a minimal handler set to
+ * prove the consumer is wire-compatible end-to-end (request frame,
+ * response frame, abort propagation) using the same port transport
+ * the package builds on top of in `src/main-side` / `src/worker-side`.
+ */
+import { afterEach, describe, expect, it } from "@suaveplan/testing/runner";
+import { runWorkerRpcConformance } from "../../../api-worker-rpc/src/testing/conformance.js";
+
+const handles: Array<{ dispose(): void }> = [];
+afterEach(() => {
+    while (handles.length > 0) handles.pop()?.dispose();
+});
+
+describe("api-worker-rpc contract conformance (consumer-side)", () => {
+    it("round-trips a request through the canonical harness", {
+        timeout: 5000,
+    }, async () => {
+        const h = runWorkerRpcConformance(() => ({
+            echo: (params: ReadonlyArray<unknown>) => params[0],
+        }));
+        handles.push(h);
+        const result = await h.client.call<number>("echo", [42]);
+        expect(result).toBe(42);
+    });
+
+    it("surfaces UNKNOWN_METHOD from the server", {
+        timeout: 5000,
+    }, async () => {
+        const h = runWorkerRpcConformance(() => ({}));
+        handles.push(h);
+        await expect(h.client.call("missing", [])).rejects.toThrow();
+    });
+});

packages/api-stack/api/api-jobs-worker-proxy/tests/conformance/run-jobs-conformance.test.ts

@@ -0,0 +1,24 @@
+import { describe, expect, it } from "@suaveplan/testing/runner";
+import {
+    createJobsProxyHarness,
+    runJobsConformance,
+} from "../../src/testing/testing.js";
+
+describe("runJobsConformance passes against the worker proxy", () => {
+    it("every scenario reports ok against the standard harness factory", {
+        timeout: 5000,
+    }, async () => {
+        const factory = () =>
+            createJobsProxyHarness({
+                declaredJobs: [
+                    { name: "daily-rotate", kind: "cron" },
+                    { name: "send-email", kind: "queued" },
+                    { name: "ok", kind: "cron" },
+                ],
+            });
+        const results = await runJobsConformance(factory);
+        for (const r of results) {
+            expect(r.ok).toBe(true);
+        }
+    });
+});