graphile-build 4.12.2 → 5.0.0-0.3

package/CHANGELOG.md

@@ -0,0 +1,32 @@
+# graphile-build
+
+## 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,44 +1,54 @@
 # 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/)
 
 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://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="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://storyscript.com/?utm_source=postgraphile"><img src="https://graphile.org/images/sponsors/storyscript.png" width="90" height="90" alt="Storyscript" /><br />Storyscript</a> *</td>
-<td align="center"><a href="https://postlight.com/?utm_source=graphile"><img src="https://graphile.org/images/sponsors/postlight.jpg" width="90" height="90" alt="Postlight" /><br />Postlight</a> *</td>
-<td align="center"><a href="https://surge.io/"><img src="https://graphile.org/images/sponsors/surge.png" width="90" height="90" alt="Surge.io" /><br />Surge.io</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://dovetailapp.com/"><img src="https://graphile.org/images/sponsors/dovetail.png" width="90" height="90" alt="Dovetail" /><br />Dovetail</a> *</td>
+<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>
@@ -47,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.GraphileBuildSchemaOptions;
+    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.GraphileBuildSchemaOptions, 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,0BAA0B,CAAC;IAClD,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,0BAA0B,EACzC,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;IA0BpD;;;OAGG;IACH,WAAW,CAAC,KAAK,EAAE,aAAa,CAAC,UAAU,GAAG,aAAa;CAgD5D;AAED,eAAe,aAAa,CAAC"}

package/dist/SchemaBuilder.js

@@ -0,0 +1,178 @@
+"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: {},
+            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: {}, 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: {},
+            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 | 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,IAAI,GAAG,SAAS,EACnD,MAAM,EAAE,MAAM,EACd,eAAe,SAAK,GACnB,OAAO,GAAG,SAAS;CAevB"}

package/dist/behavior.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Behavior = void 0;
+class Behavior {
+    globalBehaviorDefaults = "";
+    // Should only be called during 'build' phase.
+    addDefaultBehavior(behavior) {
+        if (this.globalBehaviorDefaults) {
+            this.globalBehaviorDefaults += " " + behavior;
+        }
+        else {
+            this.globalBehaviorDefaults = behavior;
+        }
+    }
+    // TODO: would be great if this could return `{deprecationReason: string}` too...
+    /**
+     * @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, filter, defaultBehavior = "") {
+        const finalBehaviorSpecsString = `${defaultBehavior} ${this.globalBehaviorDefaults} ${localBehaviorSpecsString ?? ""}`;
+        const specs = parseSpecs(finalBehaviorSpecsString);
+        const filterScope = parseScope(filter);
+        // Loop backwards through the specs
+        for (let i = specs.length - 1; i >= 0; i--) {
+            const { positive, scope } = specs[i];
+            if (scopeMatches(scope, filterScope, positive)) {
+                return positive;
+            }
+        }
+        return undefined;
+    }
+}
+exports.Behavior = Behavior;
+/**
+ * Parses a scope like `root:connection:filter` into it's constituent parts.
+ *
+ * @internal
+ */
+function parseScope(scopeString) {
+    return scopeString.split(":");
+}
+/**
+ * Parses a behaviorSpecs string like `+list -connection -list:filter` into a
+ * list of BehaviorSpecs.
+ *
+ * @internal
+ */
+function parseSpecs(behaviorSpecsString) {
+    const fragments = behaviorSpecsString.split(/\s+/);
+    const specs = [];
+    for (const fragment of fragments) {
+        // `+` is implicit
+        const [pm, rest] = /^[+-]/.test(fragment)
+            ? [fragment.slice(0, 1), fragment.slice(1)]
+            : ["+", fragment];
+        const positive = pm === "+";
+        const scope = parseScope(rest);
+        specs.push({ positive, scope });
+    }
+    return specs;
+}
+/**
+ * Returns true if `filterScope` can be matched by `specifiedScope`.
+ *
+ * If `filterScope` contains an `*` then we return true if any possible
+ * `filterScope` can be matched by `specifiedScope` in a positive fashion.
+ *
+ * @param specifiedScope - the scope the user entered, e.g. from `+root:*:filter`
+ * @param filterScope - the scope the plugin says we're in, e.g. from `root:connection:filter`
+ *
+ * @internal
+ */
+function scopeMatches(specifiedScope, filterScope, positive) {
+    if (specifiedScope.length > filterScope.length) {
+        return false;
+    }
+    // `specifiedScope` is effectively prepended with `*:*:*:` as many times as
+    // necessary to make it the same length as `filterScope`. In actuality we do
+    // it more efficiently.
+    const filterScopeTrimmed = specifiedScope.length === filterScope.length
+        ? filterScope
+        : filterScope.slice(filterScope.length - specifiedScope.length);
+    // Loop through each entry, if it doesn't match then return false.
+    for (let i = 0, l = filterScopeTrimmed.length; i < l; i++) {
+        const rule = specifiedScope[i];
+        const filter = filterScopeTrimmed[i];
+        if (filter === "*" && rule !== "*" && !positive) {
+            return false;
+        }
+        if (rule === "*" || filter === "*") {
+            continue;
+        }
+        if (rule !== filter) {
+            return false;
+        }
+    }
+    return true;
+}
+//# sourceMappingURL=behavior.js.map

package/dist/behavior.js.map

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

package/dist/callbackToAsyncIterator.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Builds an AsyncIterator from a callback; much safer than an async generator
+ * because it will not get frozen waiting for a promise to resolve.
+ */
+export default function callbackToAsyncIterator<CallbackInput, ReturnVal>(listener: (callback: (value: CallbackInput) => void) => (ReturnVal | null | undefined) | Promise<ReturnVal | null | undefined>, options?: {
+    onError?: (err: Error) => void;
+    onClose?: (arg: ReturnVal | null | undefined) => void;
+    buffering?: boolean;
+}): AsyncIterableIterator<CallbackInput>;
+//# sourceMappingURL=callbackToAsyncIterator.d.ts.map

package/dist/callbackToAsyncIterator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"callbackToAsyncIterator.d.ts","sourceRoot":"","sources":["../src/callbackToAsyncIterator.ts"],"names":[],"mappings":"AAcA;;;GAGG;AACH,MAAM,CAAC,OAAO,UAAU,uBAAuB,CAAC,aAAa,EAAE,SAAS,EACtE,QAAQ,EAAE,CACR,QAAQ,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,KACrC,CAAC,SAAS,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,GAAG,SAAS,CAAC,EAC3E,OAAO,GAAE;IACP,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,GAAG,SAAS,KAAK,IAAI,CAAC;IACtD,SAAS,CAAC,EAAE,OAAO,CAAC;CAChB,GACL,qBAAqB,CAAC,aAAa,CAAC,CA+EtC"}