feat: create @launchql/env package for complete GraphQL separation

- Create new @launchql/env package that handles GraphQL env parsing and defaults
- Strip GraphQL env vars from @pgpmjs/env (GRAPHILE_*, FEATURES_*, API_*)
- Update @pgpmjs/env to return only core PgpmOptions (no GraphQL fields)
- Update all LaunchQL consumers to use @launchql/env:
  - packages/server, explorer, cli
  - graphile/graphile-settings, graphile-test, graphile-upload-plugin
  - packages/launchql-test
- @launchql/env exports getEnvOptions() that merges core + GraphQL options
- Re-exports getNodeEnv and other utilities from @pgpmjs/env for convenience

This completes the architectural separation where:
- @pgpmjs/types + @pgpmjs/env = core PGPM (zero GraphQL deps)
- @launchql/types + @launchql/env = LaunchQL (GraphQL features)

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

Author: pyramation

graphile/graphile-settings/package.json

@@ -28,10 +28,10 @@
     "test": "jest",
     "test:watch": "jest --watch"
   },
-  "dependencies": {
-    "@graphile-contrib/pg-many-to-many": "^1.0.2",
-    "@launchql/types": "workspace:^",
-    "@pgpmjs/env": "workspace:^",
+    "dependencies": {
+      "@graphile-contrib/pg-many-to-many": "^1.0.2",
+      "@launchql/env": "workspace:^",
+      "@launchql/types": "workspace:^",
     "@pgpmjs/types": "workspace:^",
     "cors": "^2.8.5",
     "express": "^5.1.0",

graphile/graphile-settings/src/index.ts

@@ -1,5 +1,5 @@
 import PgManyToMany from '@graphile-contrib/pg-many-to-many';
-import { getEnvOptions } from '@pgpmjs/env';
+import { getEnvOptions } from '@launchql/env';
 import { LaunchQLOptions } from '@launchql/types';
 import PgPostgis from 'graphile-postgis';
 import FulltextFilterPlugin from 'graphile-plugin-fulltext-filter';

graphile/graphile-test/package.json

@@ -33,9 +33,10 @@
     "graphql-tag": "2.12.6",
     "makage": "^0.1.8"
   },
-  "dependencies": {
-    "@launchql/types": "workspace:^",
-    "@pgpmjs/types": "workspace:^",
+    "dependencies": {
+      "@launchql/env": "workspace:^",
+      "@launchql/types": "workspace:^",
+      "@pgpmjs/types": "workspace:^",
     "graphql": "15.10.1",
     "mock-req": "^0.2.0",
     "pg": "^8.16.3",

graphile/graphile-upload-plugin/__tests__/plugin.test.ts

@@ -3,7 +3,7 @@ import { join } from 'path';
 import { createReadStream, writeFileSync, unlinkSync } from 'fs';
 import { tmpdir } from 'os';
 import { S3Client } from '@aws-sdk/client-s3';
-import { getEnvOptions } from '@pgpmjs/env';
+import { getEnvOptions } from '@launchql/env';
 import { createS3Bucket } from '@launchql/s3-utils';
 import { getConnections, snapshot, seed } from 'graphile-test';
 import type { PgTestClient } from 'pgsql-test/test-client';

graphile/graphile-upload-plugin/package.json

@@ -37,10 +37,10 @@
   "bugs": {
     "url": "https://github.com/constructive-io/constructive/issues"
   },
-  "devDependencies": {
-    "@aws-sdk/client-s3": "^3.948.0",
-    "@launchql/s3-utils": "workspace:^",
-    "@pgpmjs/env": "workspace:^",
+    "devDependencies": {
+      "@aws-sdk/client-s3": "^3.948.0",
+      "@launchql/env": "workspace:^",
+      "@launchql/s3-utils": "workspace:^",
     "@types/pg": "^8.16.0",
     "graphile-test": "workspace:^",
     "graphql-tag": "^2.12.6",

packages/cli/package.json

@@ -45,12 +45,12 @@
     "pg": "^8.16.3",
     "ts-node": "^10.9.2"
   },
-  "dependencies": {
-    "@launchql/codegen": "workspace:^",
-    "@launchql/explorer": "workspace:^",
-    "@launchql/server": "workspace:^",
-    "@pgpmjs/core": "workspace:^",
-    "@pgpmjs/env": "workspace:^",
+    "dependencies": {
+      "@launchql/codegen": "workspace:^",
+      "@launchql/env": "workspace:^",
+      "@launchql/explorer": "workspace:^",
+      "@launchql/server": "workspace:^",
+      "@pgpmjs/core": "workspace:^",
     "@pgpmjs/logger": "workspace:^",
     "@pgpmjs/server-utils": "workspace:^",
     "@pgpmjs/types": "workspace:^",

packages/cli/src/commands/explorer.ts

@@ -1,4 +1,4 @@
-import { getEnvOptions } from '@pgpmjs/env';
+import { getEnvOptions } from '@launchql/env';
 import { LaunchQLExplorer as explorer } from '@launchql/explorer';
 import { Logger } from '@pgpmjs/logger';
 import { PgpmOptions } from '@pgpmjs/types';

packages/cli/src/commands/server.ts

@@ -1,4 +1,4 @@
-import { getEnvOptions } from '@pgpmjs/env';
+import { getEnvOptions } from '@launchql/env';
 import { Logger } from '@pgpmjs/logger';
 import { LaunchQLServer as server } from '@launchql/server';
 import { PgpmOptions } from '@pgpmjs/types';

packages/env/src/env.ts

@@ -1,38 +1,5 @@
 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;
@@ -43,7 +10,11 @@ const parseEnvBoolean = (val?: string): boolean | undefined => {
   return ['true', '1', 'yes'].includes(val.toLowerCase());
 };
 
-export const getEnvVars = (): EnvOptions => {
+/**
+ * Parse core PGPM environment variables.
+ * GraphQL-related env vars (GRAPHILE_*, FEATURES_*, API_*) are handled by @launchql/env.
+ */
+export const getEnvVars = (): PgpmOptions => {
   const {
     PGROOTDATABASE,
     PGTEMPLATE,
@@ -66,19 +37,6 @@ export const getEnvVars = (): EnvOptions => {
     PGPASSWORD,
     PGDATABASE,
 
-    GRAPHILE_SCHEMA,
-
-    FEATURES_SIMPLE_INFLECTION,
-    FEATURES_OPPOSITE_BASE_NAMES,
-    FEATURES_POSTGIS,
-    API_ENABLE_META,
-    API_IS_PUBLIC,
-    API_EXPOSED_SCHEMAS,
-    API_META_SCHEMAS,
-    API_ANON_ROLE,
-    API_ROLE_NAME,
-    API_DEFAULT_DATABASE_ID,
-
     BUCKET_NAME,
     AWS_REGION,
     AWS_ACCESS_KEY,
@@ -123,27 +81,6 @@ export const getEnvVars = (): EnvOptions => {
       ...(PGPASSWORD && { password: PGPASSWORD }),
       ...(PGDATABASE && { database: PGDATABASE }),
     },
-    graphile: {
-      ...(GRAPHILE_SCHEMA && { 
-        schema: GRAPHILE_SCHEMA.includes(',') 
-          ? GRAPHILE_SCHEMA.split(',').map(s => s.trim())
-          : GRAPHILE_SCHEMA 
-      }),
-    },
-    features: {
-      ...(FEATURES_SIMPLE_INFLECTION && { simpleInflection: parseEnvBoolean(FEATURES_SIMPLE_INFLECTION) }),
-      ...(FEATURES_OPPOSITE_BASE_NAMES && { oppositeBaseNames: parseEnvBoolean(FEATURES_OPPOSITE_BASE_NAMES) }),
-      ...(FEATURES_POSTGIS && { postgis: parseEnvBoolean(FEATURES_POSTGIS) }),
-    },
-    api: {
-      ...(API_ENABLE_META && { enableMetaApi: parseEnvBoolean(API_ENABLE_META) }),
-      ...(API_IS_PUBLIC && { isPublic: parseEnvBoolean(API_IS_PUBLIC) }),
-      ...(API_EXPOSED_SCHEMAS && { exposedSchemas: API_EXPOSED_SCHEMAS.split(',').map(s => s.trim()) }),
-      ...(API_META_SCHEMAS && { metaSchemas: API_META_SCHEMAS.split(',').map(s => s.trim()) }),
-      ...(API_ANON_ROLE && { anonRole: API_ANON_ROLE }),
-      ...(API_ROLE_NAME && { roleName: API_ROLE_NAME }),
-      ...(API_DEFAULT_DATABASE_ID && { defaultDatabaseId: API_DEFAULT_DATABASE_ID }),
-    },
     cdn: {
       ...(BUCKET_NAME && { bucketName: BUCKET_NAME }),
       ...(AWS_REGION && { awsRegion: AWS_REGION }),

packages/env/src/index.ts

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