makeExtendSchemaPlugin: add ability to define field scope as part of plans

[benjie]

Description

Can now define field scope as part of plans:

const SGrovePlugin = makeExtendSchemaPlugin((build) => {
  const { sql } = build;
  const email = build.input.pgRegistry.pgResources.email;
  return {
    typeDefs: gql`
      extend type Email {
        threadAncestors: EmailsConnection
      }
    `,
    plans: {
      Email: {
        threadAncestors: {
          // 👇 👇 👇 👇 👇 👇 👇 👇 👇 👇
          scope: {
            isPgFieldConnection: true,
            pgFieldResource: email,
          },
          // 👆 👆 👆 👆 👆 👆 👆 👆 👆 👆
          plan($email) {
            const $refs = $email.get("refs");

            const $ancestors = email.find();
            $ancestors.where(
              sql`${
                $ancestors.alias
              }.id in (select unnest(${$ancestors.placeholder($refs)}))`,
            );

            return connection($ancestors);
          },
        },
      },
    },
  };
});

This still averts the need for embed() used in V4.

Further, have made the system automatically guess the scope for connection types, so when using a connection type all the arguments you'd expect (first, last, before, after, offset, condition, orderBy, etc) are automatically added. You can disable this by overwriting the scope as shown above, but setting undefined as the values for the keys.

Fixes graphile/crystal-pre-merge#476

Performance impact

Build-time only.

Security impact

None known.

Checklist

• My code matches the project's code style and yarn lint:fix passes.
• I've added tests for the new feature, and yarn test passes.
• I have detailed the new feature in the relevant documentation.
• I have added this feature to 'Pending' in the RELEASE_NOTES.md file (if one exists).
• If this is a breaking change I've explained why.

[changeset-bot]

🦋 Changeset detected

Latest commit: d9d7d43

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 4 packages

Name	Type
graphile-utils	Patch
postgraphile	Patch
pgl	Patch
graphile	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR