graphql-server-test 3.1.1 → 3.3.2

package/README.md

@@ -181,17 +181,22 @@ The `server.api` option provides full control over the GraphQL server configurat
 
 | Property | Type | Default | Description |
 |----------|------|---------|-------------|
-| `enableScopedRouting` | `boolean` | package default | Resolve host routing through the scoped plane (`constructive_routing_public.resolve_route`); disable for static single-tenant mode |
 | `scopedRoutingSchema` | `string` | `constructive_routing_public` | Schema that owns `resolve_route()` and the routing tables |
 | `exposedSchemas` | `string[]` | from `schemas` | Database schemas to expose (overridden by `schemas`) |
 | `anonRole` | `string` | from `authRole` | Anonymous role name (overridden by `authRole`) |
 | `roleName` | `string` | from `authRole` | Default role name (overridden by `authRole`) |
-| `defaultDatabaseId` | `string` | package default | Default database identifier |
 | `isPublic` | `boolean` | package default | Whether the API is publicly accessible |
 | `metaSchemas` | `string[]` | package default | Schemas containing metadata tables |
 
 The convenience properties (`schemas`, `authRole`) take precedence over corresponding values in `server.api`.
 
+### Choosing the server (`server.scopedRouting`)
+
+The harness runs suites against one of two servers:
+
+- `server.scopedRouting: true` (default) — the production `@constructive-io/graphql-server`. Every request resolves through the scoped-routing plane, so the suite must seed real routing/database records and use a real database id.
+- `server.scopedRouting: false` — the single-tenant `@constructive-io/graphql-dev-server` (pure PostGraphile, no routing, no database id). It exposes the configured schemas directly and is for local/static suites only.
+
 ```typescript
 // Basic usage with convenience properties
 const { query } = await getConnections({
@@ -199,27 +204,24 @@ const { query } = await getConnections({
   authRole: 'anonymous'
 });
 
-// Static single-tenant mode for testing (bypasses host route resolution)
+// Static single-tenant mode for testing (runs the dev server, no routing)
 const { query } = await getConnections({
   schemas: ['app_public'],
   server: {
-    api: {
-      enableScopedRouting: false
-    }
+    scopedRouting: false
   }
 });
 
-// Full server configuration
+// Full server configuration (production scoped-routing server)
 const { query } = await getConnections({
   schemas: ['app_public'],
   authRole: 'authenticated',
   server: {
     port: 5555,
     host: 'localhost',
+    scopedRouting: true,
     api: {
-      enableScopedRouting: false,
       isPublic: false,
-      defaultDatabaseId: 'my-test-db',
       metaSchemas: ['constructive_routing_public', 'metaschema_public']
     }
   }

package/esm/get-connections.js

@@ -1,6 +1,6 @@
 import { getConnections as getPgConnections } from 'pgsql-test';
 import { getEnvOptions } from '@constructive-io/graphql-env';
-import { createTestServer } from './server';
+import { createDevTestServer, createTestServer } from './server';
 import { createSuperTestAgent, createQueryFn } from './supertest';
 /**
  * Creates connections with an HTTP server for SuperTest testing
@@ -48,8 +48,13 @@ export const getConnections = async (input, seedAdapters) => {
         },
         graphile: input.graphile
     });
-    // Start the HTTP server using @constructive-io/graphql-server
-    const server = await createTestServer(serverOpts, input.server);
+    // Start the HTTP server. Suites default to the production scoped-routing
+    // server; static/single-tenant suites opt into the dev server with
+    // `server.scopedRouting: false`.
+    const scopedRouting = input.server?.scopedRouting ?? true;
+    const server = scopedRouting
+        ? await createTestServer(serverOpts, input.server)
+        : await createDevTestServer(serverOpts, input.server);
     // Create SuperTest agent
     const request = createSuperTestAgent(server);
     // Combined teardown function

package/esm/server.js

@@ -1,4 +1,18 @@
+import { createDevServer } from '@constructive-io/graphql-dev-server';
 import { Server } from '@constructive-io/graphql-server';
+/**
+ * Create a single-tenant dev test server (no scoped routing, no database id).
+ *
+ * Wraps `@constructive-io/graphql-dev-server` for suites that exercise a plain
+ * PostGraphile surface against one seeded database.
+ */
+export const createDevTestServer = async (opts, serverOpts = {}) => {
+    const { httpServer, url, graphqlUrl, port, host, stop } = await createDevServer(opts, {
+        host: serverOpts.host ?? '127.0.0.1',
+        port: serverOpts.port ?? 0
+    });
+    return { httpServer, url, graphqlUrl, port, host, stop };
+};
 /**
  * Create a test server for SuperTest testing
  *

package/get-connections.js

@@ -51,8 +51,13 @@ const getConnections = async (input, seedAdapters) => {
         },
         graphile: input.graphile
     });
-    // Start the HTTP server using @constructive-io/graphql-server
-    const server = await (0, server_1.createTestServer)(serverOpts, input.server);
+    // Start the HTTP server. Suites default to the production scoped-routing
+    // server; static/single-tenant suites opt into the dev server with
+    // `server.scopedRouting: false`.
+    const scopedRouting = input.server?.scopedRouting ?? true;
+    const server = scopedRouting
+        ? await (0, server_1.createTestServer)(serverOpts, input.server)
+        : await (0, server_1.createDevTestServer)(serverOpts, input.server);
     // Create SuperTest agent
     const request = (0, supertest_1.createSuperTestAgent)(server);
     // Combined teardown function

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "graphql-server-test",
-  "version": "3.1.1",
+  "version": "3.3.2",
   "author": "Constructive <developers@constructive.io>",
   "description": "Constructive GraphQL Server Testing with SuperTest HTTP requests",
   "main": "index.js",
@@ -30,30 +30,31 @@
   },
   "devDependencies": {
     "@0no-co/graphql.web": "^1.2.0",
-    "@agentic-kit/ollama": "2.3.0",
-    "@constructive-io/graphql-codegen": "^5.1.1",
-    "@constructive-io/graphql-query": "^4.0.6",
+    "@agentic-kit/ollama": "2.4.2",
+    "@constructive-io/graphql-codegen": "^5.2.2",
+    "@constructive-io/graphql-query": "^4.1.2",
     "@types/express": "^5.0.6",
     "@types/pg": "^8.20.0",
     "@types/supertest": "^7.2.0",
     "appstash": "^0.7.0",
-    "gql-ast": "^3.13.0",
+    "gql-ast": "^3.14.2",
     "inquirerer": "^4.9.1",
     "makage": "^0.3.0",
     "nested-obj": "^0.2.2"
   },
   "dependencies": {
-    "@constructive-io/graphql-env": "^3.17.1",
-    "@constructive-io/graphql-server": "^5.1.1",
-    "@constructive-io/graphql-types": "^3.16.1",
-    "@constructive-io/upload-client": "0.16.0",
-    "@pgpmjs/types": "^2.36.0",
+    "@constructive-io/graphql-dev-server": "^3.3.2",
+    "@constructive-io/graphql-env": "^3.19.2",
+    "@constructive-io/graphql-server": "^5.3.2",
+    "@constructive-io/graphql-types": "^3.18.2",
+    "@constructive-io/upload-client": "0.17.2",
+    "@pgpmjs/types": "^2.37.2",
     "express": "^5.2.1",
-    "graphile-schema": "^2.0.6",
+    "graphile-schema": "^2.1.2",
     "graphql": "16.13.0",
     "pg": "^8.21.0",
-    "pg-cache": "^3.15.3",
-    "pgsql-test": "^5.0.5",
+    "pg-cache": "^3.16.2",
+    "pgsql-test": "^5.1.2",
     "supertest": "^7.0.0"
   },
   "keywords": [
@@ -67,5 +68,5 @@
     "e2e",
     "server"
   ],
-  "gitHead": "ebba3f838664032e6f6adf6c9c6d2b6cdddd994a"
+  "gitHead": "08741ce3a6897192c2dbc7d1da48b9f456ffb59f"
 }

package/server.d.ts

@@ -1,5 +1,12 @@
 import type { ConstructiveOptions } from '@constructive-io/graphql-types';
 import type { ServerInfo, ServerOptions } from './types';
+/**
+ * Create a single-tenant dev test server (no scoped routing, no database id).
+ *
+ * Wraps `@constructive-io/graphql-dev-server` for suites that exercise a plain
+ * PostGraphile surface against one seeded database.
+ */
+export declare const createDevTestServer: (opts: ConstructiveOptions, serverOpts?: ServerOptions) => Promise<ServerInfo>;
 /**
  * Create a test server for SuperTest testing
  *

package/server.js

@@ -1,7 +1,22 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createTestServer = void 0;
+exports.createTestServer = exports.createDevTestServer = void 0;
+const graphql_dev_server_1 = require("@constructive-io/graphql-dev-server");
 const graphql_server_1 = require("@constructive-io/graphql-server");
+/**
+ * Create a single-tenant dev test server (no scoped routing, no database id).
+ *
+ * Wraps `@constructive-io/graphql-dev-server` for suites that exercise a plain
+ * PostGraphile surface against one seeded database.
+ */
+const createDevTestServer = async (opts, serverOpts = {}) => {
+    const { httpServer, url, graphqlUrl, port, host, stop } = await (0, graphql_dev_server_1.createDevServer)(opts, {
+        host: serverOpts.host ?? '127.0.0.1',
+        port: serverOpts.port ?? 0
+    });
+    return { httpServer, url, graphqlUrl, port, host, stop };
+};
+exports.createDevTestServer = createDevTestServer;
 /**
  * Create a test server for SuperTest testing
  *

package/types.d.ts

@@ -11,6 +11,17 @@ export interface ServerOptions {
     port?: number;
     /** Host to bind the server to (defaults to localhost) */
     host?: string;
+    /**
+     * Which server to run this suite against:
+     * - `true` (default): the production `@constructive-io/graphql-server`, which
+     *   resolves every request through the scoped-routing plane. Suites must seed
+     *   real routing/database records so `resolve_route()` returns a real
+     *   database id.
+     * - `false`: the single-tenant `@constructive-io/graphql-dev-server`
+     *   (pure PostGraphile, no routing, no database id) exposing the configured
+     *   schemas directly. For local/static suites only.
+     */
+    scopedRouting?: boolean;
     /**
      * API configuration options for the GraphQL server.
      * These options control how the server handles requests and which features are enabled.
@@ -21,11 +32,7 @@ export interface ServerOptions {
      *   schemas: ['app_public'],
      *   server: {
      *     port: 5555,
-     *     api: {
-     *       enableScopedRouting: false,
-     *       isPublic: false,
-     *       defaultDatabaseId: 'my-database'
-     *     }
+     *     scopedRouting: false
      *   }
      * });
      * ```