node-type-registry 0.7.1 → 0.9.0

package/README.md

@@ -31,7 +31,6 @@ import type {
 const definition: BlueprintDefinition = {
   tables: [
     {
-      ref: 'tasks',
       table_name: 'tasks',
       nodes: [
         'DataId',
@@ -48,11 +47,17 @@ const definition: BlueprintDefinition = {
   relations: [
     {
       $type: 'RelationBelongsTo',
-      source_ref: 'tasks',
-      target_ref: 'projects',
+      source_table: 'tasks',
+      target_table: 'projects',
       delete_action: 'c',
     },
   ],
+  unique_constraints: [
+    {
+      table_name: 'tasks',
+      columns: ['title', 'owner_id'],
+    },
+  ],
 };
 ```
 
@@ -61,7 +66,7 @@ const definition: BlueprintDefinition = {
 When node type definitions are added or modified, regenerate with:
 
 ```bash
-cd graphile/node-type-registry && pnpm generate:types
+cd graphql/node-type-registry && pnpm generate:types
 ```
 
 This produces `src/blueprint-types.generated.ts` from the TS node type source of truth.
@@ -71,7 +76,7 @@ This produces `src/blueprint-types.generated.ts` from the TS node type source of
 Generate SQL seed scripts for `node_type_registry` table:
 
 ```bash
-cd graphile/node-type-registry && pnpm generate:seed --pgpm ../../constructive-db/packages/metaschema
+cd graphql/node-type-registry && pnpm generate:seed --pgpm ../../constructive-db/packages/metaschema
 ```
 
 ---

package/blueprint-types.generated.d.ts

@@ -363,7 +363,7 @@ export interface RelationHasManyParams {
     delete_action: "c" | "r" | "n" | "d" | "a";
     is_required?: boolean;
 }
-/** Creates a junction table between source and target tables with auto-derived naming and FK fields. The trigger creates a bare table (no implicit DataId or any node_type), adds FK fields to both tables, optionally creates a composite PK (use_composite_key), then forwards all security config to secure_table_provision as-is. The trigger never injects values the caller did not provide. Junction table FKs always CASCADE on delete. */
+/** Creates a junction table between source and target tables with auto-derived naming and FK fields. The trigger creates a bare table (no implicit DataId), adds FK fields to both tables, optionally creates a composite PK (use_composite_key), then forwards all security config to secure_table_provision as-is. The trigger never injects values the caller did not provide. Junction table FKs always CASCADE on delete. */
 export interface RelationManyToManyParams {
     source_table_id: string;
     target_table_id: string;
@@ -372,10 +372,9 @@ export interface RelationManyToManyParams {
     source_field_name?: string;
     target_field_name?: string;
     use_composite_key?: boolean;
-    node_type?: string;
-    node_data?: {
+    nodes?: {
         [key: string]: unknown;
-    };
+    }[];
     grant_roles?: string[];
     grant_privileges?: string[][];
     policy_type?: string;
@@ -444,18 +443,18 @@ export interface BlueprintField {
     /** Comment/description for this field. */
     description?: string;
 }
-/** An RLS policy entry for a blueprint table. */
+/** An RLS policy entry for a blueprint table. Uses $type to match the blueprint JSON convention. */
 export interface BlueprintPolicy {
     /** Authz* policy type name (e.g., "AuthzDirectOwner", "AuthzAllowAll"). */
-    policy_type: "AuthzDirectOwner" | "AuthzDirectOwnerAny" | "AuthzMembership" | "AuthzEntityMembership" | "AuthzRelatedEntityMembership" | "AuthzOrgHierarchy" | "AuthzTemporal" | "AuthzPublishable" | "AuthzMemberList" | "AuthzRelatedMemberList" | "AuthzAllowAll" | "AuthzDenyAll" | "AuthzComposite" | "AuthzPeerOwnership" | "AuthzRelatedPeerOwnership";
+    $type: "AuthzDirectOwner" | "AuthzDirectOwnerAny" | "AuthzMembership" | "AuthzEntityMembership" | "AuthzRelatedEntityMembership" | "AuthzOrgHierarchy" | "AuthzTemporal" | "AuthzPublishable" | "AuthzMemberList" | "AuthzRelatedMemberList" | "AuthzAllowAll" | "AuthzDenyAll" | "AuthzComposite" | "AuthzPeerOwnership" | "AuthzRelatedPeerOwnership";
+    /** Privileges this policy applies to (e.g., ["select"], ["insert", "update", "delete"]). */
+    privileges?: string[];
+    /** Whether this policy is permissive (true) or restrictive (false). Defaults to true. */
+    permissive?: boolean;
     /** Role for this policy. Defaults to "authenticated". */
     policy_role?: string;
-    /** Whether this policy is permissive (true) or restrictive (false). */
-    permissive?: boolean;
     /** Optional custom name for this policy. */
     policy_name?: string;
-    /** Privileges this policy applies to. */
-    privileges?: string[];
     /** Policy-specific data (structure varies by policy type). */
     data?: Record<string, unknown>;
 }
@@ -468,19 +467,49 @@ export interface BlueprintFtsSource {
     /** Language for text search. Defaults to "english". */
     lang?: string;
 }
-/** A full-text search configuration for a blueprint table. */
+/** A full-text search configuration for a blueprint table (top-level, requires table_name). */
 export interface BlueprintFullTextSearch {
-    /** Reference key of the table this full-text search belongs to. */
-    table_ref: string;
+    /** Table name this full-text search belongs to. */
+    table_name: string;
+    /** Optional schema name for disambiguation (falls back to top-level default). */
+    schema_name?: string;
     /** Name of the tsvector field on the table. */
     field: string;
     /** Source fields that feed into this tsvector. */
     sources: BlueprintFtsSource[];
 }
-/** An index definition within a blueprint. */
+/** A full-text search configuration nested inside a table definition (table_name not required). */
+export interface BlueprintTableFullTextSearch {
+    /** Name of the tsvector field on the table. */
+    field: string;
+    /** Source fields that feed into this tsvector. */
+    sources: BlueprintFtsSource[];
+    /** Optional schema name override. */
+    schema_name?: string;
+}
+/** An index definition within a blueprint (top-level, requires table_name). */
 export interface BlueprintIndex {
-    /** Reference key of the table this index belongs to. */
-    table_ref: string;
+    /** Table name this index belongs to. */
+    table_name: string;
+    /** Optional schema name for disambiguation (falls back to top-level default). */
+    schema_name?: string;
+    /** Single column name for the index. */
+    column?: string;
+    /** Array of column names for a multi-column index. */
+    columns?: string[];
+    /** Index access method (e.g., "BTREE", "GIN", "GIST", "HNSW", "BM25"). */
+    access_method: string;
+    /** Whether this is a unique index. */
+    is_unique?: boolean;
+    /** Optional custom name for the index. */
+    name?: string;
+    /** Operator classes for the index columns. */
+    op_classes?: string[];
+    /** Additional index-specific options. */
+    options?: Record<string, unknown>;
+}
+/** An index definition nested inside a table definition (table_name not required). */
+export interface BlueprintTableIndex {
     /** Single column name for the index. */
     column?: string;
     /** Array of column names for a multi-column index. */
@@ -495,6 +524,24 @@ export interface BlueprintIndex {
     op_classes?: string[];
     /** Additional index-specific options. */
     options?: Record<string, unknown>;
+    /** Optional schema name override. */
+    schema_name?: string;
+}
+/** A unique constraint definition within a blueprint (top-level, requires table_name). */
+export interface BlueprintUniqueConstraint {
+    /** Table name this unique constraint belongs to. */
+    table_name: string;
+    /** Optional schema name for disambiguation (falls back to top-level default). */
+    schema_name?: string;
+    /** Column names that form the unique constraint. */
+    columns: string[];
+}
+/** A unique constraint nested inside a table definition (table_name not required). */
+export interface BlueprintTableUniqueConstraint {
+    /** Column names that form the unique constraint. */
+    columns: string[];
+    /** Optional schema name override. */
+    schema_name?: string;
 }
 /** String shorthand -- just the node type name. */
 export type BlueprintNodeShorthand = "AuthzDirectOwner" | "AuthzDirectOwnerAny" | "AuthzMembership" | "AuthzEntityMembership" | "AuthzRelatedEntityMembership" | "AuthzOrgHierarchy" | "AuthzTemporal" | "AuthzPublishable" | "AuthzMemberList" | "AuthzRelatedMemberList" | "AuthzAllowAll" | "AuthzDenyAll" | "AuthzComposite" | "AuthzPeerOwnership" | "AuthzRelatedPeerOwnership" | "DataId" | "DataDirectOwner" | "DataEntityMembership" | "DataOwnershipInEntity" | "DataTimestamps" | "DataPeoplestamps" | "DataPublishable" | "DataSoftDelete" | "DataEmbedding" | "DataFullTextSearch" | "DataBm25" | "DataSearch" | "DataPostGIS" | "DataPostGISAggregate" | "DataJobTrigger" | "DataTags" | "DataStatusField" | "DataJsonb" | "DataTrgm" | "DataSlug" | "DataInflection" | "DataOwnedFields" | "DataInheritFromParent" | "DataForceCurrentUser" | "DataImmutableFields" | "TableUserProfiles" | "TableOrganizationSettings" | "TableUserSettings";
@@ -634,27 +681,35 @@ export type BlueprintNode = BlueprintNodeShorthand | BlueprintNodeObject;
 /** A relation entry in a blueprint definition. */
 export type BlueprintRelation = {
     $type: "RelationBelongsTo";
-    source_ref: string;
-    target_ref: string;
+    source_table: string;
+    target_table: string;
+    source_schema_name?: string;
+    target_schema_name?: string;
 } & Partial<RelationBelongsToParams> | {
     $type: "RelationHasOne";
-    source_ref: string;
-    target_ref: string;
+    source_table: string;
+    target_table: string;
+    source_schema_name?: string;
+    target_schema_name?: string;
 } & Partial<RelationHasOneParams> | {
     $type: "RelationHasMany";
-    source_ref: string;
-    target_ref: string;
+    source_table: string;
+    target_table: string;
+    source_schema_name?: string;
+    target_schema_name?: string;
 } & Partial<RelationHasManyParams> | {
     $type: "RelationManyToMany";
-    source_ref: string;
-    target_ref: string;
+    source_table: string;
+    target_table: string;
+    source_schema_name?: string;
+    target_schema_name?: string;
 } & Partial<RelationManyToManyParams>;
 /** A table definition within a blueprint. */
 export interface BlueprintTable {
-    /** Local reference key for this table (used by relations, indexes, fts). */
-    ref: string;
     /** The PostgreSQL table name to create. */
     table_name: string;
+    /** Optional schema name (falls back to top-level default). */
+    schema_name?: string;
     /** Array of node type entries that define the table's behavior. */
     nodes: BlueprintNode[];
     /** Custom fields (columns) to add to the table. */
@@ -667,6 +722,12 @@ export interface BlueprintTable {
     grants?: unknown[];
     /** Whether to enable RLS on this table. Defaults to true. */
     use_rls?: boolean;
+    /** Table-level indexes (table_name inherited from parent). */
+    indexes?: BlueprintTableIndex[];
+    /** Table-level full-text search configurations (table_name inherited from parent). */
+    full_text_searches?: BlueprintTableFullTextSearch[];
+    /** Table-level unique constraints (table_name inherited from parent). */
+    unique_constraints?: BlueprintTableUniqueConstraint[];
 }
 /** The complete blueprint definition -- the JSONB shape accepted by construct_blueprint(). */
 export interface BlueprintDefinition {
@@ -678,4 +739,6 @@ export interface BlueprintDefinition {
     indexes?: BlueprintIndex[];
     /** Full-text search configurations. */
     full_text_searches?: BlueprintFullTextSearch[];
+    /** Unique constraints on table columns. */
+    unique_constraints?: BlueprintUniqueConstraint[];
 }

package/blueprint-types.generated.js

@@ -2,7 +2,7 @@
 // GENERATED FILE — DO NOT EDIT
 //
 // Regenerate with:
-//   cd graphile/node-type-registry && pnpm generate:types
+//   cd graphql/node-type-registry && pnpm generate:types
 //
 // These types match the JSONB shape expected by construct_blueprint().
 // All field names are snake_case to match the SQL convention.

package/codegen/generate-seed.js

@@ -128,7 +128,7 @@ const GENERATED_HEADER = [
     '-- GENERATED FILE — DO NOT EDIT',
     '--',
     '-- Regenerate with:',
-    '--   cd graphile/node-type-registry && pnpm generate:seed --pgpm ../../constructive-db/packages/metaschema',
+    '--   cd graphql/node-type-registry && pnpm generate:seed --pgpm ../../constructive-db/packages/metaschema',
     '--',
     '',
 ].join('\n');

package/codegen/generate-types.d.ts

@@ -6,7 +6,7 @@
  *
  *   - Per-node-type parameter interfaces (via schema-typescript)
  *   - BlueprintNode  -- discriminated union of all non-relation node types
- *   - BlueprintRelation -- typed relation entries with $type, source_ref, target_ref
+ *   - BlueprintRelation -- typed relation entries with $type, source_table, target_table
  *   - BlueprintTable, BlueprintField, BlueprintPolicy, BlueprintIndex, etc.
  *   - BlueprintDefinition -- the top-level type matching the JSONB shape
  *

package/codegen/generate-types.js

@@ -7,7 +7,7 @@
  *
  *   - Per-node-type parameter interfaces (via schema-typescript)
  *   - BlueprintNode  -- discriminated union of all non-relation node types
- *   - BlueprintRelation -- typed relation entries with $type, source_ref, target_ref
+ *   - BlueprintRelation -- typed relation entries with $type, source_table, target_table
  *   - BlueprintTable, BlueprintField, BlueprintPolicy, BlueprintIndex, etc.
  *   - BlueprintDefinition -- the top-level type matching the JSONB shape
  *
@@ -246,28 +246,22 @@ function buildBlueprintField(meta) {
         addJSDoc(optionalProp('description', t.tsStringKeyword()), 'Comment/description for this field.'),
     ]), 'A custom field (column) to add to a blueprint table.');
 }
-function buildBlueprintPolicy(authzNodes, meta) {
+function buildBlueprintPolicy(authzNodes, _meta) {
+    // BlueprintPolicy represents the blueprint JSON shape (not the DB table).
+    // The SQL procedure reads $type (not policy_type) from the JSONB:
+    //   v_policy_type := v_policy_entry->>'$type';
+    // So we always use the static definition with $type.
     const policyTypeAnnotation = authzNodes.length > 0
         ? strUnion(authzNodes.map((nt) => nt.name))
         : t.tsStringKeyword();
-    const table = meta && findTable(meta, 'metaschema_public', 'policy');
-    if (table) {
-        return deriveInterfaceFromTable(table, 'BlueprintPolicy', 'An RLS policy entry for a blueprint table. Derived from _meta.', {
-            // policy_type gets a typed union of known Authz* node names
-            policy_type: policyTypeAnnotation,
-            // data is untyped JSONB — use Record<string, unknown>
-            data: recordType(t.tsStringKeyword(), t.tsUnknownKeyword()),
-        });
-    }
-    // Static fallback
     return addJSDoc(exportInterface('BlueprintPolicy', [
-        addJSDoc(requiredProp('policy_type', policyTypeAnnotation), 'Authz* policy type name (e.g., "AuthzDirectOwner", "AuthzAllowAll").'),
+        addJSDoc(requiredProp('$type', policyTypeAnnotation), 'Authz* policy type name (e.g., "AuthzDirectOwner", "AuthzAllowAll").'),
+        addJSDoc(optionalProp('privileges', t.tsArrayType(t.tsStringKeyword())), 'Privileges this policy applies to (e.g., ["select"], ["insert", "update", "delete"]).'),
+        addJSDoc(optionalProp('permissive', t.tsBooleanKeyword()), 'Whether this policy is permissive (true) or restrictive (false). Defaults to true.'),
         addJSDoc(optionalProp('policy_role', t.tsStringKeyword()), 'Role for this policy. Defaults to "authenticated".'),
-        addJSDoc(optionalProp('permissive', t.tsBooleanKeyword()), 'Whether this policy is permissive (true) or restrictive (false).'),
         addJSDoc(optionalProp('policy_name', t.tsStringKeyword()), 'Optional custom name for this policy.'),
-        addJSDoc(optionalProp('privileges', t.tsArrayType(t.tsStringKeyword())), 'Privileges this policy applies to.'),
         addJSDoc(optionalProp('data', recordType(t.tsStringKeyword(), t.tsUnknownKeyword())), 'Policy-specific data (structure varies by policy type).'),
-    ]), 'An RLS policy entry for a blueprint table.');
+    ]), 'An RLS policy entry for a blueprint table. Uses $type to match the blueprint JSON convention.');
 }
 function buildBlueprintFtsSource() {
     return addJSDoc(exportInterface('BlueprintFtsSource', [
@@ -278,10 +272,18 @@ function buildBlueprintFtsSource() {
 }
 function buildBlueprintFullTextSearch() {
     return addJSDoc(exportInterface('BlueprintFullTextSearch', [
-        addJSDoc(requiredProp('table_ref', t.tsStringKeyword()), 'Reference key of the table this full-text search belongs to.'),
+        addJSDoc(requiredProp('table_name', t.tsStringKeyword()), 'Table name this full-text search belongs to.'),
+        addJSDoc(optionalProp('schema_name', t.tsStringKeyword()), 'Optional schema name for disambiguation (falls back to top-level default).'),
         addJSDoc(requiredProp('field', t.tsStringKeyword()), 'Name of the tsvector field on the table.'),
         addJSDoc(requiredProp('sources', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintFtsSource')))), 'Source fields that feed into this tsvector.'),
-    ]), 'A full-text search configuration for a blueprint table.');
+    ]), 'A full-text search configuration for a blueprint table (top-level, requires table_name).');
+}
+function buildBlueprintTableFullTextSearch() {
+    return addJSDoc(exportInterface('BlueprintTableFullTextSearch', [
+        addJSDoc(requiredProp('field', t.tsStringKeyword()), 'Name of the tsvector field on the table.'),
+        addJSDoc(requiredProp('sources', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintFtsSource')))), 'Source fields that feed into this tsvector.'),
+        addJSDoc(optionalProp('schema_name', t.tsStringKeyword()), 'Optional schema name override.'),
+    ]), 'A full-text search configuration nested inside a table definition (table_name not required).');
 }
 function buildBlueprintIndex(meta) {
     const table = meta && findTable(meta, 'metaschema_public', 'index');
@@ -295,7 +297,8 @@ function buildBlueprintIndex(meta) {
     }
     // Static fallback
     return addJSDoc(exportInterface('BlueprintIndex', [
-        addJSDoc(requiredProp('table_ref', t.tsStringKeyword()), 'Reference key of the table this index belongs to.'),
+        addJSDoc(requiredProp('table_name', t.tsStringKeyword()), 'Table name this index belongs to.'),
+        addJSDoc(optionalProp('schema_name', t.tsStringKeyword()), 'Optional schema name for disambiguation (falls back to top-level default).'),
         addJSDoc(optionalProp('column', t.tsStringKeyword()), 'Single column name for the index.'),
         addJSDoc(optionalProp('columns', t.tsArrayType(t.tsStringKeyword())), 'Array of column names for a multi-column index.'),
         addJSDoc(requiredProp('access_method', t.tsStringKeyword()), 'Index access method (e.g., "BTREE", "GIN", "GIST", "HNSW", "BM25").'),
@@ -303,7 +306,19 @@ function buildBlueprintIndex(meta) {
         addJSDoc(optionalProp('name', t.tsStringKeyword()), 'Optional custom name for the index.'),
         addJSDoc(optionalProp('op_classes', t.tsArrayType(t.tsStringKeyword())), 'Operator classes for the index columns.'),
         addJSDoc(optionalProp('options', recordType(t.tsStringKeyword(), t.tsUnknownKeyword())), 'Additional index-specific options.'),
-    ]), 'An index definition within a blueprint.');
+    ]), 'An index definition within a blueprint (top-level, requires table_name).');
+}
+function buildBlueprintTableIndex() {
+    return addJSDoc(exportInterface('BlueprintTableIndex', [
+        addJSDoc(optionalProp('column', t.tsStringKeyword()), 'Single column name for the index.'),
+        addJSDoc(optionalProp('columns', t.tsArrayType(t.tsStringKeyword())), 'Array of column names for a multi-column index.'),
+        addJSDoc(requiredProp('access_method', t.tsStringKeyword()), 'Index access method (e.g., "BTREE", "GIN", "GIST", "HNSW", "BM25").'),
+        addJSDoc(optionalProp('is_unique', t.tsBooleanKeyword()), 'Whether this is a unique index.'),
+        addJSDoc(optionalProp('name', t.tsStringKeyword()), 'Optional custom name for the index.'),
+        addJSDoc(optionalProp('op_classes', t.tsArrayType(t.tsStringKeyword())), 'Operator classes for the index columns.'),
+        addJSDoc(optionalProp('options', recordType(t.tsStringKeyword(), t.tsUnknownKeyword())), 'Additional index-specific options.'),
+        addJSDoc(optionalProp('schema_name', t.tsStringKeyword()), 'Optional schema name override.'),
+    ]), 'An index definition nested inside a table definition (table_name not required).');
 }
 // ---------------------------------------------------------------------------
 // Node type discriminated unions
@@ -339,8 +354,10 @@ function buildRelationTypes(relationNodes) {
     const relationMembers = relationNodes.map((nt) => {
         const baseType = t.tsTypeLiteral([
             requiredProp('$type', strLit(nt.name)),
-            requiredProp('source_ref', t.tsStringKeyword()),
-            requiredProp('target_ref', t.tsStringKeyword()),
+            requiredProp('source_table', t.tsStringKeyword()),
+            requiredProp('target_table', t.tsStringKeyword()),
+            optionalProp('source_schema_name', t.tsStringKeyword()),
+            optionalProp('target_schema_name', t.tsStringKeyword()),
         ]);
         return t.tsIntersectionType([
             baseType,
@@ -354,16 +371,32 @@ function buildRelationTypes(relationNodes) {
 // ---------------------------------------------------------------------------
 // BlueprintTable and BlueprintDefinition
 // ---------------------------------------------------------------------------
+function buildBlueprintUniqueConstraint() {
+    return addJSDoc(exportInterface('BlueprintUniqueConstraint', [
+        addJSDoc(requiredProp('table_name', t.tsStringKeyword()), 'Table name this unique constraint belongs to.'),
+        addJSDoc(optionalProp('schema_name', t.tsStringKeyword()), 'Optional schema name for disambiguation (falls back to top-level default).'),
+        addJSDoc(requiredProp('columns', t.tsArrayType(t.tsStringKeyword())), 'Column names that form the unique constraint.'),
+    ]), 'A unique constraint definition within a blueprint (top-level, requires table_name).');
+}
+function buildBlueprintTableUniqueConstraint() {
+    return addJSDoc(exportInterface('BlueprintTableUniqueConstraint', [
+        addJSDoc(requiredProp('columns', t.tsArrayType(t.tsStringKeyword())), 'Column names that form the unique constraint.'),
+        addJSDoc(optionalProp('schema_name', t.tsStringKeyword()), 'Optional schema name override.'),
+    ]), 'A unique constraint nested inside a table definition (table_name not required).');
+}
 function buildBlueprintTable() {
     return addJSDoc(exportInterface('BlueprintTable', [
-        addJSDoc(requiredProp('ref', t.tsStringKeyword()), 'Local reference key for this table (used by relations, indexes, fts).'),
         addJSDoc(requiredProp('table_name', t.tsStringKeyword()), 'The PostgreSQL table name to create.'),
+        addJSDoc(optionalProp('schema_name', t.tsStringKeyword()), 'Optional schema name (falls back to top-level default).'),
         addJSDoc(requiredProp('nodes', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintNode')))), "Array of node type entries that define the table's behavior."),
         addJSDoc(optionalProp('fields', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintField')))), 'Custom fields (columns) to add to the table.'),
         addJSDoc(optionalProp('policies', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintPolicy')))), 'RLS policies for this table.'),
         addJSDoc(optionalProp('grant_roles', t.tsArrayType(t.tsStringKeyword())), 'Database roles to grant privileges to. Defaults to ["authenticated"].'),
         addJSDoc(optionalProp('grants', t.tsArrayType(t.tsUnknownKeyword())), 'Privilege grants as [verb, column] tuples or objects. Defaults to empty (no grants — callers must explicitly specify).'),
         addJSDoc(optionalProp('use_rls', t.tsBooleanKeyword()), 'Whether to enable RLS on this table. Defaults to true.'),
+        addJSDoc(optionalProp('indexes', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintTableIndex')))), 'Table-level indexes (table_name inherited from parent).'),
+        addJSDoc(optionalProp('full_text_searches', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintTableFullTextSearch')))), 'Table-level full-text search configurations (table_name inherited from parent).'),
+        addJSDoc(optionalProp('unique_constraints', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintTableUniqueConstraint')))), 'Table-level unique constraints (table_name inherited from parent).'),
     ]), 'A table definition within a blueprint.');
 }
 function buildBlueprintDefinition() {
@@ -372,6 +405,7 @@ function buildBlueprintDefinition() {
         addJSDoc(optionalProp('relations', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintRelation')))), 'Relations between tables.'),
         addJSDoc(optionalProp('indexes', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintIndex')))), 'Indexes on table columns.'),
         addJSDoc(optionalProp('full_text_searches', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintFullTextSearch')))), 'Full-text search configurations.'),
+        addJSDoc(optionalProp('unique_constraints', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintUniqueConstraint')))), 'Unique constraints on table columns.'),
     ]), 'The complete blueprint definition -- the JSONB shape accepted by construct_blueprint().');
 }
 // ---------------------------------------------------------------------------
@@ -420,7 +454,11 @@ function buildProgram(meta) {
     statements.push(buildBlueprintPolicy(authzNodes, meta));
     statements.push(buildBlueprintFtsSource());
     statements.push(buildBlueprintFullTextSearch());
+    statements.push(buildBlueprintTableFullTextSearch());
     statements.push(buildBlueprintIndex(meta));
+    statements.push(buildBlueprintTableIndex());
+    statements.push(buildBlueprintUniqueConstraint());
+    statements.push(buildBlueprintTableUniqueConstraint());
     // -- Node types discriminated union --
     statements.push(sectionComment('Node types -- discriminated union for nodes[] entries'));
     statements.push(...buildNodeTypes(dataNodes));
@@ -438,7 +476,7 @@ function buildProgram(meta) {
         '// GENERATED FILE \u2014 DO NOT EDIT',
         '//',
         '// Regenerate with:',
-        '//   cd graphile/node-type-registry && pnpm generate:types',
+        '//   cd graphql/node-type-registry && pnpm generate:types',
         '//',
         '// These types match the JSONB shape expected by construct_blueprint().',
         '// All field names are snake_case to match the SQL convention.',

package/esm/blueprint-types.generated.d.ts

@@ -363,7 +363,7 @@ export interface RelationHasManyParams {
     delete_action: "c" | "r" | "n" | "d" | "a";
     is_required?: boolean;
 }
-/** Creates a junction table between source and target tables with auto-derived naming and FK fields. The trigger creates a bare table (no implicit DataId or any node_type), adds FK fields to both tables, optionally creates a composite PK (use_composite_key), then forwards all security config to secure_table_provision as-is. The trigger never injects values the caller did not provide. Junction table FKs always CASCADE on delete. */
+/** Creates a junction table between source and target tables with auto-derived naming and FK fields. The trigger creates a bare table (no implicit DataId), adds FK fields to both tables, optionally creates a composite PK (use_composite_key), then forwards all security config to secure_table_provision as-is. The trigger never injects values the caller did not provide. Junction table FKs always CASCADE on delete. */
 export interface RelationManyToManyParams {
     source_table_id: string;
     target_table_id: string;
@@ -372,10 +372,9 @@ export interface RelationManyToManyParams {
     source_field_name?: string;
     target_field_name?: string;
     use_composite_key?: boolean;
-    node_type?: string;
-    node_data?: {
+    nodes?: {
         [key: string]: unknown;
-    };
+    }[];
     grant_roles?: string[];
     grant_privileges?: string[][];
     policy_type?: string;
@@ -444,18 +443,18 @@ export interface BlueprintField {
     /** Comment/description for this field. */
     description?: string;
 }
-/** An RLS policy entry for a blueprint table. */
+/** An RLS policy entry for a blueprint table. Uses $type to match the blueprint JSON convention. */
 export interface BlueprintPolicy {
     /** Authz* policy type name (e.g., "AuthzDirectOwner", "AuthzAllowAll"). */
-    policy_type: "AuthzDirectOwner" | "AuthzDirectOwnerAny" | "AuthzMembership" | "AuthzEntityMembership" | "AuthzRelatedEntityMembership" | "AuthzOrgHierarchy" | "AuthzTemporal" | "AuthzPublishable" | "AuthzMemberList" | "AuthzRelatedMemberList" | "AuthzAllowAll" | "AuthzDenyAll" | "AuthzComposite" | "AuthzPeerOwnership" | "AuthzRelatedPeerOwnership";
+    $type: "AuthzDirectOwner" | "AuthzDirectOwnerAny" | "AuthzMembership" | "AuthzEntityMembership" | "AuthzRelatedEntityMembership" | "AuthzOrgHierarchy" | "AuthzTemporal" | "AuthzPublishable" | "AuthzMemberList" | "AuthzRelatedMemberList" | "AuthzAllowAll" | "AuthzDenyAll" | "AuthzComposite" | "AuthzPeerOwnership" | "AuthzRelatedPeerOwnership";
+    /** Privileges this policy applies to (e.g., ["select"], ["insert", "update", "delete"]). */
+    privileges?: string[];
+    /** Whether this policy is permissive (true) or restrictive (false). Defaults to true. */
+    permissive?: boolean;
     /** Role for this policy. Defaults to "authenticated". */
     policy_role?: string;
-    /** Whether this policy is permissive (true) or restrictive (false). */
-    permissive?: boolean;
     /** Optional custom name for this policy. */
     policy_name?: string;
-    /** Privileges this policy applies to. */
-    privileges?: string[];
     /** Policy-specific data (structure varies by policy type). */
     data?: Record<string, unknown>;
 }
@@ -468,19 +467,49 @@ export interface BlueprintFtsSource {
     /** Language for text search. Defaults to "english". */
     lang?: string;
 }
-/** A full-text search configuration for a blueprint table. */
+/** A full-text search configuration for a blueprint table (top-level, requires table_name). */
 export interface BlueprintFullTextSearch {
-    /** Reference key of the table this full-text search belongs to. */
-    table_ref: string;
+    /** Table name this full-text search belongs to. */
+    table_name: string;
+    /** Optional schema name for disambiguation (falls back to top-level default). */
+    schema_name?: string;
     /** Name of the tsvector field on the table. */
     field: string;
     /** Source fields that feed into this tsvector. */
     sources: BlueprintFtsSource[];
 }
-/** An index definition within a blueprint. */
+/** A full-text search configuration nested inside a table definition (table_name not required). */
+export interface BlueprintTableFullTextSearch {
+    /** Name of the tsvector field on the table. */
+    field: string;
+    /** Source fields that feed into this tsvector. */
+    sources: BlueprintFtsSource[];
+    /** Optional schema name override. */
+    schema_name?: string;
+}
+/** An index definition within a blueprint (top-level, requires table_name). */
 export interface BlueprintIndex {
-    /** Reference key of the table this index belongs to. */
-    table_ref: string;
+    /** Table name this index belongs to. */
+    table_name: string;
+    /** Optional schema name for disambiguation (falls back to top-level default). */
+    schema_name?: string;
+    /** Single column name for the index. */
+    column?: string;
+    /** Array of column names for a multi-column index. */
+    columns?: string[];
+    /** Index access method (e.g., "BTREE", "GIN", "GIST", "HNSW", "BM25"). */
+    access_method: string;
+    /** Whether this is a unique index. */
+    is_unique?: boolean;
+    /** Optional custom name for the index. */
+    name?: string;
+    /** Operator classes for the index columns. */
+    op_classes?: string[];
+    /** Additional index-specific options. */
+    options?: Record<string, unknown>;
+}
+/** An index definition nested inside a table definition (table_name not required). */
+export interface BlueprintTableIndex {
     /** Single column name for the index. */
     column?: string;
     /** Array of column names for a multi-column index. */
@@ -495,6 +524,24 @@ export interface BlueprintIndex {
     op_classes?: string[];
     /** Additional index-specific options. */
     options?: Record<string, unknown>;
+    /** Optional schema name override. */
+    schema_name?: string;
+}
+/** A unique constraint definition within a blueprint (top-level, requires table_name). */
+export interface BlueprintUniqueConstraint {
+    /** Table name this unique constraint belongs to. */
+    table_name: string;
+    /** Optional schema name for disambiguation (falls back to top-level default). */
+    schema_name?: string;
+    /** Column names that form the unique constraint. */
+    columns: string[];
+}
+/** A unique constraint nested inside a table definition (table_name not required). */
+export interface BlueprintTableUniqueConstraint {
+    /** Column names that form the unique constraint. */
+    columns: string[];
+    /** Optional schema name override. */
+    schema_name?: string;
 }
 /** String shorthand -- just the node type name. */
 export type BlueprintNodeShorthand = "AuthzDirectOwner" | "AuthzDirectOwnerAny" | "AuthzMembership" | "AuthzEntityMembership" | "AuthzRelatedEntityMembership" | "AuthzOrgHierarchy" | "AuthzTemporal" | "AuthzPublishable" | "AuthzMemberList" | "AuthzRelatedMemberList" | "AuthzAllowAll" | "AuthzDenyAll" | "AuthzComposite" | "AuthzPeerOwnership" | "AuthzRelatedPeerOwnership" | "DataId" | "DataDirectOwner" | "DataEntityMembership" | "DataOwnershipInEntity" | "DataTimestamps" | "DataPeoplestamps" | "DataPublishable" | "DataSoftDelete" | "DataEmbedding" | "DataFullTextSearch" | "DataBm25" | "DataSearch" | "DataPostGIS" | "DataPostGISAggregate" | "DataJobTrigger" | "DataTags" | "DataStatusField" | "DataJsonb" | "DataTrgm" | "DataSlug" | "DataInflection" | "DataOwnedFields" | "DataInheritFromParent" | "DataForceCurrentUser" | "DataImmutableFields" | "TableUserProfiles" | "TableOrganizationSettings" | "TableUserSettings";
@@ -634,27 +681,35 @@ export type BlueprintNode = BlueprintNodeShorthand | BlueprintNodeObject;
 /** A relation entry in a blueprint definition. */
 export type BlueprintRelation = {
     $type: "RelationBelongsTo";
-    source_ref: string;
-    target_ref: string;
+    source_table: string;
+    target_table: string;
+    source_schema_name?: string;
+    target_schema_name?: string;
 } & Partial<RelationBelongsToParams> | {
     $type: "RelationHasOne";
-    source_ref: string;
-    target_ref: string;
+    source_table: string;
+    target_table: string;
+    source_schema_name?: string;
+    target_schema_name?: string;
 } & Partial<RelationHasOneParams> | {
     $type: "RelationHasMany";
-    source_ref: string;
-    target_ref: string;
+    source_table: string;
+    target_table: string;
+    source_schema_name?: string;
+    target_schema_name?: string;
 } & Partial<RelationHasManyParams> | {
     $type: "RelationManyToMany";
-    source_ref: string;
-    target_ref: string;
+    source_table: string;
+    target_table: string;
+    source_schema_name?: string;
+    target_schema_name?: string;
 } & Partial<RelationManyToManyParams>;
 /** A table definition within a blueprint. */
 export interface BlueprintTable {
-    /** Local reference key for this table (used by relations, indexes, fts). */
-    ref: string;
     /** The PostgreSQL table name to create. */
     table_name: string;
+    /** Optional schema name (falls back to top-level default). */
+    schema_name?: string;
     /** Array of node type entries that define the table's behavior. */
     nodes: BlueprintNode[];
     /** Custom fields (columns) to add to the table. */
@@ -667,6 +722,12 @@ export interface BlueprintTable {
     grants?: unknown[];
     /** Whether to enable RLS on this table. Defaults to true. */
     use_rls?: boolean;
+    /** Table-level indexes (table_name inherited from parent). */
+    indexes?: BlueprintTableIndex[];
+    /** Table-level full-text search configurations (table_name inherited from parent). */
+    full_text_searches?: BlueprintTableFullTextSearch[];
+    /** Table-level unique constraints (table_name inherited from parent). */
+    unique_constraints?: BlueprintTableUniqueConstraint[];
 }
 /** The complete blueprint definition -- the JSONB shape accepted by construct_blueprint(). */
 export interface BlueprintDefinition {
@@ -678,4 +739,6 @@ export interface BlueprintDefinition {
     indexes?: BlueprintIndex[];
     /** Full-text search configurations. */
     full_text_searches?: BlueprintFullTextSearch[];
+    /** Unique constraints on table columns. */
+    unique_constraints?: BlueprintUniqueConstraint[];
 }

package/esm/blueprint-types.generated.js

@@ -1,7 +1,7 @@
 // GENERATED FILE — DO NOT EDIT
 //
 // Regenerate with:
-//   cd graphile/node-type-registry && pnpm generate:types
+//   cd graphql/node-type-registry && pnpm generate:types
 //
 // These types match the JSONB shape expected by construct_blueprint().
 // All field names are snake_case to match the SQL convention.

package/esm/codegen/generate-seed.js

@@ -126,7 +126,7 @@ const GENERATED_HEADER = [
     '-- GENERATED FILE — DO NOT EDIT',
     '--',
     '-- Regenerate with:',
-    '--   cd graphile/node-type-registry && pnpm generate:seed --pgpm ../../constructive-db/packages/metaschema',
+    '--   cd graphql/node-type-registry && pnpm generate:seed --pgpm ../../constructive-db/packages/metaschema',
     '--',
     '',
 ].join('\n');

package/esm/codegen/generate-types.d.ts

@@ -6,7 +6,7 @@
  *
  *   - Per-node-type parameter interfaces (via schema-typescript)
  *   - BlueprintNode  -- discriminated union of all non-relation node types
- *   - BlueprintRelation -- typed relation entries with $type, source_ref, target_ref
+ *   - BlueprintRelation -- typed relation entries with $type, source_table, target_table
  *   - BlueprintTable, BlueprintField, BlueprintPolicy, BlueprintIndex, etc.
  *   - BlueprintDefinition -- the top-level type matching the JSONB shape
  *

package/esm/codegen/generate-types.js

@@ -6,7 +6,7 @@
  *
  *   - Per-node-type parameter interfaces (via schema-typescript)
  *   - BlueprintNode  -- discriminated union of all non-relation node types
- *   - BlueprintRelation -- typed relation entries with $type, source_ref, target_ref
+ *   - BlueprintRelation -- typed relation entries with $type, source_table, target_table
  *   - BlueprintTable, BlueprintField, BlueprintPolicy, BlueprintIndex, etc.
  *   - BlueprintDefinition -- the top-level type matching the JSONB shape
  *
@@ -211,28 +211,22 @@ function buildBlueprintField(meta) {
         addJSDoc(optionalProp('description', t.tsStringKeyword()), 'Comment/description for this field.'),
     ]), 'A custom field (column) to add to a blueprint table.');
 }
-function buildBlueprintPolicy(authzNodes, meta) {
+function buildBlueprintPolicy(authzNodes, _meta) {
+    // BlueprintPolicy represents the blueprint JSON shape (not the DB table).
+    // The SQL procedure reads $type (not policy_type) from the JSONB:
+    //   v_policy_type := v_policy_entry->>'$type';
+    // So we always use the static definition with $type.
     const policyTypeAnnotation = authzNodes.length > 0
         ? strUnion(authzNodes.map((nt) => nt.name))
         : t.tsStringKeyword();
-    const table = meta && findTable(meta, 'metaschema_public', 'policy');
-    if (table) {
-        return deriveInterfaceFromTable(table, 'BlueprintPolicy', 'An RLS policy entry for a blueprint table. Derived from _meta.', {
-            // policy_type gets a typed union of known Authz* node names
-            policy_type: policyTypeAnnotation,
-            // data is untyped JSONB — use Record<string, unknown>
-            data: recordType(t.tsStringKeyword(), t.tsUnknownKeyword()),
-        });
-    }
-    // Static fallback
     return addJSDoc(exportInterface('BlueprintPolicy', [
-        addJSDoc(requiredProp('policy_type', policyTypeAnnotation), 'Authz* policy type name (e.g., "AuthzDirectOwner", "AuthzAllowAll").'),
+        addJSDoc(requiredProp('$type', policyTypeAnnotation), 'Authz* policy type name (e.g., "AuthzDirectOwner", "AuthzAllowAll").'),
+        addJSDoc(optionalProp('privileges', t.tsArrayType(t.tsStringKeyword())), 'Privileges this policy applies to (e.g., ["select"], ["insert", "update", "delete"]).'),
+        addJSDoc(optionalProp('permissive', t.tsBooleanKeyword()), 'Whether this policy is permissive (true) or restrictive (false). Defaults to true.'),
         addJSDoc(optionalProp('policy_role', t.tsStringKeyword()), 'Role for this policy. Defaults to "authenticated".'),
-        addJSDoc(optionalProp('permissive', t.tsBooleanKeyword()), 'Whether this policy is permissive (true) or restrictive (false).'),
         addJSDoc(optionalProp('policy_name', t.tsStringKeyword()), 'Optional custom name for this policy.'),
-        addJSDoc(optionalProp('privileges', t.tsArrayType(t.tsStringKeyword())), 'Privileges this policy applies to.'),
         addJSDoc(optionalProp('data', recordType(t.tsStringKeyword(), t.tsUnknownKeyword())), 'Policy-specific data (structure varies by policy type).'),
-    ]), 'An RLS policy entry for a blueprint table.');
+    ]), 'An RLS policy entry for a blueprint table. Uses $type to match the blueprint JSON convention.');
 }
 function buildBlueprintFtsSource() {
     return addJSDoc(exportInterface('BlueprintFtsSource', [
@@ -243,10 +237,18 @@ function buildBlueprintFtsSource() {
 }
 function buildBlueprintFullTextSearch() {
     return addJSDoc(exportInterface('BlueprintFullTextSearch', [
-        addJSDoc(requiredProp('table_ref', t.tsStringKeyword()), 'Reference key of the table this full-text search belongs to.'),
+        addJSDoc(requiredProp('table_name', t.tsStringKeyword()), 'Table name this full-text search belongs to.'),
+        addJSDoc(optionalProp('schema_name', t.tsStringKeyword()), 'Optional schema name for disambiguation (falls back to top-level default).'),
         addJSDoc(requiredProp('field', t.tsStringKeyword()), 'Name of the tsvector field on the table.'),
         addJSDoc(requiredProp('sources', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintFtsSource')))), 'Source fields that feed into this tsvector.'),
-    ]), 'A full-text search configuration for a blueprint table.');
+    ]), 'A full-text search configuration for a blueprint table (top-level, requires table_name).');
+}
+function buildBlueprintTableFullTextSearch() {
+    return addJSDoc(exportInterface('BlueprintTableFullTextSearch', [
+        addJSDoc(requiredProp('field', t.tsStringKeyword()), 'Name of the tsvector field on the table.'),
+        addJSDoc(requiredProp('sources', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintFtsSource')))), 'Source fields that feed into this tsvector.'),
+        addJSDoc(optionalProp('schema_name', t.tsStringKeyword()), 'Optional schema name override.'),
+    ]), 'A full-text search configuration nested inside a table definition (table_name not required).');
 }
 function buildBlueprintIndex(meta) {
     const table = meta && findTable(meta, 'metaschema_public', 'index');
@@ -260,7 +262,8 @@ function buildBlueprintIndex(meta) {
     }
     // Static fallback
     return addJSDoc(exportInterface('BlueprintIndex', [
-        addJSDoc(requiredProp('table_ref', t.tsStringKeyword()), 'Reference key of the table this index belongs to.'),
+        addJSDoc(requiredProp('table_name', t.tsStringKeyword()), 'Table name this index belongs to.'),
+        addJSDoc(optionalProp('schema_name', t.tsStringKeyword()), 'Optional schema name for disambiguation (falls back to top-level default).'),
         addJSDoc(optionalProp('column', t.tsStringKeyword()), 'Single column name for the index.'),
         addJSDoc(optionalProp('columns', t.tsArrayType(t.tsStringKeyword())), 'Array of column names for a multi-column index.'),
         addJSDoc(requiredProp('access_method', t.tsStringKeyword()), 'Index access method (e.g., "BTREE", "GIN", "GIST", "HNSW", "BM25").'),
@@ -268,7 +271,19 @@ function buildBlueprintIndex(meta) {
         addJSDoc(optionalProp('name', t.tsStringKeyword()), 'Optional custom name for the index.'),
         addJSDoc(optionalProp('op_classes', t.tsArrayType(t.tsStringKeyword())), 'Operator classes for the index columns.'),
         addJSDoc(optionalProp('options', recordType(t.tsStringKeyword(), t.tsUnknownKeyword())), 'Additional index-specific options.'),
-    ]), 'An index definition within a blueprint.');
+    ]), 'An index definition within a blueprint (top-level, requires table_name).');
+}
+function buildBlueprintTableIndex() {
+    return addJSDoc(exportInterface('BlueprintTableIndex', [
+        addJSDoc(optionalProp('column', t.tsStringKeyword()), 'Single column name for the index.'),
+        addJSDoc(optionalProp('columns', t.tsArrayType(t.tsStringKeyword())), 'Array of column names for a multi-column index.'),
+        addJSDoc(requiredProp('access_method', t.tsStringKeyword()), 'Index access method (e.g., "BTREE", "GIN", "GIST", "HNSW", "BM25").'),
+        addJSDoc(optionalProp('is_unique', t.tsBooleanKeyword()), 'Whether this is a unique index.'),
+        addJSDoc(optionalProp('name', t.tsStringKeyword()), 'Optional custom name for the index.'),
+        addJSDoc(optionalProp('op_classes', t.tsArrayType(t.tsStringKeyword())), 'Operator classes for the index columns.'),
+        addJSDoc(optionalProp('options', recordType(t.tsStringKeyword(), t.tsUnknownKeyword())), 'Additional index-specific options.'),
+        addJSDoc(optionalProp('schema_name', t.tsStringKeyword()), 'Optional schema name override.'),
+    ]), 'An index definition nested inside a table definition (table_name not required).');
 }
 // ---------------------------------------------------------------------------
 // Node type discriminated unions
@@ -304,8 +319,10 @@ function buildRelationTypes(relationNodes) {
     const relationMembers = relationNodes.map((nt) => {
         const baseType = t.tsTypeLiteral([
             requiredProp('$type', strLit(nt.name)),
-            requiredProp('source_ref', t.tsStringKeyword()),
-            requiredProp('target_ref', t.tsStringKeyword()),
+            requiredProp('source_table', t.tsStringKeyword()),
+            requiredProp('target_table', t.tsStringKeyword()),
+            optionalProp('source_schema_name', t.tsStringKeyword()),
+            optionalProp('target_schema_name', t.tsStringKeyword()),
         ]);
         return t.tsIntersectionType([
             baseType,
@@ -319,16 +336,32 @@ function buildRelationTypes(relationNodes) {
 // ---------------------------------------------------------------------------
 // BlueprintTable and BlueprintDefinition
 // ---------------------------------------------------------------------------
+function buildBlueprintUniqueConstraint() {
+    return addJSDoc(exportInterface('BlueprintUniqueConstraint', [
+        addJSDoc(requiredProp('table_name', t.tsStringKeyword()), 'Table name this unique constraint belongs to.'),
+        addJSDoc(optionalProp('schema_name', t.tsStringKeyword()), 'Optional schema name for disambiguation (falls back to top-level default).'),
+        addJSDoc(requiredProp('columns', t.tsArrayType(t.tsStringKeyword())), 'Column names that form the unique constraint.'),
+    ]), 'A unique constraint definition within a blueprint (top-level, requires table_name).');
+}
+function buildBlueprintTableUniqueConstraint() {
+    return addJSDoc(exportInterface('BlueprintTableUniqueConstraint', [
+        addJSDoc(requiredProp('columns', t.tsArrayType(t.tsStringKeyword())), 'Column names that form the unique constraint.'),
+        addJSDoc(optionalProp('schema_name', t.tsStringKeyword()), 'Optional schema name override.'),
+    ]), 'A unique constraint nested inside a table definition (table_name not required).');
+}
 function buildBlueprintTable() {
     return addJSDoc(exportInterface('BlueprintTable', [
-        addJSDoc(requiredProp('ref', t.tsStringKeyword()), 'Local reference key for this table (used by relations, indexes, fts).'),
         addJSDoc(requiredProp('table_name', t.tsStringKeyword()), 'The PostgreSQL table name to create.'),
+        addJSDoc(optionalProp('schema_name', t.tsStringKeyword()), 'Optional schema name (falls back to top-level default).'),
         addJSDoc(requiredProp('nodes', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintNode')))), "Array of node type entries that define the table's behavior."),
         addJSDoc(optionalProp('fields', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintField')))), 'Custom fields (columns) to add to the table.'),
         addJSDoc(optionalProp('policies', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintPolicy')))), 'RLS policies for this table.'),
         addJSDoc(optionalProp('grant_roles', t.tsArrayType(t.tsStringKeyword())), 'Database roles to grant privileges to. Defaults to ["authenticated"].'),
         addJSDoc(optionalProp('grants', t.tsArrayType(t.tsUnknownKeyword())), 'Privilege grants as [verb, column] tuples or objects. Defaults to empty (no grants — callers must explicitly specify).'),
         addJSDoc(optionalProp('use_rls', t.tsBooleanKeyword()), 'Whether to enable RLS on this table. Defaults to true.'),
+        addJSDoc(optionalProp('indexes', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintTableIndex')))), 'Table-level indexes (table_name inherited from parent).'),
+        addJSDoc(optionalProp('full_text_searches', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintTableFullTextSearch')))), 'Table-level full-text search configurations (table_name inherited from parent).'),
+        addJSDoc(optionalProp('unique_constraints', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintTableUniqueConstraint')))), 'Table-level unique constraints (table_name inherited from parent).'),
     ]), 'A table definition within a blueprint.');
 }
 function buildBlueprintDefinition() {
@@ -337,6 +370,7 @@ function buildBlueprintDefinition() {
         addJSDoc(optionalProp('relations', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintRelation')))), 'Relations between tables.'),
         addJSDoc(optionalProp('indexes', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintIndex')))), 'Indexes on table columns.'),
         addJSDoc(optionalProp('full_text_searches', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintFullTextSearch')))), 'Full-text search configurations.'),
+        addJSDoc(optionalProp('unique_constraints', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintUniqueConstraint')))), 'Unique constraints on table columns.'),
     ]), 'The complete blueprint definition -- the JSONB shape accepted by construct_blueprint().');
 }
 // ---------------------------------------------------------------------------
@@ -385,7 +419,11 @@ function buildProgram(meta) {
     statements.push(buildBlueprintPolicy(authzNodes, meta));
     statements.push(buildBlueprintFtsSource());
     statements.push(buildBlueprintFullTextSearch());
+    statements.push(buildBlueprintTableFullTextSearch());
     statements.push(buildBlueprintIndex(meta));
+    statements.push(buildBlueprintTableIndex());
+    statements.push(buildBlueprintUniqueConstraint());
+    statements.push(buildBlueprintTableUniqueConstraint());
     // -- Node types discriminated union --
     statements.push(sectionComment('Node types -- discriminated union for nodes[] entries'));
     statements.push(...buildNodeTypes(dataNodes));
@@ -403,7 +441,7 @@ function buildProgram(meta) {
         '// GENERATED FILE \u2014 DO NOT EDIT',
         '//',
         '// Regenerate with:',
-        '//   cd graphile/node-type-registry && pnpm generate:types',
+        '//   cd graphql/node-type-registry && pnpm generate:types',
         '//',
         '// These types match the JSONB shape expected by construct_blueprint().',
         '// All field names are snake_case to match the SQL convention.',

package/esm/relation/relation-many-to-many.js

@@ -3,7 +3,7 @@ export const RelationManyToMany = {
     "slug": "relation_many_to_many",
     "category": "relation",
     "display_name": "Many to Many",
-    "description": "Creates a junction table between source and target tables with auto-derived naming and FK fields. The trigger creates a bare table (no implicit DataId or any node_type), adds FK fields to both tables, optionally creates a composite PK (use_composite_key), then forwards all security config to secure_table_provision as-is. The trigger never injects values the caller did not provide. Junction table FKs always CASCADE on delete.",
+    "description": "Creates a junction table between source and target tables with auto-derived naming and FK fields. The trigger creates a bare table (no implicit DataId), adds FK fields to both tables, optionally creates a composite PK (use_composite_key), then forwards all security config to secure_table_provision as-is. The trigger never injects values the caller did not provide. Junction table FKs always CASCADE on delete.",
     "parameter_schema": {
         "type": "object",
         "properties": {
@@ -36,16 +36,15 @@ export const RelationManyToMany = {
             },
             "use_composite_key": {
                 "type": "boolean",
-                "description": "When true, creates a composite PK from the two FK fields. When false, no PK is created by the trigger (use node_type=DataId for UUID PK). Mutually exclusive with node_type=DataId.",
+                "description": "When true, creates a composite PK from the two FK fields. When false, no PK is created by the trigger (use nodes with DataId for UUID PK). Mutually exclusive with nodes containing DataId.",
                 "default": false
             },
-            "node_type": {
-                "type": "string",
-                "description": "Generator for field creation on junction table. Forwarded to secure_table_provision as-is. Examples: DataId, DataEntityMembership, DataDirectOwner. NULL means no additional fields."
-            },
-            "node_data": {
-                "type": "object",
-                "description": "Configuration for the generator. Forwarded to secure_table_provision as-is. Only used when node_type is set."
+            "nodes": {
+                "type": "array",
+                "items": {
+                    "type": "object"
+                },
+                "description": "Array of node objects for field creation on junction table. Each object has a $type key (e.g. DataId, DataEntityMembership) and optional data keys. Forwarded to secure_table_provision as-is. Empty array means no additional fields."
             },
             "grant_roles": {
                 "type": "array",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "node-type-registry",
-  "version": "0.7.1",
+  "version": "0.9.0",
   "description": "Node type definitions for the Constructive blueprint system. Single source of truth for all Authz*, Data*, Relation*, and View* node types.",
   "author": "Constructive <developers@constructive.io>",
   "main": "index.js",
@@ -48,5 +48,5 @@
     "registry",
     "graphile"
   ],
-  "gitHead": "d0d8f5ca5828ad3efba5f607bc699a8d520e4603"
+  "gitHead": "fc23b83307d007a14e54b1d0fc36614b9650a5dc"
 }

package/relation/relation-many-to-many.js

@@ -6,7 +6,7 @@ exports.RelationManyToMany = {
     "slug": "relation_many_to_many",
     "category": "relation",
     "display_name": "Many to Many",
-    "description": "Creates a junction table between source and target tables with auto-derived naming and FK fields. The trigger creates a bare table (no implicit DataId or any node_type), adds FK fields to both tables, optionally creates a composite PK (use_composite_key), then forwards all security config to secure_table_provision as-is. The trigger never injects values the caller did not provide. Junction table FKs always CASCADE on delete.",
+    "description": "Creates a junction table between source and target tables with auto-derived naming and FK fields. The trigger creates a bare table (no implicit DataId), adds FK fields to both tables, optionally creates a composite PK (use_composite_key), then forwards all security config to secure_table_provision as-is. The trigger never injects values the caller did not provide. Junction table FKs always CASCADE on delete.",
     "parameter_schema": {
         "type": "object",
         "properties": {
@@ -39,16 +39,15 @@ exports.RelationManyToMany = {
             },
             "use_composite_key": {
                 "type": "boolean",
-                "description": "When true, creates a composite PK from the two FK fields. When false, no PK is created by the trigger (use node_type=DataId for UUID PK). Mutually exclusive with node_type=DataId.",
+                "description": "When true, creates a composite PK from the two FK fields. When false, no PK is created by the trigger (use nodes with DataId for UUID PK). Mutually exclusive with nodes containing DataId.",
                 "default": false
             },
-            "node_type": {
-                "type": "string",
-                "description": "Generator for field creation on junction table. Forwarded to secure_table_provision as-is. Examples: DataId, DataEntityMembership, DataDirectOwner. NULL means no additional fields."
-            },
-            "node_data": {
-                "type": "object",
-                "description": "Configuration for the generator. Forwarded to secure_table_provision as-is. Only used when node_type is set."
+            "nodes": {
+                "type": "array",
+                "items": {
+                    "type": "object"
+                },
+                "description": "Array of node objects for field creation on junction table. Each object has a $type key (e.g. DataId, DataEntityMembership) and optional data keys. Forwarded to secure_table_provision as-is. Empty array means no additional fields."
             },
             "grant_roles": {
                 "type": "array",