feat: add table-level BlueprintTableIndex, BlueprintTableFullTextSearch, BlueprintTableUniqueConstraint types

- BlueprintTable now supports nested indexes[], full_text_searches[], unique_constraints[]
- Table-level types omit table_name (inherited from parent table)
- Top-level types still require table_name
- Updated codegen to generate all three table-level type variants
- Matches the three-tier blueprint definition system in construct_blueprint()

Author: pyramation

graphql/node-type-registry/src/blueprint-types.generated.ts

@@ -707,7 +707,7 @@ 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 {
   /** Table name this full-text search belongs to. */
   table_name: string;
@@ -718,7 +718,16 @@ export interface BlueprintFullTextSearch {
   /** 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 {
   /** Table name this index belongs to. */
   table_name: string;
@@ -739,6 +748,25 @@ export interface BlueprintIndex {
   /** 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. */
+  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>;
+  /** Optional schema name override. */
+  schema_name?: string;
+}
 /**
  * ===========================================================================
  * Node types -- discriminated union for nodes[] entries
@@ -918,7 +946,7 @@ export type BlueprintRelation = {
  * ===========================================================================
  */
 ;
-/** A unique constraint definition within a blueprint. */
+/** 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;
@@ -927,6 +955,13 @@ export interface BlueprintUniqueConstraint {
   /** 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;
+}
 /** A table definition within a blueprint. */
 export interface BlueprintTable {
   /** The PostgreSQL table name to create. */
@@ -945,6 +980,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 {

graphql/node-type-registry/src/codegen/generate-types.ts

@@ -402,7 +402,30 @@ function buildBlueprintFullTextSearch(): t.ExportNamedDeclaration {
         '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(): t.ExportNamedDeclaration {
+  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).'
   );
 }
 
@@ -436,7 +459,23 @@ function buildBlueprintIndex(
       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(): t.ExportNamedDeclaration {
+  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).'
   );
 }
 
@@ -551,7 +590,23 @@ function buildBlueprintUniqueConstraint(): t.ExportNamedDeclaration {
         'Column names that form the unique constraint.'
       ),
     ]),
-    'A unique constraint definition within a blueprint.'
+    'A unique constraint definition within a blueprint (top-level, requires table_name).'
+  );
+}
+
+function buildBlueprintTableUniqueConstraint(): t.ExportNamedDeclaration {
+  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).'
   );
 }
 
@@ -599,6 +654,27 @@ function buildBlueprintTable(): t.ExportNamedDeclaration {
         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.'
   );
@@ -712,8 +788,11 @@ function buildProgram(meta?: MetaTableInfo[]): string {
   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(