node-type-registry 0.34.0 → 0.36.0

package/esm/data/data-direct-owner.js

@@ -22,6 +22,11 @@ export const DataDirectOwner = {
                 type: 'boolean',
                 description: 'If true, adds a foreign key constraint from owner_id to the users table',
                 default: true
+            },
+            create_index: {
+                type: 'boolean',
+                description: 'If true, creates a B-tree index on the owner column',
+                default: true
             }
         }
     },

package/esm/data/data-entity-membership.js

@@ -22,6 +22,11 @@ export const DataEntityMembership = {
                 type: 'boolean',
                 description: 'If true, adds a foreign key constraint from entity_id to the users table',
                 default: true
+            },
+            create_index: {
+                type: 'boolean',
+                description: 'If true, creates a B-tree index on the entity column',
+                default: true
             }
         }
     },

package/esm/data/data-feature-flag.d.ts

@@ -1,2 +1,2 @@
 import type { NodeTypeDefinition } from '../types';
-export declare const DataFeatureFlag: NodeTypeDefinition;
+export declare const LimitFeatureFlag: NodeTypeDefinition;

package/esm/data/data-feature-flag.js

@@ -1,7 +1,7 @@
-export const DataFeatureFlag = {
-    name: 'DataFeatureFlag',
+export const LimitFeatureFlag = {
+    name: 'LimitFeatureFlag',
     slug: 'data_feature_flag',
-    category: 'data',
+    category: 'limit',
     display_name: 'Feature Flag',
     description: 'Gates a table behind a feature flag backed by the cap tables. Attaches a BEFORE INSERT trigger that checks whether the named feature cap value is > 0. Features are modeled as caps with max=0 (disabled) or max=1 (enabled) in limit_caps / limit_caps_defaults tables. Resolution: COALESCE(per-entity cap, scope default, 0).',
     parameter_schema: {

package/esm/data/data-file-embedding.d.ts

@@ -1,2 +1,2 @@
 import type { NodeTypeDefinition } from '../types';
-export declare const DataFileEmbedding: NodeTypeDefinition;
+export declare const ProcessFileEmbedding: NodeTypeDefinition;

package/esm/data/data-file-embedding.js

@@ -1,13 +1,13 @@
-export const DataFileEmbedding = {
-    name: 'DataFileEmbedding',
+export const ProcessFileEmbedding = {
+    name: 'ProcessFileEmbedding',
     slug: 'data_file_embedding',
-    category: 'data',
+    category: 'process',
     display_name: 'File Embedding',
     description: 'Generic, MIME-scoped embedding node for file tables. Supports two modes: ' +
         'direct (whole-file to single vector, e.g. CLIP for images) when extraction ' +
         'is omitted, or extract (file to text to chunks to per-chunk vectors) when ' +
-        'extraction config is provided. Composes SearchVector + DataJobTrigger + ' +
-        'DataChunks (enabled by default in extract mode) internally. Multiple ' +
+        'extraction config is provided. Composes SearchVector + JobTrigger + ' +
+        'ProcessChunks (enabled by default in extract mode) internally. Multiple ' +
         'instances can coexist on the same table with different MIME scopes, field ' +
         'names, and embedding strategies.',
     parameter_schema: {
@@ -103,27 +103,22 @@ export const DataFileEmbedding = {
                         format: 'column-ref',
                         description: 'JSONB field for extraction metadata (page count, language, etc.)',
                         default: 'extracted_metadata'
-                    },
-                    status_field: {
-                        type: 'string',
-                        format: 'column-ref',
-                        description: 'Extraction lifecycle status field',
-                        default: 'extraction_status'
                     }
                 }
             },
             // ── Chunking (enabled by default in extract mode) ──────────────
             include_chunks: {
                 type: 'boolean',
-                description: 'Whether to create a chunks table via DataChunks. Defaults to true ' +
+                description: 'Whether to create a chunks table via ProcessChunks. Defaults to true ' +
                     'when extraction is provided, false in direct mode. Set explicitly ' +
                     'to override.',
             },
             chunks: {
                 type: 'object',
-                description: 'Chunking configuration passed through to DataChunks. When ' +
+                description: 'Chunking configuration passed through to ProcessChunks. When ' +
                     'include_chunks is true (or defaults to true in extract mode), these ' +
                     'params configure the chunks table, embedding dimensions, strategy, etc.',
+                default: {},
                 properties: {
                     content_field_name: {
                         type: 'string',
@@ -163,19 +158,6 @@ export const DataFileEmbedding = {
                         default: 'generate_chunks'
                     }
                 }
-            },
-            // ── Stale tracking (meaningful in extract mode) ────────────────
-            stale_strategy: {
-                type: 'string',
-                enum: ['column', 'null', 'hash'],
-                description: 'Strategy for tracking embedding staleness when extraction is enabled. ' +
-                    'column: embedding_stale boolean. null: set embedding to NULL. hash: md5 hash.',
-                default: 'column'
-            },
-            include_stale_field: {
-                type: 'boolean',
-                description: 'Whether to include the embedding_stale boolean field (extract mode)',
-                default: true
             }
         }
     },

package/esm/data/data-image-embedding.d.ts

@@ -1,14 +1,14 @@
 import type { NodeTypeDefinition } from '../types';
 /**
- * Image-specific preset of DataFileEmbedding.
+ * Image-specific preset of ProcessFileEmbedding.
  *
  * At the SQL layer, data_image_embedding delegates entirely to
  * data_file_embedding, merging image-specific defaults before forwarding.
- * The parameter schema here is intentionally identical to DataFileEmbedding;
+ * The parameter schema here is intentionally identical to ProcessFileEmbedding;
  * only the defaults differ (dimensions: 512, task: process_image_embedding,
  * mime_patterns: ['image/%']).
  *
  * Kept as a separate node type for backward compatibility — existing
- * blueprints that reference DataImageEmbedding continue to work unchanged.
+ * blueprints that reference ProcessImageEmbedding continue to work unchanged.
  */
-export declare const DataImageEmbedding: NodeTypeDefinition;
+export declare const ProcessImageEmbedding: NodeTypeDefinition;

package/esm/data/data-image-embedding.js

@@ -1,28 +1,28 @@
 /**
- * Image-specific preset of DataFileEmbedding.
+ * Image-specific preset of ProcessFileEmbedding.
  *
  * At the SQL layer, data_image_embedding delegates entirely to
  * data_file_embedding, merging image-specific defaults before forwarding.
- * The parameter schema here is intentionally identical to DataFileEmbedding;
+ * The parameter schema here is intentionally identical to ProcessFileEmbedding;
  * only the defaults differ (dimensions: 512, task: process_image_embedding,
  * mime_patterns: ['image/%']).
  *
  * Kept as a separate node type for backward compatibility — existing
- * blueprints that reference DataImageEmbedding continue to work unchanged.
+ * blueprints that reference ProcessImageEmbedding continue to work unchanged.
  */
-export const DataImageEmbedding = {
-    name: 'DataImageEmbedding',
+export const ProcessImageEmbedding = {
+    name: 'ProcessImageEmbedding',
     slug: 'data_image_embedding',
-    category: 'data',
+    category: 'process',
     display_name: 'Image Embedding',
-    description: 'Image-specific preset of DataFileEmbedding. Delegates to DataFileEmbedding ' +
+    description: 'Image-specific preset of ProcessFileEmbedding. Delegates to ProcessFileEmbedding ' +
         'with image-oriented defaults: dimensions=512 (CLIP), mime_patterns=[\'image/%\'], ' +
         'task_identifier=\'process_image_embedding\', direct mode (no extraction). ' +
-        'Accepts all DataFileEmbedding parameters — any overrides are forwarded through.',
+        'Accepts all ProcessFileEmbedding parameters — any overrides are forwarded through.',
     parameter_schema: {
         type: 'object',
         properties: {
-            // ── Vector config (passed through to DataFileEmbedding) ──────────
+            // ── Vector config (passed through to ProcessFileEmbedding) ──────────
             field_name: {
                 type: 'string',
                 format: 'column-ref',
@@ -93,7 +93,7 @@ export const DataImageEmbedding = {
             // ── Extraction config (optional — enables extract mode) ────────
             extraction: {
                 type: 'object',
-                description: 'Text extraction configuration. Forwarded to DataFileEmbedding. ' +
+                description: 'Text extraction configuration. Forwarded to ProcessFileEmbedding. ' +
                     'When present, enables extract mode (e.g., OCR for images).',
                 properties: {
                     text_field: {
@@ -107,19 +107,13 @@ export const DataImageEmbedding = {
                         format: 'column-ref',
                         description: 'JSONB field for extraction metadata',
                         default: 'extracted_metadata'
-                    },
-                    status_field: {
-                        type: 'string',
-                        format: 'column-ref',
-                        description: 'Extraction lifecycle status field',
-                        default: 'extraction_status'
                     }
                 }
             },
-            // ── Chunking config (optional — forwarded to DataFileEmbedding) ─
+            // ── Chunking config (optional — forwarded to ProcessFileEmbedding) ─
             chunks: {
                 type: 'object',
-                description: 'Chunking configuration. Forwarded to DataFileEmbedding. ' +
+                description: 'Chunking configuration. Forwarded to ProcessFileEmbedding. ' +
                     'Only meaningful when extraction is also provided.',
                 properties: {
                     content_field_name: {
@@ -138,18 +132,6 @@ export const DataImageEmbedding = {
                     enqueue_chunking_job: { type: 'boolean', default: true },
                     chunking_task_name: { type: 'string', default: 'generate_chunks' }
                 }
-            },
-            // ── Stale tracking (forwarded to DataFileEmbedding) ────────────
-            stale_strategy: {
-                type: 'string',
-                enum: ['column', 'null', 'hash'],
-                description: 'Strategy for tracking embedding staleness in extract mode',
-                default: 'column'
-            },
-            include_stale_field: {
-                type: 'boolean',
-                description: 'Whether to include the embedding_stale boolean field',
-                default: true
             }
         }
     },

package/esm/data/data-job-trigger.d.ts

@@ -1,2 +1,2 @@
 import type { NodeTypeDefinition } from '../types';
-export declare const DataJobTrigger: NodeTypeDefinition;
+export declare const JobTrigger: NodeTypeDefinition;

package/esm/data/data-job-trigger.js

@@ -23,10 +23,10 @@ const triggerConditionSchema = {
         NOT: { $ref: '#/$defs/triggerCondition', description: 'Negated condition.' }
     }
 };
-export const DataJobTrigger = {
-    name: 'DataJobTrigger',
+export const JobTrigger = {
+    name: 'JobTrigger',
     slug: 'data_job_trigger',
-    category: 'data',
+    category: 'job',
     display_name: 'Job Trigger',
     description: 'Dynamically creates PostgreSQL triggers that enqueue jobs via app_jobs.add_job() when table rows are inserted, updated, or deleted. Supports configurable payload strategies (full row, row ID, selected fields, or custom mapping), conditional firing via WHEN clauses, watched field changes, and extended job options (queue, priority, delay, max attempts).',
     parameter_schema: {

package/esm/data/data-jsonb.js

@@ -15,7 +15,8 @@ export const DataJsonb = {
             },
             default_value: {
                 type: 'string',
-                description: 'Default value expression'
+                description: 'Default value expression',
+                default: "'{}'::jsonb"
             },
             is_required: {
                 type: 'boolean',

package/esm/data/data-limit-counter.d.ts

@@ -1,2 +1,2 @@
 import type { NodeTypeDefinition } from '../types';
-export declare const DataLimitCounter: NodeTypeDefinition;
+export declare const LimitCounter: NodeTypeDefinition;

package/esm/data/data-limit-counter.js

@@ -1,7 +1,7 @@
-export const DataLimitCounter = {
-    name: 'DataLimitCounter',
+export const LimitCounter = {
+    name: 'LimitCounter',
     slug: 'data_limit_counter',
-    category: 'data',
+    category: 'limit',
     display_name: 'Limit Counter',
     description: 'Declaratively attaches limit-tracking triggers to a table. On INSERT the named limit is incremented; on DELETE it is decremented. Requires a provisioned limits_module for the target scope.',
     parameter_schema: {

package/esm/data/data-ownership-in-entity.js

@@ -28,6 +28,11 @@ export const DataOwnershipInEntity = {
                 type: 'boolean',
                 description: 'If true, adds foreign key constraints from owner_id and entity_id to the users table',
                 default: true
+            },
+            create_index: {
+                type: 'boolean',
+                description: 'If true, creates B-tree indexes on the owner and entity columns',
+                default: true
             }
         }
     },

package/esm/data/data-peoplestamps.js

@@ -28,6 +28,11 @@ export const DataPeoplestamps = {
                 type: 'boolean',
                 description: 'If true, adds foreign key constraints from created_by and updated_by to the users table',
                 default: false
+            },
+            create_index: {
+                type: 'boolean',
+                description: 'If true, creates B-tree indexes on the peoplestamp columns',
+                default: true
             }
         }
     },

package/esm/data/data-publishable.js

@@ -7,13 +7,13 @@ export const DataPublishable = {
     parameter_schema: {
         type: 'object',
         properties: {
-            is_published_field: {
+            is_published_field_name: {
                 type: 'string',
                 format: 'column-ref',
                 description: 'Column name for the published boolean flag',
                 default: 'is_published'
             },
-            published_at_field: {
+            published_at_field_name: {
                 type: 'string',
                 format: 'column-ref',
                 description: 'Column name for the publish timestamp',

package/esm/data/data-slug.js

@@ -10,7 +10,8 @@ export const DataSlug = {
             field_name: {
                 type: 'string',
                 format: 'column-ref',
-                description: 'Name of the field to slugify'
+                description: 'Name of the field to slugify',
+                default: 'slug'
             },
             source_field_name: {
                 type: 'string',
@@ -18,9 +19,7 @@ export const DataSlug = {
                 description: 'Optional source field name (defaults to field_name)'
             }
         },
-        required: [
-            'field_name'
-        ]
+        required: []
     },
     tags: [
         'transform',

package/esm/data/data-tags.js

@@ -15,7 +15,8 @@ export const DataTags = {
             },
             default_value: {
                 type: 'string',
-                description: 'Default value expression for the tags column'
+                description: 'Default value expression for the tags column',
+                default: 'ARRAY[]::citext[]'
             },
             is_required: {
                 type: 'boolean',

package/esm/data/index.d.ts

@@ -2,25 +2,27 @@ 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 { LimitAggregate } from './data-aggregate-limit-counter';
+export { BillingMeter } from './data-billing-meter';
 export { DataBulk } from './data-bulk';
-export { DataChunks } from './data-chunks';
+export { ProcessChunks } from './data-chunks';
 export { DataCompositeField } from './data-composite-field';
 export { DataDirectOwner } from './data-direct-owner';
 export { DataEntityMembership } from './data-entity-membership';
-export { DataFileEmbedding } from './data-file-embedding';
-export { DataFeatureFlag } from './data-feature-flag';
+export { ProcessFileEmbedding } from './data-file-embedding';
+export { LimitFeatureFlag } from './data-feature-flag';
 export { DataForceCurrentUser } from './data-force-current-user';
 export { DataId } from './data-id';
-export { DataImageEmbedding } from './data-image-embedding';
+export { ProcessImageEmbedding } from './data-image-embedding';
 export { DataImmutableFields } from './data-immutable-fields';
 export { DataInflection } from './data-inflection';
 export { DataInheritFromParent } from './data-inherit-from-parent';
-export { DataJobTrigger } from './data-job-trigger';
-export { DataLimitCounter } from './data-limit-counter';
+export { JobTrigger } from './data-job-trigger';
+export { LimitCounter } from './data-limit-counter';
 export { DataJsonb } from './data-jsonb';
 export { DataOwnedFields } from './data-owned-fields';
+export { ProcessExtraction } from './process-extraction';
+export { ProcessImageVersions } from './process-image-versions';
 export { DataOwnershipInEntity } from './data-ownership-in-entity';
 export { DataPeoplestamps } from './data-peoplestamps';
 export { DataPublishable } from './data-publishable';

package/esm/data/index.js

@@ -2,25 +2,27 @@ 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 { LimitAggregate } from './data-aggregate-limit-counter';
+export { BillingMeter } from './data-billing-meter';
 export { DataBulk } from './data-bulk';
-export { DataChunks } from './data-chunks';
+export { ProcessChunks } from './data-chunks';
 export { DataCompositeField } from './data-composite-field';
 export { DataDirectOwner } from './data-direct-owner';
 export { DataEntityMembership } from './data-entity-membership';
-export { DataFileEmbedding } from './data-file-embedding';
-export { DataFeatureFlag } from './data-feature-flag';
+export { ProcessFileEmbedding } from './data-file-embedding';
+export { LimitFeatureFlag } from './data-feature-flag';
 export { DataForceCurrentUser } from './data-force-current-user';
 export { DataId } from './data-id';
-export { DataImageEmbedding } from './data-image-embedding';
+export { ProcessImageEmbedding } from './data-image-embedding';
 export { DataImmutableFields } from './data-immutable-fields';
 export { DataInflection } from './data-inflection';
 export { DataInheritFromParent } from './data-inherit-from-parent';
-export { DataJobTrigger } from './data-job-trigger';
-export { DataLimitCounter } from './data-limit-counter';
+export { JobTrigger } from './data-job-trigger';
+export { LimitCounter } from './data-limit-counter';
 export { DataJsonb } from './data-jsonb';
 export { DataOwnedFields } from './data-owned-fields';
+export { ProcessExtraction } from './process-extraction';
+export { ProcessImageVersions } from './process-image-versions';
 export { DataOwnershipInEntity } from './data-ownership-in-entity';
 export { DataPeoplestamps } from './data-peoplestamps';
 export { DataPublishable } from './data-publishable';

package/esm/data/process-extraction.d.ts

@@ -0,0 +1,14 @@
+import type { NodeTypeDefinition } from '../types';
+/**
+ * File extraction processing node.
+ *
+ * Composes a JobTrigger that fires when a file transitions to status = 'uploaded'
+ * (or on INSERT if confirm_upload is not enabled). The trigger enqueues a
+ * text-extraction job that converts the file contents (PDF, DOCX, HTML, etc.)
+ * into plain text or markdown, storing the result in configurable output fields.
+ *
+ * The extraction worker is external (Knative function) — this node only creates
+ * the trigger infrastructure and output fields. The worker calls back into the
+ * database to write extracted text and metadata.
+ */
+export declare const ProcessExtraction: NodeTypeDefinition;

package/esm/data/process-extraction.js

@@ -0,0 +1,105 @@
+/**
+ * File extraction processing node.
+ *
+ * Composes a JobTrigger that fires when a file transitions to status = 'uploaded'
+ * (or on INSERT if confirm_upload is not enabled). The trigger enqueues a
+ * text-extraction job that converts the file contents (PDF, DOCX, HTML, etc.)
+ * into plain text or markdown, storing the result in configurable output fields.
+ *
+ * The extraction worker is external (Knative function) — this node only creates
+ * the trigger infrastructure and output fields. The worker calls back into the
+ * database to write extracted text and metadata.
+ */
+export const ProcessExtraction = {
+    name: 'ProcessExtraction',
+    slug: 'process_extraction',
+    category: 'process',
+    display_name: 'File Extraction',
+    description: 'Creates extraction output fields and a job trigger for file text extraction. ' +
+        'Fires when a file is uploaded (status = \'uploaded\') or on INSERT. ' +
+        'The external worker extracts text/metadata from the file (PDF, DOCX, HTML, etc.) ' +
+        'and writes the result back to the configured output fields. ' +
+        'Typically used upstream of ProcessFileEmbedding or ProcessChunks.',
+    parameter_schema: {
+        type: 'object',
+        properties: {
+            // ── Output fields ─────────────────────────────────────────────
+            text_field: {
+                type: 'string',
+                format: 'column-ref',
+                description: 'Field to store extracted text/markdown',
+                default: 'extracted_text'
+            },
+            metadata_field: {
+                type: 'string',
+                format: 'column-ref',
+                description: 'JSONB field for extraction metadata (page count, language, etc.)',
+                default: 'extracted_metadata'
+            },
+            // ── MIME scoping ──────────────────────────────────────────────
+            mime_patterns: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'MIME type LIKE patterns to match. Multiple patterns are OR\'d together. ' +
+                    'Examples: [\'application/pdf\', \'text/%\'], [\'application/vnd.openxmlformats%\'].',
+                default: ['application/pdf', 'text/%']
+            },
+            // ── Job routing ───────────────────────────────────────────────
+            task_identifier: {
+                type: 'string',
+                description: 'Job task identifier for the extraction worker',
+                default: 'extract_file_text'
+            },
+            events: {
+                type: 'array',
+                items: { type: 'string', enum: ['INSERT', 'UPDATE'] },
+                description: 'Trigger events that fire the job',
+                default: ['INSERT']
+            },
+            payload_custom: {
+                type: 'object',
+                additionalProperties: { type: 'string', format: 'column-ref' },
+                description: 'Custom payload key-to-column mapping for the job trigger',
+                default: {
+                    file_id: 'id',
+                    key: 'key',
+                    mime_type: 'mime_type',
+                    bucket_id: 'bucket_id'
+                }
+            },
+            trigger_conditions: {
+                description: 'Additional compound conditions beyond MIME filtering. ' +
+                    'Merged with the auto-generated MIME conditions via AND. ' +
+                    'Use this to add status checks (e.g., status = \'uploaded\').',
+                'x-codegen-type': 'TriggerCondition | TriggerCondition[]',
+                oneOf: [
+                    { $ref: '#/$defs/triggerCondition' },
+                    { type: 'array', items: { $ref: '#/$defs/triggerCondition' } }
+                ]
+            },
+            // ── Job options ───────────────────────────────────────────────
+            queue_name: {
+                type: 'string',
+                description: 'Job queue name for extraction tasks',
+                default: 'extraction'
+            },
+            max_attempts: {
+                type: 'integer',
+                description: 'Maximum number of retry attempts',
+                default: 5
+            },
+            priority: {
+                type: 'integer',
+                description: 'Job priority (lower = higher priority)',
+                default: 0
+            }
+        }
+    },
+    tags: [
+        'extraction',
+        'files',
+        'processing',
+        'jobs',
+        'text'
+    ]
+};

package/esm/data/process-image-versions.d.ts

@@ -0,0 +1,15 @@
+import type { NodeTypeDefinition } from '../types';
+/**
+ * Image version processing node.
+ *
+ * Composes a JobTrigger that fires when an image file transitions to
+ * status = 'uploaded' (or on INSERT if confirm_upload is not enabled).
+ * The trigger enqueues an image-processing job that generates resized,
+ * cropped, or reformatted variants of the source image.
+ *
+ * The image processing worker is external (Knative function) — this node
+ * only creates the trigger infrastructure. The worker generates the variants
+ * and writes them back to the storage system as new file records linked to
+ * the source file.
+ */
+export declare const ProcessImageVersions: NodeTypeDefinition;