graphile-config 0.0.1-beta.8 → 1.0.0-rc.1

package/CHANGELOG.md

@@ -1,5 +1,200 @@
 # graphile-config
 
+## 1.0.0-rc.1
+
+### Patch Changes
+
+- [`8a5a7c5`](https://github.com/graphile/crystal/commit/8a5a7c536fc4b9b702600c5cc3d413724670c327)
+  Thanks [@benjie](https://github.com/benjie)! - Bump to release candidate
+
+## 0.0.1-beta.18
+
+### Patch Changes
+
+- [#2697](https://github.com/graphile/crystal/pull/2697)
+  [`cfd4c3c`](https://github.com/graphile/crystal/commit/cfd4c3cff0ef40ed87a2c700b7719c1ca0e73588)
+  Thanks [@benjie](https://github.com/benjie)! - Be more selective about the
+  errors caught whilst loading a config file; a bug/throw in the config file
+  should still be raised.
+
+- [#2688](https://github.com/graphile/crystal/pull/2688)
+  [`e15f886`](https://github.com/graphile/crystal/commit/e15f886cae1041416b44b74b75426f8d43000dcf)
+  Thanks [@benjie](https://github.com/benjie)! - Fixes bug where two different
+  plugins with the same name would be allowed to exist in the same (resolved)
+  preset. Users of dynamically created presets and plugins (e.g.
+  `makeV4Preset(...)` in PostGraphile) should be wary not to include two calls
+  to the same factory in their preset (directly or indirectly).
+
+## 0.0.1-beta.17
+
+### Patch Changes
+
+- [#2577](https://github.com/graphile/crystal/pull/2577)
+  [`0c6b1f1`](https://github.com/graphile/crystal/commit/0c6b1f1e188f6e2913832adfed9ca76dfdc25c47)
+  Thanks [@benjie](https://github.com/benjie)! - Update dependencies
+
+- [#2588](https://github.com/graphile/crystal/pull/2588)
+  [`e0cdabe`](https://github.com/graphile/crystal/commit/e0cdabe25c8894da550546c93bc03b895585544c)
+  Thanks [@benjie](https://github.com/benjie)! - Add support for
+  `--experimental-strip-types` to `graphile-config`'s loading of config files.
+  No need for `ts-node`/`tsx` now.
+
+## 0.0.1-beta.16
+
+### Patch Changes
+
+- [#2482](https://github.com/graphile/crystal/pull/2482)
+  [`459e1869a2ec58925b2bac5458af487c52a8ca37`](https://github.com/graphile/crystal/commit/459e1869a2ec58925b2bac5458af487c52a8ca37)
+  Thanks [@benjie](https://github.com/benjie)! - Minimum version of Node.js
+  bumped to Node 22 (the latest LTS).
+
+## 0.0.1-beta.15
+
+### Patch Changes
+
+- [`00d79e6f5608affc3f36bb0ce4ca2547230174e7`](https://github.com/graphile/crystal/commit/00d79e6f5608affc3f36bb0ce4ca2547230174e7)
+  Thanks [@benjie](https://github.com/benjie)! - Rename parameter to
+  Middleware.register.
+
+## 0.0.1-beta.14
+
+### Patch Changes
+
+- [#2280](https://github.com/graphile/crystal/pull/2280)
+  [`83c546509`](https://github.com/graphile/crystal/commit/83c546509d24be2955a56120981363ad3c3a5f3f)
+  Thanks [@benjie](https://github.com/benjie)! - Fix TypeScript types of
+  MiddlewareNext
+
+## 0.0.1-beta.13
+
+### Patch Changes
+
+- [#2270](https://github.com/graphile/crystal/pull/2270)
+  [`7580bc16a`](https://github.com/graphile/crystal/commit/7580bc16a050fd8d916c6dabe9d1ded980090349)
+  Thanks [@benjie](https://github.com/benjie)! - Check that `process` exists
+  before reading from it.
+
+## 0.0.1-beta.12
+
+### Patch Changes
+
+- [#2240](https://github.com/graphile/crystal/pull/2240)
+  [`d13b76f0f`](https://github.com/graphile/crystal/commit/d13b76f0fef2a58466ecb44880af62d25910e83e)
+  Thanks [@benjie](https://github.com/benjie)! - Adds
+  `MiddlewareHandlers<TActivities>` type to help with adding middleware to
+  configs
+
+- [#2253](https://github.com/graphile/crystal/pull/2253)
+  [`b167bd849`](https://github.com/graphile/crystal/commit/b167bd8499be5866b71bac6594d55bd768fda1d0)
+  Thanks [@benjie](https://github.com/benjie)! - 🚨 `{}` is no longer a valid
+  `GraphileConfig.ResolvedPreset`; use `resolvePreset({})`
+
+  Also: adds `resolvePreset(preset)` and deprecates `resolvePresets(presets)`.
+
+- [#2250](https://github.com/graphile/crystal/pull/2250)
+  [`6a13ecbd4`](https://github.com/graphile/crystal/commit/6a13ecbd45534c39c846c1d8bc58242108426dd1)
+  Thanks [@benjie](https://github.com/benjie)! - Add support for 'preset.lib'
+  which can be used to store global module references to help avoid the dual
+  package hazard.
+
+## 0.0.1-beta.11
+
+### Patch Changes
+
+- [#2224](https://github.com/graphile/crystal/pull/2224)
+  [`5626c7d36`](https://github.com/graphile/crystal/commit/5626c7d3649285e11fe9857dfa319d2883d027eb)
+  Thanks [@benjie](https://github.com/benjie)! - Remove requirement that plugins
+  have a version.
+
+## 0.0.1-beta.10
+
+### Patch Changes
+
+- [#2188](https://github.com/graphile/crystal/pull/2188)
+  [`cc0941731`](https://github.com/graphile/crystal/commit/cc0941731a1679bc04ce7b7fd4254009bb5f1f62)
+  Thanks [@benjie](https://github.com/benjie)! - Overhaul the way in which
+  `graphile-config` presets work such that including a preset at two different
+  layers shouldn't result in unexpected behavior.
+
+- [#2155](https://github.com/graphile/crystal/pull/2155)
+  [`8b472cd51`](https://github.com/graphile/crystal/commit/8b472cd51cd66d8227f9f2722d09c0a774792b0f)
+  Thanks [@benjie](https://github.com/benjie)! - `disablePlugins` now supports
+  TypeScript auto-completion of known plugin names. Other names are still
+  accepted without error, so this is just a minor DX improvement rather than
+  type safety.
+
+- [#2160](https://github.com/graphile/crystal/pull/2160)
+  [`9cd9bb522`](https://github.com/graphile/crystal/commit/9cd9bb5222a9f0398ee4b8bfa4f741b6de2a2192)
+  Thanks [@benjie](https://github.com/benjie)! - Add support for lists of hook
+  objects, so that the same hook can be applied multiple times in the same
+  plugin but with different priorities.
+
+## 0.0.1-beta.9
+
+### Patch Changes
+
+- [#2071](https://github.com/graphile/crystal/pull/2071)
+  [`582bd768f`](https://github.com/graphile/crystal/commit/582bd768fec403ce3284f293b85b9fd86e4d3f40)
+  Thanks [@benjie](https://github.com/benjie)! - `GrafastExecutionArgs` now
+  accepts `resolvedPreset` and `requestContext` directly; passing these through
+  additional arguments is now deprecated and support will be removed in a future
+  revision. This affects:
+  - `grafast()`
+  - `execute()`
+  - `subscribe()`
+  - `hookArgs()`
+
+  `graphile-config` has gained a middleware system which is more powerful than
+  it's AsyncHooks system. Old hooks can be emulated through the middleware
+  system safely since middleware is a superset of hooks' capabilities.
+  `applyHooks` has been renamed to `orderedApply` (because it applies to more
+  than just hooks), calling `applyHooks` will still work but is deprecated.
+
+  🚨 `grafast` no longer automatically reads your `graphile.config.ts` or
+  similar; you must do that yourself and pass the `resolvedPreset` to grafast
+  via the `args`. This is to aid in bundling of grafast since it should not need
+  to read from filesystem or dynamically load modules.
+
+  `grafast` no longer outputs performance warning when you set
+  `GRAPHILE_ENV=development`.
+
+  🚨 `plugin.grafast.hooks.args` is now `plugin.grafast.middleware.prepareArgs`,
+  and the signature has changed - you must be sure to call the `next()` function
+  and ctx/resolvedPreset can be extracted directly from `args`:
+
+  ```diff
+   const plugin = {
+     grafast: {
+  -    hooks: {
+  +    middleware: {
+  -      args({ args, ctx, resolvedPreset }) {
+  +      prepareArgs(next, { args }) {
+  +        const { requestContext: ctx, resolvedPreset } = args;
+           // ...
+  +        return next();
+         }
+       }
+     }
+   }
+  ```
+
+  Many more middleware have been added; use TypeScript's autocomplete to see
+  what's available until we have proper documentation for them.
+
+  `plugin.grafserv.hooks.*` are still supported but deprecated; instead use
+  middleware `plugin.grafserv.middleware.*` (note that call signatures have
+  changed slightly, similar to the diff above):
+  - `hooks.init` -> `middleware.setPreset`
+  - `hooks.processGraphQLRequestBody` -> `middleware.processGraphQLRequestBody`
+  - `hooks.ruruHTMLParts` -> `middleware.ruruHTMLParts`
+
+  A few TypeScript types related to Hooks have been renamed, but their old names
+  are still available, just deprecated. They will be removed in a future update:
+  - `HookObject` -> `FunctionalityObject`
+  - `PluginHook` -> `CallbackOrDescriptor`
+  - `PluginHookObject` -> `CallbackDescriptor`
+  - `PluginHookCallback` -> `UnwrapCallback`
+
 ## 0.0.1-beta.8
 
 ### Patch Changes

package/README.md

@@ -125,12 +125,7 @@ And please give some love to our featured sponsors 🤩:
 
 <table><tr>
 <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>
-<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.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://stellate.co/"><img src="https://graphile.org/images/sponsors/Stellate.png" width="90" height="90" alt="Stellate" /><br />Stellate</a> *</td>
-</tr><tr>
 <td align="center"><a href="https://gosteelhead.com/"><img src="https://graphile.org/images/sponsors/steelhead.svg" width="90" height="90" alt="Steelhead" /><br />Steelhead</a> *</td>
-<td align="center"><a href="https://www.sylvera.com/"><img src="https://graphile.org/images/sponsors/sylvera.svg" width="90" height="90" alt="Sylvera" /><br />Sylvera</a> *</td>
 </tr></table>
 
 <em>\* Sponsors the entire Graphile suite</em>

package/dist/cli.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getTerminalWidth = exports.runCli = void 0;
+exports.runCli = runCli;
+exports.getTerminalWidth = getTerminalWidth;
 const tslib_1 = require("tslib");
 const yargs_1 = tslib_1.__importDefault(require("yargs"));
 const helpers_1 = require("yargs/helpers");
@@ -17,9 +18,7 @@ Thank you for using our software.`)
         .wrap(yargs_1.default.terminalWidth()).argv;
     await run(argv);
 }
-exports.runCli = runCli;
 function getTerminalWidth() {
     return yargs_1.default.terminalWidth();
 }
-exports.getTerminalWidth = getTerminalWidth;
 //# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;;;AACA,0DAA0B;AAC1B,2CAAwC;AAejC,KAAK,UAAU,MAAM,CAC1B,OAA+B,EAC/B,GAAyC;IAEzC,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,IAAA,eAAK,EAAC,IAAA,iBAAO,EAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;SACrD,MAAM,EAAE;SACR,cAAc,CAAC,KAAK,EAAE,sCAAsC,CAAC;SAC7D,QAAQ,CACP;;;;;kCAK4B,CAC7B;SACA,IAAI,CAAC,eAAK,CAAC,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC;IACpC,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC;AAClB,CAAC;AAjBD,wBAiBC;AAED,SAAgB,gBAAgB;IAC9B,OAAO,eAAK,CAAC,aAAa,EAAE,CAAC;AAC/B,CAAC;AAFD,4CAEC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;AAiBA,wBAiBC;AAED,4CAEC;;AArCD,0DAA0B;AAC1B,2CAAwC;AAejC,KAAK,UAAU,MAAM,CAC1B,OAA+B,EAC/B,GAAyC;IAEzC,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,IAAA,eAAK,EAAC,IAAA,iBAAO,EAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;SACrD,MAAM,EAAE;SACR,cAAc,CAAC,KAAK,EAAE,sCAAsC,CAAC;SAC7D,QAAQ,CACP;;;;;kCAK4B,CAC7B;SACA,IAAI,CAAC,eAAK,CAAC,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC;IACpC,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC;AAClB,CAAC;AAED,SAAgB,gBAAgB;IAC9B,OAAO,eAAK,CAAC,aAAa,EAAE,CAAC;AAC/B,CAAC"}

package/dist/functionality.d.ts

@@ -0,0 +1,3 @@
+import type { CallbackDescriptor, CallbackOrDescriptor, FunctionalityObject } from "./interfaces.js";
+export declare function orderedApply<TFunctionality extends FunctionalityObject<TFunctionality>>(plugins: readonly GraphileConfig.Plugin[] | undefined, functionalityRetriever: (plugin: GraphileConfig.Plugin) => Partial<TFunctionality> | undefined, applyCallback: <TFunctionalityName extends keyof TFunctionality>(functionalityName: TFunctionalityName, hookFn: TFunctionality[TFunctionalityName] extends CallbackOrDescriptor<infer U> ? U : TFunctionality[TFunctionalityName] extends ReadonlyArray<CallbackDescriptor<infer U>> ? U : never, plugin: GraphileConfig.Plugin) => void): void;
+//# sourceMappingURL=functionality.d.ts.map

package/dist/functionality.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"functionality.d.ts","sourceRoot":"","sources":["../src/functionality.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EAEpB,MAAM,iBAAiB,CAAC;AAkBzB,wBAAgB,YAAY,CAC1B,cAAc,SAAS,mBAAmB,CAAC,cAAc,CAAC,EAE1D,OAAO,EAAE,SAAS,cAAc,CAAC,MAAM,EAAE,GAAG,SAAS,EACrD,sBAAsB,EAAE,CACtB,MAAM,EAAE,cAAc,CAAC,MAAM,KAC1B,OAAO,CAAC,cAAc,CAAC,GAAG,SAAS,EACxC,aAAa,EAAE,CAAC,kBAAkB,SAAS,MAAM,cAAc,EAC7D,iBAAiB,EAAE,kBAAkB,EACrC,MAAM,EAAE,cAAc,CAAC,kBAAkB,CAAC,SAAS,oBAAoB,CACrE,MAAM,CAAC,CACR,GACG,CAAC,GACD,cAAc,CAAC,kBAAkB,CAAC,SAAS,aAAa,CACpD,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAC5B,GACD,CAAC,GACD,KAAK,EACX,MAAM,EAAE,cAAc,CAAC,MAAM,KAC1B,IAAI,GACR,IAAI,CAgFN"}

package/dist/functionality.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.orderedApply = orderedApply;
+const sort_js_1 = require("./sort.js");
+// TypeScript nonsense
+const isCallbackDescriptor = (v) => typeof v !== "function";
+const isCallback = (v) => typeof v === "function";
+function isArray(arg) {
+    return Array.isArray(arg);
+}
+function orderedApply(plugins, functionalityRetriever, applyCallback) {
+    // Normalize all the plugin "functionalities" and gather them into collections
+    const allFunctionalities = Object.create(null);
+    let uid = 0;
+    if (plugins) {
+        for (const plugin of plugins) {
+            const hooks = functionalityRetriever(plugin);
+            if (!hooks) {
+                continue;
+            }
+            const keys = Object.keys(hooks);
+            for (const key of keys) {
+                const value = hooks[key];
+                if (!value) {
+                    continue;
+                }
+                const hookList = isArray(value) ? value : [value];
+                for (const hookSpecRaw of hookList) {
+                    const callback = (isCallback(hookSpecRaw) ? hookSpecRaw : hookSpecRaw.callback);
+                    const { provides, before, after } = isCallbackDescriptor(hookSpecRaw)
+                        ? hookSpecRaw
+                        : {};
+                    if (!allFunctionalities[key]) {
+                        allFunctionalities[key] = [];
+                    }
+                    // We need to give each functionality a unique ID
+                    const id = String(uid++);
+                    allFunctionalities[key].push({
+                        id,
+                        plugin,
+                        callback,
+                        provides: [...(provides || []), id, plugin.name],
+                        before: before || [],
+                        after: after || [],
+                    });
+                }
+            }
+        }
+    }
+    // Sort the collections according to provides, before and after.
+    for (const functionalityName in allFunctionalities) {
+        const functionalities = allFunctionalities[functionalityName];
+        if (!functionalities) {
+            continue;
+        }
+        const final = (0, sort_js_1.sortWithBeforeAfterProvides)(functionalities, "id");
+        // Finally we can register the functionalities
+        for (const functionality of final) {
+            applyCallback(functionalityName, functionality.callback, functionality.plugin);
+        }
+    }
+}
+//# sourceMappingURL=functionality.js.map

package/dist/functionality.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"functionality.js","sourceRoot":"","sources":["../src/functionality.ts"],"names":[],"mappings":";;AAwBA,oCAoGC;AArHD,uCAAwD;AAExD,sBAAsB;AACtB,MAAM,oBAAoB,GAAG,CAC3B,CAA0B,EACE,EAAE,CAAC,OAAO,CAAC,KAAK,UAAU,CAAC;AACzD,MAAM,UAAU,GAAG,CACjB,CAA0B,EAClB,EAAE,CAAC,OAAO,CAAC,KAAK,UAAU,CAAC;AACrC,SAAS,OAAO,CACd,GAE8C;IAE9C,OAAO,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;AAC5B,CAAC;AAED,SAAgB,YAAY,CAG1B,OAAqD,EACrD,sBAEwC,EACxC,aAYS;IAUT,8EAA8E;IAC9E,MAAM,kBAAkB,GAEpB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACxB,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,IAAI,OAAO,EAAE,CAAC;QACZ,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;YAC7C,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,SAAS;YACX,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAyC,CAAC;YACxE,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;gBACvB,MAAM,KAAK,GAGK,KAAK,CAAC,GAAG,CAAC,CAAC;gBAC3B,IAAI,CAAC,KAAK,EAAE,CAAC;oBACX,SAAS;gBACX,CAAC;gBAED,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;gBAClD,KAAK,MAAM,WAAW,IAAI,QAAQ,EAAE,CAAC;oBACnC,MAAM,QAAQ,GAIF,CACV,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,QAAQ,CACtD,CAAC;oBACT,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,oBAAoB,CAAC,WAAW,CAAC;wBACnE,CAAC,CAAC,WAAW;wBACb,CAAC,CAAE,EAA8D,CAAC;oBACpE,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC;wBAC7B,kBAAkB,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;oBAC/B,CAAC;oBACD,iDAAiD;oBACjD,MAAM,EAAE,GAAG,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC;oBACzB,kBAAkB,CAAC,GAAG,CAAE,CAAC,IAAI,CAAC;wBAC5B,EAAE;wBACF,MAAM;wBACN,QAAQ;wBACR,QAAQ,EAAE,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC;wBAChD,MAAM,EAAE,MAAM,IAAI,EAAE;wBACpB,KAAK,EAAE,KAAK,IAAI,EAAE;qBACnB,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,gEAAgE;IAChE,KAAK,MAAM,iBAAiB,IAAI,kBAAkB,EAAE,CAAC;QACnD,MAAM,eAAe,GAAG,kBAAkB,CAAC,iBAAiB,CAE/C,CAAC;QACd,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,SAAS;QACX,CAAC;QAED,MAAM,KAAK,GAAG,IAAA,qCAA2B,EAAC,eAAe,EAAE,IAAI,CAAC,CAAC;QAEjE,8CAA8C;QAC9C,KAAK,MAAM,aAAa,IAAI,KAAK,EAAE,CAAC;YAClC,aAAa,CACX,iBAAiB,EACjB,aAAa,CAAC,QAAQ,EACtB,aAAa,CAAC,MAAM,CACrB,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/hooks.d.ts

@@ -1,15 +1,24 @@
-import type { PluginHook } from "./interfaces.js";
-export type HookObject<T> = Record<keyof T, PluginHook<(...args: any[]) => any>>;
-export declare class AsyncHooks<THooks extends HookObject<THooks>> {
+import { orderedApply } from "./functionality.js";
+import type { CallbackDescriptor, CallbackOrDescriptor, FunctionalityObject, PromiseOrDirect, UnwrapCallback } from "./interfaces.js";
+export declare class AsyncHooks<THooks extends FunctionalityObject<THooks>> {
     callbacks: {
-        [key in keyof THooks]?: Array<THooks[keyof THooks] extends PluginHook<infer U> ? U : never>;
+        [key in keyof THooks]?: Array<THooks[keyof THooks] extends CallbackOrDescriptor<infer U> ? U : never>;
     };
-    hook<THookName extends keyof THooks>(event: THookName, fn: THooks[THookName] extends PluginHook<infer U> ? U : never): void;
+    hook<THookName extends keyof THooks>(event: THookName, fn: THooks[THookName] extends CallbackOrDescriptor<infer U> ? U : never): void;
     /**
      * Hooks can _mutate_ the argument, they cannot return a replacement. This
      * allows us to completely side-step the problem of recursive calls.
      */
-    process<THookName extends keyof THooks>(event: THookName, ...args: Parameters<THooks[THookName] extends PluginHook<infer U> ? U : never>): void | Promise<void>;
+    process<THookName extends keyof THooks>(hookName: THookName, ...args: Parameters<THooks[THookName] extends CallbackOrDescriptor<infer U> ? U : never>): void | Promise<void>;
 }
-export declare function applyHooks<THooks extends HookObject<THooks>>(plugins: readonly GraphileConfig.Plugin[] | undefined, hooksRetriever: (plugin: GraphileConfig.Plugin) => Partial<THooks> | undefined, applyHookCallback: <THookName extends keyof THooks>(hookName: THookName, hookFn: THooks[THookName] extends PluginHook<infer U> ? U : never, plugin: GraphileConfig.Plugin) => void): void;
+/** @deprecated Use FunctionalityObject */
+export type HookObject<T> = FunctionalityObject<T>;
+/** @deprecated Use `orderedApply` */
+export declare const applyHooks: typeof orderedApply;
+/** @deprecated Use CallbackDescriptor */
+export type PluginHookObject<T extends (...args: any[]) => any> = CallbackDescriptor<T>;
+/** @deprecated Use CallbackOrDescriptor */
+export type PluginHook<T extends (...args: any[]) => PromiseOrDirect<UnwrapCallback<any> | void>> = CallbackOrDescriptor<T> | readonly CallbackDescriptor<T>[];
+/** @deprecated Use UnwrapCallback */
+export type PluginHookCallback<T extends CallbackOrDescriptor<(...args: any[]) => any>> = UnwrapCallback<T>;
 //# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAoB,MAAM,iBAAiB,CAAC;AAKpE,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,MAAM,CAChC,MAAM,CAAC,EACP,UAAU,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC,CACpC,CAAC;AAEF,qBAAa,UAAU,CAAC,MAAM,SAAS,UAAU,CAAC,MAAM,CAAC;IACvD,SAAS,EAAE;SACR,GAAG,IAAI,MAAM,MAAM,CAAC,CAAC,EAAE,KAAK,CAC3B,MAAM,CAAC,MAAM,MAAM,CAAC,SAAS,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAC7D;KACF,CAAuB;IAExB,IAAI,CAAC,SAAS,SAAS,MAAM,MAAM,EACjC,KAAK,EAAE,SAAS,EAChB,EAAE,EAAE,MAAM,CAAC,SAAS,CAAC,SAAS,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,GAC5D,IAAI;IAKP;;;OAGG;IACH,OAAO,CAAC,SAAS,SAAS,MAAM,MAAM,EACpC,KAAK,EAAE,SAAS,EAChB,GAAG,IAAI,EAAE,UAAU,CACjB,MAAM,CAAC,SAAS,CAAC,SAAS,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAC1D,GACA,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;CA2BxB;AAED,wBAAgB,UAAU,CAAC,MAAM,SAAS,UAAU,CAAC,MAAM,CAAC,EAC1D,OAAO,EAAE,SAAS,cAAc,CAAC,MAAM,EAAE,GAAG,SAAS,EACrD,cAAc,EAAE,CACd,MAAM,EAAE,cAAc,CAAC,MAAM,KAC1B,OAAO,CAAC,MAAM,CAAC,GAAG,SAAS,EAChC,iBAAiB,EAAE,CAAC,SAAS,SAAS,MAAM,MAAM,EAChD,QAAQ,EAAE,SAAS,EACnB,MAAM,EAAE,MAAM,CAAC,SAAS,CAAC,SAAS,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,EACjE,MAAM,EAAE,cAAc,CAAC,MAAM,KAC1B,IAAI,GACR,IAAI,CA0EN"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EACV,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,EACf,cAAc,EACf,MAAM,iBAAiB,CAAC;AAKzB,qBAAa,UAAU,CAAC,MAAM,SAAS,mBAAmB,CAAC,MAAM,CAAC;IAChE,SAAS,EAAE;SACR,GAAG,IAAI,MAAM,MAAM,CAAC,CAAC,EAAE,KAAK,CAC3B,MAAM,CAAC,MAAM,MAAM,CAAC,SAAS,oBAAoB,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CACvE;KACF,CAAuB;IAExB,IAAI,CAAC,SAAS,SAAS,MAAM,MAAM,EACjC,KAAK,EAAE,SAAS,EAChB,EAAE,EAAE,MAAM,CAAC,SAAS,CAAC,SAAS,oBAAoB,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,GACtE,IAAI;IAKP;;;OAGG;IACH,OAAO,CAAC,SAAS,SAAS,MAAM,MAAM,EACpC,QAAQ,EAAE,SAAS,EACnB,GAAG,IAAI,EAAE,UAAU,CACjB,MAAM,CAAC,SAAS,CAAC,SAAS,oBAAoB,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CACpE,GACA,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;CA2BxB;AAID,0CAA0C;AAC1C,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,mBAAmB,CAAC,CAAC,CAAC,CAAC;AACnD,qCAAqC;AACrC,eAAO,MAAM,UAAU,qBAAe,CAAC;AACvC,yCAAyC;AACzC,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,IAC5D,kBAAkB,CAAC,CAAC,CAAC,CAAC;AACxB,2CAA2C;AAC3C,MAAM,MAAM,UAAU,CACpB,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,eAAe,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,IACvE,oBAAoB,CAAC,CAAC,CAAC,GAAG,SAAS,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAAC;AAC/D,qCAAqC;AACrC,MAAM,MAAM,kBAAkB,CAC5B,CAAC,SAAS,oBAAoB,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC,IACrD,cAAc,CAAC,CAAC,CAAC,CAAC"}

package/dist/hooks.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.applyHooks = exports.AsyncHooks = void 0;
-const sort_js_1 = require("./sort.js");
-const isDev = process.env.GRAPHILE_ENV === "development";
+const functionality_js_1 = require("./functionality.js");
+const isDev = typeof process !== "undefined" && process.env.GRAPHILE_ENV === "development";
 class AsyncHooks {
     constructor() {
         this.callbacks = Object.create(null);
@@ -15,8 +15,8 @@ class AsyncHooks {
      * Hooks can _mutate_ the argument, they cannot return a replacement. This
      * allows us to completely side-step the problem of recursive calls.
      */
-    process(event, ...args) {
-        const callbacks = this.callbacks[event];
+    process(hookName, ...args) {
+        const callbacks = this.callbacks[hookName];
         if (!callbacks) {
             return;
         }
@@ -31,7 +31,7 @@ class AsyncHooks {
                 const result = callback.apply(null, args);
                 if (result != null) {
                     if (isDev && typeof result.then !== "function") {
-                        throw new Error(`Hook '${event}' returned invalid value of type ${typeof result} - must be 'undefined' or a Promise/PromiseLike.`);
+                        throw new Error(`Hook '${hookName}' returned invalid value of type ${typeof result} - must be 'undefined' or a Promise/PromiseLike.`);
                     }
                     chain = result;
                 }
@@ -41,57 +41,6 @@ class AsyncHooks {
     }
 }
 exports.AsyncHooks = AsyncHooks;
-function applyHooks(plugins, hooksRetriever, applyHookCallback) {
-    // Normalize all the hooks and gather them into collections
-    const allHooks = Object.create(null);
-    let uid = 0;
-    if (plugins) {
-        for (const plugin of plugins) {
-            const hooks = hooksRetriever(plugin);
-            if (!hooks) {
-                continue;
-            }
-            const keys = Object.keys(hooks);
-            for (const key of keys) {
-                const hookSpecRaw = hooks[key];
-                if (!hookSpecRaw) {
-                    continue;
-                }
-                // TypeScript nonsense
-                const isPluginHookObject = (v) => typeof v !== "function";
-                const isPluginHookFunction = (v) => typeof v === "function";
-                const callback = (isPluginHookFunction(hookSpecRaw) ? hookSpecRaw : hookSpecRaw.callback);
-                const { provides, before, after } = isPluginHookObject(hookSpecRaw)
-                    ? hookSpecRaw
-                    : {};
-                if (!allHooks[key]) {
-                    allHooks[key] = [];
-                }
-                // We need to give each hook a unique ID
-                const id = String(uid++);
-                allHooks[key].push({
-                    id,
-                    plugin,
-                    callback,
-                    provides: [...(provides || []), id, plugin.name],
-                    before: before || [],
-                    after: after || [],
-                });
-            }
-        }
-    }
-    // Sort the collections according to provides, before and after.
-    for (const hookName in allHooks) {
-        const hooks = allHooks[hookName];
-        if (!hooks) {
-            continue;
-        }
-        const final = (0, sort_js_1.sortWithBeforeAfterProvides)(hooks, "id");
-        // Finally we can register the hooks
-        for (const hook of final) {
-            applyHookCallback(hookName, hook.callback, hook.plugin);
-        }
-    }
-}
-exports.applyHooks = applyHooks;
+/** @deprecated Use `orderedApply` */
+exports.applyHooks = functionality_js_1.orderedApply;
 //# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":";;;AAAA,yDAAkD;AASlD,MAAM,KAAK,GACT,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,aAAa,CAAC;AAE/E,MAAa,UAAU;IAAvB;QACE,cAAS,GAIL,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IA8C1B,CAAC;IA5CC,IAAI,CACF,KAAgB,EAChB,EAAuE;QAEvE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QACpD,IAAI,CAAC,SAAS,CAAC,KAAK,CAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClC,CAAC;IAED;;;OAGG;IACH,OAAO,CACL,QAAmB,EACnB,GAAG,IAEF;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC3C,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO;QACT,CAAC;QACD,MAAM,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC;QAC3B,IAAI,KAAK,GAAG,SAAS,CAAC;QACtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3B,MAAM,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;YAC9B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;YACvD,CAAC;iBAAM,CAAC;gBACN,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;gBAC1C,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;oBACnB,IAAI,KAAK,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;wBAC/C,MAAM,IAAI,KAAK,CACb,SACE,QACF,oCAAoC,OAAO,MAAM,kDAAkD,CACpG,CAAC;oBACJ,CAAC;oBACD,KAAK,GAAG,MAAM,CAAC;gBACjB,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAnDD,gCAmDC;AAMD,qCAAqC;AACxB,QAAA,UAAU,GAAG,+BAAY,CAAC"}

package/dist/index.d.ts

@@ -1,19 +1,39 @@
 import "./interfaces.js";
 export { GraphileConfig };
-export { applyHooks, AsyncHooks, HookObject } from "./hooks.js";
-export type { PluginHook, PluginHookObject } from "./interfaces.js";
-export { isResolvedPreset, resolvePresets } from "./resolvePresets.js";
+export { orderedApply } from "./functionality.js";
+export { applyHooks, AsyncHooks, HookObject, PluginHook, PluginHookObject, } from "./hooks.js";
+export type { CallbackDescriptor, CallbackOrDescriptor, FunctionalityObject, } from "./interfaces.js";
+export type { MiddlewareHandlers, MiddlewareNext } from "./middleware.js";
+export { Middleware } from "./middleware.js";
+export { isResolvedPreset, resolvePreset, resolvePresets, } from "./resolvePresets.js";
 export declare function sortedPlugins(plugins: GraphileConfig.Plugin[] | undefined): GraphileConfig.Plugin[];
 declare global {
     namespace GraphileConfig {
+        interface Lib {
+            versions: Record<string, string | undefined>;
+        }
+        /**
+         * Expand this through declaration merging to get TypeScript
+         * auto-completion of plugin names in the relevant places.
+         */
+        interface Plugins {
+            [key: string & {}]: true;
+        }
+        /**
+         * Expand this through declaration merging to get TypeScript
+         * auto-completion of things that plugins can provide.
+         */
+        interface Provides {
+            [key: string & {}]: true;
+        }
         interface Plugin {
-            name: string;
-            version: string;
+            name: keyof GraphileConfig.Plugins;
+            version?: string;
             experimental?: boolean;
             description?: string;
-            provides?: string[];
-            after?: string[];
-            before?: string[];
+            provides?: (keyof GraphileConfig.Plugins | keyof GraphileConfig.Provides)[];
+            after?: (keyof GraphileConfig.Plugins | keyof GraphileConfig.Provides)[];
+            before?: (keyof GraphileConfig.Plugins | keyof GraphileConfig.Provides)[];
         }
         /**
          * A Graphile Config Preset that can be combined with other presets to
@@ -23,15 +43,22 @@ declare global {
         interface Preset {
             extends?: ReadonlyArray<Preset>;
             plugins?: Plugin[];
-            disablePlugins?: ReadonlyArray<string>;
+            disablePlugins?: ReadonlyArray<keyof GraphileConfig.Plugins>;
+            lib?: Partial<GraphileConfig.Lib>;
             appendPlugins?: never;
             prependPlugins?: never;
             skipPlugins?: never;
         }
+        /**
+         * The result of `resolvePreset(preset)` on a preset - compatible with
+         * `Preset` but guaranteed to not extend from other presets (and a few
+         * other assertions).
+         */
         interface ResolvedPreset extends Preset {
-            extends?: ReadonlyArray<never>;
-            plugins?: Plugin[];
-            disablePlugins?: ReadonlyArray<string>;
+            extends?: never;
+            plugins: Plugin[];
+            disablePlugins: ReadonlyArray<keyof GraphileConfig.Plugins>;
+            lib: GraphileConfig.Lib;
         }
     }
 }

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,iBAAiB,CAAC;AAIzB,OAAO,EAAE,cAAc,EAAE,CAAC;AAE1B,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAChE,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAEvE,wBAAgB,aAAa,CAC3B,OAAO,EAAE,cAAc,CAAC,MAAM,EAAE,GAAG,SAAS,GAC3C,cAAc,CAAC,MAAM,EAAE,CAMzB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,cAAc,CAAC;QACvB,UAAU,MAAM;YACd,IAAI,EAAE,MAAM,CAAC;YACb,OAAO,EAAE,MAAM,CAAC;YAChB,YAAY,CAAC,EAAE,OAAO,CAAC;YACvB,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;YACpB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;YACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;SACnB;QAED;;;;WAIG;QACH,UAAU,MAAM;YACd,OAAO,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;YAChC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;YACnB,cAAc,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;YACvC,aAAa,CAAC,EAAE,KAAK,CAAC;YACtB,cAAc,CAAC,EAAE,KAAK,CAAC;YACvB,WAAW,CAAC,EAAE,KAAK,CAAC;SAGrB;QAED,UAAU,cAAe,SAAQ,MAAM;YAErC,OAAO,CAAC,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC;YAC/B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;YACnB,cAAc,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;SACxC;KACF;CACF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,iBAAiB,CAAC;AAIzB,OAAO,EAAE,cAAc,EAAE,CAAC;AAE1B,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EACL,UAAU,EACV,UAAU,EACV,UAAU,EACV,UAAU,EACV,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,cAAc,GACf,MAAM,qBAAqB,CAAC;AAE7B,wBAAgB,aAAa,CAC3B,OAAO,EAAE,cAAc,CAAC,MAAM,EAAE,GAAG,SAAS,GAC3C,cAAc,CAAC,MAAM,EAAE,CAMzB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,cAAc,CAAC;QACvB,UAAU,GAAG;YACX,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;SAE9C;QAED;;;WAGG;QACH,UAAU,OAAO;YAEf,CAAC,GAAG,EAAE,MAAM,GAAG,EAAE,GAAG,IAAI,CAAC;SAC1B;QAED;;;WAGG;QACH,UAAU,QAAQ;YAEhB,CAAC,GAAG,EAAE,MAAM,GAAG,EAAE,GAAG,IAAI,CAAC;SAC1B;QAED,UAAU,MAAM;YACd,IAAI,EAAE,MAAM,cAAc,CAAC,OAAO,CAAC;YACnC,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB,YAAY,CAAC,EAAE,OAAO,CAAC;YACvB,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,QAAQ,CAAC,EAAE,CACP,MAAM,cAAc,CAAC,OAAO,GAC5B,MAAM,cAAc,CAAC,QAAQ,CAChC,EAAE,CAAC;YACJ,KAAK,CAAC,EAAE,CAAC,MAAM,cAAc,CAAC,OAAO,GAAG,MAAM,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzE,MAAM,CAAC,EAAE,CAAC,MAAM,cAAc,CAAC,OAAO,GAAG,MAAM,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC;SAC3E;QAED;;;;WAIG;QACH,UAAU,MAAM;YACd,OAAO,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;YAChC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;YACnB,cAAc,CAAC,EAAE,aAAa,CAAC,MAAM,cAAc,CAAC,OAAO,CAAC,CAAC;YAC7D,GAAG,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;YAIlC,aAAa,CAAC,EAAE,KAAK,CAAC;YACtB,cAAc,CAAC,EAAE,KAAK,CAAC;YACvB,WAAW,CAAC,EAAE,KAAK,CAAC;SAGrB;QAED;;;;WAIG;QACH,UAAU,cAAe,SAAQ,MAAM;YAGrC,OAAO,CAAC,EAAE,KAAK,CAAC;YAChB,OAAO,EAAE,MAAM,EAAE,CAAC;YAClB,cAAc,EAAE,aAAa,CAAC,MAAM,cAAc,CAAC,OAAO,CAAC,CAAC;YAC5D,GAAG,EAAE,cAAc,CAAC,GAAG,CAAC;SACzB;KACF;CACF"}

package/dist/index.js

@@ -1,13 +1,19 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.sortedPlugins = exports.resolvePresets = exports.isResolvedPreset = exports.AsyncHooks = exports.applyHooks = void 0;
+exports.resolvePresets = exports.resolvePreset = exports.isResolvedPreset = exports.Middleware = exports.AsyncHooks = exports.applyHooks = exports.orderedApply = void 0;
+exports.sortedPlugins = sortedPlugins;
 require("./interfaces.js");
 const sort_js_1 = require("./sort.js");
+var functionality_js_1 = require("./functionality.js");
+Object.defineProperty(exports, "orderedApply", { enumerable: true, get: function () { return functionality_js_1.orderedApply; } });
 var hooks_js_1 = require("./hooks.js");
 Object.defineProperty(exports, "applyHooks", { enumerable: true, get: function () { return hooks_js_1.applyHooks; } });
 Object.defineProperty(exports, "AsyncHooks", { enumerable: true, get: function () { return hooks_js_1.AsyncHooks; } });
+var middleware_js_1 = require("./middleware.js");
+Object.defineProperty(exports, "Middleware", { enumerable: true, get: function () { return middleware_js_1.Middleware; } });
 var resolvePresets_js_1 = require("./resolvePresets.js");
 Object.defineProperty(exports, "isResolvedPreset", { enumerable: true, get: function () { return resolvePresets_js_1.isResolvedPreset; } });
+Object.defineProperty(exports, "resolvePreset", { enumerable: true, get: function () { return resolvePresets_js_1.resolvePreset; } });
 Object.defineProperty(exports, "resolvePresets", { enumerable: true, get: function () { return resolvePresets_js_1.resolvePresets; } });
 function sortedPlugins(plugins) {
     if (plugins) {
@@ -17,5 +23,4 @@ function sortedPlugins(plugins) {
         return [];
     }
 }
-exports.sortedPlugins = sortedPlugins;
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,2BAAyB;AAEzB,uCAAwD;AAIxD,uCAAgE;AAAvD,sGAAA,UAAU,OAAA;AAAE,sGAAA,UAAU,OAAA;AAE/B,yDAAuE;AAA9D,qHAAA,gBAAgB,OAAA;AAAE,mHAAA,cAAc,OAAA;AAEzC,SAAgB,aAAa,CAC3B,OAA4C;IAE5C,IAAI,OAAO,EAAE;QACX,OAAO,IAAA,qCAA2B,EAAC,OAAO,EAAE,MAAM,CAAC,CAAC;KACrD;SAAM;QACL,OAAO,EAAE,CAAC;KACX;AACH,CAAC;AARD,sCAQC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AA2BA,sCAQC;AAnCD,2BAAyB;AAEzB,uCAAwD;AAIxD,uDAAkD;AAAzC,gHAAA,YAAY,OAAA;AACrB,uCAMoB;AALlB,sGAAA,UAAU,OAAA;AACV,sGAAA,UAAU,OAAA;AAWZ,iDAA6C;AAApC,2GAAA,UAAU,OAAA;AACnB,yDAI6B;AAH3B,qHAAA,gBAAgB,OAAA;AAChB,kHAAA,aAAa,OAAA;AACb,mHAAA,cAAc,OAAA;AAGhB,SAAgB,aAAa,CAC3B,OAA4C;IAE5C,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,IAAA,qCAA2B,EAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACtD,CAAC;SAAM,CAAC;QACN,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/interfaces.d.ts

@@ -1,9 +1,12 @@
-export type PluginHookObject<T extends (...args: any[]) => any> = {
-    provides?: string[];
-    before?: string[];
-    after?: string[];
+export type AnyCallback = (...args: any[]) => any;
+export type CallbackDescriptor<T extends AnyCallback> = {
+    provides?: (keyof GraphileConfig.Plugins | keyof GraphileConfig.Provides)[];
+    before?: (keyof GraphileConfig.Plugins | keyof GraphileConfig.Provides)[];
+    after?: (keyof GraphileConfig.Plugins | keyof GraphileConfig.Provides)[];
     callback: T;
 };
-export type PluginHook<T extends (...args: any[]) => any> = T | PluginHookObject<T>;
-export type PluginHookCallback<T extends PluginHook<(...args: any[]) => any>> = T extends PluginHook<infer U> ? U : never;
+export type PromiseOrDirect<T> = T | PromiseLike<T>;
+export type CallbackOrDescriptor<T extends AnyCallback> = T | CallbackDescriptor<T>;
+export type UnwrapCallback<T extends CallbackOrDescriptor<AnyCallback> | ReadonlyArray<CallbackDescriptor<AnyCallback>>> = T extends CallbackOrDescriptor<infer U> ? U : T extends ReadonlyArray<CallbackDescriptor<infer U>> ? U : never;
+export type FunctionalityObject<T> = Record<keyof T, CallbackOrDescriptor<AnyCallback> | ReadonlyArray<CallbackDescriptor<AnyCallback>>>;
 //# sourceMappingURL=interfaces.d.ts.map

package/dist/interfaces.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../src/interfaces.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,IAAI;IAChE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,CAAC,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,IACpD,CAAC,GACD,gBAAgB,CAAC,CAAC,CAAC,CAAC;AAExB,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,UAAU,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC,IAC1E,CAAC,SAAS,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC"}
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../src/interfaces.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;AAElD,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,WAAW,IAAI;IACtD,QAAQ,CAAC,EAAE,CAAC,MAAM,cAAc,CAAC,OAAO,GAAG,MAAM,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC;IAC5E,MAAM,CAAC,EAAE,CAAC,MAAM,cAAc,CAAC,OAAO,GAAG,MAAM,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC;IAC1E,KAAK,CAAC,EAAE,CAAC,MAAM,cAAc,CAAC,OAAO,GAAG,MAAM,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC;IACzE,QAAQ,EAAE,CAAC,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;AAEpD,MAAM,MAAM,oBAAoB,CAAC,CAAC,SAAS,WAAW,IAClD,CAAC,GACD,kBAAkB,CAAC,CAAC,CAAC,CAAC;AAE1B,MAAM,MAAM,cAAc,CACxB,CAAC,SACG,oBAAoB,CAAC,WAAW,CAAC,GACjC,aAAa,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC,IAElD,CAAC,SAAS,oBAAoB,CAAC,MAAM,CAAC,CAAC,GACnC,CAAC,GACD,CAAC,SAAS,aAAa,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,GAClD,CAAC,GACD,KAAK,CAAC;AAEd,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI,MAAM,CACzC,MAAM,CAAC,EACL,oBAAoB,CAAC,WAAW,CAAC,GACjC,aAAa,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC,CACjD,CAAC"}

package/dist/loadConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loadConfig.d.ts","sourceRoot":"","sources":["../src/loadConfig.ts"],"names":[],"mappings":"AAAA,OAAO,iBAAiB,CAAC;AA6DzB,wBAAsB,UAAU,CAC9B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,GACzB,OAAO,CAAC,cAAc,CAAC,MAAM,GAAG,IAAI,CAAC,CA2CvC"}
+{"version":3,"file":"loadConfig.d.ts","sourceRoot":"","sources":["../src/loadConfig.ts"],"names":[],"mappings":"AACA,OAAO,iBAAiB,CAAC;AAiHzB,wBAAsB,UAAU,CAC9B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,GACzB,OAAO,CAAC,cAAc,CAAC,MAAM,GAAG,IAAI,CAAC,CAwDvC"}