chore: scrub stale filter argument references in comments/errors

The GraphQL connection argument was renamed from `filter` to `where`
back in commit 10b4fc6 (via `connectionFilterArgumentName: 'where'` in
`graphile-connection-filter`'s default preset). A number of JSDoc
examples, plugin descriptions, and error strings were not updated at
the time and still referenced the old `filter:` name, which was
confusing when reading the code.

This change:
- Updates JSDoc `filter: { ... }` examples to `where: { ... }` in the
  forward/backward/computed-attribute relation plugins, the spatial
  relations plugin, and the constructive preset.
- Rewords the `ConnectionFilterArgPlugin` JSDoc, description, and
  internal log string to reflect that the argument name is `where`.
- Renames the "Empty objects are forbidden in filter argument input"
  and "Null literals are forbidden in filter argument input" error
  messages to say "where argument input".
- Fixes the stale preset comments that still claimed filtering lives
  under the `filter` argument.
- Renames one test case title to match what it actually asserts (`where`
  not `filter`).

No behavior change beyond the text of the above two error messages.

Author: pyramation

graphile/graphile-connection-filter/src/plugins/ConnectionFilterArgPlugin.ts

@@ -7,17 +7,18 @@ const version = '1.0.0';
 /**
  * ConnectionFilterArgPlugin
  *
- * Adds the filter argument (configurable name, default 'where') to connection
- * and simple collection fields. Uses `applyPlan` to create a PgCondition that
- * child filter fields can add WHERE clauses to.
+ * Adds the `where` argument (name configurable via
+ * `connectionFilterArgumentName`, default `'where'`) to connection and
+ * simple collection fields. Uses `applyPlan` to create a PgCondition
+ * that child filter fields can add WHERE clauses to.
  *
  * This runs before PgConnectionArgOrderByPlugin so that filters are applied
  * before ordering (important for e.g. full-text search rank ordering).
  */
 export const ConnectionFilterArgPlugin: GraphileConfig.Plugin = {
   name: 'ConnectionFilterArgPlugin',
   version,
-  description: 'Adds the filter argument to connection and list fields',
+  description: 'Adds the `where` argument to connection and list fields',
   before: ['PgConnectionArgOrderByPlugin'],
 
   schema: {
@@ -100,7 +101,7 @@ export const ConnectionFilterArgPlugin: GraphileConfig.Plugin = {
                           fieldArg.apply(
                             $pgSelect,
                             (queryBuilder: any, value: any) => {
-                              // If filter is null/undefined or empty {}, treat as "no filter" — skip
+                              // If where is null/undefined or empty {}, treat as "no filter" — skip
                               if (value == null || isEmpty(value)) return;
                               const condition = new PgCondition(queryBuilder);
                               if (attributeCodec) {
@@ -126,7 +127,7 @@ export const ConnectionFilterArgPlugin: GraphileConfig.Plugin = {
                           fieldArg.apply(
                             $pgSelect,
                             (queryBuilder: any, value: any) => {
-                              // If filter is null/undefined or empty {}, treat as "no filter" — skip
+                              // If where is null/undefined or empty {}, treat as "no filter" — skip
                               if (value == null || isEmpty(value)) return;
                               const condition = new PgCondition(queryBuilder);
                               if (attributeCodec) {
@@ -143,7 +144,7 @@ export const ConnectionFilterArgPlugin: GraphileConfig.Plugin = {
                   }),
             },
           },
-          `Adding connection filter '${argName}' arg to field '${fieldName}' of '${Self.name}'`
+          `Adding connection where arg '${argName}' to field '${fieldName}' of '${Self.name}'`
         );
       },
     },

graphile/graphile-connection-filter/src/plugins/ConnectionFilterAttributesPlugin.ts

@@ -96,7 +96,7 @@ export const ConnectionFilterAttributesPlugin: GraphileConfig.Plugin = {
                         if (isEmpty(value)) {
                           throw Object.assign(
                             new Error(
-                              'Empty objects are forbidden in filter argument input.'
+                              'Empty objects are forbidden in where argument input.'
                             ),
                             {}
                           );
@@ -107,7 +107,7 @@ export const ConnectionFilterAttributesPlugin: GraphileConfig.Plugin = {
                         ) {
                           throw Object.assign(
                             new Error(
-                              'Null literals are forbidden in filter argument input.'
+                              'Null literals are forbidden in where argument input.'
                             ),
                             {}
                           );

graphile/graphile-connection-filter/src/plugins/ConnectionFilterBackwardRelationsPlugin.ts

@@ -15,15 +15,15 @@ const version = '1.0.0';
  *
  * For unique backward relations (one-to-one), a single filter field is added:
  * ```graphql
- * allClients(filter: {
+ * allClients(where: {
  *   profileByClientId: { bio: { includes: "engineer" } }
  * }) { ... }
  * ```
  *
  * For non-unique backward relations (one-to-many), a "many" filter type is added
  * with `some`, `every`, and `none` sub-fields:
  * ```graphql
- * allClients(filter: {
+ * allClients(where: {
  *   ordersByClientId: { some: { total: { greaterThan: 1000 } } }
  * }) { ... }
  * ```

graphile/graphile-connection-filter/src/plugins/ConnectionFilterComputedAttributesPlugin.ts

@@ -18,7 +18,7 @@ const version = '1.0.0';
  *
  * This plugin adds a `fullName` filter field to `PersonFilter`, typed as `StringFilter`,
  * allowing queries like:
- *   { people(filter: { fullName: { startsWith: "John" } }) { ... } }
+ *   { people(where: { fullName: { startsWith: "John" } }) { ... } }
  *
  * Controlled by the `connectionFilterComputedColumns` schema option (default: true).
  * Requires the `filterBy` behavior on the pgResource to be enabled.

graphile/graphile-connection-filter/src/plugins/ConnectionFilterForwardRelationsPlugin.ts

@@ -18,7 +18,7 @@ const version = '1.0.0';
  * allowing queries like:
  *
  * ```graphql
- * allOrders(filter: {
+ * allOrders(where: {
  *   clientByClientId: { name: { startsWith: "Acme" } }
  * }) { ... }
  * ```

graphile/graphile-connection-filter/src/plugins/operatorApply.ts

@@ -83,7 +83,7 @@ export function makeApplyFromOperatorSpec(
         }
         if (!connectionFilterAllowNullInput && value === null) {
           throw Object.assign(
-            new Error('Null literals are forbidden in filter argument input.'),
+            new Error('Null literals are forbidden in where argument input.'),
             {}
           );
         }

graphile/graphile-connection-filter/src/utils.ts

@@ -116,11 +116,11 @@ export function makeAssertAllowed(build: any): (value: unknown, mode: 'object' |
       isEmpty: (o: unknown) => boolean
     ) =>
       function (value: unknown, mode: 'object' | 'list') {
-        // Reject empty objects in nested filter contexts (and/or/not, relation filters)
+        // Reject empty objects in nested where contexts (and/or/not, relation filters)
         if (mode === 'object' && isEmpty(value)) {
           throw Object.assign(
             new Error(
-              'Empty objects are forbidden in filter argument input.'
+              'Empty objects are forbidden in where argument input.'
             ),
             {}
           );
@@ -134,7 +134,7 @@ export function makeAssertAllowed(build: any): (value: unknown, mode: 'object' |
               if (isEmpty(arr[i])) {
                 throw Object.assign(
                   new Error(
-                    'Empty objects are forbidden in filter argument input.'
+                    'Empty objects are forbidden in where argument input.'
                   ),
                   {}
                 );
@@ -147,7 +147,7 @@ export function makeAssertAllowed(build: any): (value: unknown, mode: 'object' |
         if (!connectionFilterAllowNullInput && value === null) {
           throw Object.assign(
             new Error(
-              'Null literals are forbidden in filter argument input.'
+              'Null literals are forbidden in where argument input.'
             ),
             {}
           );

graphile/graphile-postgis/src/plugins/spatial-relations.ts

@@ -46,7 +46,7 @@ import type { PostgisExtensionInfo } from './detect-extension';
  * Generated GraphQL (for the `st_dwithin` case):
  *
  * ```graphql
- * telemedicineClinics(filter: {
+ * telemedicineClinics(where: {
  *   nearbyClinic: {
  *     distance: 5000,
  *     some: { specialty: { eq: "pediatrics" } }

graphile/graphile-settings/__tests__/preset-integration.test.ts

@@ -131,7 +131,7 @@ describe('Schema introspection', () => {
     expect(fieldNames).toContain('embedding');
   });
 
-  it('locations connection exists and has filter argument but no condition', async () => {
+  it('locations connection exists and has where argument but no condition', async () => {
     const result = await query<{ __type: { fields: { name: string; args: { name: string }[] }[] } | null }>({
       query: `
         query {

graphile/graphile-settings/src/plugins/enable-all-filter-columns.ts

@@ -39,7 +39,7 @@ import type { GraphileConfig } from 'graphile-config';
  * and adds `+attribute:filterBy` and `+attribute:orderBy` back to ALL columns, regardless of index status.
  *
  * This means:
- * - All columns will appear in the connection filter's filter argument
+ * - All columns will appear in the connection filter's `where` argument
  * - All columns will appear in the connection's orderBy enum
  * - Developers can filter and sort by any column
  * - It's the developer's/DBA's responsibility to add indexes for frequently filtered/sorted columns