@powerhousedao/reactor-api 6.0.0-dev.11 → 6.0.0-dev.110

package/dist/test/gateway/auth-middleware.test.js

@@ -0,0 +1,73 @@
+/**
+ * Unit tests for createAuthFetchMiddleware and getAuthContext.
+ *
+ * AuthService is mocked so tests are pure unit tests with no network I/O or
+ * real token verification.
+ */
+import { describe, expect, it, vi } from "vitest";
+import { createAuthFetchMiddleware, getAuthContext, } from "../../src/graphql/gateway/auth-middleware.js";
+// ─── helpers ──────────────────────────────────────────────────────────────────
+function makeAuthService(result) {
+    return {
+        authenticateRequest: vi.fn().mockResolvedValue(result),
+    };
+}
+function makeRequest(url = "http://localhost/graphql") {
+    return new globalThis.Request(url, { method: "POST" });
+}
+const AUTH_CTX = {
+    user: { address: "0xabc", chainId: 1, networkId: "eip155" },
+    admins: ["0xadmin"],
+    auth_enabled: true,
+};
+// ─── tests ────────────────────────────────────────────────────────────────────
+describe("createAuthFetchMiddleware", () => {
+    it("calls the next handler and returns its response when auth succeeds", async () => {
+        const service = makeAuthService(AUTH_CTX);
+        const next = vi.fn().mockResolvedValue(new Response("ok", { status: 200 }));
+        const middleware = createAuthFetchMiddleware(service);
+        const req = makeRequest();
+        const res = await middleware(next)(req);
+        expect(next).toHaveBeenCalledOnce();
+        expect(next).toHaveBeenCalledWith(req);
+        expect(res.status).toBe(200);
+    });
+    it("short-circuits and returns the auth Response without calling next when auth fails", async () => {
+        const authResponse = new globalThis.Response(JSON.stringify({ error: "Verification failed" }), { status: 401 });
+        const service = makeAuthService(authResponse);
+        const next = vi.fn();
+        const middleware = createAuthFetchMiddleware(service);
+        const res = await middleware(next)(makeRequest());
+        expect(next).not.toHaveBeenCalled();
+        expect(res.status).toBe(401);
+    });
+    it("stores the AuthContext in the WeakMap so getAuthContext returns it", async () => {
+        const service = makeAuthService(AUTH_CTX);
+        const req = makeRequest();
+        let capturedRequest;
+        const next = vi.fn().mockImplementation((r) => {
+            capturedRequest = r;
+            return Promise.resolve(new Response("ok"));
+        });
+        const middleware = createAuthFetchMiddleware(service);
+        await middleware(next)(req);
+        expect(capturedRequest).toBe(req);
+        expect(getAuthContext(req)).toEqual(AUTH_CTX);
+    });
+    it("does not store AuthContext in the WeakMap when auth fails", async () => {
+        const authResponse = new globalThis.Response(null, { status: 401 });
+        const service = makeAuthService(authResponse);
+        const req = makeRequest();
+        const next = vi.fn();
+        const middleware = createAuthFetchMiddleware(service);
+        await middleware(next)(req);
+        expect(getAuthContext(req)).toBeUndefined();
+    });
+});
+describe("getAuthContext", () => {
+    it("returns undefined for a request that was never authenticated", () => {
+        const freshRequest = makeRequest("http://localhost/other");
+        expect(getAuthContext(freshRequest)).toBeUndefined();
+    });
+});
+//# sourceMappingURL=auth-middleware.test.js.map

package/dist/test/gateway/auth-middleware.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-middleware.test.js","sourceRoot":"","sources":["../../../test/gateway/auth-middleware.test.ts"],"names":[],"mappings":"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"}

package/dist/test/gateway/gateway-adapter-contract.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Shared contract test suite for IGatewayAdapter implementations.
+ *
+ * Import this module and call runGatewayAdapterContractTests() in your
+ * adapter-specific test file to verify that the implementation satisfies
+ * the full IGatewayAdapter behavioral contract.
+ *
+ * Usage:
+ *
+ *   import { runGatewayAdapterContractTests } from "./gateway-adapter-contract.js";
+ *
+ *   runGatewayAdapterContractTests("MyAdapter", async () => {
+ *     const adapter = new MyGatewayAdapter(...);
+ *     const httpServer = createServer();
+ *     return { adapter, httpServer, close: () => adapter.stop() };
+ *   });
+ */
+import type { IGatewayAdapter } from "../../src/graphql/gateway/types.js";
+import type { Context } from "../../src/graphql/types.js";
+export type GatewayAdapterHarness = {
+    adapter: IGatewayAdapter<Context>;
+    /**
+     * Shut down the adapter and release any resources. Called in afterEach.
+     * Implementations should be idempotent (safe to call after stop()).
+     */
+    close: () => Promise<void>;
+};
+export type GatewayAdapterHarnessFactory = () => Promise<GatewayAdapterHarness>;
+export declare function runGatewayAdapterContractTests(adapterName: string, createHarness: GatewayAdapterHarnessFactory): void;
+//# sourceMappingURL=gateway-adapter-contract.d.ts.map

package/dist/test/gateway/gateway-adapter-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-adapter-contract.d.ts","sourceRoot":"","sources":["../../../test/gateway/gateway-adapter-contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAQH,OAAO,KAAK,EAGV,eAAe,EAEhB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAI1D,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;IAClC;;;OAGG;IACH,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG,MAAM,OAAO,CAAC,qBAAqB,CAAC,CAAC;AAyChF,wBAAgB,8BAA8B,CAC5C,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,4BAA4B,GAC1C,IAAI,CAmZN"}

package/dist/test/gateway/gateway-adapter-contract.js

@@ -0,0 +1,347 @@
+/**
+ * Shared contract test suite for IGatewayAdapter implementations.
+ *
+ * Import this module and call runGatewayAdapterContractTests() in your
+ * adapter-specific test file to verify that the implementation satisfies
+ * the full IGatewayAdapter behavioral contract.
+ *
+ * Usage:
+ *
+ *   import { runGatewayAdapterContractTests } from "./gateway-adapter-contract.js";
+ *
+ *   runGatewayAdapterContractTests("MyAdapter", async () => {
+ *     const adapter = new MyGatewayAdapter(...);
+ *     const httpServer = createServer();
+ *     return { adapter, httpServer, close: () => adapter.stop() };
+ *   });
+ */
+import { buildSubgraphSchema } from "@apollo/subgraph";
+import { gql } from "graphql-tag";
+import { createServer } from "node:http";
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+// ─── shared helpers ──────────────────────────────────────────────────────────
+/** A minimal context factory that satisfies GatewayContextFactory<Context>. */
+const noopCtx = async () => ({
+    headers: {},
+    db: null,
+});
+/**
+ * Build a minimal federated schema with a single Query field.
+ * Uses buildSubgraphSchema from @apollo/subgraph to ensure schema instances
+ * are compatible with Apollo Server's graphql module instance.
+ */
+function makeSchema(fieldName = "hello", returnValue = "world") {
+    return buildSubgraphSchema({
+        typeDefs: gql `
+      type Query {
+        ${fieldName}: String
+      }
+    `,
+        resolvers: {
+            Query: {
+                [fieldName]: () => returnValue,
+            },
+        },
+    });
+}
+/** A minimal http.Server used to satisfy the start() signature. */
+function makeHttpServer() {
+    const server = createServer();
+    return {
+        server,
+        close: () => new Promise((resolve) => server.close(() => resolve())),
+    };
+}
+// ─── contract tests ──────────────────────────────────────────────────────────
+export function runGatewayAdapterContractTests(adapterName, createHarness) {
+    // ── lifecycle ──────────────────────────────────────────────────────────────
+    describe(`IGatewayAdapter contract (${adapterName}) – lifecycle`, () => {
+        let h;
+        let httpServer;
+        beforeEach(async () => {
+            h = await createHarness();
+            httpServer = makeHttpServer();
+        });
+        afterEach(async () => {
+            await httpServer.close();
+            await h.close();
+        });
+        it("start() resolves without throwing", async () => {
+            await expect(h.adapter.start(httpServer.server)).resolves.toBeUndefined();
+        });
+        it("stop() resolves without throwing when no handlers have been created", async () => {
+            await h.adapter.start(httpServer.server);
+            await expect(h.adapter.stop()).resolves.toBeUndefined();
+        });
+        it("stop() resolves without throwing after createHandler() calls", async () => {
+            await h.adapter.start(httpServer.server);
+            await h.adapter.createHandler(makeSchema(), noopCtx);
+            await h.adapter.createHandler(makeSchema(), noopCtx);
+            await expect(h.adapter.stop()).resolves.toBeUndefined();
+        });
+        it("stop() is safe to call multiple times", async () => {
+            await h.adapter.start(httpServer.server);
+            await h.adapter.createHandler(makeSchema(), noopCtx);
+            await h.adapter.stop();
+            await expect(h.adapter.stop()).resolves.toBeUndefined();
+        });
+    });
+    // ── createHandler ──────────────────────────────────────────────────────────
+    describe(`IGatewayAdapter contract (${adapterName}) – createHandler`, () => {
+        let h;
+        let httpServer;
+        beforeEach(async () => {
+            h = await createHarness();
+            httpServer = makeHttpServer();
+            await h.adapter.start(httpServer.server);
+        });
+        afterEach(async () => {
+            await httpServer.close();
+            await h.close();
+        });
+        it("returns a callable FetchHandler", async () => {
+            const handler = await h.adapter.createHandler(makeSchema(), noopCtx);
+            expect(typeof handler).toBe("function");
+        });
+        it("the handler returns a Response for a valid query", async () => {
+            const handler = await h.adapter.createHandler(makeSchema(), noopCtx);
+            const res = await handler(new Request("http://localhost/graphql", {
+                method: "POST",
+                headers: { "content-type": "application/json" },
+                body: JSON.stringify({ query: "{ hello }" }),
+            }));
+            expect(res).toBeInstanceOf(Response);
+            expect(res.status).toBe(200);
+            const body = (await res.json());
+            expect(body.data.hello).toBe("world");
+        });
+        it("the handler returns an error response for an invalid query", async () => {
+            const handler = await h.adapter.createHandler(makeSchema(), noopCtx);
+            const res = await handler(new Request("http://localhost/graphql", {
+                method: "POST",
+                headers: { "content-type": "application/json" },
+                body: JSON.stringify({ query: "{ doesNotExist }" }),
+            }));
+            expect(res).toBeInstanceOf(Response);
+            // Apollo returns 400 for validation errors; implementations may vary
+            // but must not return 200 for an invalid query
+            expect(res.status).not.toBe(200);
+            const body = (await res.json());
+            expect(body.errors).toBeDefined();
+        });
+        it("the handler passes the Fetch Request to the context factory", async () => {
+            let capturedRequest;
+            const ctxFactory = async (req) => {
+                capturedRequest = req;
+                return { headers: {}, db: null };
+            };
+            const handler = await h.adapter.createHandler(makeSchema(), ctxFactory);
+            await handler(new Request("http://localhost/graphql", {
+                method: "POST",
+                headers: {
+                    "content-type": "application/json",
+                    "x-token": "abc123",
+                },
+                body: JSON.stringify({ query: "{ hello }" }),
+            }));
+            expect(capturedRequest?.headers.get("x-token")).toBe("abc123");
+        });
+        it("multiple handlers created from different schemas are independent", async () => {
+            const handlerA = await h.adapter.createHandler(makeSchema("hello", "from-a"), noopCtx);
+            const handlerB = await h.adapter.createHandler(makeSchema("hello", "from-b"), noopCtx);
+            const request = () => new Request("http://localhost/graphql", {
+                method: "POST",
+                headers: { "content-type": "application/json" },
+                body: JSON.stringify({ query: "{ hello }" }),
+            });
+            const [resA, resB] = await Promise.all([
+                handlerA(request()),
+                handlerB(request()),
+            ]);
+            const bodyA = (await resA.json());
+            const bodyB = (await resB.json());
+            expect(bodyA.data.hello).toBe("from-a");
+            expect(bodyB.data.hello).toBe("from-b");
+        });
+    });
+    // ── createSupergraphHandler + updateSupergraph ────────────────────────────
+    //
+    // These tests require real HTTP subgraph servers because the federation
+    // gateway uses RemoteGraphQLDataSource to route requests by URL.
+    //
+    // Helper: wrap a FetchHandler in a real Node HTTP server so the gateway
+    // can reach it via a localhost URL.
+    async function serveHandler(handler) {
+        const server = createServer(async (nodeReq, nodeRes) => {
+            const chunks = [];
+            for await (const chunk of nodeReq) {
+                chunks.push(chunk);
+            }
+            const body = Buffer.concat(chunks);
+            const url = `http://127.0.0.1${nodeReq.url ?? "/"}`;
+            const fetchReq = new Request(url, {
+                method: nodeReq.method ?? "GET",
+                headers: nodeReq.headers,
+                ...(body.length > 0 ? { body } : {}),
+            });
+            try {
+                const fetchRes = await handler(fetchReq);
+                nodeRes.statusCode = fetchRes.status;
+                fetchRes.headers.forEach((value, key) => nodeRes.setHeader(key, value));
+                nodeRes.end(await fetchRes.text());
+            }
+            catch {
+                nodeRes.statusCode = 500;
+                nodeRes.end("Internal server error");
+            }
+        });
+        await new Promise((resolve) => server.listen(0, "127.0.0.1", resolve));
+        const { port } = server.address();
+        return {
+            url: `http://127.0.0.1:${port}`,
+            close: () => new Promise((resolve) => server.close(() => resolve())),
+        };
+    }
+    describe(`IGatewayAdapter contract (${adapterName}) – createSupergraphHandler`, () => {
+        let h;
+        let httpServer;
+        const subServers = [];
+        beforeEach(async () => {
+            h = await createHarness();
+            httpServer = makeHttpServer();
+            await h.adapter.start(httpServer.server);
+        });
+        afterEach(async () => {
+            await Promise.all(subServers.map((s) => s.close()));
+            subServers.length = 0;
+            await httpServer.close();
+            await h.close();
+        });
+        // Spin up a real HTTP subgraph server backed by the adapter's createHandler.
+        async function makeSubServer(fieldName = "hello", returnValue = "world") {
+            const typeDefs = gql `
+        type Query {
+          ${fieldName}: String
+        }
+      `;
+            const schema = buildSubgraphSchema({
+                typeDefs,
+                resolvers: { Query: { [fieldName]: () => returnValue } },
+            });
+            const handler = await h.adapter.createHandler(schema, noopCtx);
+            const sub = await serveHandler(handler);
+            subServers.push(sub);
+            return { name: fieldName, typeDefs, url: sub.url };
+        }
+        it("returns a callable FetchHandler", async () => {
+            const sub = await makeSubServer();
+            const handler = await h.adapter.createSupergraphHandler(() => [sub], httpServer.server, noopCtx);
+            expect(typeof handler).toBe("function");
+        });
+        it("the supergraph handler executes a federated query", async () => {
+            const sub = await makeSubServer("hello", "world");
+            const handler = await h.adapter.createSupergraphHandler(() => [sub], httpServer.server, noopCtx);
+            const res = await handler(new Request("http://localhost/graphql", {
+                method: "POST",
+                headers: { "content-type": "application/json" },
+                body: JSON.stringify({ query: "{ hello }" }),
+            }));
+            expect(res).toBeInstanceOf(Response);
+            expect(res.status).toBe(200);
+            const body = (await res.json());
+            expect(body.data.hello).toBe("world");
+        });
+        it("the supergraph handler passes context factory the Fetch Request", async () => {
+            let capturedRequest;
+            const ctxFactory = async (req) => {
+                capturedRequest = req;
+                return { headers: {}, db: null };
+            };
+            const sub = await makeSubServer();
+            const handler = await h.adapter.createSupergraphHandler(() => [sub], httpServer.server, ctxFactory);
+            await handler(new Request("http://localhost/graphql", {
+                method: "POST",
+                headers: {
+                    "content-type": "application/json",
+                    "x-token": "test-value",
+                },
+                body: JSON.stringify({ query: "{ hello }" }),
+            }));
+            expect(capturedRequest?.headers.get("x-token")).toBe("test-value");
+        });
+        it("calling createSupergraphHandler() twice throws", async () => {
+            const sub = await makeSubServer();
+            await h.adapter.createSupergraphHandler(() => [sub], httpServer.server, noopCtx);
+            await expect(h.adapter.createSupergraphHandler(() => [sub], httpServer.server, noopCtx)).rejects.toThrow();
+        });
+        it("stop() after createSupergraphHandler() resolves without throwing", async () => {
+            const sub = await makeSubServer();
+            await h.adapter.createSupergraphHandler(() => [sub], httpServer.server, noopCtx);
+            await expect(h.adapter.stop()).resolves.toBeUndefined();
+        });
+    });
+    // ── updateSupergraph ───────────────────────────────────────────────────────
+    describe(`IGatewayAdapter contract (${adapterName}) – updateSupergraph`, () => {
+        let h;
+        let httpServer;
+        const subServers = [];
+        beforeEach(async () => {
+            h = await createHarness();
+            httpServer = makeHttpServer();
+            await h.adapter.start(httpServer.server);
+        });
+        afterEach(async () => {
+            await Promise.all(subServers.map((s) => s.close()));
+            subServers.length = 0;
+            await httpServer.close();
+            await h.close();
+        });
+        it("updateSupergraph() is a no-op before createSupergraphHandler()", async () => {
+            await expect(h.adapter.updateSupergraph()).resolves.toBeUndefined();
+        });
+        it("updateSupergraph() resolves after createSupergraphHandler()", async () => {
+            const typeDefs = gql `
+        type Query {
+          hello: String
+        }
+      `;
+            const schema = buildSubgraphSchema({
+                typeDefs,
+                resolvers: { Query: { hello: () => "world" } },
+            });
+            const handler = await h.adapter.createHandler(schema, noopCtx);
+            const sub = await serveHandler(handler);
+            subServers.push(sub);
+            await h.adapter.createSupergraphHandler(() => [{ name: "hello", typeDefs, url: sub.url }], httpServer.server, noopCtx);
+            await expect(h.adapter.updateSupergraph()).resolves.toBeUndefined();
+        });
+    });
+    // ── lifecycle (stop after createSupergraphHandler) ─────────────────────────
+    // ── attachWebSocket ────────────────────────────────────────────────────────
+    // Skipped in the Vitest environment because graphql-ws/use/ws is blocked by
+    // websocket.ts when VITEST=true. Adapters that support WebSocket in tests
+    // can override this by running the suite with NODE_ENV != "test".
+    const itWs = process.env.VITEST === "true" ? it.skip : it;
+    describe(`IGatewayAdapter contract (${adapterName}) – attachWebSocket`, () => {
+        let h;
+        let httpServer;
+        beforeEach(async () => {
+            h = await createHarness();
+            httpServer = makeHttpServer();
+            await h.adapter.start(httpServer.server);
+        });
+        afterEach(async () => {
+            await httpServer.close();
+            await h.close();
+        });
+        itWs("returns a WsDisposer with a dispose() method", async () => {
+            const { WebSocketServer } = await import("ws");
+            const wss = new WebSocketServer({ noServer: true });
+            const disposer = h.adapter.attachWebSocket(wss, makeSchema(), async () => ({ headers: {}, db: null }));
+            expect(typeof disposer.dispose).toBe("function");
+            await disposer.dispose();
+            wss.close();
+        });
+    });
+}
+//# sourceMappingURL=gateway-adapter-contract.js.map

package/dist/test/gateway/gateway-adapter-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-adapter-contract.js","sourceRoot":"","sources":["../../../test/gateway/gateway-adapter-contract.ts"],"names":[],"mappings":"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"}

package/dist/test/gateway/http-adapter-contract.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Shared contract test suite for IHttpAdapter implementations.
+ *
+ * Import this module and call runHttpAdapterContractTests() in your
+ * adapter-specific test file to verify that the implementation satisfies
+ * the full IHttpAdapter behavioral contract.
+ *
+ * Usage:
+ *
+ *   import { runHttpAdapterContractTests } from "./http-adapter-contract.js";
+ *
+ *   runHttpAdapterContractTests("MyAdapter", async () => {
+ *     const adapter = new MyHttpAdapter(...);
+ *     adapter.setupMiddleware({});
+ *     // start your framework's server on an ephemeral port
+ *     return { adapter, url: "http://127.0.0.1:PORT", close, respondWithJson };
+ *   });
+ */
+import type { IHttpAdapter } from "../../src/graphql/gateway/types.js";
+export type HttpAdapterHarness = {
+    /** The adapter under test, with setupMiddleware already called. */
+    adapter: IHttpAdapter;
+    /** Base URL of the running test server (e.g. "http://127.0.0.1:PORT"). */
+    url: string;
+    /** Shut down the server and release the port. */
+    close: () => Promise<void>;
+};
+export type HttpAdapterHarnessFactory = () => Promise<HttpAdapterHarness>;
+export declare function runHttpAdapterContractTests(adapterName: string, createHarness: HttpAdapterHarnessFactory): void;
+//# sourceMappingURL=http-adapter-contract.d.ts.map

package/dist/test/gateway/http-adapter-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-adapter-contract.d.ts","sourceRoot":"","sources":["../../../test/gateway/http-adapter-contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAKvE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,mEAAmE;IACnE,OAAO,EAAE,YAAY,CAAC;IACtB,0EAA0E;IAC1E,GAAG,EAAE,MAAM,CAAC;IACZ,iDAAiD;IACjD,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG,MAAM,OAAO,CAAC,kBAAkB,CAAC,CAAC;AAyB1E,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,yBAAyB,GACvC,IAAI,CA0PN"}