Merge pull request #1125 from constructive-io/feat/check-constraint-node-types

feat: add Check constraint node types (CheckOneOf, CheckGreaterThan, CheckLessThan, CheckNotEqual)

Author: pyramation

packages/node-type-registry/src/data/check-greater-than.ts

@@ -0,0 +1,33 @@
+import type { NodeTypeDefinition } from '../types';
+
+export const CheckGreaterThan: NodeTypeDefinition = {
+  name: 'CheckGreaterThan',
+  slug: 'check_greater_than',
+  category: 'check',
+  display_name: 'Check Greater Than',
+  description:
+    'Adds a CHECK constraint that validates a column value is greater than a threshold (single-column: column > value) or that one column is greater than another (cross-column: columns[0] > columns[1]). Compiled via AST helpers.',
+  parameter_schema: {
+    type: 'object',
+    properties: {
+      column: {
+        type: 'string',
+        format: 'column-ref',
+        description: 'Single column to compare against value (mutually exclusive with columns)',
+      },
+      value: {
+        type: 'number',
+        description: 'Threshold value for single-column comparison (column > value)',
+        default: 0,
+      },
+      columns: {
+        type: 'array',
+        items: { type: 'string', format: 'column-ref' },
+        description: 'Two columns for cross-column comparison (columns[0] > columns[1])',
+        minItems: 2,
+        maxItems: 2,
+      },
+    },
+  },
+  tags: ['check', 'constraint', 'validation', 'comparison'],
+};

packages/node-type-registry/src/data/check-less-than.ts

@@ -0,0 +1,32 @@
+import type { NodeTypeDefinition } from '../types';
+
+export const CheckLessThan: NodeTypeDefinition = {
+  name: 'CheckLessThan',
+  slug: 'check_less_than',
+  category: 'check',
+  display_name: 'Check Less Than',
+  description:
+    'Adds a CHECK constraint that validates a column value is less than a threshold (single-column: column < value) or that one column is less than another (cross-column: columns[0] < columns[1]). Compiled via AST helpers.',
+  parameter_schema: {
+    type: 'object',
+    properties: {
+      column: {
+        type: 'string',
+        format: 'column-ref',
+        description: 'Single column to compare against value (mutually exclusive with columns)',
+      },
+      value: {
+        type: 'number',
+        description: 'Threshold value for single-column comparison (column < value)',
+      },
+      columns: {
+        type: 'array',
+        items: { type: 'string', format: 'column-ref' },
+        description: 'Two columns for cross-column comparison (columns[0] < columns[1])',
+        minItems: 2,
+        maxItems: 2,
+      },
+    },
+  },
+  tags: ['check', 'constraint', 'validation', 'comparison'],
+};

packages/node-type-registry/src/data/check-not-equal.ts

@@ -0,0 +1,24 @@
+import type { NodeTypeDefinition } from '../types';
+
+export const CheckNotEqual: NodeTypeDefinition = {
+  name: 'CheckNotEqual',
+  slug: 'check_not_equal',
+  category: 'check',
+  display_name: 'Check Not Equal',
+  description:
+    'Adds a CHECK constraint that validates two columns are not equal (columns[0] != columns[1]). Useful for preventing self-referencing rows. Compiled via AST helpers.',
+  parameter_schema: {
+    type: 'object',
+    properties: {
+      columns: {
+        type: 'array',
+        items: { type: 'string', format: 'column-ref' },
+        description: 'Two columns that must not be equal',
+        minItems: 2,
+        maxItems: 2,
+      },
+    },
+    required: ['columns'],
+  },
+  tags: ['check', 'constraint', 'validation', 'inequality'],
+};

packages/node-type-registry/src/data/check-one-of.ts

@@ -0,0 +1,27 @@
+import type { NodeTypeDefinition } from '../types';
+
+export const CheckOneOf: NodeTypeDefinition = {
+  name: 'CheckOneOf',
+  slug: 'check_one_of',
+  category: 'check',
+  display_name: 'Check One Of',
+  description:
+    'Adds a CHECK constraint that validates a column value is one of an allowed set (e.g. tier IN (\'free\', \'paid\', \'custom\')). Compiled to column = ANY(ARRAY[...]) via AST helpers.',
+  parameter_schema: {
+    type: 'object',
+    properties: {
+      column: {
+        type: 'string',
+        format: 'column-ref',
+        description: 'Column to validate against the allowed values',
+      },
+      values: {
+        type: 'array',
+        items: { type: 'string' },
+        description: 'Array of allowed values for the column',
+      },
+    },
+    required: ['column', 'values'],
+  },
+  tags: ['check', 'constraint', 'validation', 'enum'],
+};

packages/node-type-registry/src/data/index.ts

@@ -1,3 +1,7 @@
+export { CheckGreaterThan } from './check-greater-than';
+export { CheckLessThan } from './check-less-than';
+export { CheckNotEqual } from './check-not-equal';
+export { CheckOneOf } from './check-one-of';
 export { DataAggregateLimitCounter } from './data-aggregate-limit-counter';
 export { DataBillingMeter } from './data-billing-meter';
 export { DataChunks } from './data-chunks';

packages/node-type-registry/src/types.ts

@@ -43,7 +43,7 @@ export interface NodeTypeDefinition {
   name: string;
   /** snake_case slug, e.g. 'authz_direct_owner' */
   slug: string;
-  /** Category: authz | data | field | relation | view */
+  /** Category: authz | check | data | field | relation | search | view */
   category: string;
   /** Human-readable display name, e.g. 'Direct Ownership' */
   display_name: string;