node-type-registry 0.18.1 → 0.20.0

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

@@ -1,89 +1,91 @@
 export const RelationManyToMany = {
-    "name": "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), 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": {
-            "source_table_id": {
-                "type": "string",
-                "format": "uuid",
-                "description": "First table in the M:N relationship"
+    name: '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), 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: {
+            source_table_id: {
+                type: 'string',
+                format: 'uuid',
+                description: 'First table in the M:N relationship'
             },
-            "target_table_id": {
-                "type": "string",
-                "format": "uuid",
-                "description": "Second table in the M:N relationship"
+            target_table_id: {
+                type: 'string',
+                format: 'uuid',
+                description: 'Second table in the M:N relationship'
             },
-            "junction_table_id": {
-                "type": "string",
-                "format": "uuid",
-                "description": "Existing junction table to use. If uuid_nil(), a new bare table is created"
+            junction_table_id: {
+                type: 'string',
+                format: 'uuid',
+                description: 'Existing junction table to use. If uuid_nil(), a new bare table is created'
             },
-            "junction_table_name": {
-                "type": "string",
-                "description": "Junction table name. Auto-derived from both table names if omitted (e.g., projects + tags derives project_tags)"
+            junction_table_name: {
+                type: 'string',
+                description: 'Junction table name. Auto-derived from both table names if omitted (e.g., projects + tags derives project_tags)'
             },
-            "source_field_name": {
-                "type": "string",
-                "description": "FK field name on junction for source table. Auto-derived if omitted (e.g., projects derives project_id)"
+            source_field_name: {
+                type: 'string',
+                format: 'column-ref',
+                description: 'FK field name on junction for source table. Auto-derived if omitted (e.g., projects derives project_id)'
             },
-            "target_field_name": {
-                "type": "string",
-                "description": "FK field name on junction for target table. Auto-derived if omitted (e.g., tags derives tag_id)"
+            target_field_name: {
+                type: 'string',
+                format: 'column-ref',
+                description: 'FK field name on junction for target table. Auto-derived if omitted (e.g., tags derives tag_id)'
             },
-            "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 nodes with DataId for UUID PK). Mutually exclusive with nodes containing DataId.",
-                "default": false
+            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 nodes with DataId for UUID PK). Mutually exclusive with nodes containing DataId.',
+                default: false
             },
-            "nodes": {
-                "type": "array",
-                "items": {
-                    "type": "object"
+            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."
+                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.'
             },
-            "grants": {
-                "type": "array",
-                "items": {
-                    "type": "object",
-                    "properties": {
-                        "roles": { "type": "array", "items": { "type": "string" } },
-                        "privileges": { "type": "array", "items": { "type": "array", "items": { "type": "string" } } }
+            grants: {
+                type: 'array',
+                items: {
+                    type: 'object',
+                    properties: {
+                        roles: { type: 'array', items: { type: 'string' } },
+                        privileges: { type: 'array', items: { type: 'array', items: { type: 'string' } } }
                     },
-                    "required": ["roles", "privileges"]
+                    required: ['roles', 'privileges']
                 },
-                "description": "Unified grant objects for the junction table. Each entry is { roles: string[], privileges: string[][] }. Forwarded to secure_table_provision as-is. Default: []"
+                description: 'Unified grant objects for the junction table. Each entry is { roles: string[], privileges: string[][] }. Forwarded to secure_table_provision as-is. Default: []'
             },
-            "policies": {
-                "type": "array",
-                "items": {
-                    "type": "object",
-                    "properties": {
-                        "$type": { "type": "string" },
-                        "data": { "type": "object" },
-                        "privileges": { "type": "array", "items": { "type": "string" } },
-                        "policy_role": { "type": "string" },
-                        "permissive": { "type": "boolean" },
-                        "policy_name": { "type": "string" }
+            policies: {
+                type: 'array',
+                items: {
+                    type: 'object',
+                    properties: {
+                        $type: { type: 'string' },
+                        data: { type: 'object' },
+                        privileges: { type: 'array', items: { type: 'string' } },
+                        policy_role: { type: 'string' },
+                        permissive: { type: 'boolean' },
+                        policy_name: { type: 'string' }
                     },
-                    "required": ["$type"]
+                    required: ['$type']
                 },
-                "description": "RLS policy objects for the junction table. Each entry has $type (Authz* generator), optional data, privileges, policy_role, permissive, policy_name. Forwarded to secure_table_provision as-is. Default: []"
+                description: 'RLS policy objects for the junction table. Each entry has $type (Authz* generator), optional data, privileges, policy_role, permissive, policy_name. Forwarded to secure_table_provision as-is. Default: []'
             }
         },
-        "required": [
-            "source_table_id",
-            "target_table_id"
+        required: [
+            'source_table_id',
+            'target_table_id'
         ]
     },
-    "tags": [
-        "relation",
-        "junction",
-        "many_to_many",
-        "schema"
+    tags: [
+        'relation',
+        'junction',
+        'many_to_many',
+        'schema'
     ]
 };

package/esm/relation/relation-spatial.js

@@ -1,68 +1,68 @@
 export const RelationSpatial = {
-    "name": "RelationSpatial",
-    "slug": "relation_spatial",
-    "category": "relation",
-    "display_name": "Spatial Relation",
-    "description": "Declares a spatial predicate between two existing geometry/geography columns. Inserts a metaschema_public.spatial_relation row; the sync_spatial_relation_tags trigger then projects a @spatialRelation smart tag onto the owner column so graphile-postgis' PostgisSpatialRelationsPlugin can expose it as a cross-table filter in GraphQL. Metadata-only: both source_field and target_field must already exist on their tables. Idempotent on (source_table_id, name). One direction per tag — author two RelationSpatial entries if symmetry is desired.",
-    "parameter_schema": {
-        "type": "object",
-        "properties": {
-            "source_table_id": {
-                "type": "string",
-                "format": "uuid",
-                "description": "Table that owns the relation (the @spatialRelation tag is emitted on the owner column of this table)"
+    name: 'RelationSpatial',
+    slug: 'relation_spatial',
+    category: 'relation',
+    display_name: 'Spatial Relation',
+    description: "Declares a spatial predicate between two existing geometry/geography columns. Inserts a metaschema_public.spatial_relation row; the sync_spatial_relation_tags trigger then projects a @spatialRelation smart tag onto the owner column so graphile-postgis' PostgisSpatialRelationsPlugin can expose it as a cross-table filter in GraphQL. Metadata-only: both source_field and target_field must already exist on their tables. Idempotent on (source_table_id, name). One direction per tag — author two RelationSpatial entries if symmetry is desired.",
+    parameter_schema: {
+        type: 'object',
+        properties: {
+            source_table_id: {
+                type: 'string',
+                format: 'uuid',
+                description: 'Table that owns the relation (the @spatialRelation tag is emitted on the owner column of this table)'
             },
-            "source_field_id": {
-                "type": "string",
-                "format": "uuid",
-                "description": "Geometry/geography column on source_table that carries the @spatialRelation smart tag"
+            source_field_id: {
+                type: 'string',
+                format: 'uuid',
+                description: 'Geometry/geography column on source_table that carries the @spatialRelation smart tag'
             },
-            "target_table_id": {
-                "type": "string",
-                "format": "uuid",
-                "description": "Table being referenced by the spatial predicate"
+            target_table_id: {
+                type: 'string',
+                format: 'uuid',
+                description: 'Table being referenced by the spatial predicate'
             },
-            "target_field_id": {
-                "type": "string",
-                "format": "uuid",
-                "description": "Geometry/geography column on target_table that the predicate is evaluated against"
+            target_field_id: {
+                type: 'string',
+                format: 'uuid',
+                description: 'Geometry/geography column on target_table that the predicate is evaluated against'
             },
-            "name": {
-                "type": "string",
-                "description": "Relation name (stable, snake_case). Becomes the generated filter field name in GraphQL (e.g. nearby_clinic). Unique per (source_table_id, name) — idempotency key."
+            name: {
+                type: 'string',
+                description: 'Relation name (stable, snake_case). Becomes the generated filter field name in GraphQL (e.g. nearby_clinic). Unique per (source_table_id, name) — idempotency key.'
             },
-            "operator": {
-                "type": "string",
-                "enum": [
-                    "st_contains",
-                    "st_within",
-                    "st_intersects",
-                    "st_covers",
-                    "st_coveredby",
-                    "st_overlaps",
-                    "st_touches",
-                    "st_dwithin"
+            operator: {
+                type: 'string',
+                enum: [
+                    'st_contains',
+                    'st_within',
+                    'st_intersects',
+                    'st_covers',
+                    'st_coveredby',
+                    'st_overlaps',
+                    'st_touches',
+                    'st_dwithin'
                 ],
-                "description": "PostGIS spatial predicate. One of the 8 whitelisted operators. st_dwithin requires param_name."
+                description: 'PostGIS spatial predicate. One of the 8 whitelisted operators. st_dwithin requires param_name.'
             },
-            "param_name": {
-                "type": "string",
-                "description": "Parameter name for parametric operators (currently only st_dwithin, which needs a distance argument). Must be NULL for all other operators. Enforced by table CHECK."
+            param_name: {
+                type: 'string',
+                description: 'Parameter name for parametric operators (currently only st_dwithin, which needs a distance argument). Must be NULL for all other operators. Enforced by table CHECK.'
             }
         },
-        "required": [
-            "source_table_id",
-            "source_field_id",
-            "target_table_id",
-            "target_field_id",
-            "name",
-            "operator"
+        required: [
+            'source_table_id',
+            'source_field_id',
+            'target_table_id',
+            'target_field_id',
+            'name',
+            'operator'
         ]
     },
-    "tags": [
-        "relation",
-        "spatial",
-        "postgis",
-        "schema"
+    tags: [
+        'relation',
+        'spatial',
+        'postgis',
+        'schema'
     ]
 };

package/esm/view/index.d.ts

@@ -1,5 +1,5 @@
-export { ViewTableProjection } from './view-table-projection';
-export { ViewFilteredTable } from './view-filtered-table';
-export { ViewJoinedTables } from './view-joined-tables';
 export { ViewAggregated } from './view-aggregated';
 export { ViewComposite } from './view-composite';
+export { ViewFilteredTable } from './view-filtered-table';
+export { ViewJoinedTables } from './view-joined-tables';
+export { ViewTableProjection } from './view-table-projection';

package/esm/view/index.js

@@ -1,5 +1,5 @@
-export { ViewTableProjection } from './view-table-projection';
-export { ViewFilteredTable } from './view-filtered-table';
-export { ViewJoinedTables } from './view-joined-tables';
 export { ViewAggregated } from './view-aggregated';
 export { ViewComposite } from './view-composite';
+export { ViewFilteredTable } from './view-filtered-table';
+export { ViewJoinedTables } from './view-joined-tables';
+export { ViewTableProjection } from './view-table-projection';

package/esm/view/view-aggregated.js

@@ -1,65 +1,67 @@
 export const ViewAggregated = {
-    "name": "ViewAggregated",
-    "slug": "view_aggregated",
-    "category": "view",
-    "display_name": "Aggregated View",
-    "description": "View with GROUP BY and aggregate functions. Useful for summary/reporting views.",
-    "parameter_schema": {
-        "type": "object",
-        "properties": {
-            "source_table_id": {
-                "type": "string",
-                "format": "uuid",
-                "description": "UUID of the source table"
+    name: 'ViewAggregated',
+    slug: 'view_aggregated',
+    category: 'view',
+    display_name: 'Aggregated View',
+    description: 'View with GROUP BY and aggregate functions. Useful for summary/reporting views.',
+    parameter_schema: {
+        type: 'object',
+        properties: {
+            source_table_id: {
+                type: 'string',
+                format: 'uuid',
+                description: 'UUID of the source table'
             },
-            "group_by_fields": {
-                "type": "array",
-                "items": {
-                    "type": "string"
+            group_by_fields: {
+                type: 'array',
+                items: {
+                    type: 'string',
+                    format: 'column-ref'
                 },
-                "description": "Field names to group by"
+                description: 'Field names to group by'
             },
-            "aggregates": {
-                "type": "array",
-                "items": {
-                    "type": "object",
-                    "properties": {
-                        "function": {
-                            "type": "string",
-                            "enum": [
-                                "COUNT",
-                                "SUM",
-                                "AVG",
-                                "MIN",
-                                "MAX"
+            aggregates: {
+                type: 'array',
+                items: {
+                    type: 'object',
+                    properties: {
+                        function: {
+                            type: 'string',
+                            enum: [
+                                'COUNT',
+                                'SUM',
+                                'AVG',
+                                'MIN',
+                                'MAX'
                             ]
                         },
-                        "field": {
-                            "type": "string",
-                            "description": "Field to aggregate (or * for COUNT)"
+                        field: {
+                            type: 'string',
+                            format: 'column-ref',
+                            description: 'Field to aggregate (or * for COUNT)'
                         },
-                        "alias": {
-                            "type": "string",
-                            "description": "Output column name"
+                        alias: {
+                            type: 'string',
+                            description: 'Output column name'
                         }
                     },
-                    "required": [
-                        "function",
-                        "alias"
+                    required: [
+                        'function',
+                        'alias'
                     ]
                 },
-                "description": "Array of aggregate specifications"
+                description: 'Array of aggregate specifications'
             }
         },
-        "required": [
-            "source_table_id",
-            "group_by_fields",
-            "aggregates"
+        required: [
+            'source_table_id',
+            'group_by_fields',
+            'aggregates'
         ]
     },
-    "tags": [
-        "view",
-        "aggregate",
-        "reporting"
+    tags: [
+        'view',
+        'aggregate',
+        'reporting'
     ]
 };

package/esm/view/view-composite.js

@@ -1,25 +1,25 @@
 export const ViewComposite = {
-    "name": "ViewComposite",
-    "slug": "view_composite",
-    "category": "view",
-    "display_name": "Composite View",
-    "description": "Advanced view using composite AST for the query. Use when other node types are insufficient (CTEs, UNIONs, complex subqueries, etc.).",
-    "parameter_schema": {
-        "type": "object",
-        "properties": {
-            "query_ast": {
-                "type": "object",
-                "description": "Composite SELECT query AST (JSONB)"
+    name: 'ViewComposite',
+    slug: 'view_composite',
+    category: 'view',
+    display_name: 'Composite View',
+    description: 'Advanced view using composite AST for the query. Use when other node types are insufficient (CTEs, UNIONs, complex subqueries, etc.).',
+    parameter_schema: {
+        type: 'object',
+        properties: {
+            query_ast: {
+                type: 'object',
+                description: 'Composite SELECT query AST (JSONB)'
             }
         },
-        "required": [
-            "query_ast"
+        required: [
+            'query_ast'
         ]
     },
-    "tags": [
-        "view",
-        "advanced",
-        "composite",
-        "ast"
+    tags: [
+        'view',
+        'advanced',
+        'composite',
+        'ast'
     ]
 };

package/esm/view/view-filtered-table.js

@@ -1,49 +1,50 @@
 export const ViewFilteredTable = {
-    "name": "ViewFilteredTable",
-    "slug": "view_filtered_table",
-    "category": "view",
-    "display_name": "Filtered Table",
-    "description": "Table projection with an Authz* filter baked into the view definition. The view only returns records matching the filter.",
-    "parameter_schema": {
-        "type": "object",
-        "properties": {
-            "source_table_id": {
-                "type": "string",
-                "format": "uuid",
-                "description": "UUID of the source table"
+    name: 'ViewFilteredTable',
+    slug: 'view_filtered_table',
+    category: 'view',
+    display_name: 'Filtered Table',
+    description: 'Table projection with an Authz* filter baked into the view definition. The view only returns records matching the filter.',
+    parameter_schema: {
+        type: 'object',
+        properties: {
+            source_table_id: {
+                type: 'string',
+                format: 'uuid',
+                description: 'UUID of the source table'
             },
-            "filter_type": {
-                "type": "string",
-                "description": "Authz* node type name (e.g., AuthzDirectOwner, AuthzPublishable)"
+            filter_type: {
+                type: 'string',
+                description: 'Authz* node type name (e.g., AuthzDirectOwner, AuthzPublishable)'
             },
-            "filter_data": {
-                "type": "object",
-                "description": "Parameters for the Authz* filter type"
+            filter_data: {
+                type: 'object',
+                description: 'Parameters for the Authz* filter type'
             },
-            "field_ids": {
-                "type": "array",
-                "items": {
-                    "type": "string",
-                    "format": "uuid"
+            field_ids: {
+                type: 'array',
+                items: {
+                    type: 'string',
+                    format: 'uuid'
                 },
-                "description": "Optional array of field UUIDs to include (alternative to field_names)"
+                description: 'Optional array of field UUIDs to include (alternative to field_names)'
             },
-            "field_names": {
-                "type": "array",
-                "items": {
-                    "type": "string"
+            field_names: {
+                type: 'array',
+                items: {
+                    type: 'string',
+                    format: 'column-ref'
                 },
-                "description": "Optional array of field names to include (alternative to field_ids)"
+                description: 'Optional array of field names to include (alternative to field_ids)'
             }
         },
-        "required": [
-            "source_table_id",
-            "filter_type"
+        required: [
+            'source_table_id',
+            'filter_type'
         ]
     },
-    "tags": [
-        "view",
-        "filter",
-        "authz"
+    tags: [
+        'view',
+        'filter',
+        'authz'
     ]
 };