graphql-server-test 0.3.0 → 0.3.1

package/README.md

@@ -157,14 +157,36 @@ it('matches snapshot', async () => {
 
 ### GetConnectionsInput
 
-| Option | Type | Description |
-|--------|------|-------------|
-| `schemas` | `string[]` | PostgreSQL schemas to expose in GraphQL |
-| `authRole` | `string` | Default role for anonymous requests |
-| `useRoot` | `boolean` | Use root/superuser for queries (bypasses RLS) |
-| `graphile` | `GraphileOptions` | Graphile/PostGraphile configuration |
-| `server.port` | `number` | Port to run the server on (default: random) |
-| `server.host` | `string` | Host to bind the server to (default: localhost) |
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `schemas` | `string[]` | required | PostgreSQL schemas to expose in GraphQL |
+| `authRole` | `string` | - | Default role for anonymous requests |
+| `useRoot` | `boolean` | `false` | Use root/superuser for queries (bypasses RLS) |
+| `graphile` | `GraphileOptions` | - | Graphile/PostGraphile configuration |
+| `server.port` | `number` | random | Port to run the server on |
+| `server.host` | `string` | `localhost` | Host to bind the server to |
+| `enableServicesApi` | `boolean` | `false` | Enable domain/subdomain routing via services_public |
+
+### Services API
+
+By default, `enableServicesApi` is set to `false`, which bypasses domain/subdomain routing and directly exposes the schemas you specify. This is the recommended setting for most testing scenarios.
+
+When `enableServicesApi` is `true`, the server uses the `services_public` schema to resolve which API and schemas to expose based on the incoming request's domain/subdomain. This is useful when you need to test the full domain routing behavior.
+
+```typescript
+// Default: bypasses domain routing, directly exposes specified schemas
+const { query } = await getConnections({
+  schemas: ['app_public'],
+  authRole: 'anonymous'
+});
+
+// With Services API enabled: uses domain/subdomain routing
+const { query } = await getConnections({
+  schemas: ['app_public'],
+  authRole: 'anonymous',
+  enableServicesApi: true
+});
+```
 
 ## Comparison with Other Test Packages
 

package/esm/get-connections.js

@@ -35,11 +35,12 @@ export const getConnections = async (input, seedAdapters) => {
     // Get database connections using pgsql-test
     const conn = await getPgConnections(input, seedAdapters);
     const { pg, db, teardown: dbTeardown } = conn;
-    // Build options for the HTTP server with enableServicesApi: false
+    // Build options for the HTTP server
+    // enableServicesApi defaults to false for testing (bypasses domain routing)
     const serverOpts = getEnvOptions({
         pg: pg.config,
         api: {
-            enableServicesApi: false,
+            enableServicesApi: input.enableServicesApi ?? false,
             exposedSchemas: input.schemas,
             defaultDatabaseId: 'test-database',
             ...(input.authRole && { anonRole: input.authRole, roleName: input.authRole })

package/get-connections.js

@@ -38,11 +38,12 @@ const getConnections = async (input, seedAdapters) => {
     // Get database connections using pgsql-test
     const conn = await (0, pgsql_test_1.getConnections)(input, seedAdapters);
     const { pg, db, teardown: dbTeardown } = conn;
-    // Build options for the HTTP server with enableServicesApi: false
+    // Build options for the HTTP server
+    // enableServicesApi defaults to false for testing (bypasses domain routing)
     const serverOpts = (0, graphql_env_1.getEnvOptions)({
         pg: pg.config,
         api: {
-            enableServicesApi: false,
+            enableServicesApi: input.enableServicesApi ?? false,
             exposedSchemas: input.schemas,
             defaultDatabaseId: 'test-database',
             ...(input.authRole && { anonRole: input.authRole, roleName: input.authRole })

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "graphql-server-test",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "author": "Constructive <developers@constructive.io>",
   "description": "Constructive GraphQL Server Testing with SuperTest HTTP requests",
   "main": "index.js",
@@ -57,5 +57,5 @@
     "e2e",
     "server"
   ],
-  "gitHead": "03a70081e7a3d761c43432866726ddf641e05531"
+  "gitHead": "480672e14ed6050622f50bace9c647580128688e"
 }

package/types.d.ts

@@ -43,6 +43,13 @@ export interface GetConnectionsInput {
     graphile?: GraphileOptions;
     /** Server configuration options */
     server?: ServerOptions;
+    /**
+     * Enable the Services API (domain/subdomain routing via services_public).
+     * When false (default), bypasses domain routing and directly exposes the specified schemas.
+     * When true, uses services_public to resolve which API/schemas to expose based on domain/subdomain.
+     * @default false
+     */
+    enableServicesApi?: boolean;
 }
 /**
  * GraphQL response structure