graphile-build 4.12.3 → 5.0.0-0.10

package/CHANGELOG.md

@@ -0,0 +1,100 @@
+# graphile-build
+
+## 5.0.0-0.10
+
+### Patch Changes
+
+- Updated dependencies
+  [[`208166269`](https://github.com/benjie/postgraphile-private/commit/208166269177d6e278b056e1c77d26a2d8f59f49)]:
+  - grafast@0.0.1-0.8
+
+## 5.0.0-0.9
+
+### Patch Changes
+
+- [`6ebe3a13e`](https://github.com/benjie/postgraphile-private/commit/6ebe3a13e563f2bd665b24a5c84bbfc5eba1cc0a)
+  Thanks [@benjie](https://github.com/benjie)! - Enable omitting update/delete
+  mutations using behaviors on unique constraints.
+
+## 5.0.0-0.8
+
+### Patch Changes
+
+- [`677c8f5fc`](undefined) - Create new getTags() introspection helper and use
+  it. Rename GraphileBuild.GraphileBuildSchemaOptions to
+  GraphileBuild.SchemaOptions. Fix a couple minor inflection bugs. Add some
+  missing descriptions. Fix the initial inflection types to not leak
+  implementation details. Fix inflectors to use ResolvedPreset rather than
+  Preset.
+- Updated dependencies []:
+  - grafast@0.0.1-0.7
+
+## 5.0.0-0.7
+
+### Patch Changes
+
+- [`9b296ba54`](undefined) - More secure, more compatible, and lots of fixes
+  across the monorepo
+
+- Updated dependencies [[`9b296ba54`](undefined)]:
+  - grafast@0.0.1-0.6
+  - graphile-config@0.0.1-0.2
+
+## 5.0.0-0.6
+
+### Patch Changes
+
+- Updated dependencies [[`cd37fd02a`](undefined)]:
+  - grafast@0.0.1-0.5
+
+## 5.0.0-0.5
+
+### Patch Changes
+
+- [`768f32681`](undefined) - Fix peerDependencies ranges
+
+- Updated dependencies [[`768f32681`](undefined)]:
+  - grafast@0.0.1-0.4
+  - graphile-export@0.0.2-0.4
+
+## 5.0.0-0.4
+
+### Patch Changes
+
+- [`d11c1911c`](undefined) - Fix dependencies
+
+- Updated dependencies [[`d11c1911c`](undefined)]:
+  - grafast@0.0.1-0.3
+  - graphile-config@0.0.1-0.1
+  - graphile-export@0.0.2-0.3
+
+## 5.0.0-0.3
+
+### Patch Changes
+
+- Updated dependencies [[`25037fc15`](undefined)]:
+  - grafast@0.0.1-0.2
+  - graphile-export@0.0.2-0.2
+
+## 5.0.0-0.2
+
+### Patch Changes
+
+- Updated dependencies [[`55f15cf35`](undefined)]:
+  - grafast@0.0.1-0.1
+  - graphile-export@0.0.2-0.1
+
+## 5.0.0-0.1
+
+### Patch Changes
+
+- [#125](https://github.com/benjie/postgraphile-private/pull/125)
+  [`91f2256b3`](https://github.com/benjie/postgraphile-private/commit/91f2256b3fd699bec19fc86f1ca79df057e58639)
+  Thanks [@benjie](https://github.com/benjie)! - Initial changesets release
+
+- Updated dependencies
+  [[`91f2256b3`](https://github.com/benjie/postgraphile-private/commit/91f2256b3fd699bec19fc86f1ca79df057e58639)]:
+  - @graphile/lru@5.0.0-0.1
+  - grafast@0.0.1-0.0
+  - graphile-config@0.0.1-0.0
+  - graphile-export@0.0.2-0.0

package/LICENSE.md

@@ -1,24 +1,20 @@
 # The MIT License (MIT)
 
-Copyright © `2018` Benjie Gillam
+Copyright © `2023` Benjie Gillam
 
-Permission is hereby granted, free of charge, to any person
-obtaining a copy of this software and associated documentation
-files (the “Software”), to deal in the Software without
-restriction, including without limitation the rights to use,
-copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the
-Software is furnished to do so, subject to the following
-conditions:
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the “Software”), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
 
-The above copyright notice and this permission notice shall be
-included in all copies or substantial portions of the Software.
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
 
-THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND,
-EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
-OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
-NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
-HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
-WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
-FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
-OTHER DEALINGS IN THE SOFTWARE.
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -1,34 +1,37 @@
 # graphile-build
 
-<span class="badge-patreon"><a href="https://patreon.com/benjie" title="Support Graphile development on Patreon"><img src="https://img.shields.io/badge/sponsor-via%20Patreon-orange.svg" alt="Patreon sponsor button" /></a></span>
+[![GitHub Sponsors](https://img.shields.io/github/sponsors/benjie?color=ff69b4&label=github%20sponsors)](https://github.com/sponsors/benjie)
+[![Patreon sponsor button](https://img.shields.io/badge/sponsor-via%20Patreon-orange.svg)](https://patreon.com/benjie)
 [![Discord chat room](https://img.shields.io/discord/489127045289476126.svg)](http://discord.gg/graphile)
-[![Package on npm](https://img.shields.io/npm/v/graphile-build.svg?style=flat)](https://www.npmjs.com/package/graphile-build)
-![MIT license](https://img.shields.io/npm/l/graphile-build.svg)
 [![Follow](https://img.shields.io/badge/twitter-@GraphileHQ-blue.svg)](https://twitter.com/GraphileHQ)
 
-`graphile-build` is the core of Graphile Engine. It provides a framework to
-build high-performance extensible GraphQL APIs by combining plugins and using
-advanced query look-ahead features. Each plugin typically has its own small
-purpose (such as implementing the Node interface, adding `query: Query` to
-mutation payloads, or watching an external source for schema changes) and by
-combining these plugins together you get a large, powerful, and manageable
-GraphQL schema. Plugins enable you to make broad changes to your GraphQL
-schema with minimal code and without sacrificing performance.
-
-An example of an application built on `graphile-build` is
-[PostGraphile](https://github.com/graphile/postgraphile) which with one
-command connects to your PostgreSQL database and provides a full highly
-performant standards-compliant GraphQL API. The separate `graphile-build-pg`
-module contains the plugins that are specific to PostgreSQL support
-(`graphile-build` itself does not know about databases).
+`graphile-build` provides a framework to build extensible GraphQL APIs by
+combining plugins. Each plugin typically has its own small purpose (such as
+implementing the [`Node` interface][global-object-identification], adding
+`query: Query` to mutation payloads, or watching an external source for schema
+changes) and by combining these plugins together you get a large, powerful, and
+manageable GraphQL schema. Plugins enable you to make broad changes to your
+GraphQL schema with minimal code, and because you're changing your schema in
+broad ways it helps to guarantee consistency.
+
+Graphile Build has strong built-in support for [Gra*fast*](https://grafast.org)
+so you can make an exceptionally performant auto-generated (or
+generator-assisted) GraphQL API.
+
+[PostGraphile](https://github.com/graphile/postgraphile) uses Graphile Build and
+Gra*fast* to produce an extremely high performance standards-compliant GraphQL
+API with minimal fuss. The separate
+[`graphile-build-pg` module](../graphile-build-pg/README.md) contains the
+plugins that are specific to PostgreSQL support (`graphile-build` itself does
+not know nor care about databases).
 
 <!-- SPONSORS_BEGIN -->
 
 ## Crowd-funded open-source software
 
-To help us develop this software sustainably under the MIT license, we ask
-all individuals and businesses that use it to help support its ongoing
-maintenance and development via sponsorship.
+To help us develop this software sustainably under the MIT license, we ask all
+individuals and businesses that use it to help support its ongoing maintenance
+and development via sponsorship.
 
 ### [Click here to find out more about sponsors and sponsorship.](https://www.graphile.org/sponsor/)
 
@@ -36,16 +39,16 @@ And please give some love to our featured sponsors 🤩:
 
 <table><tr>
 <td align="center"><a href="https://surge.io/"><img src="https://graphile.org/images/sponsors/surge.png" width="90" height="90" alt="Surge" /><br />Surge</a> *</td>
-<td align="center"><a href="https://storyscript.com/?utm_source=postgraphile"><img src="https://graphile.org/images/sponsors/storyscript.png" width="90" height="90" alt="Story.ai" /><br />Story.ai</a> *</td>
-<td align="center"><a href="http://chads.website"><img src="https://graphile.org/images/sponsors/chadf.png" width="90" height="90" alt="Chad Furman" /><br />Chad Furman</a> *</td>
+<td align="center"><a href="https://www.netflix.com/"><img src="https://graphile.org/images/sponsors/Netflix.png" width="90" height="90" alt="Netflix" /><br />Netflix</a> *</td>
+<td align="center"><a href="https://qwick.com/"><img src="https://graphile.org/images/sponsors/qwick.png" width="90" height="90" alt="Qwick" /><br />Qwick</a> *</td>
 <td align="center"><a href="https://www.the-guild.dev/"><img src="https://graphile.org/images/sponsors/theguild.png" width="90" height="90" alt="The Guild" /><br />The Guild</a> *</td>
 </tr><tr>
-<td align="center"><a href="https://qwick.com/"><img src="https://graphile.org/images/sponsors/qwick.png" width="90" height="90" alt="Qwick" /><br />Qwick</a> *</td>
+<td align="center"><a href="http://chads.website"><img src="https://graphile.org/images/sponsors/chadf.png" width="90" height="90" alt="Chad Furman" /><br />Chad Furman</a> *</td>
 <td align="center"><a href="https://www.fanatics.com/"><img src="https://graphile.org/images/sponsors/fanatics.png" width="90" height="90" alt="Fanatics" /><br />Fanatics</a> *</td>
-<td align="center"><a href="https://graphcdn.io/"><img src="https://graphile.org/images/sponsors/GraphCDN.png" width="90" height="90" alt="GraphCDN" /><br />GraphCDN</a> *</td>
 <td align="center"><a href="https://dovetailapp.com/"><img src="https://graphile.org/images/sponsors/dovetail.png" width="90" height="90" alt="Dovetail" /><br />Dovetail</a> *</td>
-</tr><tr>
 <td align="center"><a href="https://www.enzuzo.com/"><img src="https://graphile.org/images/sponsors/enzuzo.png" width="90" height="90" alt="Enzuzo" /><br />Enzuzo</a> *</td>
+</tr><tr>
+<td align="center"><a href="https://stellate.co/"><img src="https://graphile.org/images/sponsors/Stellate.png" width="90" height="90" alt="Stellate" /><br />Stellate</a> *</td>
 </tr></table>
 
 <em>\* Sponsors the entire Graphile suite</em>
@@ -54,11 +57,7 @@ And please give some love to our featured sponsors 🤩:
 
 ## Documentation
 
-**For in-depth documentation about `graphile-build`, please see [the graphile
-documentation website at graphile.org](https://www.graphile.org/).** The
-below just serves as a limited quick-reference for people already familiar
-with the library.
+TODO!
 
-**Please note: rather than using the raw plugin interface that
-`graphile-build` exposes, you may want to use the helpers in
-the `graphile-utils` module.**
+[global-object-identification]:
+  https://relay.dev/graphql/objectidentification.htm

package/dist/SchemaBuilder.d.ts

@@ -0,0 +1,57 @@
+/// <reference types="node" />
+import "./global.js";
+import { EventEmitter } from "events";
+import { GraphQLSchema } from "graphql";
+import type { NewWithHooksFunction } from "./newWithHooks/index.js";
+/**
+ * The class responsible for building a GraphQL schema from graphile-build
+ * plugins by orchestrating the various callback functions.
+ */
+declare class SchemaBuilder<TBuild extends GraphileBuild.Build = GraphileBuild.Build> extends EventEmitter {
+    private inflection;
+    options: GraphileBuild.SchemaOptions;
+    depth: number;
+    hooks: GraphileBuild.SchemaBuilderHooks<TBuild>;
+    _currentPluginName: string | null | undefined;
+    /**
+     * Given a Build object, a GraphQL type constructor and a spec, applies the
+     * hooks to the spec and then constructs the type, returning the result.
+     */
+    newWithHooks: NewWithHooksFunction;
+    constructor(options: GraphileBuild.SchemaOptions, inflection: GraphileBuild.Inflection);
+    /**
+     * @internal
+     */
+    _setPluginName(name: string | null | undefined): void;
+    /**
+     * Registers 'fn' as a hook for the given 'hookName'. Every hook `fn` takes
+     * three arguments:
+     *
+     * - obj - the object currently being inspected
+     * - build - the current build object (which contains a number of utilities
+     *   and the context of the build)
+     * - context - information specific to the current invocation of the hook
+     *
+     * The function must return a replacement object for `obj` or `obj` itself.
+     * Generally we advice that you return the object itself, modifying it as
+     * necessary. In JavaScript, modifying an object object tends to be
+     * significantly faster than returning a modified clone.
+     */
+    hook<THookName extends keyof GraphileBuild.SchemaBuilderHooks<TBuild>>(hookName: THookName, fn: GraphileBuild.SchemaBuilderHooks[THookName][number]): void;
+    /**
+     * Applies the given 'hookName' hooks to the given 'input' and returns the
+     * result, which is typically a derivative of 'input'.
+     */
+    applyHooks<THookName extends keyof GraphileBuild.SchemaBuilderHooks<TBuild>>(hookName: THookName, input: Parameters<GraphileBuild.SchemaBuilderHooks<TBuild>[THookName][number]>[0], build: Parameters<GraphileBuild.SchemaBuilderHooks<TBuild>[THookName][number]>[1], context: Parameters<GraphileBuild.SchemaBuilderHooks<TBuild>[THookName][number]>[2], debugStr?: string): Parameters<GraphileBuild.SchemaBuilderHooks<TBuild>[THookName][number]>[0];
+    /**
+     * Create the 'Build' object.
+     */
+    createBuild(input: GraphileBuild.BuildInput): TBuild;
+    /**
+     * Given the `input` (result of the "gather" phase), builds the GraphQL
+     * schema synchronously.
+     */
+    buildSchema(input: GraphileBuild.BuildInput): GraphQLSchema;
+}
+export default SchemaBuilder;
+//# sourceMappingURL=SchemaBuilder.d.ts.map

package/dist/SchemaBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaBuilder.d.ts","sourceRoot":"","sources":["../src/SchemaBuilder.ts"],"names":[],"mappings":";AAAA,OAAO,aAAa,CAAC;AAGrB,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,EAAE,aAAa,EAAkB,MAAM,SAAS,CAAC;AAGxD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAapE;;;GAGG;AACH,cAAM,aAAa,CACjB,MAAM,SAAS,aAAa,CAAC,KAAK,GAAG,aAAa,CAAC,KAAK,CACxD,SAAQ,YAAY;IAelB,OAAO,CAAC,UAAU;IAdpB,OAAO,EAAE,aAAa,CAAC,aAAa,CAAC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,aAAa,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAEhD,kBAAkB,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAE9C;;;OAGG;IACH,YAAY,EAAE,oBAAoB,CAAC;gBAGjC,OAAO,EAAE,aAAa,CAAC,aAAa,EAC5B,UAAU,EAAE,aAAa,CAAC,UAAU;IAiB9C;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAI9C;;;;;;;;;;;;;OAaG;IACH,IAAI,CAAC,SAAS,SAAS,MAAM,aAAa,CAAC,kBAAkB,CAAC,MAAM,CAAC,EACnE,QAAQ,EAAE,SAAS,EACnB,EAAE,EAAE,aAAa,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,GACtD,IAAI;IAWP;;;OAGG;IACH,UAAU,CAAC,SAAS,SAAS,MAAM,aAAa,CAAC,kBAAkB,CAAC,MAAM,CAAC,EACzE,QAAQ,EAAE,SAAS,EACnB,KAAK,EAAE,UAAU,CACf,aAAa,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAC5D,CAAC,CAAC,CAAC,EACJ,KAAK,EAAE,UAAU,CACf,aAAa,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAC5D,CAAC,CAAC,CAAC,EACJ,OAAO,EAAE,UAAU,CACjB,aAAa,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAC5D,CAAC,CAAC,CAAC,EACJ,QAAQ,SAAK,GACZ,UAAU,CACX,aAAa,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAC5D,CAAC,CAAC,CAAC;IA4EJ;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,aAAa,CAAC,UAAU,GAAG,MAAM;IA6BpD;;;OAGG;IACH,WAAW,CAAC,KAAK,EAAE,aAAa,CAAC,UAAU,GAAG,aAAa;CAgD5D;AAED,eAAe,aAAa,CAAC"}

package/dist/SchemaBuilder.js

@@ -0,0 +1,181 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+require("./global.js");
+const debug_1 = tslib_1.__importDefault(require("debug"));
+const events_1 = require("events");
+const graphql_1 = require("graphql");
+const makeNewBuild_js_1 = tslib_1.__importDefault(require("./makeNewBuild.js"));
+const index_js_1 = require("./newWithHooks/index.js");
+const SchemaBuilderHooks_js_1 = require("./SchemaBuilderHooks.js");
+const utils_js_1 = require("./utils.js");
+const debug = (0, debug_1.default)("graphile-build:SchemaBuilder");
+const INIT_OBJECT = Object.freeze(Object.create(null));
+const INDENT = "  ";
+/**
+ * The class responsible for building a GraphQL schema from graphile-build
+ * plugins by orchestrating the various callback functions.
+ */
+class SchemaBuilder extends events_1.EventEmitter {
+    inflection;
+    options;
+    depth;
+    hooks;
+    _currentPluginName;
+    /**
+     * Given a Build object, a GraphQL type constructor and a spec, applies the
+     * hooks to the spec and then constructs the type, returning the result.
+     */
+    newWithHooks;
+    constructor(options, inflection) {
+        super();
+        this.inflection = inflection;
+        if (!options) {
+            throw new Error("Please pass options to SchemaBuilder");
+        }
+        this.options = options;
+        // Because hooks can nest, this keeps track of how deep we are.
+        this.depth = -1;
+        this.hooks = (0, SchemaBuilderHooks_js_1.makeSchemaBuilderHooks)();
+        this.newWithHooks = (0, index_js_1.makeNewWithHooks)({ builder: this }).newWithHooks;
+    }
+    /**
+     * @internal
+     */
+    _setPluginName(name) {
+        this._currentPluginName = name;
+    }
+    /**
+     * Registers 'fn' as a hook for the given 'hookName'. Every hook `fn` takes
+     * three arguments:
+     *
+     * - obj - the object currently being inspected
+     * - build - the current build object (which contains a number of utilities
+     *   and the context of the build)
+     * - context - information specific to the current invocation of the hook
+     *
+     * The function must return a replacement object for `obj` or `obj` itself.
+     * Generally we advice that you return the object itself, modifying it as
+     * necessary. In JavaScript, modifying an object object tends to be
+     * significantly faster than returning a modified clone.
+     */
+    hook(hookName, fn) {
+        if (!this.hooks[hookName]) {
+            // TODO: fuzzy-find a similar hook
+            throw new Error(`Sorry, '${hookName}' is not a supported hook`);
+        }
+        if (this._currentPluginName) {
+            fn.displayName = `${this._currentPluginName}/schema.hooks.${hookName}`;
+        }
+        this.hooks[hookName].push(fn);
+    }
+    /**
+     * Applies the given 'hookName' hooks to the given 'input' and returns the
+     * result, which is typically a derivative of 'input'.
+     */
+    applyHooks(hookName, input, build, context, debugStr = "") {
+        if (!input) {
+            throw new Error("applyHooks was called with falsy input");
+        }
+        this.depth++;
+        const indent = INDENT.repeat(this.depth);
+        try {
+            debug(`%s[%s%s]: Running...`, indent, hookName, debugStr);
+            const hooks = this.hooks[hookName];
+            if (!hooks) {
+                throw new Error(`Sorry, '${hookName}' is not a registered hook`);
+            }
+            let newObj = input;
+            for (const hook of hooks) {
+                this.depth++;
+                try {
+                    const hookDisplayName = hook.displayName || hook.name || "anonymous";
+                    debug(`%s[%s%s]:   Executing '%s'`, indent, hookName, debugStr, hookDisplayName);
+                    const previousHookName = build.status.currentHookName;
+                    const previousHookEvent = build.status.currentHookEvent;
+                    build.status.currentHookName = hookDisplayName;
+                    build.status.currentHookEvent = hookName;
+                    const oldObj = newObj;
+                    newObj = hook(newObj, build, context);
+                    if (hookName === "build") {
+                        /*
+                         * Unlike all the other hooks, the `build` hook must always use the
+                         * same `build` object - never returning a new object for fear of
+                         * causing issues to other build hooks that reference the old
+                         * object and don't get the new additions.
+                         */
+                        if (newObj !== oldObj) {
+                            throw new Error(`Build hook '${hookDisplayName}' returned a new object; 'build' hooks must always return the same Build object - please use 'return build.extend(build, {...})' instead.`);
+                        }
+                    }
+                    build.status.currentHookName = previousHookName;
+                    build.status.currentHookEvent = previousHookEvent;
+                    if (!newObj) {
+                        throw new Error(`GraphileBuild.Hook '${hook.displayName || hook.name || "anonymous"}' for '${hookName}' returned falsy value '${newObj}'`);
+                    }
+                    debug(`%s[%s%s]:   '%s' complete`, indent, hookName, debugStr, hookDisplayName);
+                }
+                finally {
+                    this.depth--;
+                }
+            }
+            debug(`%s[%s%s]: Complete`, indent, hookName, debugStr);
+            return newObj;
+        }
+        finally {
+            this.depth--;
+        }
+    }
+    /**
+     * Create the 'Build' object.
+     */
+    createBuild(input) {
+        const initialBuild = (0, makeNewBuild_js_1.default)(this, input, this.inflection);
+        const build = this.applyHooks("build", initialBuild, initialBuild, {
+            scope: Object.create(null),
+            type: "build",
+        });
+        // Bind all functions so they can be dereferenced
+        (0, utils_js_1.bindAll)(build, Object.keys(build).filter((key) => typeof build[key] === "function"));
+        const finalBuild = Object.freeze(build);
+        finalBuild.status.isBuildPhaseComplete = true;
+        const initContext = {
+            scope: Object.create(null),
+            type: "init",
+        };
+        this.applyHooks("init", INIT_OBJECT, finalBuild, initContext);
+        finalBuild.status.isInitPhaseComplete = true;
+        return finalBuild;
+    }
+    /**
+     * Given the `input` (result of the "gather" phase), builds the GraphQL
+     * schema synchronously.
+     */
+    buildSchema(input) {
+        const build = this.createBuild(input);
+        const schemaSpec = {
+            directives: [...build.graphql.specifiedDirectives],
+        };
+        const schemaScope = {
+            __origin: `Graphile built-in`,
+        };
+        const tempSchema = this.newWithHooks(build, graphql_1.GraphQLSchema, schemaSpec, schemaScope);
+        const finalizeContext = {
+            scope: Object.create(null),
+            type: "finalize",
+        };
+        const schema = tempSchema
+            ? this.applyHooks("finalize", tempSchema, build, finalizeContext, "Finalizing GraphQL schema")
+            : tempSchema;
+        if (!schema) {
+            throw new Error("Schema generation failed");
+        }
+        const validationErrors = (0, graphql_1.validateSchema)(schema);
+        if (validationErrors.length) {
+            throw new AggregateError(validationErrors, `Schema construction failed due to ${validationErrors.length} validation failure(s). First failure was: ${String(validationErrors[0])}`);
+        }
+        return schema;
+    }
+}
+exports.default = SchemaBuilder;
+//# sourceMappingURL=SchemaBuilder.js.map

package/dist/SchemaBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaBuilder.js","sourceRoot":"","sources":["../src/SchemaBuilder.ts"],"names":[],"mappings":"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"}

package/dist/SchemaBuilderHooks.d.ts

@@ -0,0 +1,7 @@
+import "./global.js";
+/**
+ * Returns a new object with arrays for each supported schema hook, ready for
+ * hook functions to be registered into it.
+ */
+export declare function makeSchemaBuilderHooks<TBuild extends GraphileBuild.Build = GraphileBuild.Build>(): GraphileBuild.SchemaBuilderHooks<TBuild>;
+//# sourceMappingURL=SchemaBuilderHooks.d.ts.map

package/dist/SchemaBuilderHooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaBuilderHooks.d.ts","sourceRoot":"","sources":["../src/SchemaBuilderHooks.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,CAAC;AAErB;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,SAAS,aAAa,CAAC,KAAK,GAAG,aAAa,CAAC,KAAK,KACrD,aAAa,CAAC,kBAAkB,CAAC,MAAM,CAAC,CA2B5C"}

package/dist/SchemaBuilderHooks.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeSchemaBuilderHooks = void 0;
+require("./global.js");
+/**
+ * Returns a new object with arrays for each supported schema hook, ready for
+ * hook functions to be registered into it.
+ */
+function makeSchemaBuilderHooks() {
+    return {
+        build: [],
+        init: [],
+        finalize: [],
+        GraphQLSchema: [],
+        GraphQLSchema_types: [],
+        GraphQLObjectType: [],
+        GraphQLObjectType_interfaces: [],
+        GraphQLObjectType_fields: [],
+        GraphQLObjectType_fields_field: [],
+        GraphQLObjectType_fields_field_args: [],
+        GraphQLInputObjectType: [],
+        GraphQLInputObjectType_fields: [],
+        GraphQLInputObjectType_fields_field: [],
+        GraphQLEnumType: [],
+        GraphQLEnumType_values: [],
+        GraphQLEnumType_values_value: [],
+        GraphQLUnionType: [],
+        GraphQLUnionType_types: [],
+        GraphQLInterfaceType: [],
+        GraphQLInterfaceType_fields: [],
+        GraphQLInterfaceType_fields_field: [],
+        GraphQLInterfaceType_fields_field_args: [],
+        GraphQLInterfaceType_interfaces: [],
+        GraphQLScalarType: [],
+    };
+}
+exports.makeSchemaBuilderHooks = makeSchemaBuilderHooks;
+//# sourceMappingURL=SchemaBuilderHooks.js.map

package/dist/SchemaBuilderHooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaBuilderHooks.js","sourceRoot":"","sources":["../src/SchemaBuilderHooks.ts"],"names":[],"mappings":";;;AAAA,uBAAqB;AAErB;;;GAGG;AACH,SAAgB,sBAAsB;IAGpC,OAAO;QACL,KAAK,EAAE,EAAE;QACT,IAAI,EAAE,EAAE;QACR,QAAQ,EAAE,EAAE;QACZ,aAAa,EAAE,EAAE;QACjB,mBAAmB,EAAE,EAAE;QACvB,iBAAiB,EAAE,EAAE;QACrB,4BAA4B,EAAE,EAAE;QAChC,wBAAwB,EAAE,EAAE;QAC5B,8BAA8B,EAAE,EAAE;QAClC,mCAAmC,EAAE,EAAE;QACvC,sBAAsB,EAAE,EAAE;QAC1B,6BAA6B,EAAE,EAAE;QACjC,mCAAmC,EAAE,EAAE;QACvC,eAAe,EAAE,EAAE;QACnB,sBAAsB,EAAE,EAAE;QAC1B,4BAA4B,EAAE,EAAE;QAChC,gBAAgB,EAAE,EAAE;QACpB,sBAAsB,EAAE,EAAE;QAC1B,oBAAoB,EAAE,EAAE;QACxB,2BAA2B,EAAE,EAAE;QAC/B,iCAAiC,EAAE,EAAE;QACrC,sCAAsC,EAAE,EAAE;QAC1C,+BAA+B,EAAE,EAAE;QACnC,iBAAiB,EAAE,EAAE;KACtB,CAAC;AACJ,CAAC;AA7BD,wDA6BC"}

package/dist/behavior.d.ts

@@ -0,0 +1,11 @@
+export declare class Behavior {
+    private globalBehaviorDefaults;
+    addDefaultBehavior(behavior: string): void;
+    /**
+     * @param localBehaviorSpecsString - the behavior of the entity as determined by details on the entity itself and any applicable ancestors
+     * @param filter - the behavior the plugin specifies
+     * @param defaultBehavior - allows the plugin to specify a default behavior for this in the event that it's not defined elsewhere (lowest priority)
+     */
+    matches(localBehaviorSpecsString: string | string[] | null | undefined, filter: string, defaultBehavior?: string): boolean | undefined;
+}
+//# sourceMappingURL=behavior.d.ts.map

package/dist/behavior.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"behavior.d.ts","sourceRoot":"","sources":["../src/behavior.ts"],"names":[],"mappings":"AAMA,qBAAa,QAAQ;IACnB,OAAO,CAAC,sBAAsB,CAAM;IAG7B,kBAAkB,CAAC,QAAQ,EAAE,MAAM;IAS1C;;;;OAIG;IACI,OAAO,CACZ,wBAAwB,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,GAAG,SAAS,EAC9D,MAAM,EAAE,MAAM,EACd,eAAe,SAAK,GACnB,OAAO,GAAG,SAAS;CAkBvB"}