These plugins add a new filter: argument to Connection types in PostGraphile v4. No changes are made to the existing condition: argument.

These plugins target the alpha release of PostGraphile. Bug reports and pull requests are very much welcome.

postgraphile --append-plugins `pwd`/path/to/this/plugin/index.js

const express = require("express");
const { postgraphql } = require("postgraphile");
const GraphileBuildPgContribConnectionFilter = require("./path/to/this/plugin/index.js");

const app = express();

app.use(
  postgraphql(pgConfig, schema, {
    graphiql: true,
    appendPlugins: [GraphileBuildPgContribConnectionFilter],
  })
);

app.listen(3000);

The following options can be passed via graphqlBuildOptions:

Use short names (e.g. eq, ne, lt, lte) for operators

postgraphql(pgConfig, schema, {
  ...
  graphqlBuildOptions: {
    connectionFilterUsesShortNames: true,
  },
})

Restrict filters to specific field types

postgraphql(pgConfig, schema, {
  ...
  graphqlBuildOptions: {
    connectionFilterAllowedFieldTypes: ["String", "Int"],
  },
})

To add/remove/modify individual operators, you can edit src/PgConnectionArgFilterOperatorsPlugin.js.

To establish a test environment, create an empty Postgres database (e.g. graphile-build-test) and set a TEST_DATABASE_URL environment variable with your connection string (e.g. postgres://localhost:5432/graphile-build-test). Ensure that psql is installed locally and then run:

npm install
npm test