graphile-settings 6.5.2 → 6.5.3

package/plugins/meta-schema/graphql-meta-field.js

@@ -1,317 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.extendQueryWithMetaField = extendQueryWithMetaField;
-const graphql_1 = require("graphql");
-function nn(type) {
-    return new graphql_1.GraphQLNonNull(type);
-}
-function nnList(type) {
-    return nn(new graphql_1.GraphQLList(nn(type)));
-}
-function createMetaSchemaType() {
-    const MetaScalarEncodingType = new graphql_1.GraphQLObjectType({
-        name: 'MetaScalarEncoding',
-        description: 'How a client must serialize/parse a scalar — the one field-type detail standard GraphQL introspection cannot describe. Null for plain scalars whose wire format is obvious from gqlType.',
-        fields: () => ({
-            kind: {
-                type: nn(graphql_1.GraphQLString),
-                description: "Machine kind: bigint, datetime, date, time, interval, uuid, geojson, point, inet, ltree, vector, bytea, or composite."
-            },
-            elementType: { type: graphql_1.GraphQLString, description: "For 'vector': element scalar (e.g. 'float')." },
-            dimensions: { type: graphql_1.GraphQLInt, description: "For 'vector': declared length, else null." },
-            geometrySubtype: { type: graphql_1.GraphQLString, description: "For 'geojson': Point/LineString/Polygon/…, else null." },
-            srid: { type: graphql_1.GraphQLInt, description: "For 'geojson': spatial reference id, else null." },
-            dotPath: { type: graphql_1.GraphQLBoolean, description: "For 'ltree': values are dot-separated path strings." }
-        })
-    });
-    const MetaTypeType = new graphql_1.GraphQLObjectType({
-        name: 'MetaType',
-        description: 'Information about a PostgreSQL type',
-        fields: () => ({
-            pgType: { type: nn(graphql_1.GraphQLString) },
-            gqlType: { type: nn(graphql_1.GraphQLString) },
-            isArray: { type: nn(graphql_1.GraphQLBoolean) },
-            isNotNull: { type: graphql_1.GraphQLBoolean },
-            hasDefault: { type: graphql_1.GraphQLBoolean },
-            subtype: { type: graphql_1.GraphQLString },
-            encoding: {
-                type: MetaScalarEncodingType,
-                description: 'Scalar serialization contract (null for plain scalars)'
-            }
-        })
-    });
-    const MetaEnumType = new graphql_1.GraphQLObjectType({
-        name: 'MetaEnum',
-        description: 'Information about a PostgreSQL enum type',
-        fields: () => ({
-            name: { type: nn(graphql_1.GraphQLString), description: 'The PostgreSQL enum type name' },
-            values: { type: nnList(graphql_1.GraphQLString), description: 'Allowed values for this enum' }
-        })
-    });
-    const MetaFieldType = new graphql_1.GraphQLObjectType({
-        name: 'MetaField',
-        description: 'Information about a table field/column',
-        fields: () => ({
-            name: { type: nn(graphql_1.GraphQLString) },
-            type: { type: nn(MetaTypeType) },
-            isNotNull: { type: nn(graphql_1.GraphQLBoolean) },
-            hasDefault: { type: nn(graphql_1.GraphQLBoolean) },
-            isPrimaryKey: { type: nn(graphql_1.GraphQLBoolean) },
-            isForeignKey: { type: nn(graphql_1.GraphQLBoolean) },
-            description: { type: graphql_1.GraphQLString },
-            enumValues: { type: MetaEnumType, description: 'Enum metadata if this field has an enum type' }
-        })
-    });
-    const MetaIndexType = new graphql_1.GraphQLObjectType({
-        name: 'MetaIndex',
-        description: 'Information about a database index',
-        fields: () => ({
-            name: { type: nn(graphql_1.GraphQLString) },
-            isUnique: { type: nn(graphql_1.GraphQLBoolean) },
-            isPrimary: { type: nn(graphql_1.GraphQLBoolean) },
-            columns: { type: nnList(graphql_1.GraphQLString) },
-            fields: { type: new graphql_1.GraphQLList(nn(MetaFieldType)) }
-        })
-    });
-    const MetaPrimaryKeyConstraintType = new graphql_1.GraphQLObjectType({
-        name: 'MetaPrimaryKeyConstraint',
-        description: 'Information about a primary key constraint',
-        fields: () => ({
-            name: { type: nn(graphql_1.GraphQLString) },
-            fields: { type: nnList(MetaFieldType) }
-        })
-    });
-    const MetaUniqueConstraintType = new graphql_1.GraphQLObjectType({
-        name: 'MetaUniqueConstraint',
-        description: 'Information about a unique constraint',
-        fields: () => ({
-            name: { type: nn(graphql_1.GraphQLString) },
-            fields: { type: nnList(MetaFieldType) }
-        })
-    });
-    const MetaRefTableType = new graphql_1.GraphQLObjectType({
-        name: 'MetaRefTable',
-        description: 'Reference to a related table',
-        fields: () => ({
-            name: { type: nn(graphql_1.GraphQLString) }
-        })
-    });
-    const MetaForeignKeyConstraintType = new graphql_1.GraphQLObjectType({
-        name: 'MetaForeignKeyConstraint',
-        description: 'Information about a foreign key constraint',
-        fields: () => ({
-            name: { type: nn(graphql_1.GraphQLString) },
-            fields: { type: nnList(MetaFieldType) },
-            referencedTable: { type: nn(graphql_1.GraphQLString) },
-            referencedFields: { type: nnList(graphql_1.GraphQLString) },
-            refFields: { type: new graphql_1.GraphQLList(nn(MetaFieldType)) },
-            refTable: { type: MetaRefTableType }
-        })
-    });
-    const MetaConstraintsType = new graphql_1.GraphQLObjectType({
-        name: 'MetaConstraints',
-        description: 'Table constraints',
-        fields: () => ({
-            primaryKey: { type: MetaPrimaryKeyConstraintType },
-            unique: { type: nnList(MetaUniqueConstraintType) },
-            foreignKey: { type: nnList(MetaForeignKeyConstraintType) }
-        })
-    });
-    const MetaInflectionType = new graphql_1.GraphQLObjectType({
-        name: 'MetaInflection',
-        description: 'Table inflection names',
-        fields: () => ({
-            tableType: { type: nn(graphql_1.GraphQLString) },
-            allRows: { type: nn(graphql_1.GraphQLString) },
-            connection: { type: nn(graphql_1.GraphQLString) },
-            edge: { type: nn(graphql_1.GraphQLString) },
-            filterType: { type: graphql_1.GraphQLString },
-            orderByType: { type: nn(graphql_1.GraphQLString) },
-            conditionType: { type: nn(graphql_1.GraphQLString) },
-            patchType: { type: graphql_1.GraphQLString },
-            createInputType: { type: nn(graphql_1.GraphQLString) },
-            createPayloadType: { type: nn(graphql_1.GraphQLString) },
-            updatePayloadType: { type: graphql_1.GraphQLString },
-            deletePayloadType: { type: nn(graphql_1.GraphQLString) }
-        })
-    });
-    const MetaQueryType = new graphql_1.GraphQLObjectType({
-        name: 'MetaQuery',
-        description: 'Table query/mutation names',
-        fields: () => ({
-            all: { type: nn(graphql_1.GraphQLString) },
-            one: { type: graphql_1.GraphQLString },
-            create: { type: graphql_1.GraphQLString },
-            update: { type: graphql_1.GraphQLString },
-            delete: { type: graphql_1.GraphQLString }
-        })
-    });
-    const MetaBelongsToRelationType = new graphql_1.GraphQLObjectType({
-        name: 'MetaBelongsToRelation',
-        description: 'A belongs-to (forward FK) relation',
-        fields: () => ({
-            fieldName: { type: graphql_1.GraphQLString },
-            isUnique: { type: nn(graphql_1.GraphQLBoolean) },
-            type: { type: graphql_1.GraphQLString },
-            keys: { type: nnList(MetaFieldType) },
-            references: { type: nn(MetaRefTableType) }
-        })
-    });
-    const MetaHasRelationType = new graphql_1.GraphQLObjectType({
-        name: 'MetaHasRelation',
-        description: 'A has-one or has-many (reverse FK) relation',
-        fields: () => ({
-            fieldName: { type: graphql_1.GraphQLString },
-            isUnique: { type: nn(graphql_1.GraphQLBoolean) },
-            type: { type: graphql_1.GraphQLString },
-            keys: { type: nnList(MetaFieldType) },
-            referencedBy: { type: nn(MetaRefTableType) }
-        })
-    });
-    const MetaManyToManyRelationType = new graphql_1.GraphQLObjectType({
-        name: 'MetaManyToManyRelation',
-        description: 'A many-to-many relation via junction table',
-        fields: () => ({
-            fieldName: { type: graphql_1.GraphQLString },
-            type: { type: graphql_1.GraphQLString },
-            junctionTable: { type: nn(MetaRefTableType) },
-            junctionLeftConstraint: { type: nn(MetaForeignKeyConstraintType) },
-            junctionLeftKeyAttributes: { type: nnList(MetaFieldType) },
-            junctionRightConstraint: { type: nn(MetaForeignKeyConstraintType) },
-            junctionRightKeyAttributes: { type: nnList(MetaFieldType) },
-            leftKeyAttributes: { type: nnList(MetaFieldType) },
-            rightKeyAttributes: { type: nnList(MetaFieldType) },
-            rightTable: { type: nn(MetaRefTableType) }
-        })
-    });
-    const MetaRelationsType = new graphql_1.GraphQLObjectType({
-        name: 'MetaRelations',
-        description: 'Table relations',
-        fields: () => ({
-            belongsTo: { type: nnList(MetaBelongsToRelationType) },
-            has: { type: nnList(MetaHasRelationType) },
-            hasOne: { type: nnList(MetaHasRelationType) },
-            hasMany: { type: nnList(MetaHasRelationType) },
-            manyToMany: { type: nnList(MetaManyToManyRelationType) }
-        })
-    });
-    const MetaStorageType = new graphql_1.GraphQLObjectType({
-        name: 'MetaStorage',
-        description: 'Storage metadata for a table',
-        fields: () => ({
-            isFilesTable: { type: nn(graphql_1.GraphQLBoolean), description: 'Whether this table is a storage files table' },
-            isBucketsTable: { type: nn(graphql_1.GraphQLBoolean), description: 'Whether this table is a storage buckets table' }
-        })
-    });
-    const MetaSearchConfigType = new graphql_1.GraphQLObjectType({
-        name: 'MetaSearchConfig',
-        description: 'Per-table search configuration from @searchConfig smart tag',
-        fields: () => ({
-            weights: {
-                type: graphql_1.GraphQLString,
-                description: 'JSON-encoded per-adapter score weights',
-                resolve(source) {
-                    return source.weights ? JSON.stringify(source.weights) : null;
-                }
-            },
-            boostRecent: { type: nn(graphql_1.GraphQLBoolean), description: 'Whether recency boosting is enabled' },
-            boostRecencyField: { type: graphql_1.GraphQLString, description: 'Field used for recency decay' },
-            boostRecencyDecay: { type: graphql_1.GraphQLFloat, description: 'Exponential decay factor per day' }
-        })
-    });
-    const MetaSearchColumnType = new graphql_1.GraphQLObjectType({
-        name: 'MetaSearchColumn',
-        description: 'A searchable column with its algorithm',
-        fields: () => ({
-            name: { type: nn(graphql_1.GraphQLString), description: 'Column name (camelCase)' },
-            algorithm: { type: nn(graphql_1.GraphQLString), description: 'Search algorithm: tsvector, bm25, trgm, or vector' }
-        })
-    });
-    const MetaSearchType = new graphql_1.GraphQLObjectType({
-        name: 'MetaSearch',
-        description: 'Search metadata for a table',
-        fields: () => ({
-            algorithms: { type: nnList(graphql_1.GraphQLString), description: 'Active search algorithms on this table' },
-            columns: { type: nnList(MetaSearchColumnType), description: 'Searchable columns with their algorithm' },
-            hasUnifiedSearch: { type: nn(graphql_1.GraphQLBoolean), description: 'Whether unifiedSearch composite filter is available' },
-            config: { type: MetaSearchConfigType, description: 'Per-table search configuration' }
-        })
-    });
-    const MetaI18nFieldType = new graphql_1.GraphQLObjectType({
-        name: 'MetaI18nField',
-        description: 'A translatable field',
-        fields: () => ({
-            name: { type: nn(graphql_1.GraphQLString), description: 'GraphQL field name' },
-            type: { type: nn(graphql_1.GraphQLString), description: 'PostgreSQL column type (text, citext)' }
-        })
-    });
-    const MetaI18nType = new graphql_1.GraphQLObjectType({
-        name: 'MetaI18n',
-        description: 'i18n metadata for a table with @i18n tag',
-        fields: () => ({
-            translationTable: { type: nn(graphql_1.GraphQLString), description: 'Name of the translation table' },
-            translatableFields: { type: nnList(MetaI18nFieldType), description: 'Fields that are translatable' }
-        })
-    });
-    const MetaRealtimeType = new graphql_1.GraphQLObjectType({
-        name: 'MetaRealtime',
-        description: 'Realtime metadata for a table with @realtime tag',
-        fields: () => ({
-            subscriptionFieldName: { type: nn(graphql_1.GraphQLString), description: 'The generated subscription field name (e.g. onPostChanged)' }
-        })
-    });
-    const MetaScopeType = new graphql_1.GraphQLObjectType({
-        name: 'MetaScope',
-        description: 'Provisioning scope metadata for a table',
-        fields: () => ({
-            scope: { type: nn(graphql_1.GraphQLString), description: "Provisioning scope: 'platform', 'app', 'database', or an entity scope (e.g. 'org')" },
-            tier: { type: nn(graphql_1.GraphQLString), description: "Coarse bucket: 'global', 'database', or 'entity'" },
-            keyColumn: { type: graphql_1.GraphQLString, description: 'Inflected scope key column (e.g. databaseId, orgId), null for global tiers' },
-            entityTable: { type: graphql_1.GraphQLString, description: 'SQL name of the entity table for entity scopes, else null' },
-            source: { type: nn(graphql_1.GraphQLString), description: "Provenance of the scope metadata (always 'smartTag')" }
-        })
-    });
-    const MetaTableType = new graphql_1.GraphQLObjectType({
-        name: 'MetaTable',
-        description: 'Information about a database table',
-        fields: () => ({
-            name: { type: nn(graphql_1.GraphQLString) },
-            schemaName: { type: nn(graphql_1.GraphQLString) },
-            fields: { type: nnList(MetaFieldType) },
-            indexes: { type: nnList(MetaIndexType) },
-            constraints: { type: nn(MetaConstraintsType) },
-            foreignKeyConstraints: { type: nnList(MetaForeignKeyConstraintType) },
-            primaryKeyConstraints: { type: nnList(MetaPrimaryKeyConstraintType) },
-            uniqueConstraints: { type: nnList(MetaUniqueConstraintType) },
-            relations: { type: nn(MetaRelationsType) },
-            inflection: { type: nn(MetaInflectionType) },
-            query: { type: nn(MetaQueryType) },
-            storage: { type: MetaStorageType, description: 'Storage metadata (null if not a storage table)' },
-            search: { type: MetaSearchType, description: 'Search metadata (null if no search configured)' },
-            i18n: { type: MetaI18nType, description: 'i18n metadata (null if no @i18n tag)' },
-            realtime: { type: MetaRealtimeType, description: 'Realtime metadata (null if no @realtime tag)' },
-            scope: { type: MetaScopeType, description: 'Provisioning scope metadata (null if no @scope tag)' }
-        })
-    });
-    return new graphql_1.GraphQLObjectType({
-        name: 'MetaSchema',
-        description: 'Root meta schema type',
-        fields: () => ({
-            tables: { type: nnList(MetaTableType) }
-        })
-    });
-}
-function extendQueryWithMetaField(fields, tablesMeta) {
-    const metaSchemaType = createMetaSchemaType();
-    const metaField = {
-        type: metaSchemaType,
-        description: 'Metadata about the database schema, including tables, fields, indexes, and constraints. Useful for code generation tools.',
-        resolve() {
-            return { tables: tablesMeta };
-        }
-    };
-    return {
-        ...fields,
-        _meta: metaField
-    };
-}

package/plugins/meta-schema/inflection-utils.d.ts

@@ -1,4 +0,0 @@
-import type { MetaInflection, PgCodec } from './types';
-export declare function safeInflection<T>(fn: () => T, fallback: T): T;
-export declare function createAttributeInflector(inflection: MetaInflection): (attrName: string, codec: PgCodec) => string;
-export declare function fallbackTableType(codecName: string): string;

package/plugins/meta-schema/inflection-utils.js

@@ -1,25 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.safeInflection = safeInflection;
-exports.createAttributeInflector = createAttributeInflector;
-exports.fallbackTableType = fallbackTableType;
-function safeInflection(fn, fallback) {
-    try {
-        return fn() ?? fallback;
-    }
-    catch {
-        return fallback;
-    }
-}
-function createAttributeInflector(inflection) {
-    return (attrName, codec) => {
-        const attributeName = safeInflection(() => inflection._attributeName?.({ attributeName: attrName, codec }), attrName);
-        return safeInflection(() => inflection.camelCase?.(attributeName), attributeName);
-    };
-}
-function fallbackTableType(codecName) {
-    return codecName
-        .replace(/_/g, ' ')
-        .replace(/\b\w/g, (char) => char.toUpperCase())
-        .replace(/ /g, '');
-}

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

@@ -1,4 +0,0 @@
-import type { InflectionMeta, MetaBuild, PgCodec, PgTableResource, PgUnique, QueryMeta } from './types';
-export declare function resolveTableType(build: MetaBuild, codec: PgCodec): string;
-export declare function buildInflectionMeta(resource: PgTableResource, tableType: string, build: MetaBuild): InflectionMeta;
-export declare function buildQueryMeta(resource: PgTableResource, uniques: PgUnique[], tableType: string, build: MetaBuild): QueryMeta;

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

@@ -1,43 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveTableType = resolveTableType;
-exports.buildInflectionMeta = buildInflectionMeta;
-exports.buildQueryMeta = buildQueryMeta;
-const inflection_utils_1 = require("./inflection-utils");
-function resolveTableType(build, codec) {
-    return (0, inflection_utils_1.safeInflection)(() => build.inflection.tableType(codec), (0, inflection_utils_1.fallbackTableType)(codec.name));
-}
-function buildInflectionMeta(resource, tableType, build) {
-    const inflection = build.inflection;
-    return {
-        tableType,
-        allRows: (0, inflection_utils_1.safeInflection)(() => inflection.allRows?.(resource), `${tableType.toLowerCase()}s`),
-        connection: (0, inflection_utils_1.safeInflection)(() => inflection.connectionType?.(tableType), `${tableType}Connection`),
-        edge: (0, inflection_utils_1.safeInflection)(() => inflection.edgeType?.(tableType), `${tableType}Edge`),
-        filterType: (0, inflection_utils_1.safeInflection)(() => inflection.filterType?.(tableType), `${tableType}Filter`),
-        orderByType: (0, inflection_utils_1.safeInflection)(() => inflection.orderByType?.(tableType), `${tableType}OrderBy`),
-        conditionType: (0, inflection_utils_1.safeInflection)(() => inflection.conditionType?.(tableType), `${tableType}Condition`),
-        patchType: (0, inflection_utils_1.safeInflection)(() => inflection.patchType?.(tableType), `${tableType}Patch`),
-        createInputType: (0, inflection_utils_1.safeInflection)(() => inflection.createInputType?.(resource), `Create${tableType}Input`),
-        createPayloadType: (0, inflection_utils_1.safeInflection)(() => inflection.createPayloadType?.(resource), `Create${tableType}Payload`),
-        updatePayloadType: (0, inflection_utils_1.safeInflection)(() => inflection.updatePayloadType?.(resource), `Update${tableType}Payload`),
-        deletePayloadType: (0, inflection_utils_1.safeInflection)(() => inflection.deletePayloadType?.(resource), `Delete${tableType}Payload`),
-    };
-}
-function buildQueryMeta(resource, uniques, tableType, build) {
-    const inflection = build.inflection;
-    const hasPrimaryKey = uniques.some((unique) => unique.isPrimary);
-    return {
-        all: (0, inflection_utils_1.safeInflection)(() => inflection.allRows?.(resource), `${tableType.toLowerCase()}s`),
-        one: hasPrimaryKey
-            ? (0, inflection_utils_1.safeInflection)(() => inflection.tableFieldName?.(resource), tableType.toLowerCase())
-            : null,
-        create: (0, inflection_utils_1.safeInflection)(() => inflection.createField?.(resource), `create${tableType}`),
-        update: hasPrimaryKey
-            ? (0, inflection_utils_1.safeInflection)(() => inflection.updateByKeys?.(resource), `update${tableType}`)
-            : null,
-        delete: hasPrimaryKey
-            ? (0, inflection_utils_1.safeInflection)(() => inflection.deleteByKeys?.(resource), `delete${tableType}`)
-            : null,
-    };
-}

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

@@ -1,2 +0,0 @@
-import type { GraphileConfig } from 'graphile-config';
-export declare const MetaSchemaPlugin: GraphileConfig.Plugin;

package/plugins/meta-schema/plugin.js

@@ -1,26 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MetaSchemaPlugin = void 0;
-const cache_1 = require("./cache");
-const graphql_meta_field_1 = require("./graphql-meta-field");
-const table_meta_builder_1 = require("./table-meta-builder");
-exports.MetaSchemaPlugin = {
-    name: 'MetaSchemaPlugin',
-    version: '1.0.0',
-    description: 'Exposes _meta query for database schema introspection',
-    schema: {
-        hooks: {
-            init(input, rawBuild) {
-                const build = rawBuild;
-                (0, cache_1.setCachedTablesMeta)((0, table_meta_builder_1.collectTablesMeta)(build));
-                return input;
-            },
-            GraphQLObjectType_fields(rawFields, _rawBuild, rawContext) {
-                const context = rawContext;
-                if (context.Self?.name !== 'Query')
-                    return rawFields;
-                return (0, graphql_meta_field_1.extendQueryWithMetaField)(rawFields, (0, cache_1.getCachedTablesMeta)());
-            },
-        },
-    },
-};

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

@@ -1,8 +0,0 @@
-import { type BuildContext } from './table-meta-context';
-import type { BelongsToRelation, HasRelation, ManyToManyRelation, PgAttribute, PgCodec, PgRelation, PgTableResource, PgUnique } from './types';
-export declare function buildBelongsToRelations(codec: PgCodec, attributes: Record<string, PgAttribute>, uniques: PgUnique[], relations: Record<string, PgRelation>, context: BuildContext): BelongsToRelation[];
-export declare function buildReverseRelations(codec: PgCodec, attributes: Record<string, PgAttribute>, relations: Record<string, PgRelation>, context: BuildContext): {
-    hasOne: HasRelation[];
-    hasMany: HasRelation[];
-};
-export declare function buildManyToManyRelations(resource: PgTableResource, codec: PgCodec, context: BuildContext): ManyToManyRelation[];

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

@@ -1,124 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildBelongsToRelations = buildBelongsToRelations;
-exports.buildReverseRelations = buildReverseRelations;
-exports.buildManyToManyRelations = buildManyToManyRelations;
-const inflection_utils_1 = require("./inflection-utils");
-const constraint_meta_builders_1 = require("./constraint-meta-builders");
-const table_meta_context_1 = require("./table-meta-context");
-const table_resource_utils_1 = require("./table-resource-utils");
-function isRecord(value) {
-    return typeof value === 'object' && value !== null;
-}
-function buildBelongsToRelations(codec, attributes, uniques, relations, context) {
-    const belongsTo = [];
-    for (const [relationName, relation] of Object.entries(relations)) {
-        // PostGraphile only sets isReferencee when true (reverse FK);
-        // forward relations have isReferencee undefined, not false.
-        if (relation.isReferencee)
-            continue;
-        const localAttributes = relation.localAttributes || [];
-        const isUnique = uniques.some((unique) => (0, table_resource_utils_1.sameAttributes)(unique.attributes, localAttributes));
-        const remoteCodec = relation.remoteResource?.codec;
-        belongsTo.push({
-            fieldName: relationName,
-            isUnique,
-            type: remoteCodec?.name || null,
-            keys: (0, table_meta_context_1.buildFieldList)(localAttributes, codec, attributes, context),
-            references: { name: remoteCodec?.name || 'unknown' },
-        });
-    }
-    return belongsTo;
-}
-function buildReverseRelations(codec, attributes, relations, context) {
-    const hasOne = [];
-    const hasMany = [];
-    for (const [relationName, relation] of Object.entries(relations)) {
-        if (relation.isReferencee !== true)
-            continue;
-        const remoteUniques = (0, table_resource_utils_1.getUniques)(relation.remoteResource || {});
-        const remoteAttributes = relation.remoteAttributes || [];
-        const isUnique = remoteUniques.some((unique) => (0, table_resource_utils_1.sameAttributes)(unique.attributes, remoteAttributes));
-        const remoteCodec = relation.remoteResource?.codec;
-        const meta = {
-            fieldName: relationName,
-            isUnique,
-            type: remoteCodec?.name || null,
-            keys: (0, table_meta_context_1.buildFieldList)(relation.localAttributes || [], codec, attributes, context),
-            referencedBy: { name: remoteCodec?.name || 'unknown' },
-        };
-        if (isUnique) {
-            hasOne.push(meta);
-        }
-        else {
-            hasMany.push(meta);
-        }
-    }
-    return { hasOne, hasMany };
-}
-function isManyToManyDetails(value) {
-    if (!isRecord(value))
-        return false;
-    return (isRecord(value.leftTable) &&
-        isRecord(value.junctionTable) &&
-        isRecord(value.rightTable) &&
-        typeof value.leftRelationName === 'string' &&
-        typeof value.rightRelationName === 'string');
-}
-function parseManyToManyRelationships(value) {
-    if (!Array.isArray(value))
-        return [];
-    return value.filter(isManyToManyDetails);
-}
-function getManyToManyRelationships(build, tableResource, codec) {
-    const relationshipsByResource = build.pgManyToManyRealtionshipsByResource;
-    if (!(relationshipsByResource instanceof Map))
-        return [];
-    const direct = parseManyToManyRelationships(relationshipsByResource.get(tableResource));
-    if (direct.length > 0)
-        return direct;
-    for (const [leftTable, relationships] of relationshipsByResource.entries()) {
-        const details = parseManyToManyRelationships(relationships);
-        if (details.length === 0 || !isRecord(leftTable))
-            continue;
-        if (leftTable.codec === codec) {
-            return details;
-        }
-    }
-    return [];
-}
-function buildManyToManyRelation(details, context) {
-    const leftCodec = (0, table_resource_utils_1.getResourceCodec)(details.leftTable);
-    const junctionCodec = (0, table_resource_utils_1.getResourceCodec)(details.junctionTable);
-    const rightCodec = (0, table_resource_utils_1.getResourceCodec)(details.rightTable);
-    if (!leftCodec || !junctionCodec || !rightCodec)
-        return null;
-    const leftRelation = (0, table_resource_utils_1.getRelation)(details.leftTable, details.leftRelationName);
-    const junctionRightRelation = (0, table_resource_utils_1.getRelation)(details.junctionTable, details.rightRelationName);
-    if (!leftRelation || !junctionRightRelation)
-        return null;
-    const leftJunctionAttributes = leftRelation.remoteAttributes || [];
-    const leftTableAttributes = leftRelation.localAttributes || [];
-    const rightJunctionAttributes = junctionRightRelation.localAttributes || [];
-    const rightTableAttributes = junctionRightRelation.remoteAttributes || [];
-    const relationFieldName = (0, inflection_utils_1.safeInflection)(() => context.build.inflection._manyToManyRelation?.(details), details.rightRelationName || rightCodec.name || null);
-    const junctionLeftConstraint = (0, constraint_meta_builders_1.buildForeignKeyConstraint)(details.leftRelationName || `${junctionCodec.name}_${leftCodec.name}_fkey`, junctionCodec, junctionCodec.attributes, leftJunctionAttributes, leftCodec, leftCodec.attributes, leftTableAttributes, context);
-    const junctionRightConstraint = (0, constraint_meta_builders_1.buildForeignKeyConstraint)(details.rightRelationName || `${junctionCodec.name}_${rightCodec.name}_fkey`, junctionCodec, junctionCodec.attributes, rightJunctionAttributes, rightCodec, rightCodec.attributes, rightTableAttributes, context);
-    return {
-        fieldName: relationFieldName,
-        type: rightCodec.name || null,
-        junctionTable: { name: junctionCodec.name || 'unknown' },
-        junctionLeftConstraint,
-        junctionLeftKeyAttributes: (0, table_meta_context_1.buildFieldList)(leftJunctionAttributes, junctionCodec, junctionCodec.attributes, context),
-        junctionRightConstraint,
-        junctionRightKeyAttributes: (0, table_meta_context_1.buildFieldList)(rightJunctionAttributes, junctionCodec, junctionCodec.attributes, context),
-        leftKeyAttributes: (0, table_meta_context_1.buildFieldList)(leftTableAttributes, leftCodec, leftCodec.attributes, context),
-        rightKeyAttributes: (0, table_meta_context_1.buildFieldList)(rightTableAttributes, rightCodec, rightCodec.attributes, context),
-        rightTable: { name: rightCodec.name || 'unknown' },
-    };
-}
-function buildManyToManyRelations(resource, codec, context) {
-    return getManyToManyRelationships(context.build, resource, codec)
-        .map((details) => buildManyToManyRelation(details, context))
-        .filter((relation) => relation !== null);
-}

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

@@ -1,15 +0,0 @@
-import type { PgCodec, ScopeMeta } from './types';
-/**
- * Detect provisioning scope metadata for a table.
- *
- * The `@scope` smart tag emitted by the constructive-db generators is the sole
- * source of truth. `apply_scope_fields` knows the exact scope, tier, key column,
- * and entity table, and emits them via
- * `metaschema.append_table_smart_tags(id, { scope, scopeTier, scopeKey, scopeEntityTable })`.
- * PostGraphile surfaces these as `codec.extensions.tags.*`.
- *
- * There is NO inference from column names — a table without the tag returns
- * `null` (the same convention as every other nullable metadata block). This
- * avoids guessing key columns, whose names are chosen freely by each generator.
- */
-export declare function buildScopeMeta(codec: PgCodec, inflectAttr: (attrName: string, codec: PgCodec) => string): ScopeMeta | null;

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

@@ -1,43 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildScopeMeta = buildScopeMeta;
-const VALID_TIERS = new Set(['global', 'database', 'entity']);
-function readString(value) {
-    return typeof value === 'string' && value.length > 0 ? value : null;
-}
-/**
- * Detect provisioning scope metadata for a table.
- *
- * The `@scope` smart tag emitted by the constructive-db generators is the sole
- * source of truth. `apply_scope_fields` knows the exact scope, tier, key column,
- * and entity table, and emits them via
- * `metaschema.append_table_smart_tags(id, { scope, scopeTier, scopeKey, scopeEntityTable })`.
- * PostGraphile surfaces these as `codec.extensions.tags.*`.
- *
- * There is NO inference from column names — a table without the tag returns
- * `null` (the same convention as every other nullable metadata block). This
- * avoids guessing key columns, whose names are chosen freely by each generator.
- */
-function buildScopeMeta(codec, inflectAttr) {
-    const tags = codec.extensions?.tags;
-    const scope = readString(tags?.scope);
-    if (!scope)
-        return null;
-    const rawTier = readString(tags.scopeTier);
-    const tier = rawTier && VALID_TIERS.has(rawTier)
-        ? rawTier
-        : null;
-    if (!tier) {
-        throw new Error(`@scope tag on codec "${codec.name}" is missing a valid scopeTier ` +
-            `(expected one of global|database|entity, got ${JSON.stringify(rawTier)})`);
-    }
-    const keyColumn = readString(tags.scopeKey);
-    const entityTable = readString(tags.scopeEntityTable);
-    return {
-        scope,
-        tier,
-        keyColumn: keyColumn ? inflectAttr(keyColumn, codec) : null,
-        entityTable,
-        source: 'smartTag'
-    };
-}

package/plugins/meta-schema/storage-search-meta-builders.d.ts

@@ -1,29 +0,0 @@
-import type { I18nMeta, PgCodec, RealtimeMeta, SearchMeta, StorageMeta } from './types';
-/**
- * Detect storage metadata from a codec's smart tags.
- * Storage tables are identified by @storageFiles and @storageBuckets smart tags.
- */
-export declare function buildStorageMeta(codec: PgCodec): StorageMeta | null;
-/**
- * Detect search metadata from a codec's columns and smart tags.
- *
- * Looks for:
- * - tsvector columns (full-text search)
- * - vector columns (pgvector semantic search)
- * - @searchConfig smart tag (per-table search configuration)
- * - @bm25Index smart tag on columns (BM25 search)
- * - @trgmSearch smart tag (trigram search)
- */
-export declare function buildSearchMeta(codec: PgCodec, _build: unknown, inflectAttr: (attrName: string, codec: PgCodec) => string): SearchMeta | null;
-/**
- * Detect i18n metadata from a codec's @i18n smart tag.
- * The @i18n tag value is the name of the translation table.
- * Translatable fields are discovered by matching text/citext columns
- * between the base table and the translation table codec.
- */
-export declare function buildI18nMeta(codec: PgCodec, build: unknown, inflectAttr: (attrName: string, codec: PgCodec) => string): I18nMeta | null;
-/**
- * Detect realtime metadata from a codec's @realtime smart tag.
- * Tables tagged with @realtime get subscription fields generated.
- */
-export declare function buildRealtimeMeta(codec: PgCodec, build: unknown): RealtimeMeta | null;