node-type-registry 0.34.0 → 0.35.0

package/data/data-file-embedding.js

@@ -1,16 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DataFileEmbedding = void 0;
-exports.DataFileEmbedding = {
-    name: 'DataFileEmbedding',
+exports.ProcessFileEmbedding = void 0;
+exports.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: {
@@ -106,25 +106,19 @@ exports.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.',
                 properties: {
@@ -166,19 +160,6 @@ exports.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/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/data/data-image-embedding.js

@@ -1,31 +1,31 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DataImageEmbedding = void 0;
+exports.ProcessImageEmbedding = void 0;
 /**
- * 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.
  */
-exports.DataImageEmbedding = {
-    name: 'DataImageEmbedding',
+exports.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',
@@ -96,7 +96,7 @@ exports.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: {
@@ -110,19 +110,13 @@ exports.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: {
@@ -141,18 +135,6 @@ exports.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/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/data/data-job-trigger.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DataJobTrigger = void 0;
+exports.JobTrigger = void 0;
 const triggerConditionSchema = {
     type: 'object',
     description: 'A leaf condition ({field, op, value?, row?, ref?}) or a combinator ({AND, OR, NOT}).',
@@ -26,10 +26,10 @@ const triggerConditionSchema = {
         NOT: { $ref: '#/$defs/triggerCondition', description: 'Negated condition.' }
     }
 };
-exports.DataJobTrigger = {
-    name: 'DataJobTrigger',
+exports.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/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/data/data-limit-counter.js

@@ -1,10 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DataLimitCounter = void 0;
-exports.DataLimitCounter = {
-    name: 'DataLimitCounter',
+exports.LimitCounter = void 0;
+exports.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/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/data/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TableUserSettings = exports.TableUserProfiles = exports.TableOrganizationSettings = exports.SearchVector = exports.SearchUnified = exports.SearchTrgm = exports.SearchSpatialAggregate = exports.SearchSpatial = exports.SearchFullText = exports.SearchBm25 = exports.DataTimestamps = exports.DataTags = exports.DataStatusField = exports.DataSoftDelete = exports.DataSlug = exports.DataRealtime = exports.DataPublishable = exports.DataPeoplestamps = exports.DataOwnershipInEntity = exports.DataOwnedFields = exports.DataJsonb = exports.DataLimitCounter = exports.DataJobTrigger = exports.DataInheritFromParent = exports.DataInflection = exports.DataImmutableFields = exports.DataImageEmbedding = exports.DataId = exports.DataForceCurrentUser = exports.DataFeatureFlag = exports.DataFileEmbedding = exports.DataEntityMembership = exports.DataDirectOwner = exports.DataCompositeField = exports.DataChunks = exports.DataBulk = exports.DataBillingMeter = exports.DataAggregateLimitCounter = exports.CheckOneOf = exports.CheckNotEqual = exports.CheckLessThan = exports.CheckGreaterThan = void 0;
+exports.TableUserSettings = exports.TableUserProfiles = exports.TableOrganizationSettings = exports.SearchVector = exports.SearchUnified = exports.SearchTrgm = exports.SearchSpatialAggregate = exports.SearchSpatial = exports.SearchFullText = exports.SearchBm25 = exports.DataTimestamps = exports.DataTags = exports.DataStatusField = exports.DataSoftDelete = exports.DataSlug = exports.DataRealtime = exports.DataPublishable = exports.DataPeoplestamps = exports.DataOwnershipInEntity = exports.ProcessImageVersions = exports.ProcessExtraction = exports.DataOwnedFields = exports.DataJsonb = exports.LimitCounter = exports.JobTrigger = exports.DataInheritFromParent = exports.DataInflection = exports.DataImmutableFields = exports.ProcessImageEmbedding = exports.DataId = exports.DataForceCurrentUser = exports.LimitFeatureFlag = exports.ProcessFileEmbedding = exports.DataEntityMembership = exports.DataDirectOwner = exports.DataCompositeField = exports.ProcessChunks = exports.DataBulk = exports.BillingMeter = exports.LimitAggregate = exports.CheckOneOf = exports.CheckNotEqual = exports.CheckLessThan = exports.CheckGreaterThan = void 0;
 var check_greater_than_1 = require("./check-greater-than");
 Object.defineProperty(exports, "CheckGreaterThan", { enumerable: true, get: function () { return check_greater_than_1.CheckGreaterThan; } });
 var check_less_than_1 = require("./check-less-than");
@@ -10,13 +10,13 @@ Object.defineProperty(exports, "CheckNotEqual", { enumerable: true, get: functio
 var check_one_of_1 = require("./check-one-of");
 Object.defineProperty(exports, "CheckOneOf", { enumerable: true, get: function () { return check_one_of_1.CheckOneOf; } });
 var data_aggregate_limit_counter_1 = require("./data-aggregate-limit-counter");
-Object.defineProperty(exports, "DataAggregateLimitCounter", { enumerable: true, get: function () { return data_aggregate_limit_counter_1.DataAggregateLimitCounter; } });
+Object.defineProperty(exports, "LimitAggregate", { enumerable: true, get: function () { return data_aggregate_limit_counter_1.LimitAggregate; } });
 var data_billing_meter_1 = require("./data-billing-meter");
-Object.defineProperty(exports, "DataBillingMeter", { enumerable: true, get: function () { return data_billing_meter_1.DataBillingMeter; } });
+Object.defineProperty(exports, "BillingMeter", { enumerable: true, get: function () { return data_billing_meter_1.BillingMeter; } });
 var data_bulk_1 = require("./data-bulk");
 Object.defineProperty(exports, "DataBulk", { enumerable: true, get: function () { return data_bulk_1.DataBulk; } });
 var data_chunks_1 = require("./data-chunks");
-Object.defineProperty(exports, "DataChunks", { enumerable: true, get: function () { return data_chunks_1.DataChunks; } });
+Object.defineProperty(exports, "ProcessChunks", { enumerable: true, get: function () { return data_chunks_1.ProcessChunks; } });
 var data_composite_field_1 = require("./data-composite-field");
 Object.defineProperty(exports, "DataCompositeField", { enumerable: true, get: function () { return data_composite_field_1.DataCompositeField; } });
 var data_direct_owner_1 = require("./data-direct-owner");
@@ -24,15 +24,15 @@ Object.defineProperty(exports, "DataDirectOwner", { enumerable: true, get: funct
 var data_entity_membership_1 = require("./data-entity-membership");
 Object.defineProperty(exports, "DataEntityMembership", { enumerable: true, get: function () { return data_entity_membership_1.DataEntityMembership; } });
 var data_file_embedding_1 = require("./data-file-embedding");
-Object.defineProperty(exports, "DataFileEmbedding", { enumerable: true, get: function () { return data_file_embedding_1.DataFileEmbedding; } });
+Object.defineProperty(exports, "ProcessFileEmbedding", { enumerable: true, get: function () { return data_file_embedding_1.ProcessFileEmbedding; } });
 var data_feature_flag_1 = require("./data-feature-flag");
-Object.defineProperty(exports, "DataFeatureFlag", { enumerable: true, get: function () { return data_feature_flag_1.DataFeatureFlag; } });
+Object.defineProperty(exports, "LimitFeatureFlag", { enumerable: true, get: function () { return data_feature_flag_1.LimitFeatureFlag; } });
 var data_force_current_user_1 = require("./data-force-current-user");
 Object.defineProperty(exports, "DataForceCurrentUser", { enumerable: true, get: function () { return data_force_current_user_1.DataForceCurrentUser; } });
 var data_id_1 = require("./data-id");
 Object.defineProperty(exports, "DataId", { enumerable: true, get: function () { return data_id_1.DataId; } });
 var data_image_embedding_1 = require("./data-image-embedding");
-Object.defineProperty(exports, "DataImageEmbedding", { enumerable: true, get: function () { return data_image_embedding_1.DataImageEmbedding; } });
+Object.defineProperty(exports, "ProcessImageEmbedding", { enumerable: true, get: function () { return data_image_embedding_1.ProcessImageEmbedding; } });
 var data_immutable_fields_1 = require("./data-immutable-fields");
 Object.defineProperty(exports, "DataImmutableFields", { enumerable: true, get: function () { return data_immutable_fields_1.DataImmutableFields; } });
 var data_inflection_1 = require("./data-inflection");
@@ -40,13 +40,17 @@ Object.defineProperty(exports, "DataInflection", { enumerable: true, get: functi
 var data_inherit_from_parent_1 = require("./data-inherit-from-parent");
 Object.defineProperty(exports, "DataInheritFromParent", { enumerable: true, get: function () { return data_inherit_from_parent_1.DataInheritFromParent; } });
 var data_job_trigger_1 = require("./data-job-trigger");
-Object.defineProperty(exports, "DataJobTrigger", { enumerable: true, get: function () { return data_job_trigger_1.DataJobTrigger; } });
+Object.defineProperty(exports, "JobTrigger", { enumerable: true, get: function () { return data_job_trigger_1.JobTrigger; } });
 var data_limit_counter_1 = require("./data-limit-counter");
-Object.defineProperty(exports, "DataLimitCounter", { enumerable: true, get: function () { return data_limit_counter_1.DataLimitCounter; } });
+Object.defineProperty(exports, "LimitCounter", { enumerable: true, get: function () { return data_limit_counter_1.LimitCounter; } });
 var data_jsonb_1 = require("./data-jsonb");
 Object.defineProperty(exports, "DataJsonb", { enumerable: true, get: function () { return data_jsonb_1.DataJsonb; } });
 var data_owned_fields_1 = require("./data-owned-fields");
 Object.defineProperty(exports, "DataOwnedFields", { enumerable: true, get: function () { return data_owned_fields_1.DataOwnedFields; } });
+var process_extraction_1 = require("./process-extraction");
+Object.defineProperty(exports, "ProcessExtraction", { enumerable: true, get: function () { return process_extraction_1.ProcessExtraction; } });
+var process_image_versions_1 = require("./process-image-versions");
+Object.defineProperty(exports, "ProcessImageVersions", { enumerable: true, get: function () { return process_image_versions_1.ProcessImageVersions; } });
 var data_ownership_in_entity_1 = require("./data-ownership-in-entity");
 Object.defineProperty(exports, "DataOwnershipInEntity", { enumerable: true, get: function () { return data_ownership_in_entity_1.DataOwnershipInEntity; } });
 var data_peoplestamps_1 = require("./data-peoplestamps");

package/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/data/process-extraction.js

@@ -0,0 +1,108 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProcessExtraction = void 0;
+/**
+ * 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.
+ */
+exports.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/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;

package/data/process-image-versions.js

@@ -0,0 +1,139 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProcessImageVersions = void 0;
+/**
+ * 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.
+ */
+exports.ProcessImageVersions = {
+    name: 'ProcessImageVersions',
+    slug: 'process_image_versions',
+    category: 'process',
+    display_name: 'Image Versions',
+    description: 'Creates a job trigger for image variant generation. ' +
+        'Fires when an image file is uploaded (status = \'uploaded\') or on INSERT. ' +
+        'The external worker generates resized, cropped, or reformatted versions ' +
+        '(thumbnails, previews, WebP conversions, etc.) and stores them as new ' +
+        'file records linked to the source image.',
+    parameter_schema: {
+        type: 'object',
+        required: ['versions'],
+        properties: {
+            // ── Version definitions ───────────────────────────────────────
+            versions: {
+                type: 'array',
+                items: {
+                    type: 'object',
+                    properties: {
+                        name: {
+                            type: 'string',
+                            description: 'Version identifier (e.g., "thumb", "preview", "hero")'
+                        },
+                        width: {
+                            type: 'integer',
+                            description: 'Target width in pixels'
+                        },
+                        height: {
+                            type: 'integer',
+                            description: 'Target height in pixels'
+                        },
+                        fit: {
+                            type: 'string',
+                            enum: ['cover', 'contain', 'fill', 'inside', 'outside'],
+                            description: 'Resize fitting strategy',
+                            default: 'cover'
+                        },
+                        format: {
+                            type: 'string',
+                            enum: ['jpeg', 'png', 'webp', 'avif'],
+                            description: 'Output image format',
+                            default: 'webp'
+                        },
+                        quality: {
+                            type: 'integer',
+                            description: 'Output quality (1-100)',
+                            default: 80
+                        }
+                    },
+                    required: ['name']
+                },
+                description: 'Array of version definitions. Each version specifies dimensions, ' +
+                    'format, and quality for a generated image variant. ' +
+                    'Required — the blueprint must explicitly define what variants to generate.',
+                minItems: 1
+            },
+            // ── MIME scoping ──────────────────────────────────────────────
+            mime_patterns: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'MIME type LIKE patterns to match. Defaults to all image types.',
+                default: ['image/%']
+            },
+            // ── Job routing ───────────────────────────────────────────────
+            task_identifier: {
+                type: 'string',
+                description: 'Job task identifier for the image processing worker',
+                default: 'process_image_versions'
+            },
+            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.',
+                '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 image processing tasks',
+                default: 'image_processing'
+            },
+            max_attempts: {
+                type: 'integer',
+                description: 'Maximum number of retry attempts',
+                default: 5
+            },
+            priority: {
+                type: 'integer',
+                description: 'Job priority (lower = higher priority)',
+                default: 0
+            }
+        }
+    },
+    tags: [
+        'images',
+        'processing',
+        'jobs',
+        'resize',
+        'thumbnails',
+        'files'
+    ]
+};