pin graphile rc versions in graphql/* packages to fix dual-install of grafast

- Pin grafast, grafserv, graphile-build, graphile-build-pg, graphile-config, pg-sql2, postgraphile in graphql/test, graphql/query, graphql/server, graphql/explorer
- Fixes runtime error: Preset attempted to register version 'rc.7' of 'grafast' but 'rc.4' is already registered
- Update GRAPHILE.md to document graphql/* packages

Author: pyramation

GRAPHILE.md

@@ -50,7 +50,7 @@ All Graphile RC dependencies are pinned to **exact versions** (no `^` or `~` pre
 
 ## Packages That Use Graphile
 
-The following packages in `graphile/` depend on the Graphile RC ecosystem:
+### `graphile/` packages
 
 - **graphile-settings** -- Core settings/configuration for PostGraphile v5 (most deps, including the transitive peer deps `tamedevil`, `@dataplan/pg`, `@dataplan/json`, `grafserv`)
 - **graphile-schema** -- Builds GraphQL SDL from PostgreSQL using PostGraphile v5
@@ -61,14 +61,24 @@ The following packages in `graphile/` depend on the Graphile RC ecosystem:
 - **graphile-authz** -- Dynamic authorization plugin for PostGraphile v5
 - **postgraphile-plugin-pgvector** -- pgvector similarity search plugin for PostGraphile v5
 
+### `graphql/` packages
+
+- **@constructive-io/graphql-server** -- GraphQL server with PostGraphile v5
+- **@constructive-io/graphql-test** -- GraphQL testing with all plugins loaded
+- **@constructive-io/graphql-query** -- GraphQL query builder
+- **@constructive-io/graphql-explorer** -- GraphQL Explorer UI
+
+**Important:** Having different versions of `grafast` (or other singleton graphile packages) installed in the same workspace causes runtime errors like `Preset attempted to register version 'X' of 'grafast', but version 'Y' is already registered`. This is why **all** packages must use the same pinned versions.
+
 ## Upgrading Graphile RC Versions
 
 When upgrading to a new Graphile RC set:
 
 1. Check the latest RC versions on npm for all packages listed in the table above
 2. Verify peer dependency compatibility by running `npm view <package>@<version> peerDependencies` for each package
 3. Update **all** packages in this table simultaneously -- do not upgrade one without the others
-4. Update every `graphile/*/package.json` that references these packages
+4. Update every `graphile/*/package.json` and `graphql/*/package.json` that references these packages
 5. Run `pnpm install` to update the lockfile
-6. Run tests to verify nothing broke
-7. Update the version table in this document
+6. Run `pnpm build` to verify no type errors
+7. Run tests to verify nothing broke
+8. Update the version table in this document

graphql/explorer/package.json

@@ -39,14 +39,14 @@
     "@constructive-io/url-domains": "workspace:^",
     "@pgpmjs/server-utils": "workspace:^",
     "express": "^5.2.1",
-    "grafserv": "^1.0.0-rc.4",
+    "grafserv": "1.0.0-rc.6",
     "graphile-cache": "workspace:^",
-    "graphile-config": "1.0.0-rc.3",
+    "graphile-config": "1.0.0-rc.5",
     "graphile-settings": "workspace:^",
     "graphql": "^16.9.0",
     "pg-cache": "workspace:^",
     "pg-env": "workspace:^",
-    "postgraphile": "^5.0.0-rc.4"
+    "postgraphile": "5.0.0-rc.7"
   },
   "devDependencies": {
     "@types/express": "^5.0.6",

graphql/query/package.json

@@ -31,14 +31,14 @@
   "dependencies": {
     "ajv": "^7.0.4",
     "gql-ast": "workspace:^",
-    "grafast": "^1.0.0-rc.4",
-    "graphile-build-pg": "^5.0.0-rc.3",
-    "graphile-config": "1.0.0-rc.3",
+    "grafast": "1.0.0-rc.7",
+    "graphile-build-pg": "5.0.0-rc.5",
+    "graphile-config": "1.0.0-rc.5",
     "graphile-settings": "workspace:^",
     "graphql": "^16.9.0",
     "inflection": "^3.0.0",
     "lru-cache": "^10.4.3",
-    "postgraphile": "^5.0.0-rc.4"
+    "postgraphile": "5.0.0-rc.7"
   },
   "keywords": [
     "query",

graphql/server/package.json

@@ -53,12 +53,12 @@
     "deepmerge": "^4.3.1",
     "express": "^5.2.1",
     "gql-ast": "workspace:^",
-    "grafast": "^1.0.0-rc.4",
-    "grafserv": "^1.0.0-rc.4",
-    "graphile-build": "^5.0.0-rc.3",
-    "graphile-build-pg": "^5.0.0-rc.3",
+    "grafast": "1.0.0-rc.7",
+    "grafserv": "1.0.0-rc.6",
+    "graphile-build": "5.0.0-rc.4",
+    "graphile-build-pg": "5.0.0-rc.5",
     "graphile-cache": "workspace:^",
-    "graphile-config": "1.0.0-rc.3",
+    "graphile-config": "1.0.0-rc.5",
     "graphile-settings": "workspace:^",
     "graphql": "^16.9.0",
     "graphql-upload": "^13.0.0",
@@ -67,9 +67,9 @@
     "pg-cache": "workspace:^",
     "pg-env": "workspace:^",
     "pg-query-context": "workspace:^",
-    "pg-sql2": "^5.0.0-rc.3",
-    "postgraphile": "^5.0.0-rc.4",
-    "postgraphile-plugin-connection-filter": "^3.0.0-rc.1",
+    "pg-sql2": "5.0.0-rc.4",
+    "postgraphile": "5.0.0-rc.7",
+    "postgraphile-plugin-connection-filter": "3.0.0-rc.1",
     "request-ip": "^3.3.0"
   },
   "devDependencies": {

graphql/test/package.json

@@ -37,17 +37,17 @@
     "@constructive-io/graphql-env": "workspace:^",
     "@constructive-io/graphql-types": "workspace:^",
     "@pgpmjs/types": "workspace:^",
-    "grafast": "^1.0.0-rc.4",
-    "graphile-build": "^5.0.0-rc.3",
-    "graphile-build-pg": "^5.0.0-rc.3",
-    "graphile-config": "1.0.0-rc.3",
+    "grafast": "1.0.0-rc.7",
+    "graphile-build": "5.0.0-rc.4",
+    "graphile-build-pg": "5.0.0-rc.5",
+    "graphile-config": "1.0.0-rc.5",
     "graphile-settings": "workspace:^",
     "graphile-test": "workspace:^",
     "graphql": "^16.9.0",
     "mock-req": "^0.2.0",
     "pg": "^8.17.1",
     "pgsql-test": "workspace:^",
-    "postgraphile": "^5.0.0-rc.4"
+    "postgraphile": "5.0.0-rc.7"
   },
   "keywords": [
     "testing",