feat: separate GraphQL types into @launchql/types package

- Create new @launchql/types package (v2.11.0) with GraphQL/Graphile types
- Remove postgraphile and graphile-build dependencies from @pgpmjs/types
- Move GraphileOptions, ApiOptions, FeatureOptions to @launchql/types
- Add EnvOptions and EnvGraphQLOptions types to @pgpmjs/env
- Update consumer packages to use @launchql/types for GraphQL types
- Ensures pgpm has zero GraphQL dependencies in its dependency chain

Packages updated:
- @pgpmjs/types: removed graphile deps, kept core PGPM types
- @pgpmjs/env: added EnvOptions type for full env var parsing
- @launchql/types: new package with LaunchQLOptions, GraphileOptions, etc.
- @launchql/server, @launchql/explorer: use LaunchQLOptions
- graphile-settings, graphile-test, launchql-test: use @launchql/types

Co-Authored-By: Dan Lynch <pyramation@gmail.com>

Author: pyramation

graphile/graphile-settings/package.json

@@ -30,6 +30,7 @@
   },
   "dependencies": {
     "@graphile-contrib/pg-many-to-many": "^1.0.2",
+    "@launchql/types": "workspace:^",
     "@pgpmjs/env": "workspace:^",
     "@pgpmjs/types": "workspace:^",
     "cors": "^2.8.5",

graphile/graphile-settings/src/index.ts

@@ -1,6 +1,6 @@
 import PgManyToMany from '@graphile-contrib/pg-many-to-many';
 import { getEnvOptions } from '@pgpmjs/env';
-import { PgpmOptions } from '@pgpmjs/types';
+import { LaunchQLOptions } from '@launchql/types';
 import PgPostgis from 'graphile-postgis';
 import FulltextFilterPlugin from 'graphile-plugin-fulltext-filter';
 import { NodePlugin, Plugin } from 'graphile-build';
@@ -19,7 +19,7 @@ import CustomPgTypeMappingsPlugin from 'graphile-pg-type-mappings';
 import UploadPostGraphilePlugin, { Uploader } from 'graphile-upload-plugin';
 
 export const getGraphileSettings = (
-  rawOpts: PgpmOptions
+  rawOpts: LaunchQLOptions
 ): PostGraphileOptions => {
   const opts = getEnvOptions(rawOpts);
 

graphile/graphile-test/package.json

@@ -34,6 +34,7 @@
     "makage": "^0.1.8"
   },
   "dependencies": {
+    "@launchql/types": "workspace:^",
     "@pgpmjs/types": "workspace:^",
     "graphql": "15.10.1",
     "mock-req": "^0.2.0",

graphile/graphile-test/src/types.ts

@@ -1,4 +1,4 @@
-import type { GraphileOptions } from '@pgpmjs/types';
+import type { GraphileOptions } from '@launchql/types';
 import { DocumentNode, GraphQLError } from 'graphql';
 
 export interface GraphQLQueryOptions<TVariables = Record<string, any>> {

packages/env/src/env.ts

@@ -1,5 +1,38 @@
 import { PgpmOptions } from '@pgpmjs/types';
 
+/**
+ * Extended env options that include GraphQL-related fields.
+ * These fields are parsed from environment variables but typed separately
+ * to avoid coupling @pgpmjs/types to GraphQL dependencies.
+ * 
+ * For full type safety with GraphQL options, use LaunchQLOptions from @launchql/types
+ */
+export interface EnvGraphQLOptions {
+  graphile?: {
+    schema?: string | string[];
+  };
+  features?: {
+    simpleInflection?: boolean;
+    oppositeBaseNames?: boolean;
+    postgis?: boolean;
+  };
+  api?: {
+    enableMetaApi?: boolean;
+    isPublic?: boolean;
+    exposedSchemas?: string[];
+    metaSchemas?: string[];
+    anonRole?: string;
+    roleName?: string;
+    defaultDatabaseId?: string;
+  };
+}
+
+/**
+ * Combined environment options type that includes both PGPM core options
+ * and GraphQL-related options parsed from environment variables.
+ */
+export type EnvOptions = PgpmOptions & EnvGraphQLOptions;
+
 const parseEnvNumber = (val?: string): number | undefined => {
   const num = Number(val);
   return !isNaN(num) ? num : undefined;
@@ -10,7 +43,7 @@ const parseEnvBoolean = (val?: string): boolean | undefined => {
   return ['true', '1', 'yes'].includes(val.toLowerCase());
 };
 
-export const getEnvVars = (): PgpmOptions => {
+export const getEnvVars = (): EnvOptions => {
   const {
     PGROOTDATABASE,
     PGTEMPLATE,

packages/env/src/index.ts

@@ -4,3 +4,4 @@ export { getEnvVars, getNodeEnv } from './env';
 export { walkUp } from './utils';
 
 export type { PgpmOptions, PgTestConnectionOptions, DeploymentOptions } from '@pgpmjs/types';
+export type { EnvOptions, EnvGraphQLOptions } from './env';

packages/env/src/merge.ts

@@ -1,9 +1,9 @@
 import deepmerge from 'deepmerge';
 import { pgpmDefaults, PgpmOptions, PgTestConnectionOptions, DeploymentOptions } from '@pgpmjs/types';
 import { loadConfigSync } from './config';
-import { getEnvVars } from './env';
+import { getEnvVars, EnvOptions } from './env';
 
-export const getEnvOptions = (overrides: PgpmOptions = {}, cwd: string = process.cwd()): PgpmOptions => {
+export const getEnvOptions = (overrides: EnvOptions = {}, cwd: string = process.cwd()): EnvOptions => {
   const defaults = pgpmDefaults;
   const configOptions = loadConfigSync(cwd);
   const envOptions = getEnvVars();

packages/explorer/package.json

@@ -35,6 +35,7 @@
   },
   "dependencies": {
     "@launchql/s3-streamer": "workspace:^",
+    "@launchql/types": "workspace:^",
     "@launchql/upload-names": "workspace:^",
     "@launchql/url-domains": "workspace:^",
     "@pgpmjs/env": "workspace:^",

packages/explorer/src/settings.ts

@@ -1,9 +1,9 @@
-import { PgpmOptions } from '@pgpmjs/types';
+import { LaunchQLOptions } from '@launchql/types';
 import { getEnvOptions } from '@pgpmjs/env';
 import { getGraphileSettings as getSettings } from 'graphile-settings';
 import { PostGraphileOptions } from 'postgraphile';
 
-export const getGraphileSettings = (rawOpts: PgpmOptions): PostGraphileOptions => {
+export const getGraphileSettings = (rawOpts: LaunchQLOptions): PostGraphileOptions => {
   const opts = getEnvOptions(rawOpts);
 
   const baseOptions = getSettings(opts);

packages/launchql-test/package.json

@@ -34,6 +34,7 @@
     "makage": "^0.1.8"
   },
   "dependencies": {
+    "@launchql/types": "workspace:^",
     "@pgpmjs/types": "workspace:^",
     "graphile-settings": "workspace:^",
     "graphile-test": "workspace:^",