graphile-settings 4.9.3 → 4.10.1

package/plugins/index.js

@@ -2,39 +2,62 @@
 /**
  * PostGraphile v5 Plugins
  *
- * This module re-exports all custom plugins.
- * Plugin implementations have been moved to graphile-misc-plugins.
+ * This module exports all custom plugins (consolidated from graphile-misc-plugins).
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createTrgmOperatorFactories = exports.createMatchesOperatorFactory = exports.createPgvectorAdapter = exports.createTrgmAdapter = exports.createBm25Adapter = exports.createTsvectorAdapter = exports.VectorCodecPreset = exports.VectorCodecPlugin = exports.bm25IndexStore = exports.Bm25CodecPreset = exports.Bm25CodecPlugin = exports.createTsvectorCodecPlugin = exports.TsvectorCodecPreset = exports.TsvectorCodecPlugin = exports.UnifiedSearchPreset = exports.createUnifiedSearchPlugin = exports._buildFieldMeta = exports._pgTypeToGqlType = exports._cachedTablesMeta = exports.PublicKeySignature = exports.PgTypeMappingsPreset = exports.PgTypeMappingsPlugin = exports.MetaSchemaPreset = exports.MetaSchemaPlugin = exports.NoUniqueLookupPreset = exports.PrimaryKeyOnlyPreset = exports.NoUniqueLookupPlugin = exports.PrimaryKeyOnlyPlugin = exports.createUniqueLookupPlugin = exports.ManyToManyOptInPreset = exports.ManyToManyOptInPlugin = exports.EnableAllFilterColumnsPreset = exports.EnableAllFilterColumnsPlugin = exports.InflectorLoggerPreset = exports.InflectorLoggerPlugin = exports.ConflictDetectorPreset = exports.ConflictDetectorPlugin = exports.CustomInflectorPreset = exports.CustomInflectorPlugin = exports.InflektPreset = exports.InflektPlugin = exports.MinimalPreset = void 0;
-// Re-export all plugins from graphile-misc-plugins
-var graphile_misc_plugins_1 = require("graphile-misc-plugins");
-Object.defineProperty(exports, "MinimalPreset", { enumerable: true, get: function () { return graphile_misc_plugins_1.MinimalPreset; } });
-Object.defineProperty(exports, "InflektPlugin", { enumerable: true, get: function () { return graphile_misc_plugins_1.InflektPlugin; } });
-Object.defineProperty(exports, "InflektPreset", { enumerable: true, get: function () { return graphile_misc_plugins_1.InflektPreset; } });
-Object.defineProperty(exports, "CustomInflectorPlugin", { enumerable: true, get: function () { return graphile_misc_plugins_1.CustomInflectorPlugin; } });
-Object.defineProperty(exports, "CustomInflectorPreset", { enumerable: true, get: function () { return graphile_misc_plugins_1.CustomInflectorPreset; } });
-Object.defineProperty(exports, "ConflictDetectorPlugin", { enumerable: true, get: function () { return graphile_misc_plugins_1.ConflictDetectorPlugin; } });
-Object.defineProperty(exports, "ConflictDetectorPreset", { enumerable: true, get: function () { return graphile_misc_plugins_1.ConflictDetectorPreset; } });
-Object.defineProperty(exports, "InflectorLoggerPlugin", { enumerable: true, get: function () { return graphile_misc_plugins_1.InflectorLoggerPlugin; } });
-Object.defineProperty(exports, "InflectorLoggerPreset", { enumerable: true, get: function () { return graphile_misc_plugins_1.InflectorLoggerPreset; } });
-Object.defineProperty(exports, "EnableAllFilterColumnsPlugin", { enumerable: true, get: function () { return graphile_misc_plugins_1.EnableAllFilterColumnsPlugin; } });
-Object.defineProperty(exports, "EnableAllFilterColumnsPreset", { enumerable: true, get: function () { return graphile_misc_plugins_1.EnableAllFilterColumnsPreset; } });
-Object.defineProperty(exports, "ManyToManyOptInPlugin", { enumerable: true, get: function () { return graphile_misc_plugins_1.ManyToManyOptInPlugin; } });
-Object.defineProperty(exports, "ManyToManyOptInPreset", { enumerable: true, get: function () { return graphile_misc_plugins_1.ManyToManyOptInPreset; } });
-Object.defineProperty(exports, "createUniqueLookupPlugin", { enumerable: true, get: function () { return graphile_misc_plugins_1.createUniqueLookupPlugin; } });
-Object.defineProperty(exports, "PrimaryKeyOnlyPlugin", { enumerable: true, get: function () { return graphile_misc_plugins_1.PrimaryKeyOnlyPlugin; } });
-Object.defineProperty(exports, "NoUniqueLookupPlugin", { enumerable: true, get: function () { return graphile_misc_plugins_1.NoUniqueLookupPlugin; } });
-Object.defineProperty(exports, "PrimaryKeyOnlyPreset", { enumerable: true, get: function () { return graphile_misc_plugins_1.PrimaryKeyOnlyPreset; } });
-Object.defineProperty(exports, "NoUniqueLookupPreset", { enumerable: true, get: function () { return graphile_misc_plugins_1.NoUniqueLookupPreset; } });
-Object.defineProperty(exports, "MetaSchemaPlugin", { enumerable: true, get: function () { return graphile_misc_plugins_1.MetaSchemaPlugin; } });
-Object.defineProperty(exports, "MetaSchemaPreset", { enumerable: true, get: function () { return graphile_misc_plugins_1.MetaSchemaPreset; } });
-Object.defineProperty(exports, "PgTypeMappingsPlugin", { enumerable: true, get: function () { return graphile_misc_plugins_1.PgTypeMappingsPlugin; } });
-Object.defineProperty(exports, "PgTypeMappingsPreset", { enumerable: true, get: function () { return graphile_misc_plugins_1.PgTypeMappingsPreset; } });
-Object.defineProperty(exports, "PublicKeySignature", { enumerable: true, get: function () { return graphile_misc_plugins_1.PublicKeySignature; } });
-Object.defineProperty(exports, "_cachedTablesMeta", { enumerable: true, get: function () { return graphile_misc_plugins_1._cachedTablesMeta; } });
-Object.defineProperty(exports, "_pgTypeToGqlType", { enumerable: true, get: function () { return graphile_misc_plugins_1._pgTypeToGqlType; } });
-Object.defineProperty(exports, "_buildFieldMeta", { enumerable: true, get: function () { return graphile_misc_plugins_1._buildFieldMeta; } });
+exports.createTrgmOperatorFactories = exports.createMatchesOperatorFactory = exports.createPgvectorAdapter = exports.createTrgmAdapter = exports.createBm25Adapter = exports.createTsvectorAdapter = exports.VectorCodecPreset = exports.VectorCodecPlugin = exports.bm25IndexStore = exports.Bm25CodecPreset = exports.Bm25CodecPlugin = exports.createTsvectorCodecPlugin = exports.TsvectorCodecPreset = exports.TsvectorCodecPlugin = exports.UnifiedSearchPreset = exports.createUnifiedSearchPlugin = exports.RequiredInputPreset = exports.RequiredInputPlugin = exports._cachedTablesMeta = exports._buildFieldMeta = exports._pgTypeToGqlType = exports.PublicKeySignature = exports.PgTypeMappingsPreset = exports.PgTypeMappingsPlugin = exports.MetaSchemaPreset = exports.MetaSchemaPlugin = exports.NoUniqueLookupPreset = exports.PrimaryKeyOnlyPreset = exports.NoUniqueLookupPlugin = exports.PrimaryKeyOnlyPlugin = exports.createUniqueLookupPlugin = exports.ManyToManyOptInPreset = exports.ManyToManyOptInPlugin = exports.EnableAllFilterColumnsPreset = exports.EnableAllFilterColumnsPlugin = exports.InflectorLoggerPreset = exports.InflectorLoggerPlugin = exports.ConflictDetectorPreset = exports.ConflictDetectorPlugin = exports.CustomInflectorPreset = exports.CustomInflectorPlugin = exports.InflektPreset = exports.InflektPlugin = exports.MinimalPreset = void 0;
+// Minimal preset - PostGraphile without Node/Relay features
+var minimal_preset_1 = require("./minimal-preset");
+Object.defineProperty(exports, "MinimalPreset", { enumerable: true, get: function () { return minimal_preset_1.MinimalPreset; } });
+// Custom inflector using inflekt library
+var custom_inflector_1 = require("./custom-inflector");
+Object.defineProperty(exports, "InflektPlugin", { enumerable: true, get: function () { return custom_inflector_1.InflektPlugin; } });
+Object.defineProperty(exports, "InflektPreset", { enumerable: true, get: function () { return custom_inflector_1.InflektPreset; } });
+Object.defineProperty(exports, "CustomInflectorPlugin", { enumerable: true, get: function () { return custom_inflector_1.CustomInflectorPlugin; } });
+Object.defineProperty(exports, "CustomInflectorPreset", { enumerable: true, get: function () { return custom_inflector_1.CustomInflectorPreset; } });
+// Conflict detector for multi-schema setups
+var conflict_detector_1 = require("./conflict-detector");
+Object.defineProperty(exports, "ConflictDetectorPlugin", { enumerable: true, get: function () { return conflict_detector_1.ConflictDetectorPlugin; } });
+Object.defineProperty(exports, "ConflictDetectorPreset", { enumerable: true, get: function () { return conflict_detector_1.ConflictDetectorPreset; } });
+// Inflector logger for debugging
+var inflector_logger_1 = require("./inflector-logger");
+Object.defineProperty(exports, "InflectorLoggerPlugin", { enumerable: true, get: function () { return inflector_logger_1.InflectorLoggerPlugin; } });
+Object.defineProperty(exports, "InflectorLoggerPreset", { enumerable: true, get: function () { return inflector_logger_1.InflectorLoggerPreset; } });
+// Enable filtering on all columns (not just indexed)
+var enable_all_filter_columns_1 = require("./enable-all-filter-columns");
+Object.defineProperty(exports, "EnableAllFilterColumnsPlugin", { enumerable: true, get: function () { return enable_all_filter_columns_1.EnableAllFilterColumnsPlugin; } });
+Object.defineProperty(exports, "EnableAllFilterColumnsPreset", { enumerable: true, get: function () { return enable_all_filter_columns_1.EnableAllFilterColumnsPreset; } });
+// Many-to-many with opt-in behavior
+var many_to_many_preset_1 = require("./many-to-many-preset");
+Object.defineProperty(exports, "ManyToManyOptInPlugin", { enumerable: true, get: function () { return many_to_many_preset_1.ManyToManyOptInPlugin; } });
+Object.defineProperty(exports, "ManyToManyOptInPreset", { enumerable: true, get: function () { return many_to_many_preset_1.ManyToManyOptInPreset; } });
+// Primary key only lookups (disable non-PK unique constraints)
+var primary_key_only_1 = require("./primary-key-only");
+Object.defineProperty(exports, "createUniqueLookupPlugin", { enumerable: true, get: function () { return primary_key_only_1.createUniqueLookupPlugin; } });
+Object.defineProperty(exports, "PrimaryKeyOnlyPlugin", { enumerable: true, get: function () { return primary_key_only_1.PrimaryKeyOnlyPlugin; } });
+Object.defineProperty(exports, "NoUniqueLookupPlugin", { enumerable: true, get: function () { return primary_key_only_1.NoUniqueLookupPlugin; } });
+Object.defineProperty(exports, "PrimaryKeyOnlyPreset", { enumerable: true, get: function () { return primary_key_only_1.PrimaryKeyOnlyPreset; } });
+Object.defineProperty(exports, "NoUniqueLookupPreset", { enumerable: true, get: function () { return primary_key_only_1.NoUniqueLookupPreset; } });
+// Meta schema plugin for introspection (tables, fields, indexes, constraints)
+var meta_schema_1 = require("./meta-schema");
+Object.defineProperty(exports, "MetaSchemaPlugin", { enumerable: true, get: function () { return meta_schema_1.MetaSchemaPlugin; } });
+Object.defineProperty(exports, "MetaSchemaPreset", { enumerable: true, get: function () { return meta_schema_1.MetaSchemaPreset; } });
+// PG type mappings for custom PostgreSQL types (email, url, etc.)
+var pg_type_mappings_1 = require("./pg-type-mappings");
+Object.defineProperty(exports, "PgTypeMappingsPlugin", { enumerable: true, get: function () { return pg_type_mappings_1.PgTypeMappingsPlugin; } });
+Object.defineProperty(exports, "PgTypeMappingsPreset", { enumerable: true, get: function () { return pg_type_mappings_1.PgTypeMappingsPreset; } });
+// Public key signature plugin for crypto authentication
+var PublicKeySignature_1 = require("./PublicKeySignature");
+Object.defineProperty(exports, "PublicKeySignature", { enumerable: true, get: function () { return PublicKeySignature_1.PublicKeySignature; } });
+// Internal exports for testing
+var meta_schema_2 = require("./meta-schema");
+Object.defineProperty(exports, "_pgTypeToGqlType", { enumerable: true, get: function () { return meta_schema_2._pgTypeToGqlType; } });
+Object.defineProperty(exports, "_buildFieldMeta", { enumerable: true, get: function () { return meta_schema_2._buildFieldMeta; } });
+Object.defineProperty(exports, "_cachedTablesMeta", { enumerable: true, get: function () { return meta_schema_2._cachedTablesMeta; } });
+// Required input plugin - makes @requiredInput tagged fields non-nullable in mutation inputs
+var required_input_plugin_1 = require("./required-input-plugin");
+Object.defineProperty(exports, "RequiredInputPlugin", { enumerable: true, get: function () { return required_input_plugin_1.RequiredInputPlugin; } });
+Object.defineProperty(exports, "RequiredInputPreset", { enumerable: true, get: function () { return required_input_plugin_1.RequiredInputPreset; } });
 // Unified search — tsvector + BM25 + pg_trgm + pgvector behind a single adapter architecture
 var graphile_search_1 = require("graphile-search");
 // Core plugin + preset

package/plugins/inflector-logger.d.ts

@@ -0,0 +1,7 @@
+import type { GraphileConfig } from 'graphile-config';
+export declare const InflectorLoggerPlugin: GraphileConfig.Plugin;
+/**
+ * Preset that includes the inflector logger plugin.
+ * Use this in your main preset's `extends` array.
+ */
+export declare const InflectorLoggerPreset: GraphileConfig.Preset;

package/plugins/inflector-logger.js

@@ -0,0 +1,218 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InflectorLoggerPreset = exports.InflectorLoggerPlugin = void 0;
+/**
+ * InflectorLoggerPlugin - Logs inflector calls during schema build for debugging.
+ *
+ * This plugin wraps key inflectors to log what fields are being generated and why.
+ * It passes through to the default behavior but logs the inputs and outputs.
+ *
+ * WHEN DO PLUGINS RUN?
+ * Plugins only run at BUILD TIME, not on every request. The schema is built once
+ * and cached. This means logging only happens during schema generation, not during
+ * query execution.
+ *
+ * SOURCE CODE REFERENCES:
+ *
+ * 1. PgRowByUniquePlugin - Creates root Query fields for unique constraints
+ *    (e.g., `userById`, `userByEmail`, `postBySlug`)
+ *    https://github.com/graphile/crystal/blob/924b2515c6bd30e5905ac1419a25244b40c8bb4d/graphile-build/graphile-build-pg/src/plugins/PgRowByUniquePlugin.ts#L42-L257
+ *
+ * 2. PgRelationsPlugin - Creates relationship fields on types for foreign keys
+ *    - Forward relations: `post.author` (from posts.author_id -> users.id)
+ *    - Backward relations: `user.posts` (from users.id <- posts.author_id)
+ *    https://github.com/graphile/crystal/blob/924b2515c6bd30e5905ac1419a25244b40c8bb4d/graphile-build/graphile-build-pg/src/plugins/PgRelationsPlugin.ts#L167-L638
+ *
+ * 3. PgAttributesPlugin - Creates fields for table columns
+ *    Also contains the `_attributeName` inflector that renames `id` to `rowId`
+ *    https://github.com/graphile/crystal/blob/924b2515c6bd30e5905ac1419a25244b40c8bb4d/graphile-build/graphile-build-pg/src/plugins/PgAttributesPlugin.ts#L289-L298
+ *
+ * 4. PgTablesPlugin - Creates GraphQL types for tables
+ *    Contains the `_schemaPrefix` inflector that adds schema prefixes
+ *    https://github.com/graphile/crystal/blob/924b2515c6bd30e5905ac1419a25244b40c8bb4d/graphile-build/graphile-build-pg/src/plugins/PgTablesPlugin.ts#L261-L271
+ *
+ * USAGE:
+ * Add InflectorLoggerPlugin to your preset's plugins array.
+ * Set INFLECTOR_LOG=1 environment variable to enable logging.
+ */
+const LOG_ENABLED = process.env.INFLECTOR_LOG === '1';
+function log(category, message, details) {
+    if (!LOG_ENABLED)
+        return;
+    const detailsStr = details ? ` ${JSON.stringify(details)}` : '';
+    console.log(`[Inflector:${category}]${detailsStr} => ${message}`);
+}
+exports.InflectorLoggerPlugin = {
+    name: 'InflectorLoggerPlugin',
+    version: '1.0.0',
+    description: 'Logs inflector calls during schema build for debugging',
+    inflection: {
+        replace: {
+            /**
+             * Logs when root Query fields are created for unique constraints.
+             * Source: PgRowByUniquePlugin
+             * https://github.com/graphile/crystal/blob/924b2515c6bd30e5905ac1419a25244b40c8bb4d/graphile-build/graphile-build-pg/src/plugins/PgRowByUniquePlugin.ts#L50-L63
+             */
+            rowByUnique(previous, _options, details) {
+                const result = previous(details);
+                const { unique, resource } = details;
+                log('rowByUnique', result, {
+                    resource: resource.name,
+                    uniqueAttributes: unique.attributes,
+                    isPrimary: unique.isPrimary,
+                });
+                return result;
+            },
+            /**
+             * Logs when forward relation fields are created (e.g., post.author).
+             * Source: PgRelationsPlugin
+             * https://github.com/graphile/crystal/blob/924b2515c6bd30e5905ac1419a25244b40c8bb4d/graphile-build/graphile-build-pg/src/plugins/PgRelationsPlugin.ts#L228-L230
+             */
+            singleRelation(previous, _options, details) {
+                const result = previous(details);
+                const { codec, relationName, registry } = details;
+                const relation = registry.pgRelations[codec.name]?.[relationName];
+                log('singleRelation', result, {
+                    fromType: codec.name,
+                    relationName,
+                    toType: relation?.remoteResource?.name,
+                    localAttributes: relation?.localAttributes,
+                });
+                return result;
+            },
+            /**
+             * Logs when backward single relation fields are created.
+             * Source: PgRelationsPlugin
+             * https://github.com/graphile/crystal/blob/924b2515c6bd30e5905ac1419a25244b40c8bb4d/graphile-build/graphile-build-pg/src/plugins/PgRelationsPlugin.ts#L250-L252
+             */
+            singleRelationBackwards(previous, _options, details) {
+                const result = previous(details);
+                const { codec, relationName, registry } = details;
+                const relation = registry.pgRelations[codec.name]?.[relationName];
+                log('singleRelationBackwards', result, {
+                    fromType: codec.name,
+                    relationName,
+                    toType: relation?.remoteResource?.name,
+                    remoteAttributes: relation?.remoteAttributes,
+                });
+                return result;
+            },
+            /**
+             * Logs when many-relation fields are created (e.g., user.posts).
+             * Source: PgRelationsPlugin
+             * https://github.com/graphile/crystal/blob/924b2515c6bd30e5905ac1419a25244b40c8bb4d/graphile-build/graphile-build-pg/src/plugins/PgRelationsPlugin.ts#L268-L270
+             */
+            _manyRelation(previous, _options, details) {
+                const result = previous(details);
+                const { codec, relationName, registry } = details;
+                const relation = registry.pgRelations[codec.name]?.[relationName];
+                log('manyRelation', result, {
+                    fromType: codec.name,
+                    relationName,
+                    toType: relation?.remoteResource?.name,
+                    remoteAttributes: relation?.remoteAttributes,
+                });
+                return result;
+            },
+            /**
+             * Logs when connection fields are created for many relations.
+             * Source: PgRelationsPlugin
+             * https://github.com/graphile/crystal/blob/924b2515c6bd30e5905ac1419a25244b40c8bb4d/graphile-build/graphile-build-pg/src/plugins/PgRelationsPlugin.ts#L271-L279
+             */
+            manyRelationConnection(previous, _options, details) {
+                const result = previous(details);
+                const { codec, relationName } = details;
+                log('manyRelationConnection', result, {
+                    fromType: codec.name,
+                    relationName,
+                });
+                return result;
+            },
+            /**
+             * Logs when list fields are created for many relations.
+             * Source: PgRelationsPlugin
+             * https://github.com/graphile/crystal/blob/924b2515c6bd30e5905ac1419a25244b40c8bb4d/graphile-build/graphile-build-pg/src/plugins/PgRelationsPlugin.ts#L280-L288
+             */
+            manyRelationList(previous, _options, details) {
+                const result = previous(details);
+                const { codec, relationName } = details;
+                log('manyRelationList', result, {
+                    fromType: codec.name,
+                    relationName,
+                });
+                return result;
+            },
+            /**
+             * Logs when root connection fields are created (e.g., Query.users).
+             * Source: PgAllRowsPlugin
+             */
+            allRowsConnection(previous, _options, resource) {
+                const result = previous(resource);
+                log('allRowsConnection', result, {
+                    resource: resource.name,
+                });
+                return result;
+            },
+            /**
+             * Logs when update mutation fields are created.
+             * Source: PgMutationUpdateDeletePlugin
+             */
+            updateByKeysField(previous, _options, details) {
+                const result = previous(details);
+                const { resource, unique } = details;
+                log('updateByKeysField', result, {
+                    resource: resource.name,
+                    uniqueAttributes: unique.attributes,
+                    isPrimary: unique.isPrimary,
+                });
+                return result;
+            },
+            /**
+             * Logs when delete mutation fields are created.
+             * Source: PgMutationUpdateDeletePlugin
+             */
+            deleteByKeysField(previous, _options, details) {
+                const result = previous(details);
+                const { resource, unique } = details;
+                log('deleteByKeysField', result, {
+                    resource: resource.name,
+                    uniqueAttributes: unique.attributes,
+                    isPrimary: unique.isPrimary,
+                });
+                return result;
+            },
+            /**
+             * Logs when attribute (column) fields are created.
+             * Source: PgAttributesPlugin
+             * https://github.com/graphile/crystal/blob/924b2515c6bd30e5905ac1419a25244b40c8bb4d/graphile-build/graphile-build-pg/src/plugins/PgAttributesPlugin.ts#L289-L298
+             */
+            attribute(previous, _options, details) {
+                const result = previous(details);
+                const { attributeName, codec } = details;
+                log('attribute', result, {
+                    codec: codec.name,
+                    attributeName,
+                });
+                return result;
+            },
+            /**
+             * Logs when table types are created.
+             * Source: PgTablesPlugin
+             */
+            tableType(previous, _options, codec) {
+                const result = previous(codec);
+                log('tableType', result, {
+                    codec: codec.name,
+                });
+                return result;
+            },
+        },
+    },
+};
+/**
+ * Preset that includes the inflector logger plugin.
+ * Use this in your main preset's `extends` array.
+ */
+exports.InflectorLoggerPreset = {
+    plugins: [exports.InflectorLoggerPlugin],
+};

package/plugins/many-to-many-preset.d.ts

@@ -0,0 +1,62 @@
+import type { GraphileConfig } from 'graphile-config';
+/**
+ * Many-to-Many Preset with OPT-IN behavior (disabled by default).
+ *
+ * WHY THIS EXISTS:
+ * The default @graphile-contrib/pg-many-to-many plugin adds many-to-many connection
+ * fields to EVERY junction table automatically. This can bloat the API with fields
+ * that may never be used.
+ *
+ * OUR FIX:
+ * We override the default behavior to be OPT-IN instead of OPT-OUT:
+ * - By default, NO many-to-many fields are generated
+ * - To enable for a specific junction table, use: @behavior +manyToMany
+ *
+ * USAGE:
+ * To enable many-to-many for a specific junction table, add a smart comment:
+ *
+ * ```sql
+ * -- Enable many-to-many through this junction table
+ * COMMENT ON TABLE post_tags IS E'@behavior +manyToMany';
+ *
+ * -- Or enable on a specific constraint
+ * COMMENT ON CONSTRAINT post_tags_tag_id_fkey ON post_tags IS E'@behavior +manyToMany';
+ * ```
+ *
+ * SOURCE CODE REFERENCE:
+ * The many-to-many plugin uses the behavior system to control field generation:
+ * https://github.com/graphile-contrib/pg-many-to-many/blob/v2.0.0-rc.1/src/PgManyToManyRelationPlugin.ts#L478-L503
+ *
+ * The plugin defines these behaviors:
+ * - `manyToMany` - Controls whether many-to-many fields are generated
+ * - `connection` - Controls whether connection fields are generated
+ * - `list` - Controls whether list fields are generated
+ *
+ * By default, the plugin's entityBehavior for pgManyToMany includes:
+ * `["manyToMany", "connection", "list", behavior]`
+ *
+ * We override this to be `-manyToMany` by default, requiring explicit opt-in.
+ */
+/**
+ * Plugin that makes many-to-many fields opt-in by default.
+ *
+ * This overrides the default behavior from @graphile-contrib/pg-many-to-many
+ * to require explicit `@behavior +manyToMany` smart tags.
+ */
+export declare const ManyToManyOptInPlugin: GraphileConfig.Plugin;
+/**
+ * Preset that includes the many-to-many plugin with opt-in behavior.
+ *
+ * Use this in your main preset's `extends` array:
+ * ```typescript
+ * const preset: GraphileConfig.Preset = {
+ *   extends: [
+ *     MinimalPreset,
+ *     ManyToManyOptInPreset,
+ *     // ... other presets
+ *   ],
+ * };
+ * ```
+ */
+export declare const ManyToManyOptInPreset: GraphileConfig.Preset;
+export default ManyToManyOptInPreset;

package/plugins/many-to-many-preset.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ManyToManyOptInPreset = exports.ManyToManyOptInPlugin = void 0;
+const pg_many_to_many_1 = require("@graphile-contrib/pg-many-to-many");
+/**
+ * Many-to-Many Preset with OPT-IN behavior (disabled by default).
+ *
+ * WHY THIS EXISTS:
+ * The default @graphile-contrib/pg-many-to-many plugin adds many-to-many connection
+ * fields to EVERY junction table automatically. This can bloat the API with fields
+ * that may never be used.
+ *
+ * OUR FIX:
+ * We override the default behavior to be OPT-IN instead of OPT-OUT:
+ * - By default, NO many-to-many fields are generated
+ * - To enable for a specific junction table, use: @behavior +manyToMany
+ *
+ * USAGE:
+ * To enable many-to-many for a specific junction table, add a smart comment:
+ *
+ * ```sql
+ * -- Enable many-to-many through this junction table
+ * COMMENT ON TABLE post_tags IS E'@behavior +manyToMany';
+ *
+ * -- Or enable on a specific constraint
+ * COMMENT ON CONSTRAINT post_tags_tag_id_fkey ON post_tags IS E'@behavior +manyToMany';
+ * ```
+ *
+ * SOURCE CODE REFERENCE:
+ * The many-to-many plugin uses the behavior system to control field generation:
+ * https://github.com/graphile-contrib/pg-many-to-many/blob/v2.0.0-rc.1/src/PgManyToManyRelationPlugin.ts#L478-L503
+ *
+ * The plugin defines these behaviors:
+ * - `manyToMany` - Controls whether many-to-many fields are generated
+ * - `connection` - Controls whether connection fields are generated
+ * - `list` - Controls whether list fields are generated
+ *
+ * By default, the plugin's entityBehavior for pgManyToMany includes:
+ * `["manyToMany", "connection", "list", behavior]`
+ *
+ * We override this to be `-manyToMany` by default, requiring explicit opt-in.
+ */
+/**
+ * Plugin that makes many-to-many fields opt-in by default.
+ *
+ * This overrides the default behavior from @graphile-contrib/pg-many-to-many
+ * to require explicit `@behavior +manyToMany` smart tags.
+ */
+exports.ManyToManyOptInPlugin = {
+    name: 'ManyToManyOptInPlugin',
+    version: '1.0.0',
+    description: 'Makes many-to-many fields opt-in by default (disabled unless explicitly enabled)',
+    schema: {
+        entityBehavior: {
+            pgManyToMany: {
+                // Override the default behavior to be opt-out (disabled by default)
+                // The 'inferred' phase runs before 'override', so we use 'inferred'
+                // to set the default before any smart tags are processed.
+                inferred: {
+                    provides: ['manyToManyOptIn'],
+                    before: ['default'],
+                    callback(behavior) {
+                        // Default to disabled - require explicit @behavior +manyToMany
+                        return ['-manyToMany', behavior];
+                    },
+                },
+            },
+        },
+    },
+};
+/**
+ * Preset that includes the many-to-many plugin with opt-in behavior.
+ *
+ * Use this in your main preset's `extends` array:
+ * ```typescript
+ * const preset: GraphileConfig.Preset = {
+ *   extends: [
+ *     MinimalPreset,
+ *     ManyToManyOptInPreset,
+ *     // ... other presets
+ *   ],
+ * };
+ * ```
+ */
+exports.ManyToManyOptInPreset = {
+    extends: [pg_many_to_many_1.PgManyToManyPreset],
+    plugins: [exports.ManyToManyOptInPlugin],
+};
+exports.default = exports.ManyToManyOptInPreset;

package/plugins/meta-schema/cache.d.ts

@@ -0,0 +1,4 @@
+import type { TableMeta } from './types';
+export declare let cachedTablesMeta: TableMeta[];
+export declare function getCachedTablesMeta(): TableMeta[];
+export declare function setCachedTablesMeta(tablesMeta: TableMeta[]): void;

package/plugins/meta-schema/cache.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cachedTablesMeta = void 0;
+exports.getCachedTablesMeta = getCachedTablesMeta;
+exports.setCachedTablesMeta = setCachedTablesMeta;
+exports.cachedTablesMeta = [];
+function getCachedTablesMeta() {
+    return exports.cachedTablesMeta;
+}
+function setCachedTablesMeta(tablesMeta) {
+    exports.cachedTablesMeta = tablesMeta;
+}

package/plugins/meta-schema/constraint-meta-builders.d.ts

@@ -0,0 +1,13 @@
+import { type BuildContext } from './table-meta-context';
+import type { ForeignKeyConstraintMeta, PgAttribute, PgCodec, PgRelation, PgUnique, PrimaryKeyConstraintMeta, UniqueConstraintMeta } from './types';
+export declare function buildForeignKeyConstraint(constraintName: string, localCodec: PgCodec, localAttributes: Record<string, PgAttribute>, localAttributeNames: string[], remoteCodec: PgCodec | undefined, remoteAttributes: Record<string, PgAttribute>, remoteAttributeNames: string[], context: BuildContext): ForeignKeyConstraintMeta;
+export declare function buildIndexes(codec: PgCodec, attributes: Record<string, PgAttribute>, uniques: PgUnique[], context: BuildContext): {
+    name: string;
+    isUnique: boolean;
+    isPrimary: boolean;
+    columns: string[];
+    fields: import("./types").FieldMeta[];
+}[];
+export declare function buildPrimaryKey(codec: PgCodec, attributes: Record<string, PgAttribute>, uniques: PgUnique[], context: BuildContext): PrimaryKeyConstraintMeta | null;
+export declare function buildUniqueConstraints(codec: PgCodec, attributes: Record<string, PgAttribute>, uniques: PgUnique[], context: BuildContext): UniqueConstraintMeta[];
+export declare function buildForeignKeyConstraints(codec: PgCodec, attributes: Record<string, PgAttribute>, relations: Record<string, PgRelation>, context: BuildContext): ForeignKeyConstraintMeta[];

package/plugins/meta-schema/constraint-meta-builders.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildForeignKeyConstraint = buildForeignKeyConstraint;
+exports.buildIndexes = buildIndexes;
+exports.buildPrimaryKey = buildPrimaryKey;
+exports.buildUniqueConstraints = buildUniqueConstraints;
+exports.buildForeignKeyConstraints = buildForeignKeyConstraints;
+const type_mappings_1 = require("./type-mappings");
+const table_meta_context_1 = require("./table-meta-context");
+function buildForeignKeyConstraint(constraintName, localCodec, localAttributes, localAttributeNames, remoteCodec, remoteAttributes, remoteAttributeNames, context) {
+    const referencedTable = remoteCodec?.name || 'unknown';
+    const referencedFields = remoteAttributeNames.map((attrName) => remoteCodec ? context.inflectAttr(attrName, remoteCodec) : attrName);
+    return {
+        name: constraintName,
+        fields: (0, table_meta_context_1.buildFieldList)(localAttributeNames, localCodec, localAttributes, context),
+        referencedTable,
+        referencedFields,
+        refFields: remoteAttributeNames.map((attrName) => (0, type_mappings_1.buildFieldMeta)(remoteCodec ? context.inflectAttr(attrName, remoteCodec) : attrName, remoteAttributes[attrName], context.build)),
+        refTable: { name: referencedTable },
+    };
+}
+function buildIndexes(codec, attributes, uniques, context) {
+    return uniques.map((unique) => ({
+        name: unique.tags?.name || `${codec.name}_${unique.attributes.join('_')}_idx`,
+        isUnique: true,
+        isPrimary: !!unique.isPrimary,
+        columns: unique.attributes.map((attrName) => context.inflectAttr(attrName, codec)),
+        fields: (0, table_meta_context_1.buildFieldList)(unique.attributes, codec, attributes, context),
+    }));
+}
+function buildPrimaryKey(codec, attributes, uniques, context) {
+    const primaryUnique = uniques.find((unique) => unique.isPrimary);
+    if (!primaryUnique)
+        return null;
+    return {
+        name: primaryUnique.tags?.name || `${codec.name}_pkey`,
+        fields: (0, table_meta_context_1.buildFieldList)(primaryUnique.attributes, codec, attributes, context),
+    };
+}
+function buildUniqueConstraints(codec, attributes, uniques, context) {
+    return uniques
+        .filter((unique) => !unique.isPrimary)
+        .map((unique) => ({
+        name: unique.tags?.name || `${codec.name}_${unique.attributes.join('_')}_key`,
+        fields: (0, table_meta_context_1.buildFieldList)(unique.attributes, codec, attributes, context),
+    }));
+}
+function buildForeignKeyConstraints(codec, attributes, relations, context) {
+    const constraints = [];
+    for (const [relationName, relation] of Object.entries(relations)) {
+        if (relation.isReferencee !== false)
+            continue;
+        const remoteCodec = relation.remoteResource?.codec;
+        const remoteAttributes = remoteCodec?.attributes || {};
+        constraints.push(buildForeignKeyConstraint(relationName, codec, attributes, relation.localAttributes || [], remoteCodec, remoteAttributes, relation.remoteAttributes || [], context));
+    }
+    return constraints;
+}

package/plugins/meta-schema/graphql-meta-field.d.ts

@@ -0,0 +1,4 @@
+import type { TableMeta } from './types';
+type FieldMap = Record<string, unknown>;
+export declare function extendQueryWithMetaField(fields: FieldMap, tablesMeta: TableMeta[]): FieldMap;
+export {};