introspectron 2.13.16 → 2.13.18

package/LICENSE

@@ -1,7 +1,7 @@
 The MIT License (MIT)
 
 Copyright (c) 2025 Dan Lynch <pyramation@gmail.com>
-Copyright (c) 2025 Hyperweb <developers@hyperweb.io>
+Copyright (c) 2025 Constructive <developers@constructive.io>
 Copyright (c) 2020-present, Interweb, Inc.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy

package/README.md

@@ -1,14 +1,14 @@
 # introspectron
 
 <p align="center" width="100%">
-  <img height="250" src="https://raw.githubusercontent.com/launchql/launchql/refs/heads/main/assets/outline-logo.svg" />
+  <img height="250" src="https://raw.githubusercontent.com/constructive-io/constructive/refs/heads/main/assets/outline-logo.svg" />
 </p>
 
 <p align="center" width="100%">
-  <a href="https://github.com/launchql/launchql/actions/workflows/run-tests.yaml">
-    <img height="20" src="https://github.com/launchql/launchql/actions/workflows/run-tests.yaml/badge.svg" />
+  <a href="https://github.com/constructive-io/constructive/actions/workflows/run-tests.yaml">
+    <img height="20" src="https://github.com/constructive-io/constructive/actions/workflows/run-tests.yaml/badge.svg" />
   </a>
-   <a href="https://github.com/launchql/launchql/blob/main/LICENSE"><img height="20" src="https://img.shields.io/badge/license-MIT-blue.svg"/></a>
+   <a href="https://github.com/constructive-io/constructive/blob/main/LICENSE"><img height="20" src="https://img.shields.io/badge/license-MIT-blue.svg"/></a>
    <a href="https://www.npmjs.com/package/introspectron"><img height="20" src="https://img.shields.io/github/package-json/v/launchql/launchql?filename=packages%2Fintrospectron%2Fpackage.json"/></a>
 </p>
 
@@ -64,71 +64,71 @@ psql testdb -f ./seed.sql
 
 ## Education and Tutorials
 
- 1. 🚀 [Quickstart: Getting Up and Running](https://launchql.com/learn/quickstart)
+ 1. 🚀 [Quickstart: Getting Up and Running](https://constructive.io/learn/quickstart)
 Get started with modular databases in minutes. Install prerequisites and deploy your first module.
 
- 2. 📦 [Modular PostgreSQL Development with Database Packages](https://launchql.com/learn/modular-postgres)
+ 2. 📦 [Modular PostgreSQL Development with Database Packages](https://constructive.io/learn/modular-postgres)
 Learn to organize PostgreSQL projects with pgpm workspaces and reusable database modules.
 
- 3. ✏️ [Authoring Database Changes](https://launchql.com/learn/authoring-database-changes)
+ 3. ✏️ [Authoring Database Changes](https://constructive.io/learn/authoring-database-changes)
 Master the workflow for adding, organizing, and managing database changes with pgpm.
 
- 4. 🧪 [End-to-End PostgreSQL Testing with TypeScript](https://launchql.com/learn/e2e-postgres-testing)
+ 4. 🧪 [End-to-End PostgreSQL Testing with TypeScript](https://constructive.io/learn/e2e-postgres-testing)
 Master end-to-end PostgreSQL testing with ephemeral databases, RLS testing, and CI/CD automation.
 
- 5. ⚡ [Supabase Testing](https://launchql.com/learn/supabase)
+ 5. ⚡ [Supabase Testing](https://constructive.io/learn/supabase)
 Use TypeScript-first tools to test Supabase projects with realistic RLS, policies, and auth contexts.
 
- 6. 💧 [Drizzle ORM Testing](https://launchql.com/learn/drizzle-testing)
+ 6. 💧 [Drizzle ORM Testing](https://constructive.io/learn/drizzle-testing)
 Run full-stack tests with Drizzle ORM, including database setup, teardown, and RLS enforcement.
 
- 7. 🔧 [Troubleshooting](https://launchql.com/learn/troubleshooting)
+ 7. 🔧 [Troubleshooting](https://constructive.io/learn/troubleshooting)
 Common issues and solutions for pgpm, PostgreSQL, and testing.
 
-## Related LaunchQL Tooling
+## Related Constructive Tooling
 
 ### 🧪 Testing
 
-* [launchql/pgsql-test](https://github.com/launchql/launchql/tree/main/packages/pgsql-test): **📊 Isolated testing environments** with per-test transaction rollbacks—ideal for integration tests, complex migrations, and RLS simulation.
-* [launchql/supabase-test](https://github.com/launchql/launchql/tree/main/packages/supabase-test): **🧪 Supabase-native test harness** preconfigured for the local Supabase stack—per-test rollbacks, JWT/role context helpers, and CI/GitHub Actions ready.
-* [launchql/graphile-test](https://github.com/launchql/launchql/tree/main/packages/graphile-test): **🔐 Authentication mocking** for Graphile-focused test helpers and emulating row-level security contexts.
-* [launchql/pg-query-context](https://github.com/launchql/launchql/tree/main/packages/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.
+* [pgsql-test](https://github.com/constructive-io/constructive/tree/main/packages/pgsql-test): **📊 Isolated testing environments** with per-test transaction rollbacks—ideal for integration tests, complex migrations, and RLS simulation.
+* [supabase-test](https://github.com/constructive-io/constructive/tree/main/packages/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/packages/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/packages/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.
 
 ### 🧠 Parsing & AST
 
-* [launchql/pgsql-parser](https://github.com/launchql/pgsql-parser): **🔄 SQL conversion engine** that interprets and converts PostgreSQL syntax.
-* [launchql/libpg-query-node](https://github.com/launchql/libpg-query-node): **🌉 Node.js bindings** for `libpg_query`, converting SQL into parse trees.
-* [launchql/pg-proto-parser](https://github.com/launchql/pg-proto-parser): **📦 Protobuf parser** for parsing PostgreSQL Protocol Buffers definitions to generate TypeScript interfaces, utility functions, and JSON mappings for enums.
-* [@pgsql/enums](https://github.com/launchql/pgsql-parser/tree/main/packages/enums): **🏷️ TypeScript enums** for PostgreSQL AST for safe and ergonomic parsing logic.
-* [@pgsql/types](https://github.com/launchql/pgsql-parser/tree/main/packages/types): **📝 Type definitions** for PostgreSQL AST nodes in TypeScript.
-* [@pgsql/utils](https://github.com/launchql/pgsql-parser/tree/main/packages/utils): **🛠️ AST utilities** for constructing and transforming PostgreSQL syntax trees.
-* [launchql/pg-ast](https://github.com/launchql/launchql/tree/main/packages/pg-ast): **🔍 Low-level AST tools** and transformations for Postgres query structures.
+* [pgsql-parser](https://www.npmjs.com/package/pgsql-parser): **🔄 SQL conversion engine** that interprets and converts PostgreSQL syntax.
+* [libpg-query-node](https://www.npmjs.com/package/libpg-query): **🌉 Node.js bindings** for `libpg_query`, converting SQL into parse trees.
+* [pg-proto-parser](https://www.npmjs.com/package/pg-proto-parser): **📦 Protobuf parser** for parsing PostgreSQL Protocol Buffers definitions to generate TypeScript interfaces, utility functions, and JSON mappings for enums.
+* [@pgsql/enums](https://www.npmjs.com/package/@pgsql/enums): **🏷️ TypeScript enums** for PostgreSQL AST for safe and ergonomic parsing logic.
+* [@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.
+* [pg-ast](https://www.npmjs.com/package/pg-ast): **🔍 Low-level AST tools** and transformations for Postgres query structures.
 
 ### 🚀 API & Dev Tools
 
-* [launchql/server](https://github.com/launchql/launchql/tree/main/packages/server): **⚡ Express-based API server** powered by PostGraphile to expose a secure, scalable GraphQL API over your Postgres database.
-* [launchql/explorer](https://github.com/launchql/launchql/tree/main/packages/explorer): **🔎 Visual API explorer** with GraphiQL for browsing across all databases and schemas—useful for debugging, documentation, and API prototyping.
+* [launchql/server](https://github.com/constructive-io/constructive/tree/main/packages/server): **⚡ Express-based API server** powered by PostGraphile to expose a secure, scalable GraphQL API over your Postgres database.
+* [launchql/explorer](https://github.com/constructive-io/constructive/tree/main/packages/explorer): **🔎 Visual API explorer** with GraphiQL for browsing across all databases and schemas—useful for debugging, documentation, and API prototyping.
 
 ### 🔁 Streaming & Uploads
 
-* [launchql/s3-streamer](https://github.com/launchql/launchql/tree/main/packages/s3-streamer): **📤 Direct S3 streaming** for large files with support for metadata injection and content validation.
-* [launchql/etag-hash](https://github.com/launchql/launchql/tree/main/packages/etag-hash): **🏷️ S3-compatible ETags** created by streaming and hashing file uploads in chunks.
-* [launchql/etag-stream](https://github.com/launchql/launchql/tree/main/packages/etag-stream): **🔄 ETag computation** via Node stream transformer during upload or transfer.
-* [launchql/uuid-hash](https://github.com/launchql/launchql/tree/main/packages/uuid-hash): **🆔 Deterministic UUIDs** generated from hashed content, great for deduplication and asset referencing.
-* [launchql/uuid-stream](https://github.com/launchql/launchql/tree/main/packages/uuid-stream): **🌊 Streaming UUID generation** based on piped file content—ideal for upload pipelines.
-* [launchql/upload-names](https://github.com/launchql/launchql/tree/main/packages/upload-names): **📂 Collision-resistant filenames** utility for structured and unique file names for uploads.
+* [launchql/s3-streamer](https://github.com/constructive-io/constructive/tree/main/packages/s3-streamer): **📤 Direct S3 streaming** for large files with support for metadata injection and content validation.
+* [launchql/etag-hash](https://github.com/constructive-io/constructive/tree/main/packages/etag-hash): **🏷️ S3-compatible ETags** created by streaming and hashing file uploads in chunks.
+* [launchql/etag-stream](https://github.com/constructive-io/constructive/tree/main/packages/etag-stream): **🔄 ETag computation** via Node stream transformer during upload or transfer.
+* [launchql/uuid-hash](https://github.com/constructive-io/constructive/tree/main/packages/uuid-hash): **🆔 Deterministic UUIDs** generated from hashed content, great for deduplication and asset referencing.
+* [launchql/uuid-stream](https://github.com/constructive-io/constructive/tree/main/packages/uuid-stream): **🌊 Streaming UUID generation** based on piped file content—ideal for upload pipelines.
+* [launchql/upload-names](https://github.com/constructive-io/constructive/tree/main/packages/upload-names): **📂 Collision-resistant filenames** utility for structured and unique file names for uploads.
 
 ### 🧰 CLI & Codegen
 
-* [pgpm](https://github.com/launchql/launchql/tree/main/packages/pgpm): **🖥️ PostgreSQL Package Manager** for modular Postgres development. Works with database workspaces, scaffolding, migrations, seeding, and installing database packages.
-* [@launchql/cli](https://github.com/launchql/launchql/tree/main/packages/cli): **🖥️ Command-line toolkit** for managing LaunchQL projects—supports database scaffolding, migrations, seeding, code generation, and automation.
-* [launchql/launchql-gen](https://github.com/launchql/launchql/tree/main/packages/launchql-gen): **✨ Auto-generated GraphQL** mutations and queries dynamically built from introspected schema data.
-* [@launchql/query-builder](https://github.com/launchql/launchql/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.
-* [@launchql/query](https://github.com/launchql/launchql/tree/main/packages/query): **🧩 Fluent GraphQL builder** for PostGraphile schemas. ⚡ Schema-aware via introspection, 🧩 composable and ergonomic for building deeply nested queries.
+* [pgpm](https://github.com/constructive-io/constructive/tree/main/packages/pgpm): **🖥️ PostgreSQL Package Manager** for modular Postgres development. Works with database workspaces, scaffolding, migrations, seeding, and installing database packages.
+* [@launchql/cli](https://github.com/constructive-io/constructive/tree/main/packages/cli): **🖥️ Command-line toolkit** for managing LaunchQL projects—supports database scaffolding, migrations, seeding, code generation, and automation.
+* [launchql/launchql-gen](https://github.com/constructive-io/constructive/tree/main/packages/launchql-gen): **✨ Auto-generated GraphQL** mutations and queries dynamically built from introspected schema data.
+* [@launchql/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.
+* [@launchql/query](https://github.com/constructive-io/constructive/tree/main/packages/query): **🧩 Fluent GraphQL builder** for PostGraphile schemas. ⚡ Schema-aware via introspection, 🧩 composable and ergonomic for building deeply nested queries.
 
 ## Credits
 
-🛠 Built by LaunchQL — if you like our tools, please checkout and contribute to [our github ⚛️](https://github.com/launchql)
+🛠 Built by Constructive — if you like our tools, please checkout and contribute to [our github ⚛️](https://github.com/constructive-io)
 
 
 ## Disclaimer

package/esm/gql.js

@@ -156,7 +156,8 @@ export const parseGraphQuery = (introQuery) => {
         return m;
     }, {});
     const queries = queriesRoot.fields.reduce((m, query) => {
-        if (query.type.kind === 'OBJECT') {
+        const model = getObjectType(query.type);
+        if (model) {
             if (isConnectionQuery(query)) {
                 m[query.name] = parseConnectionQuery(context, query, 1);
             }
@@ -174,24 +175,59 @@ export const parseGraphQuery = (introQuery) => {
 function parseSelectionObject(context, model, nesting) {
     const { HASH } = context;
     throwIfInvalidContext(context);
-    const selectionFields = HASH[model].fields.filter((f) => !isPureObjectType(f.type));
-    return selectionFields.map((f) => {
-        if (f.type.ofType?.kind === 'OBJECT') {
+    const selectionFields = HASH[model].fields
+        .filter((f) => !isPureObjectType(f.type))
+        .filter((f) => {
+        const objectType = getObjectType(f.type);
+        if (objectType && fieldHasRequiredArgs(f))
+            return false;
+        return true;
+    });
+    const mapped = selectionFields.map((f) => {
+        const objectType = getObjectType(f.type);
+        if (objectType) {
             if (isConnectionQuery(f)) {
                 return { name: f.name, ...parseConnectionQuery(context, f, nesting - 1) };
             }
-            else {
-                return { name: f.name, ...parseSingleQuery(context, f, nesting - 1) };
+            if (isListType(f.type)) {
+                return { name: f.name, selection: parseSelectionScalar(context, objectType) };
             }
+            return { name: f.name, ...parseSingleQuery(context, f, nesting - 1) };
+        }
+        const baseKind = getBaseKind(f.type);
+        if (isListType(f.type)) {
+            if (baseKind === 'SCALAR' || baseKind === 'ENUM')
+                return f.name;
+            return null;
         }
+        if (baseKind === 'UNION' || baseKind === 'INTERFACE')
+            return null;
         return f.name;
     });
+    return mapped.filter((x) => x != null);
 }
 function parseSelectionScalar(context, model) {
     const { HASH } = context;
     throwIfInvalidContext(context);
-    const selectionFields = HASH[model].fields.filter((f) => !isPureObjectType(f.type) && !isConnectionQuery(f));
-    return selectionFields.map((f) => f.name);
+    const selectionFields = HASH[model].fields.filter((f) => {
+        if (isPureObjectType(f.type))
+            return false;
+        if (isConnectionQuery(f))
+            return false;
+        const objectType = getObjectType(f.type);
+        if (objectType)
+            return false;
+        const baseKind = getBaseKind(f.type);
+        if (isListType(f.type) && !(baseKind === 'SCALAR' || baseKind === 'ENUM'))
+            return false;
+        if (baseKind === 'UNION' || baseKind === 'INTERFACE')
+            return false;
+        return true;
+    });
+    const names = selectionFields.map((f) => f.name);
+    if (names.length === 0)
+        return ['__typename'];
+    return names;
 }
 function isConnectionQuery(query) {
     const objectType = getObjectType(query.type);
@@ -210,6 +246,27 @@ function getObjectType(type) {
         return getObjectType(type.ofType);
     return undefined;
 }
+function isListType(type) {
+    if (type.kind === 'LIST')
+        return true;
+    if (type.ofType)
+        return isListType(type.ofType);
+    return false;
+}
+function fieldHasRequiredArgs(field) {
+    for (const a of field.args) {
+        if (a.type && a.type.kind === 'NON_NULL' && (a.defaultValue === undefined || a.defaultValue === null)) {
+            return true;
+        }
+    }
+    return false;
+}
+function getBaseKind(type) {
+    let t = type;
+    while (t && t.ofType)
+        t = t.ofType;
+    return (t?.kind || type.kind);
+}
 function throwIfInvalidContext(context) {
     const { HASH, getInputForQueries } = context;
     if (!HASH || !getInputForQueries) {

package/gql.js

@@ -161,7 +161,8 @@ const parseGraphQuery = (introQuery) => {
         return m;
     }, {});
     const queries = queriesRoot.fields.reduce((m, query) => {
-        if (query.type.kind === 'OBJECT') {
+        const model = getObjectType(query.type);
+        if (model) {
             if (isConnectionQuery(query)) {
                 m[query.name] = (0, exports.parseConnectionQuery)(context, query, 1);
             }
@@ -180,24 +181,59 @@ exports.parseGraphQuery = parseGraphQuery;
 function parseSelectionObject(context, model, nesting) {
     const { HASH } = context;
     throwIfInvalidContext(context);
-    const selectionFields = HASH[model].fields.filter((f) => !isPureObjectType(f.type));
-    return selectionFields.map((f) => {
-        if (f.type.ofType?.kind === 'OBJECT') {
+    const selectionFields = HASH[model].fields
+        .filter((f) => !isPureObjectType(f.type))
+        .filter((f) => {
+        const objectType = getObjectType(f.type);
+        if (objectType && fieldHasRequiredArgs(f))
+            return false;
+        return true;
+    });
+    const mapped = selectionFields.map((f) => {
+        const objectType = getObjectType(f.type);
+        if (objectType) {
             if (isConnectionQuery(f)) {
                 return { name: f.name, ...(0, exports.parseConnectionQuery)(context, f, nesting - 1) };
             }
-            else {
-                return { name: f.name, ...(0, exports.parseSingleQuery)(context, f, nesting - 1) };
+            if (isListType(f.type)) {
+                return { name: f.name, selection: parseSelectionScalar(context, objectType) };
             }
+            return { name: f.name, ...(0, exports.parseSingleQuery)(context, f, nesting - 1) };
+        }
+        const baseKind = getBaseKind(f.type);
+        if (isListType(f.type)) {
+            if (baseKind === 'SCALAR' || baseKind === 'ENUM')
+                return f.name;
+            return null;
         }
+        if (baseKind === 'UNION' || baseKind === 'INTERFACE')
+            return null;
         return f.name;
     });
+    return mapped.filter((x) => x != null);
 }
 function parseSelectionScalar(context, model) {
     const { HASH } = context;
     throwIfInvalidContext(context);
-    const selectionFields = HASH[model].fields.filter((f) => !isPureObjectType(f.type) && !isConnectionQuery(f));
-    return selectionFields.map((f) => f.name);
+    const selectionFields = HASH[model].fields.filter((f) => {
+        if (isPureObjectType(f.type))
+            return false;
+        if (isConnectionQuery(f))
+            return false;
+        const objectType = getObjectType(f.type);
+        if (objectType)
+            return false;
+        const baseKind = getBaseKind(f.type);
+        if (isListType(f.type) && !(baseKind === 'SCALAR' || baseKind === 'ENUM'))
+            return false;
+        if (baseKind === 'UNION' || baseKind === 'INTERFACE')
+            return false;
+        return true;
+    });
+    const names = selectionFields.map((f) => f.name);
+    if (names.length === 0)
+        return ['__typename'];
+    return names;
 }
 function isConnectionQuery(query) {
     const objectType = getObjectType(query.type);
@@ -216,6 +252,27 @@ function getObjectType(type) {
         return getObjectType(type.ofType);
     return undefined;
 }
+function isListType(type) {
+    if (type.kind === 'LIST')
+        return true;
+    if (type.ofType)
+        return isListType(type.ofType);
+    return false;
+}
+function fieldHasRequiredArgs(field) {
+    for (const a of field.args) {
+        if (a.type && a.type.kind === 'NON_NULL' && (a.defaultValue === undefined || a.defaultValue === null)) {
+            return true;
+        }
+    }
+    return false;
+}
+function getBaseKind(type) {
+    let t = type;
+    while (t && t.ofType)
+        t = t.ofType;
+    return (t?.kind || type.kind);
+}
 function throwIfInvalidContext(context) {
     const { HASH, getInputForQueries } = context;
     if (!HASH || !getInputForQueries) {

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "introspectron",
-  "version": "2.13.16",
+  "version": "2.13.18",
   "description": "introspect your Postgres database and generate an SDK",
   "author": "Dan Lynch <pyramation@gmail.com>",
   "main": "index.js",
   "module": "esm/index.js",
   "types": "index.d.ts",
-  "homepage": "https://github.com/launchql/launchql",
+  "homepage": "https://github.com/constructive-io/constructive",
   "license": "MIT",
   "publishConfig": {
     "access": "public",
@@ -14,10 +14,10 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/launchql/launchql"
+    "url": "https://github.com/constructive-io/constructive"
   },
   "bugs": {
-    "url": "https://github.com/launchql/launchql/issues"
+    "url": "https://github.com/constructive-io/constructive/issues"
   },
   "scripts": {
     "clean": "makage clean",
@@ -31,9 +31,9 @@
   "devDependencies": {
     "@jest/test-sequencer": "^30.2.0",
     "@types/pg": "^8.15.2",
-    "launchql-test": "^2.8.13",
+    "launchql-test": "^2.8.15",
     "makage": "^0.1.8",
-    "pgsql-test": "^2.14.14"
+    "pgsql-test": "^2.14.15"
   },
   "dependencies": {
     "graphql": "15.10.1",
@@ -48,5 +48,5 @@
     "graphile",
     "launchql"
   ],
-  "gitHead": "00c90828cab8d3e306ebb2bc6053aab4aa9ae807"
+  "gitHead": "5a0d7c7502624bd42a214f983fd7ab957e1fb3e3"
 }