postgraphile 4.12.12 → 5.0.0-0.3

package/CHANGELOG.md

@@ -0,0 +1,46 @@
+# postgraphile
+
+## 5.0.0-0.3
+
+### Patch Changes
+
+- Updated dependencies [[`6576bd37b`](undefined), [`25037fc15`](undefined)]:
+  - ruru@2.0.0-0.1
+  - @dataplan/pg@0.0.1-0.2
+  - grafast@0.0.1-0.2
+  - grafserv@0.0.1-0.2
+  - graphile-build-pg@5.0.0-0.3
+  - graphile-build@5.0.0-0.3
+  - graphile-export@0.0.2-0.2
+
+## 5.0.0-0.2
+
+### Patch Changes
+
+- Updated dependencies [[`55f15cf35`](undefined)]:
+  - @dataplan/pg@0.0.1-0.1
+  - grafast@0.0.1-0.1
+  - graphile-build-pg@5.0.0-0.2
+  - grafserv@0.0.1-0.1
+  - graphile-build@5.0.0-0.2
+  - 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)]:
+  - ruru@2.0.0-0.0
+  - @dataplan/pg@0.0.1-0.0
+  - @graphile/lru@5.0.0-0.1
+  - grafast@0.0.1-0.0
+  - grafserv@0.0.1-0.0
+  - graphile-build@5.0.0-0.1
+  - graphile-build-pg@5.0.0-0.1
+  - graphile-config@0.0.1-0.0
+  - graphile-export@0.0.2-0.0

package/LICENSE.md

@@ -1,25 +1,20 @@
 # The MIT License (MIT)
 
-Copyright (c) 2016 Caleb Meredith  
-Copyright (c) 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,25 +1,30 @@
-<img width="120" height="120" title="PostGraphile logo" src="https://cdn.rawgit.com/graphile/graphile.github.io/a6225f8c3052df5c276ecef28aeb0cade1aec16a/logos/postgraphile.optimized.svg" />
-
 # PostGraphile
 
-[![GitHub Sponsors](https://img.shields.io/github/sponsors/benjie?label=GitHub%20sponsors)](https://github.com/sponsors/benjie)
+[![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/postgraphile.svg?style=flat)](https://www.npmjs.com/package/postgraphile)
-![MIT license](https://img.shields.io/npm/l/postgraphile.svg)
 [![Follow](https://img.shields.io/badge/twitter-@GraphileHQ-blue.svg)](https://twitter.com/GraphileHQ)
 
-_**Instant lightning-fast GraphQL API backed primarily by your PostgreSQL database. Highly customisable and extensible thanks to incredibly powerful plugin system.**_ _Formerly "PostGraphQL"._
+_**Instant lightning-fast GraphQL API backed primarily by your PostgreSQL
+database. Highly customisable and extensible thanks to incredibly powerful
+plugin system.**_
+
+**Documentation**: https://postgraphile.org/postgraphile/next/
 
-## Documentation: [graphile.org/postgraphile](https://graphile.org/postgraphile)
+An incredibly low-effort way to build a well structured and high-performance
+GraphQL API backed primarily by a PostgreSQL database. Our main focusses are
+performance, automatic best-practices and customisability/extensibility. Use
+this if you have a PostgreSQL database and you want to use it as the primary
+"source of truth" for an auto-generated GraphQL API (which you can still make
+significant changes to).
 
 <!-- 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/)
 
@@ -28,10 +33,10 @@ 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>
-<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>
 </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://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>
@@ -44,163 +49,3 @@ And please give some love to our featured sponsors 🤩:
 <em>\* Sponsors the entire Graphile suite</em>
 
 <!-- SPONSORS_END -->
-
-## About
-
-**GraphQL** is a new way of communicating with your server. It eliminates the problems of over- and under-fetching, incorporates strong data types, has built-in introspection, documentation and deprecation capabilities, and is implemented in many programming languages. This all leads to gloriously low-latency user experiences, better developer experiences, and much increased productivity. Because of all this, GraphQL is typically used as a replacement for (or companion to) RESTful API services.
-
-**PostgreSQL** is the self-proclaimed “world’s most advanced open source database,” with each new release bringing more amazing features and performance gains. Thinking of your database as a plain CRUD store is now an archaic viewpoint as modern PostgreSQL can do so much for you &mdash; from authorization with Row-Level Security (RLS, introduced in PG9.5), through Foreign Data Wrappers (FDW), to real time notifications with `LISTEN`/`NOTIFY`.
-
-**PostGraphile** pairs these two incredible technologies together, helping you not only build applications more rapidly, but to build lightning-fast applications. PostGraphile allows you to access the power of PostgreSQL through a well designed, extensible, customisable and incredibly performant GraphQL server. It automatically detects tables, columns, indexes, relationships, views, types, functions, comments, and more - providing a GraphQL server that is highly intelligent about your data, and that automatically updates itself without restarting when you change your database schema.
-
-With PostGraphile, a well designed database schema should serve the basis for a well thought out API. PostgreSQL already has amazing authorization and relationship infrastructure, _why duplicate that logic_ in a custom API? A PostGraphile API is likely to provide a more performant and standards compliant GraphQL API than any created in-house, and can be built in a fraction of the time. Focus on your product and let PostGraphile worry about the API layer. Once you need to expand beyond this, we have a powerful plugin system including many [community contributed plugins](https://www.graphile.org/postgraphile/community-plugins/). For a critical evaluation of PostGraphile to determine if it fits in your tech stack, read [evaluating PostGraphile for your project](https://www.graphile.org/postgraphile/evaluating/).
-
-## Introduction
-
-Watch a talk by the original author [Caleb](https://twitter.com/calebmer) at GraphQL Summit for a walk-through of building an application with PostGraphile in under 7 minutes. This was using v2 (then called PostGraphQL); we're now up to v4 which has many more bells and whistles!
-
-[![PostGraphile at GraphQL Summit](https://img.youtube.com/vi/b3pwlCDy6vY/0.jpg)](https://www.youtube.com/watch?v=b3pwlCDy6vY)
-
-Hear from the current maintainer [Benjie](https://twitter.com/benjie) at GraphQL Finland about the benefits of Database-Driven GraphQL Development:
-
-[![Database Driven GraphQL Development at GraphQL Finland](https://img.youtube.com/vi/XDOrhTXd4pE/0.jpg)](https://www.youtube.com/watch?v=XDOrhTXd4pE)
-
-## Usage
-
-**Documentation: [graphile.org/postgraphile](https://graphile.org/postgraphile)**
-
-You can use PostGraphile via the CLI, as a Node.js middleware, or use the GraphQL schema directly. Make sure to check out the **[full usage instructions](https://graphile.org/postgraphile/usage/)** on the documentation website. We also have a [PostgreSQL schema design guide](https://www.graphile.org/postgraphile/postgresql-schema-design/) you can follow to build a fully functional PostGraphile API.
-
-### CLI
-
-To get started you can install PostGraphile globally:
-
-```bash
-npm install -g postgraphile
-```
-
-…and then just run it! By default, PostGraphile will connect to your local database at `postgres://localhost:5432` and introspect the `public` schema. See [the available CLI flags](https://www.graphile.org/postgraphile/usage-cli/) with:
-
-```bash
-postgraphile --help
-```
-
-When you're ready to use PostGraphile for your own project, you're advised to install it locally with `yarn`, and run it with `npx`:
-
-```bash
-yarn add postgraphile
-npx postgraphile --help
-```
-
-**macOS users**: PostGraphile has used port 5000 by default for 5+ years; recently Apple decided to bind the AirPlay service to port 5000 causing a conflict. Please use the `--port` option to bind to a different port.
-
-### Middleware
-
-You can also use PostGraphile as [native HTTP, Connect, Express, or Koa (experimental) middleware](https://www.graphile.org/postgraphile/usage-library/), e.g.:
-
-```bash
-yarn add postgraphile
-```
-
-```js
-import { createServer } from 'http';
-import postgraphile from 'postgraphile';
-
-createServer(postgraphile());
-```
-
-Check out [hapi-postgraphile](https://github.com/mshick/hapi-postgraphile) if you're interested in using PostGraphile as a [hapi](https://github.com/hapijs/hapi) server plugin.
-
-### Docker
-
-To run via Docker, simply pass the [CLI options](https://www.graphile.org/postgraphile/usage-cli/) to the Docker container:
-
-```bash
-docker pull graphile/postgraphile
-docker run --init graphile/postgraphile --help
-```
-
-E.g. you might run this command (substituting the relevant variables):
-
-```bash
-docker run --init -p 5000:5000 graphile/postgraphile --connection postgres://POSTGRES_USER:POSTGRES_PASSWORD@POSTGRES_HOST:POSTGRES_PORT/POSTGRES_DATABASE --schema app_public --watch
-```
-
-**macOS users**: Please use a different port to avoid conflict with AirPlay.
-
-## Read More
-
-**Full documentation for PostGraphile is located at [graphile.org/postgraphile](https://graphile.org/postgraphile).**
-
-PostGraphile features include:
-
-- Authorization (security) provided by PostgreSQL:
-  - [role-based access control (RBAC)](https://www.postgresql.org/docs/10/static/sql-grant.html)
-  - [row-level security (RLS)][row-level-security]
-- [Automatic GraphQL relations from SQL relations](https://www.graphile.org/postgraphile/relations/)
-- [PostgreSQL procedure support][procedure documentation]:
-  - [Custom queries][advanced queries documentation]
-  - [Custom mutations](https://www.graphile.org/postgraphile/custom-mutations/)
-  - [Computed columns](https://www.graphile.org/postgraphile/computed-columns/)
-- Development UI (GraphiQL) built in
-- `--watch` mode, auto-detects changes in SQL schema, hot-reloads changes into GraphiQL
-- [Automatic documentation, enhanced by PostgreSQL `COMMENT`s](http://www.postgresql.org/docs/current/static/sql-comment.html)
-- [Schema customisation through smart comments](https://www.graphile.org/postgraphile/smart-comments/)
-- [Simple JWT authentication straight from the database](https://www.graphile.org/postgraphile/security/)
-- [Cursor-based pagination, Relay (classic & modern) compatible](https://www.graphile.org/postgraphile/connections/)
-- Global object identifiers (`nodeId` by default, but Relay-favoured `id` with `--classic-ids`)
-- Relay-compatible mutations
-- [Use direct from the CLI](https://www.graphile.org/postgraphile/usage-cli/)
-- [Use as Express, Connect, or Koa middleware](https://www.graphile.org/postgraphile/usage-library/)
-- [Just use the generated GraphQL schema](https://www.graphile.org/postgraphile/usage-schema/)
-
-[procedure documentation]: https://www.graphile.org/postgraphile/procedures/
-[advanced queries documentation]: https://www.graphile.org/postgraphile/custom-queries/
-[row-level-security]: http://www.postgresql.org/docs/current/static/ddl-rowsecurity.html
-
-## Requirements
-
-[Full requirements are on the website](https://www.graphile.org/postgraphile/requirements/), but a basic summary is:
-
-- Node v8.6+
-- PostgreSQL 9.6+ (officially; but currently works with 9.4+)
-- Linux, macOS or Windows
-
-Caveats:
-
-- PostGraphile does not have automated tests on Windows, if you notice any
-  issues please file them (or send a PR!)
-
-## Supporting PostGraphile
-
-The fastest and easiest way you can help PostGraphile thrive is by [sponsoring
-ongoing development and maintenance](https://graphile.org/sponsor/).
-
-Want to help testing and developing PostGraphile? Check out the [contributing
-document](CONTRIBUTING.md) to get started quickly!
-
-Commercial support, consultancy and development services are available direct
-from the maintainer; see [Professional Services](https://www.graphile.org/support/)
-for more information, or get in touch!
-
-The maintainer of this project is [@Benjie](https://twitter.com/benjie) -
-follow him on Twitter!
-
-## Thanks
-
-Huge thanks to [the individuals and companies who sponsor PostGraphile's
-development](SPONSORS.md) - their financial contributions enable more time to
-be spent on the project: from bug fixes, to code review, to new features! If
-you want to help the project advance more rapidly, please join them in
-[supporting this project](https://graphile.org/sponsor/) 🙏
-
-A humongous, heart-felt, thank you to the original author of PostGraphile -
-[Caleb Meredith](https://twitter.com/calebmer) - for everything he put into
-PostGraphile! He's now graduated from the project and we all wish him the best
-for his future ventures!
-
-Thanks also to the people working on
-[PostgREST](https://github.com/begriffs/postgrest) which was a huge inspiration
-for this project!
-
-Thanks and enjoy 👍

package/dist/cli-run.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli-run.d.ts.map

package/dist/cli-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-run.d.ts","sourceRoot":"","sources":["../src/cli-run.ts"],"names":[],"mappings":""}

package/dist/cli-run.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const cli_1 = require("graphile-config/cli");
+const cli_js_1 = require("./cli.js");
+(0, cli_1.runCli)(cli_js_1.options, cli_js_1.run);
+//# sourceMappingURL=cli-run.js.map

package/dist/cli-run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-run.js","sourceRoot":"","sources":["../src/cli-run.ts"],"names":[],"mappings":";;;AACA,6CAA6C;AAE7C,qCAAwC;AAExC,IAAA,YAAM,EAAC,gBAAO,EAAE,YAAG,CAAC,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,21 @@
+/// <reference types="yargs" />
+import type { ArgsFromOptions, Argv } from "graphile-config/cli";
+export declare function options(yargs: Argv): Argv<{
+    connection: string | undefined;
+} & {
+    schema: string | undefined;
+} & {
+    watch: boolean;
+} & {
+    port: number | undefined;
+} & {
+    host: string;
+} & {
+    config: string | undefined;
+} & {
+    preset: string | undefined;
+} & {
+    "allow-explain": boolean | undefined;
+}>;
+export declare function run(args: ArgsFromOptions<typeof options>): Promise<void>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAWjE,wBAAgB,OAAO,CAAC,KAAK,EAAE,IAAI;;;;;;;;;;;;;;;;GAwDlC;AAkCD,wBAAsB,GAAG,CAAC,IAAI,EAAE,eAAe,CAAC,OAAO,OAAO,CAAC,iBAkH9D"}

package/dist/cli.js

@@ -0,0 +1,180 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.run = exports.options = void 0;
+const graphile_config_1 = require("graphile-config");
+const load_1 = require("graphile-config/load");
+const node_http_1 = require("node:http");
+const node_util_1 = require("node:util");
+const index_js_1 = require("./index.js");
+const schema_js_1 = require("./schema.js");
+// The preset we recommend if the user doesn't specify one
+const RECOMMENDED_PRESET = "--preset postgraphile/presets/amber";
+function options(yargs) {
+    return yargs
+        .parserConfiguration({
+        // Last option wins - do NOT make duplicates into arrays!
+        "duplicate-arguments-array": false,
+    })
+        .usage("$0", "Run a PostGraphile HTTP server")
+        .example("$0 --connection postgres://localhost:5432/dbname --schema public --allow-explain", "Run PostGraphile connecting to the given PostgreSQL connection string, exposing the 'public' schema as GraphQL and allowing clients to request details of what went on 'under the hood' when executing operations ('explain')")
+        .option("connection", {
+        alias: "c",
+        type: "string",
+        description: "The PostgreSQL connection string to connect to",
+    })
+        .option("schema", {
+        alias: "s",
+        type: "string",
+        description: "The database schema (or comma separated list of schemas) to expose over GraphQL",
+    })
+        .option("watch", {
+        alias: "w",
+        type: "boolean",
+        description: "Watch mode (monitor DB for schema changes)",
+        default: false,
+    })
+        .option("port", {
+        alias: "p",
+        type: "number",
+        description: "The port number on which to run our HTTP server",
+    })
+        .option("host", {
+        alias: "n",
+        type: "string",
+        description: "The host to bind our HTTP server to",
+        default: "localhost",
+    })
+        .option("config", {
+        alias: "C",
+        type: "string",
+        description: "The path to the config file",
+        normalize: true,
+    })
+        .option("preset", {
+        alias: "P",
+        type: "string",
+        description: "A comma separated list of the preset(s) to use",
+    })
+        .option("allow-explain", {
+        alias: "e",
+        type: "boolean",
+        description: "Allow visitors to view the plan/SQL queries/etc related to each GraphQL operation",
+    });
+}
+exports.options = options;
+function isGraphileConfigPreset(foo) {
+    if (typeof foo !== "object")
+        return false;
+    if (foo === null)
+        return false;
+    const prototype = Object.getPrototypeOf(foo);
+    if (prototype === null || prototype === Object.prototype) {
+        return true;
+    }
+    return false;
+}
+async function loadPresets(presetSpecs) {
+    const specs = presetSpecs.split(",");
+    const presets = [];
+    for (const spec of specs) {
+        const [moduleName, exportName = "default"] = spec.split(":");
+        const mod = await import(moduleName);
+        const possiblePreset = mod[exportName];
+        if (isGraphileConfigPreset(possiblePreset)) {
+            presets.push(possiblePreset);
+        }
+        else {
+            throw new Error(`Imported '${spec}' but the '${exportName}' export doesn't look like a preset: ${(0, node_util_1.inspect)(spec)}`);
+        }
+    }
+    return presets;
+}
+async function run(args) {
+    const { connection: connectionString, schema: rawSchema, port: rawPort, host: rawHost, config: configFileLocation, allowExplain: rawAllowExplain, watch, preset: rawPresets, } = args;
+    const cliPresets = rawPresets ? await loadPresets(rawPresets) : [];
+    // Try and load the preset
+    const userPreset = await (0, load_1.loadConfig)(configFileLocation);
+    const preset = {
+        extends: [...(userPreset ? [userPreset] : []), ...cliPresets],
+    };
+    if (preset.extends.length === 0) {
+        console.error(`ERROR: You must either specify a --preset or have a \`graphile.config.js\` file that provides one. One option is to add \`${RECOMMENDED_PRESET}\` to your command line:\n\n  postgraphile ${RECOMMENDED_PRESET}${process.argv.length > 2 ? ` ${process.argv.slice(2).join(" ")}` : ""}`);
+        process.exit(1);
+    }
+    // Apply CLI options to preset
+    if (connectionString || rawSchema) {
+        const schemas = rawSchema?.split(",") ?? ["public"];
+        const newPgSources = (0, schema_js_1.makePgSources)(connectionString, schemas);
+        preset.pgSources = newPgSources;
+    }
+    preset.server = preset.server || {};
+    if (rawPort != null) {
+        preset.server.port = rawPort;
+    }
+    if (rawHost != null) {
+        preset.server.host = rawHost;
+    }
+    preset.grafast = preset.grafast || {};
+    if (rawAllowExplain != null) {
+        preset.grafast.explain = rawAllowExplain;
+    }
+    if (watch != null) {
+        preset.server.watch = watch;
+    }
+    const config = (0, graphile_config_1.resolvePresets)([preset]);
+    if (!config.pgSources || config.pgSources.length === 0) {
+        // TODO: respect envvars here?
+        console.error(`ERROR: Please specify \`--connection\` so we know which database to connect to (or add details to your \`graphile.config.js\`):\n\n  postgraphile${process.argv.length > 2 ? ` ${process.argv.slice(2).join(" ")}` : ""} --connection postgres://user:password@server:port/database_name?ssl=true`);
+        process.exit(2);
+    }
+    const instance = (0, index_js_1.postgraphile)(config);
+    const serv = await instance.getGrafserv();
+    const server = (0, node_http_1.createServer)(serv.handler);
+    server.once("listening", () => {
+        server.on("error", (e) => {
+            console.error("Server raised an error:", e);
+        });
+        const address = server.address();
+        if (typeof address === "string") {
+            console.log(`Server listening at ${address}`);
+        }
+        else if (address) {
+            const host = address.family === "IPv6" ? `[${address.address}]` : address.address;
+            console.log(`Server listening on port ${address.port} at http://${host}:${address.port}/graphql`);
+        }
+        else {
+            console.error(`Could not determine server address`);
+        }
+    });
+    const port = config.server?.port;
+    const host = config.server?.host;
+    const listenFailed = (e) => {
+        // Listen failed; exit
+        console.error("Failed to listen", e);
+        process.exit(2);
+    };
+    if (port != null) {
+        server.on("error", listenFailed);
+        server.once("listening", () => {
+            server.removeListener("error", listenFailed);
+        });
+        server.listen({ port, host });
+    }
+    else {
+        const tryPortZero = () => {
+            server.removeListener("error", tryPortZero);
+            server.on("error", listenFailed);
+            server.once("listening", () => {
+                server.removeListener("error", listenFailed);
+            });
+            server.listen({ host, port: 0 });
+        };
+        server.on("error", tryPortZero);
+        server.once("listening", () => {
+            server.removeListener("error", tryPortZero);
+        });
+        server.listen({ host, port: 5678 });
+    }
+}
+exports.run = run;
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;;AAAA,qDAAiD;AAEjD,+CAAkD;AAClD,yCAAyC;AACzC,yCAAoC;AAEpC,yCAA0C;AAC1C,2CAA4C;AAE5C,0DAA0D;AAC1D,MAAM,kBAAkB,GAAG,qCAAqC,CAAC;AAEjE,SAAgB,OAAO,CAAC,KAAW;IACjC,OAAO,KAAK;SACT,mBAAmB,CAAC;QACnB,yDAAyD;QACzD,2BAA2B,EAAE,KAAK;KACnC,CAAC;SACD,KAAK,CAAC,IAAI,EAAE,gCAAgC,CAAC;SAC7C,OAAO,CACN,kFAAkF,EAClF,+NAA+N,CAChO;SACA,MAAM,CAAC,YAAY,EAAE;QACpB,KAAK,EAAE,GAAG;QACV,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,gDAAgD;KAC9D,CAAC;SACD,MAAM,CAAC,QAAQ,EAAE;QAChB,KAAK,EAAE,GAAG;QACV,IAAI,EAAE,QAAQ;QACd,WAAW,EACT,iFAAiF;KACpF,CAAC;SACD,MAAM,CAAC,OAAO,EAAE;QACf,KAAK,EAAE,GAAG;QACV,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,4CAA4C;QACzD,OAAO,EAAE,KAAK;KACf,CAAC;SACD,MAAM,CAAC,MAAM,EAAE;QACd,KAAK,EAAE,GAAG;QACV,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,iDAAiD;KAC/D,CAAC;SACD,MAAM,CAAC,MAAM,EAAE;QACd,KAAK,EAAE,GAAG;QACV,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,qCAAqC;QAClD,OAAO,EAAE,WAAW;KACrB,CAAC;SACD,MAAM,CAAC,QAAQ,EAAE;QAChB,KAAK,EAAE,GAAG;QACV,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,6BAA6B;QAC1C,SAAS,EAAE,IAAI;KAChB,CAAC;SACD,MAAM,CAAC,QAAQ,EAAE;QAChB,KAAK,EAAE,GAAG;QACV,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,gDAAgD;KAC9D,CAAC;SACD,MAAM,CAAC,eAAe,EAAE;QACvB,KAAK,EAAE,GAAG;QACV,IAAI,EAAE,SAAS;QACf,WAAW,EACT,mFAAmF;KACtF,CAAC,CAAC;AACP,CAAC;AAxDD,0BAwDC;AAED,SAAS,sBAAsB,CAAC,GAAY;IAC1C,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC1C,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC/B,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;IAC7C,IAAI,SAAS,KAAK,IAAI,IAAI,SAAS,KAAK,MAAM,CAAC,SAAS,EAAE;QACxD,OAAO,IAAI,CAAC;KACb;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,KAAK,UAAU,WAAW,CACxB,WAAmB;IAEnB,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACrC,MAAM,OAAO,GAA4B,EAAE,CAAC;IAC5C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE;QACxB,MAAM,CAAC,UAAU,EAAE,UAAU,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC7D,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;QACrC,MAAM,cAAc,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC;QACvC,IAAI,sBAAsB,CAAC,cAAc,CAAC,EAAE;YAC1C,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;SAC9B;aAAM;YACL,MAAM,IAAI,KAAK,CACb,aAAa,IAAI,cAAc,UAAU,wCAAwC,IAAA,mBAAO,EACtF,IAAI,CACL,EAAE,CACJ,CAAC;SACH;KACF;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAEM,KAAK,UAAU,GAAG,CAAC,IAAqC;IAC7D,MAAM,EACJ,UAAU,EAAE,gBAAgB,EAC5B,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,kBAAkB,EAC1B,YAAY,EAAE,eAAe,EAC7B,KAAK,EACL,MAAM,EAAE,UAAU,GACnB,GAAG,IAAI,CAAC;IAET,MAAM,UAAU,GAAG,UAAU,CAAC,CAAC,CAAC,MAAM,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAEnE,0BAA0B;IAC1B,MAAM,UAAU,GAAG,MAAM,IAAA,iBAAU,EAAC,kBAAkB,CAAC,CAAC;IACxD,MAAM,MAAM,GAA0B;QACpC,OAAO,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,UAAU,CAAC;KAC9D,CAAC;IAEF,IAAI,MAAM,CAAC,OAAQ,CAAC,MAAM,KAAK,CAAC,EAAE;QAChC,OAAO,CAAC,KAAK,CACX,6HAA6H,kBAAkB,8CAA8C,kBAAkB,GAC7M,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EACpE,EAAE,CACH,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;KACjB;IAED,8BAA8B;IAC9B,IAAI,gBAAgB,IAAI,SAAS,EAAE;QACjC,MAAM,OAAO,GAAG,SAAS,EAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACpD,MAAM,YAAY,GAAG,IAAA,yBAAa,EAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;QAC9D,MAAM,CAAC,SAAS,GAAG,YAAY,CAAC;KACjC;IACD,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC;IACpC,IAAI,OAAO,IAAI,IAAI,EAAE;QACnB,MAAM,CAAC,MAAO,CAAC,IAAI,GAAG,OAAO,CAAC;KAC/B;IACD,IAAI,OAAO,IAAI,IAAI,EAAE;QACnB,MAAM,CAAC,MAAO,CAAC,IAAI,GAAG,OAAO,CAAC;KAC/B;IACD,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;IACtC,IAAI,eAAe,IAAI,IAAI,EAAE;QAC3B,MAAM,CAAC,OAAQ,CAAC,OAAO,GAAG,eAAe,CAAC;KAC3C;IACD,IAAI,KAAK,IAAI,IAAI,EAAE;QACjB,MAAM,CAAC,MAAO,CAAC,KAAK,GAAG,KAAK,CAAC;KAC9B;IAED,MAAM,MAAM,GAAG,IAAA,gCAAc,EAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IACxC,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE;QACtD,8BAA8B;QAC9B,OAAO,CAAC,KAAK,CACX,oJACE,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EACpE,2EAA2E,CAC5E,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;KACjB;IAED,MAAM,QAAQ,GAAG,IAAA,uBAAY,EAAC,MAAM,CAAC,CAAC;IAEtC,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC;IAE1C,MAAM,MAAM,GAAG,IAAA,wBAAY,EAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC1C,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE;QAC5B,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE;YACvB,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,CAAC,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;QACjC,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE;YAC/B,OAAO,CAAC,GAAG,CAAC,uBAAuB,OAAO,EAAE,CAAC,CAAC;SAC/C;aAAM,IAAI,OAAO,EAAE;YAClB,MAAM,IAAI,GACR,OAAO,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;YACvE,OAAO,CAAC,GAAG,CACT,4BAA4B,OAAO,CAAC,IAAI,cAAc,IAAI,IAAI,OAAO,CAAC,IAAI,UAAU,CACrF,CAAC;SACH;aAAM;YACL,OAAO,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;SACrD;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC;IACjC,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC;IAEjC,MAAM,YAAY,GAAG,CAAC,CAAQ,EAAE,EAAE;QAChC,sBAAsB;QACtB,OAAO,CAAC,KAAK,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC;QACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IAEF,IAAI,IAAI,IAAI,IAAI,EAAE;QAChB,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QACjC,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE;YAC5B,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;KAC/B;SAAM;QACL,MAAM,WAAW,GAAG,GAAG,EAAE;YACvB,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;YAC5C,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;YACjC,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE;gBAC5B,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;YAC/C,CAAC,CAAC,CAAC;YACH,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QACnC,CAAC,CAAC;QACF,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE;YAC5B,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;KACrC;AACH,CAAC;AAlHD,kBAkHC"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+import "graphile-build";
+import "graphile-build-pg";
+import type { Grafserv, ServerParams } from "grafserv";
+import type { GraphQLSchema } from "graphql";
+export { makePgSources, makeSchema } from "./schema.js";
+export { GraphileBuild, GraphileConfig };
+export declare function postgraphile(preset: GraphileConfig.Preset): {
+    getGrafserv(): Promise<Grafserv>;
+    getServerParams(): Promise<ServerParams>;
+    getSchema(): Promise<GraphQLSchema>;
+    release(): Promise<void>;
+};
+export default postgraphile;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,gBAAgB,CAAC;AACxB,OAAO,mBAAmB,CAAC;AAK3B,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAEvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAI7C,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAExD,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,CAAC;AAEzC,wBAAgB,YAAY,CAAC,MAAM,EAAE,cAAc,CAAC,MAAM,GAAG;IAC3D,WAAW,IAAI,OAAO,CAAC,QAAQ,CAAC,CAAC;IACjC,eAAe,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC;IACzC,SAAS,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;IACpC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B,CAgFA;AAED,eAAe,YAAY,CAAC"}