@pgpmjs/env 2.8.11 → 2.9.1

package/README.md

@@ -44,9 +44,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.
@@ -60,28 +65,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

@@ -3,8 +3,10 @@ export declare const parseEnvBoolean: (val?: string) => boolean | undefined;
 /**
  * Parse core PGPM environment variables.
  * GraphQL-related env vars (GRAPHILE_*, FEATURES_*, API_*) are handled by @constructive-io/graphql-env.
+ *
+ * @param env - Environment object to read from (defaults to process.env for backwards compatibility)
  */
-export declare const getEnvVars: () => PgpmOptions;
+export declare const getEnvVars: (env?: NodeJS.ProcessEnv) => PgpmOptions;
 type NodeEnv = 'development' | 'production' | 'test';
 export declare const getNodeEnv: () => NodeEnv;
 export {};

package/env.js

@@ -22,13 +22,15 @@ const parseEnvStringArray = (val) => {
 /**
  * Parse core PGPM environment variables.
  * GraphQL-related env vars (GRAPHILE_*, FEATURES_*, API_*) are handled by @constructive-io/graphql-env.
+ *
+ * @param env - Environment object to read from (defaults to process.env for backwards compatibility)
  */
-const getEnvVars = () => {
+const getEnvVars = (env = process.env) => {
     const { PGROOTDATABASE, PGTEMPLATE, DB_PREFIX, DB_EXTENSIONS, DB_CWD, DB_CONNECTION_USER, DB_CONNECTION_PASSWORD, DB_CONNECTION_ROLE, 
     // New connections.app and connections.admin env vars
-    DB_CONNECTIONS_APP_USER, DB_CONNECTIONS_APP_PASSWORD, DB_CONNECTIONS_ADMIN_USER, DB_CONNECTIONS_ADMIN_PASSWORD, PORT, SERVER_HOST, SERVER_TRUST_PROXY, SERVER_ORIGIN, SERVER_STRICT_AUTH, PGHOST, PGPORT, PGUSER, PGPASSWORD, PGDATABASE, BUCKET_NAME, AWS_REGION, AWS_ACCESS_KEY, AWS_ACCESS_KEY_ID, AWS_SECRET_KEY, AWS_SECRET_ACCESS_KEY, MINIO_ENDPOINT, DEPLOYMENT_USE_TX, DEPLOYMENT_FAST, DEPLOYMENT_USE_PLAN, DEPLOYMENT_CACHE, DEPLOYMENT_TO_CHANGE, MIGRATIONS_CODEGEN_USE_TX, 
+    DB_CONNECTIONS_APP_USER, DB_CONNECTIONS_APP_PASSWORD, DB_CONNECTIONS_ADMIN_USER, DB_CONNECTIONS_ADMIN_PASSWORD, PORT, SERVER_HOST, SERVER_TRUST_PROXY, SERVER_ORIGIN, SERVER_STRICT_AUTH, PGHOST, PGPORT, PGUSER, PGPASSWORD, PGDATABASE, BUCKET_PROVIDER, BUCKET_NAME, AWS_REGION, AWS_ACCESS_KEY, AWS_ACCESS_KEY_ID, AWS_SECRET_KEY, AWS_SECRET_ACCESS_KEY, MINIO_ENDPOINT, DEPLOYMENT_USE_TX, DEPLOYMENT_FAST, DEPLOYMENT_USE_PLAN, DEPLOYMENT_CACHE, DEPLOYMENT_TO_CHANGE, MIGRATIONS_CODEGEN_USE_TX, 
     // Jobs-related env vars
-    JOBS_SCHEMA, JOBS_SUPPORT_ANY, JOBS_SUPPORTED, INTERNAL_GATEWAY_URL, INTERNAL_JOBS_CALLBACK_URL, INTERNAL_JOBS_CALLBACK_PORT } = process.env;
+    JOBS_SCHEMA, JOBS_SUPPORT_ANY, JOBS_SUPPORTED, INTERNAL_GATEWAY_URL, INTERNAL_JOBS_CALLBACK_URL, INTERNAL_JOBS_CALLBACK_PORT } = env;
     return {
         db: {
             ...(PGROOTDATABASE && { rootDb: PGROOTDATABASE }),
@@ -75,6 +77,7 @@ const getEnvVars = () => {
             ...(PGDATABASE && { database: PGDATABASE }),
         },
         cdn: {
+            ...(BUCKET_PROVIDER && { provider: BUCKET_PROVIDER }),
             ...(BUCKET_NAME && { bucketName: BUCKET_NAME }),
             ...(AWS_REGION && { awsRegion: AWS_REGION }),
             ...((AWS_ACCESS_KEY || AWS_ACCESS_KEY_ID) && { awsAccessKey: AWS_ACCESS_KEY || AWS_ACCESS_KEY_ID }),

package/esm/env.js

@@ -18,13 +18,15 @@ const parseEnvStringArray = (val) => {
 /**
  * Parse core PGPM environment variables.
  * GraphQL-related env vars (GRAPHILE_*, FEATURES_*, API_*) are handled by @constructive-io/graphql-env.
+ *
+ * @param env - Environment object to read from (defaults to process.env for backwards compatibility)
  */
-export const getEnvVars = () => {
+export const getEnvVars = (env = process.env) => {
     const { PGROOTDATABASE, PGTEMPLATE, DB_PREFIX, DB_EXTENSIONS, DB_CWD, DB_CONNECTION_USER, DB_CONNECTION_PASSWORD, DB_CONNECTION_ROLE, 
     // New connections.app and connections.admin env vars
-    DB_CONNECTIONS_APP_USER, DB_CONNECTIONS_APP_PASSWORD, DB_CONNECTIONS_ADMIN_USER, DB_CONNECTIONS_ADMIN_PASSWORD, PORT, SERVER_HOST, SERVER_TRUST_PROXY, SERVER_ORIGIN, SERVER_STRICT_AUTH, PGHOST, PGPORT, PGUSER, PGPASSWORD, PGDATABASE, BUCKET_NAME, AWS_REGION, AWS_ACCESS_KEY, AWS_ACCESS_KEY_ID, AWS_SECRET_KEY, AWS_SECRET_ACCESS_KEY, MINIO_ENDPOINT, DEPLOYMENT_USE_TX, DEPLOYMENT_FAST, DEPLOYMENT_USE_PLAN, DEPLOYMENT_CACHE, DEPLOYMENT_TO_CHANGE, MIGRATIONS_CODEGEN_USE_TX, 
+    DB_CONNECTIONS_APP_USER, DB_CONNECTIONS_APP_PASSWORD, DB_CONNECTIONS_ADMIN_USER, DB_CONNECTIONS_ADMIN_PASSWORD, PORT, SERVER_HOST, SERVER_TRUST_PROXY, SERVER_ORIGIN, SERVER_STRICT_AUTH, PGHOST, PGPORT, PGUSER, PGPASSWORD, PGDATABASE, BUCKET_PROVIDER, BUCKET_NAME, AWS_REGION, AWS_ACCESS_KEY, AWS_ACCESS_KEY_ID, AWS_SECRET_KEY, AWS_SECRET_ACCESS_KEY, MINIO_ENDPOINT, DEPLOYMENT_USE_TX, DEPLOYMENT_FAST, DEPLOYMENT_USE_PLAN, DEPLOYMENT_CACHE, DEPLOYMENT_TO_CHANGE, MIGRATIONS_CODEGEN_USE_TX, 
     // Jobs-related env vars
-    JOBS_SCHEMA, JOBS_SUPPORT_ANY, JOBS_SUPPORTED, INTERNAL_GATEWAY_URL, INTERNAL_JOBS_CALLBACK_URL, INTERNAL_JOBS_CALLBACK_PORT } = process.env;
+    JOBS_SCHEMA, JOBS_SUPPORT_ANY, JOBS_SUPPORTED, INTERNAL_GATEWAY_URL, INTERNAL_JOBS_CALLBACK_URL, INTERNAL_JOBS_CALLBACK_PORT } = env;
     return {
         db: {
             ...(PGROOTDATABASE && { rootDb: PGROOTDATABASE }),
@@ -71,6 +73,7 @@ export const getEnvVars = () => {
             ...(PGDATABASE && { database: PGDATABASE }),
         },
         cdn: {
+            ...(BUCKET_PROVIDER && { provider: BUCKET_PROVIDER }),
             ...(BUCKET_NAME && { bucketName: BUCKET_NAME }),
             ...(AWS_REGION && { awsRegion: AWS_REGION }),
             ...((AWS_ACCESS_KEY || AWS_ACCESS_KEY_ID) && { awsAccessKey: AWS_ACCESS_KEY || AWS_ACCESS_KEY_ID }),

package/esm/merge.js

@@ -11,10 +11,14 @@ import { mergeArraysUnique } from './utils';
  * 4. Runtime overrides
  *
  * For Constructive applications that need GraphQL options, use @constructive-io/graphql-env instead.
+ *
+ * @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) => {
     const configOptions = loadConfigSync(cwd);
-    const envOptions = getEnvVars();
+    const envOptions = getEnvVars(env);
     return deepmerge.all([pgpmDefaults, configOptions, envOptions, overrides], {
         arrayMerge: mergeArraysUnique
     });

package/merge.d.ts

@@ -7,7 +7,11 @@ import { PgpmOptions, PgTestConnectionOptions, DeploymentOptions } from '@pgpmjs
  * 4. Runtime overrides
  *
  * For Constructive applications that need GraphQL options, use @constructive-io/graphql-env instead.
+ *
+ * @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?: PgpmOptions, cwd?: string) => PgpmOptions;
+export declare const getEnvOptions: (overrides?: PgpmOptions, cwd?: string, env?: NodeJS.ProcessEnv) => PgpmOptions;
 export declare const getConnEnvOptions: (overrides?: Partial<PgTestConnectionOptions>, cwd?: string) => PgTestConnectionOptions;
 export declare const getDeploymentEnvOptions: (overrides?: Partial<DeploymentOptions>, cwd?: string) => DeploymentOptions;

package/merge.js

@@ -17,10 +17,14 @@ const utils_1 = require("./utils");
  * 4. Runtime overrides
  *
  * For Constructive applications that need GraphQL options, use @constructive-io/graphql-env instead.
+ *
+ * @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) => {
     const configOptions = (0, config_1.loadConfigSync)(cwd);
-    const envOptions = (0, env_1.getEnvVars)();
+    const envOptions = (0, env_1.getEnvVars)(env);
     return deepmerge_1.default.all([types_1.pgpmDefaults, configOptions, envOptions, overrides], {
         arrayMerge: utils_1.mergeArraysUnique
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pgpmjs/env",
-  "version": "2.8.11",
+  "version": "2.9.1",
   "author": "Dan Lynch <Dan Lynch>",
   "description": "PGPM environment management",
   "main": "index.js",
@@ -29,7 +29,7 @@
     "test:watch": "jest --watch"
   },
   "dependencies": {
-    "@pgpmjs/types": "^2.12.8",
+    "@pgpmjs/types": "^2.13.0",
     "deepmerge": "^4.3.1"
   },
   "keywords": [
@@ -43,5 +43,5 @@
   "devDependencies": {
     "makage": "^0.1.9"
   },
-  "gitHead": "c2e68f9808a87e3231d9b9af5e706bef5dbd2af8"
+  "gitHead": "14ed679aeb6172e013c817b8a458e5bee68ab492"
 }