feat: add dedicated test suite for graphile-connection-filter

.github/workflows/run-tests.yaml

@@ -75,6 +75,8 @@ jobs:
             env: {}
           - package: graphile/graphile-pgvector-plugin
             env: {}
+          - package: graphile/graphile-connection-filter
+            env: {}
           - package: graphql/server-test
             env: {}
           - package: graphql/env

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-connection-filter/README.md

@@ -0,0 +1,40 @@
+# graphile-connection-filter
+
+A PostGraphile v5 native connection filter plugin for the Constructive monorepo.
+
+Adds advanced filtering capabilities to connection and list fields, including:
+
+- Per-table filter types (e.g. `UserFilter`)
+- Per-scalar operator types (e.g. `StringFilter`, `IntFilter`)
+- Standard operators: `equalTo`, `notEqualTo`, `isNull`, `in`, `notIn`, etc.
+- Sort operators: `lessThan`, `greaterThan`, etc.
+- Pattern matching: `includes`, `startsWith`, `endsWith`, `like` + case-insensitive variants
+- Type-specific operators: JSONB, hstore, inet, array, range
+- Logical operators: `and`, `or`, `not`
+- Custom operator API: `addConnectionFilterOperator` for satellite plugins
+
+## Usage
+
+```typescript
+import { ConnectionFilterPreset } from 'graphile-connection-filter';
+
+const preset: GraphileConfig.Preset = {
+  extends: [
+    ConnectionFilterPreset(),
+  ],
+};
+```
+
+## Custom Operators
+
+Satellite plugins can register custom operators during the `init` hook:
+
+```typescript
+const addConnectionFilterOperator = (build as any).addConnectionFilterOperator;
+if (typeof addConnectionFilterOperator === 'function') {
+  addConnectionFilterOperator('MyType', 'myOperator', {
+    description: 'My custom operator',
+    resolve: (sqlIdentifier, sqlValue) => sql`${sqlIdentifier} OP ${sqlValue}`,
+  });
+}
+```