@constructive-io/graphql-env 2.8.11 → 2.8.13

package/README.md

@@ -102,9 +102,14 @@ Common issues and solutions for pgpm, PostgreSQL, and testing.
 
 ## Related Constructive Tooling
 
+### 📦 Package Management
+
+* [pgpm](https://github.com/constructive-io/constructive/tree/main/pgpm/pgpm): **🖥️ PostgreSQL Package Manager** for modular Postgres development. Works with database workspaces, scaffolding, migrations, seeding, and installing database packages.
+
 ### 🧪 Testing
 
 * [pgsql-test](https://github.com/constructive-io/constructive/tree/main/postgres/pgsql-test): **📊 Isolated testing environments** with per-test transaction rollbacks—ideal for integration tests, complex migrations, and RLS simulation.
+* [pgsql-seed](https://github.com/constructive-io/constructive/tree/main/postgres/pgsql-seed): **🌱 PostgreSQL seeding utilities** for CSV, JSON, SQL data loading, and pgpm deployment.
 * [supabase-test](https://github.com/constructive-io/constructive/tree/main/postgres/supabase-test): **🧪 Supabase-native test harness** preconfigured for the local Supabase stack—per-test rollbacks, JWT/role context helpers, and CI/GitHub Actions ready.
 * [graphile-test](https://github.com/constructive-io/constructive/tree/main/graphile/graphile-test): **🔐 Authentication mocking** for Graphile-focused test helpers and emulating row-level security contexts.
 * [pg-query-context](https://github.com/constructive-io/constructive/tree/main/postgres/pg-query-context): **🔒 Session context injection** to add session-local context (e.g., `SET LOCAL`) into queries—ideal for setting `role`, `jwt.claims`, and other session settings.
@@ -118,28 +123,6 @@ Common issues and solutions for pgpm, PostgreSQL, and testing.
 * [@pgsql/types](https://www.npmjs.com/package/@pgsql/types): **📝 Type definitions** for PostgreSQL AST nodes in TypeScript.
 * [@pgsql/utils](https://www.npmjs.com/package/@pgsql/utils): **🛠️ AST utilities** for constructing and transforming PostgreSQL syntax trees.
 
-### 🚀 API & Dev Tools
-
-* [@constructive-io/graphql-server](https://github.com/constructive-io/constructive/tree/main/graphql/server): **⚡ Express-based API server** powered by PostGraphile to expose a secure, scalable GraphQL API over your Postgres database.
-* [@constructive-io/graphql-explorer](https://github.com/constructive-io/constructive/tree/main/graphql/explorer): **🔎 Visual API explorer** with GraphiQL for browsing across all databases and schemas—useful for debugging, documentation, and API prototyping.
-
-### 🔁 Streaming & Uploads
-
-* [etag-hash](https://github.com/constructive-io/constructive/tree/main/streaming/etag-hash): **🏷️ S3-compatible ETags** created by streaming and hashing file uploads in chunks.
-* [etag-stream](https://github.com/constructive-io/constructive/tree/main/streaming/etag-stream): **🔄 ETag computation** via Node stream transformer during upload or transfer.
-* [uuid-hash](https://github.com/constructive-io/constructive/tree/main/streaming/uuid-hash): **🆔 Deterministic UUIDs** generated from hashed content, great for deduplication and asset referencing.
-* [uuid-stream](https://github.com/constructive-io/constructive/tree/main/streaming/uuid-stream): **🌊 Streaming UUID generation** based on piped file content—ideal for upload pipelines.
-* [@constructive-io/s3-streamer](https://github.com/constructive-io/constructive/tree/main/streaming/s3-streamer): **📤 Direct S3 streaming** for large files with support for metadata injection and content validation.
-* [@constructive-io/upload-names](https://github.com/constructive-io/constructive/tree/main/streaming/upload-names): **📂 Collision-resistant filenames** utility for structured and unique file names for uploads.
-
-### 🧰 CLI & Codegen
-
-* [pgpm](https://github.com/constructive-io/constructive/tree/main/pgpm/pgpm): **🖥️ PostgreSQL Package Manager** for modular Postgres development. Works with database workspaces, scaffolding, migrations, seeding, and installing database packages.
-* [@constructive-io/cli](https://github.com/constructive-io/constructive/tree/main/packages/cli): **🖥️ Command-line toolkit** for managing Constructive projects—supports database scaffolding, migrations, seeding, code generation, and automation.
-* [@constructive-io/graphql-codegen](https://github.com/constructive-io/constructive/tree/main/graphql/codegen): **✨ GraphQL code generation** (types, operations, SDK) from schema/endpoint introspection.
-* [@constructive-io/query-builder](https://github.com/constructive-io/constructive/tree/main/packages/query-builder): **🏗️ SQL constructor** providing a robust TypeScript-based query builder for dynamic generation of `SELECT`, `INSERT`, `UPDATE`, `DELETE`, and stored procedure calls—supports advanced SQL features like `JOIN`, `GROUP BY`, and schema-qualified queries.
-* [@constructive-io/graphql-query](https://github.com/constructive-io/constructive/tree/main/graphql/query): **🧩 Fluent GraphQL builder** for PostGraphile schemas. ⚡ Schema-aware via introspection, 🧩 composable and ergonomic for building deeply nested queries.
-
 ## Credits
 
 **🛠 Built by the [Constructive](https://constructive.io) team — creators of modular Postgres tooling for secure, composable backends. If you like our work, contribute on [GitHub](https://github.com/constructive-io).**

package/env.d.ts

@@ -1,2 +1,5 @@
 import { ConstructiveOptions } from '@constructive-io/graphql-types';
-export declare const getGraphQLEnvVars: () => Partial<ConstructiveOptions>;
+/**
+ * @param env - Environment object to read from (defaults to process.env for backwards compatibility)
+ */
+export declare const getGraphQLEnvVars: (env?: NodeJS.ProcessEnv) => Partial<ConstructiveOptions>;

package/env.js

@@ -10,8 +10,11 @@ const parseEnvBoolean = (val) => {
         return undefined;
     return ['true', '1', 'yes'].includes(val.toLowerCase());
 };
-const getGraphQLEnvVars = () => {
-    const { 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, } = process.env;
+/**
+ * @param env - Environment object to read from (defaults to process.env for backwards compatibility)
+ */
+const getGraphQLEnvVars = (env = process.env) => {
+    const { 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, } = env;
     return {
         graphile: {
             ...(GRAPHILE_SCHEMA && {

package/esm/env.d.ts

@@ -1,2 +1,5 @@
 import { ConstructiveOptions } from '@constructive-io/graphql-types';
-export declare const getGraphQLEnvVars: () => Partial<ConstructiveOptions>;
+/**
+ * @param env - Environment object to read from (defaults to process.env for backwards compatibility)
+ */
+export declare const getGraphQLEnvVars: (env?: NodeJS.ProcessEnv) => Partial<ConstructiveOptions>;

package/esm/env.js

@@ -7,8 +7,11 @@ const parseEnvBoolean = (val) => {
         return undefined;
     return ['true', '1', 'yes'].includes(val.toLowerCase());
 };
-export const getGraphQLEnvVars = () => {
-    const { 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, } = process.env;
+/**
+ * @param env - Environment object to read from (defaults to process.env for backwards compatibility)
+ */
+export const getGraphQLEnvVars = (env = process.env) => {
+    const { 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, } = env;
     return {
         graphile: {
             ...(GRAPHILE_SCHEMA && {

package/esm/merge.d.ts

@@ -9,9 +9,13 @@ import { ConstructiveOptions } from '@constructive-io/graphql-types';
  *
  * This is the main entry point for Constructive packages that need
  * both core PGPM options and GraphQL/Graphile options.
+ *
+ * @param overrides - Runtime overrides to apply last
+ * @param cwd - Working directory for config file resolution
+ * @param env - Environment object to read from (defaults to process.env for backwards compatibility)
  */
-export declare const getEnvOptions: (overrides?: Partial<ConstructiveOptions>, cwd?: string) => ConstructiveOptions;
+export declare const getEnvOptions: (overrides?: Partial<ConstructiveOptions>, cwd?: string, env?: NodeJS.ProcessEnv) => ConstructiveOptions;
 /**
  * Alias - same as getEnvOptions
  */
-export declare const getConstructiveEnvOptions: (overrides?: Partial<ConstructiveOptions>, cwd?: string) => ConstructiveOptions;
+export declare const getConstructiveEnvOptions: (overrides?: Partial<ConstructiveOptions>, cwd?: string, env?: NodeJS.ProcessEnv) => ConstructiveOptions;

package/esm/merge.js

@@ -12,12 +12,16 @@ import { getGraphQLEnvVars } from './env';
  *
  * This is the main entry point for Constructive packages that need
  * both core PGPM options and GraphQL/Graphile options.
+ *
+ * @param overrides - Runtime overrides to apply last
+ * @param cwd - Working directory for config file resolution
+ * @param env - Environment object to read from (defaults to process.env for backwards compatibility)
  */
-export const getEnvOptions = (overrides = {}, cwd = process.cwd()) => {
+export const getEnvOptions = (overrides = {}, cwd = process.cwd(), env = process.env) => {
     // Get core PGPM options (includes pgpmDefaults + config + core env vars)
-    const coreOptions = getPgpmEnvOptions({}, cwd);
+    const coreOptions = getPgpmEnvOptions({}, cwd, env);
     // Get GraphQL-specific env vars
-    const graphqlEnvOptions = getGraphQLEnvVars();
+    const graphqlEnvOptions = getGraphQLEnvVars(env);
     // Load config again to get any GraphQL-specific config
     // Config files can contain Constructive options (graphile, features, api)
     // even though loadConfigSync returns PgpmOptions type

package/merge.d.ts

@@ -9,9 +9,13 @@ import { ConstructiveOptions } from '@constructive-io/graphql-types';
  *
  * This is the main entry point for Constructive packages that need
  * both core PGPM options and GraphQL/Graphile options.
+ *
+ * @param overrides - Runtime overrides to apply last
+ * @param cwd - Working directory for config file resolution
+ * @param env - Environment object to read from (defaults to process.env for backwards compatibility)
  */
-export declare const getEnvOptions: (overrides?: Partial<ConstructiveOptions>, cwd?: string) => ConstructiveOptions;
+export declare const getEnvOptions: (overrides?: Partial<ConstructiveOptions>, cwd?: string, env?: NodeJS.ProcessEnv) => ConstructiveOptions;
 /**
  * Alias - same as getEnvOptions
  */
-export declare const getConstructiveEnvOptions: (overrides?: Partial<ConstructiveOptions>, cwd?: string) => ConstructiveOptions;
+export declare const getConstructiveEnvOptions: (overrides?: Partial<ConstructiveOptions>, cwd?: string, env?: NodeJS.ProcessEnv) => ConstructiveOptions;

package/merge.js

@@ -18,12 +18,16 @@ const env_2 = require("./env");
  *
  * This is the main entry point for Constructive packages that need
  * both core PGPM options and GraphQL/Graphile options.
+ *
+ * @param overrides - Runtime overrides to apply last
+ * @param cwd - Working directory for config file resolution
+ * @param env - Environment object to read from (defaults to process.env for backwards compatibility)
  */
-const getEnvOptions = (overrides = {}, cwd = process.cwd()) => {
+const getEnvOptions = (overrides = {}, cwd = process.cwd(), env = process.env) => {
     // Get core PGPM options (includes pgpmDefaults + config + core env vars)
-    const coreOptions = (0, env_1.getEnvOptions)({}, cwd);
+    const coreOptions = (0, env_1.getEnvOptions)({}, cwd, env);
     // Get GraphQL-specific env vars
-    const graphqlEnvOptions = (0, env_2.getGraphQLEnvVars)();
+    const graphqlEnvOptions = (0, env_2.getGraphQLEnvVars)(env);
     // Load config again to get any GraphQL-specific config
     // Config files can contain Constructive options (graphile, features, api)
     // even though loadConfigSync returns PgpmOptions type

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@constructive-io/graphql-env",
-  "version": "2.8.11",
+  "version": "2.8.13",
   "author": "Constructive <developers@constructive.io>",
   "description": "Constructive environment configuration with GraphQL/Graphile support",
   "main": "index.js",
@@ -29,8 +29,8 @@
     "test:watch": "jest --watch"
   },
   "dependencies": {
-    "@constructive-io/graphql-types": "^2.12.8",
-    "@pgpmjs/env": "^2.8.11",
+    "@constructive-io/graphql-types": "^2.12.9",
+    "@pgpmjs/env": "^2.9.1",
     "deepmerge": "^4.3.1"
   },
   "keywords": [
@@ -44,5 +44,5 @@
   "devDependencies": {
     "makage": "^0.1.9"
   },
-  "gitHead": "c2e68f9808a87e3231d9b9af5e706bef5dbd2af8"
+  "gitHead": "14ed679aeb6172e013c817b8a458e5bee68ab492"
 }