feat: v5-native filter system — complete rewrite with declarative API, full test coverage, and new plugins

.github/workflows/run-tests.yaml

@@ -71,9 +71,9 @@ jobs:
             env: {}
           - package: graphile/graphile-test
             env: {}
-          - package: graphile/graphile-search-plugin
+          - package: graphile/graphile-tsvector
             env: {}
-          - package: graphile/graphile-pgvector-plugin
+          - package: graphile/graphile-connection-filter
             env: {}
           - package: graphql/server-test
             env: {}
@@ -107,6 +107,10 @@ jobs:
             env: {}
           - package: packages/postmaster
             env: {}
+          - package: graphile/graphile-pgvector
+            env: {}
+          - package: graphile/graphile-settings
+            env: {}
 
     env:
       PGHOST: localhost

GRAPHILE.md

@@ -55,10 +55,13 @@ All Graphile RC dependencies are pinned to **exact versions** (no `^` or `~` pre
 - **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
 - **graphile-query** -- Executes GraphQL queries against PostGraphile v5 schemas
-- **graphile-search-plugin** -- Full-text search plugin for PostGraphile v5
+- **graphile-tsvector** -- Full-text search plugin for PostGraphile v5 (tsvector columns, `matches` filter, rank scoring)
+- **graphile-bm25** -- BM25 ranked full-text search plugin for PostGraphile v5 (pg_textsearch auto-discovery, score fields, orderBy)
+- **graphile-trgm** -- pg_trgm fuzzy text matching plugin for PostGraphile v5 (similarTo/wordSimilarTo operators, similarity scoring)
+- **graphile-pgvector** -- pgvector codec + auto-discovered vector search plugin for PostGraphile v5
+- **graphile-connection-filter** -- v5-native connection filter plugin (scalar, logical, array, relation, computed column filters)
 - **graphile-cache** -- LRU cache with PostGraphile v5 integration
 - **graphile-test** -- PostGraphile v5 testing utilities
-- **graphile-pgvector-plugin** -- pgvector codec + auto-discovered vector search plugin for PostGraphile v5
 
 ### `graphql/` packages
 

functions/send-email-link/src/index.ts

@@ -14,7 +14,7 @@ const app = createJobApp();
 
 const GetUser = gql`
   query GetUser($userId: UUID!) {
-    users(condition: { id: $userId }, first: 1) {
+    users(filter: { id: { equalTo: $userId } }, first: 1) {
       nodes {
         username
         displayName
@@ -26,7 +26,7 @@ const GetUser = gql`
 
 const GetDatabaseInfo = gql`
   query GetDatabaseInfo($databaseId: UUID!) {
-    databases(condition: { id: $databaseId }, first: 1) {
+    databases(filter: { id: { equalTo: $databaseId } }, first: 1) {
       nodes {
         sites {
           nodes {
@@ -43,7 +43,7 @@ const GetDatabaseInfo = gql`
                 theme
               }
             }
-            siteModules(condition: { name: "legal_terms_module" }) {
+            siteModules(filter: { name: { equalTo: "legal_terms_module" } }) {
               nodes {
                 data
               }

graphile/graphile-pg-textsearch-plugin/README.md → graphile/graphile-bm25/README.md

@@ -1,4 +1,4 @@
-# graphile-pg-textsearch-plugin
+# graphile-bm25
 
 <p align="center" width="100%">
   <img height="250" src="https://raw.githubusercontent.com/constructive-io/constructive/refs/heads/main/assets/outline-logo.svg" />
@@ -11,23 +11,23 @@
   <a href="https://github.com/constructive-io/constructive/blob/main/LICENSE">
     <img height="20" src="https://img.shields.io/badge/license-MIT-blue.svg"/>
   </a>
-  <a href="https://www.npmjs.com/package/graphile-pg-textsearch-plugin">
-    <img height="20" src="https://img.shields.io/github/package-json/v/constructive-io/constructive?filename=graphile%2Fgraphile-pg-textsearch-plugin%2Fpackage.json"/>
+  <a href="https://www.npmjs.com/package/graphile-bm25">
+    <img height="20" src="https://img.shields.io/github/package-json/v/constructive-io/constructive?filename=graphile%2Fgraphile-bm25%2Fpackage.json"/>
   </a>
 </p>
 
-**`graphile-pg-textsearch-plugin`** enables auto-discovered BM25 ranked full-text search for PostGraphile v5 schemas using [pg_textsearch](https://github.com/timescale/pg_textsearch).
+**`graphile-bm25`** enables auto-discovered BM25 ranked full-text search for PostGraphile v5 schemas using [pg_textsearch](https://github.com/timescale/pg_textsearch).
 
 ## Installation
 
 ```sh
-npm install graphile-pg-textsearch-plugin
+npm install graphile-bm25
 ```
 
 ## Features
 
 - **Auto-discovery**: Finds all text columns with BM25 indexes automatically — zero configuration
-- **Condition fields**: `bm25<Column>` condition inputs accepting `{ query, threshold? }` for BM25 ranked search
+- **Filter fields**: `bm25<Column>` filter inputs accepting `{ query, threshold? }` for BM25 ranked search
 - **Score fields**: `bm25<Column>Score` computed fields returning BM25 relevance scores (negative values, more negative = more relevant)
 - **OrderBy**: `BM25_<COLUMN>_SCORE_ASC/DESC` enum values for sorting by relevance
 - Works with PostGraphile v5 preset/plugin pipeline
@@ -37,7 +37,7 @@ npm install graphile-pg-textsearch-plugin
 ### With Preset (Recommended)
 
 ```typescript
-import { Bm25SearchPreset } from 'graphile-pg-textsearch-plugin';
+import { Bm25SearchPreset } from 'graphile-bm25';
 
 const preset = {
   extends: [
@@ -50,7 +50,7 @@ const preset = {
 ### With Plugin Directly
 
 ```typescript
-import { Bm25CodecPlugin, Bm25SearchPlugin } from 'graphile-pg-textsearch-plugin';
+import { Bm25CodecPlugin, Bm25SearchPlugin } from 'graphile-bm25';
 
 const preset = {
   plugins: [
@@ -64,12 +64,12 @@ const preset = {
 
 ```graphql
 query SearchArticles($search: Bm25SearchInput!) {
-  articles(condition: { bm25Body: $search }) {
+  articles(filter: { bm25Body: $search }) {
     nodes {
       id
       title
       body
-      bm25BodyScore
+      bodyBm25Score
     }
   }
 }
@@ -91,13 +91,13 @@ Variables:
 ```graphql
 query SearchArticlesSorted($search: Bm25SearchInput!) {
   articles(
-    condition: { bm25Body: $search }
-    orderBy: BM25_BODY_SCORE_ASC
+    filter: { bm25Body: $search }
+    orderBy: BODY_BM25_SCORE_ASC
   ) {
     nodes {
       id
       title
-      bm25BodyScore
+      bodyBm25Score
     }
   }
 }
@@ -118,6 +118,6 @@ CREATE INDEX articles_body_idx ON articles USING bm25(body)
 
 ```sh
 # requires constructiveio/postgres-plus:18 Docker image with pg_textsearch pre-installed
-pnpm --filter graphile-pg-textsearch-plugin test
+pnpm --filter graphile-bm25 test
 ```
 

graphile/graphile-pg-textsearch-plugin/package.json → graphile/graphile-bm25/package.json

@@ -1,5 +1,5 @@
 {
-  "name": "graphile-pg-textsearch-plugin",
+  "name": "graphile-bm25",
   "version": "1.5.3",
   "description": "PostGraphile v5 plugin for pg_textsearch BM25 ranked full-text search — auto-discovers BM25 indexes and adds search condition, score, orderBy, and filter fields",
   "author": "Constructive <developers@constructive.io>",
@@ -31,6 +31,7 @@
   "devDependencies": {
     "@types/node": "^22.19.11",
     "@types/pg": "^8.18.0",
+    "graphile-connection-filter": "workspace:^",
     "graphile-test": "workspace:^",
     "makage": "^0.1.10",
     "pg": "^8.19.0",
@@ -43,13 +44,7 @@
     "graphile-config": "1.0.0-rc.5",
     "graphql": "^16.9.0",
     "pg-sql2": "5.0.0-rc.4",
-    "postgraphile": "5.0.0-rc.7",
-    "postgraphile-plugin-connection-filter": "3.0.0-rc.1"
-  },
-  "peerDependenciesMeta": {
-    "postgraphile-plugin-connection-filter": {
-      "optional": true
-    }
+    "postgraphile": "5.0.0-rc.7"
   },
   "keywords": [
     "postgraphile",