node-type-registry 0.33.1 → 0.35.0

package/esm/blueprint-types.generated.js

@@ -12,18 +12,48 @@
  * ===========================================================================
  */
 ;
+/**
+ * ===========================================================================
+ * Billing node type parameters
+ * ===========================================================================
+ */
+;
+/**
+ * ===========================================================================
+ * Check node type parameters
+ * ===========================================================================
+ */
+;
 /**
  * ===========================================================================
  * Data node type parameters
  * ===========================================================================
  */
 ;
+/**
+ * ===========================================================================
+ * Limit node type parameters
+ * ===========================================================================
+ */
+;
 /**
  * ===========================================================================
  * Search node type parameters
  * ===========================================================================
  */
 ;
+/**
+ * ===========================================================================
+ * Job node type parameters
+ * ===========================================================================
+ */
+;
+/**
+ * ===========================================================================
+ * Process node type parameters
+ * ===========================================================================
+ */
+;
 /**
  * ===========================================================================
  * Authz node type parameters

package/esm/codegen/generate-types.js

@@ -485,6 +485,8 @@ function buildBlueprintStorageConfig() {
         addJSDoc(optionalProp('download_url_expiry_seconds', t.tsNumberKeyword()), 'Override for presigned download URL expiry time in seconds.'),
         addJSDoc(optionalProp('default_max_file_size', t.tsNumberKeyword()), 'Default maximum file size in bytes for the storage module.'),
         addJSDoc(optionalProp('allowed_origins', t.tsArrayType(t.tsStringKeyword())), 'CORS allowed origins for the storage module.'),
+        addJSDoc(optionalProp('has_confirm_upload', t.tsBooleanKeyword()), 'Enable deferred upload confirmation via HeadObject. When true, creates SECURITY DEFINER status transition functions (confirm_uploaded, mark_processed) and an AFTER INSERT trigger that enqueues a storage:confirm_upload job. The job verifies the file exists in S3 before transitioning status from requested to uploaded. Defaults to false.'),
+        addJSDoc(optionalProp('confirm_upload_delay', t.tsStringKeyword()), 'Delay before the first upload confirmation attempt (PostgreSQL interval string, e.g. "30 seconds"). Only used when has_confirm_upload is true. Defaults to "30 seconds".'),
         addJSDoc(optionalProp('provisions', t.tsTypeLiteral([
             optionalProp('files', t.tsTypeReference(t.identifier('BlueprintEntityTableProvision'))),
             optionalProp('buckets', t.tsTypeReference(t.identifier('BlueprintEntityTableProvision')))
@@ -581,7 +583,7 @@ function buildProgram(meta) {
     statements.push(sectionComment('Shared recursive types'));
     statements.push(buildTriggerConditionInterface());
     // -- Parameter interfaces grouped by category --
-    const categoryOrder = ['data', 'search', 'authz', 'relation', 'view'];
+    const categoryOrder = ['billing', 'check', 'data', 'limit', 'search', 'job', 'process', 'authz', 'relation', 'view'];
     for (const cat of categoryOrder) {
         const nts = categories.get(cat);
         if (!nts || nts.length === 0)

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

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

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

@@ -1,7 +1,7 @@
-export const DataAggregateLimitCounter = {
-    name: 'DataAggregateLimitCounter',
+export const LimitAggregate = {
+    name: 'LimitAggregate',
     slug: 'data_aggregate_limit_counter',
-    category: 'data',
+    category: 'limit',
     display_name: 'Aggregate Limit Counter',
     description: 'Declaratively attaches aggregate limit-tracking triggers to a table. On INSERT the named limit is incremented per entity; on DELETE it is decremented. Uses org_limit_aggregates_inc/dec for per-entity (org-level) aggregate limits rather than per-user limits. Requires a provisioned limits_module for the target database.',
     parameter_schema: {

package/esm/data/data-billing-meter.d.ts

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

package/esm/data/data-billing-meter.js

@@ -1,7 +1,7 @@
-export const DataBillingMeter = {
-    name: 'DataBillingMeter',
+export const BillingMeter = {
+    name: 'BillingMeter',
     slug: 'data_billing_meter',
-    category: 'data',
+    category: 'billing',
     display_name: 'Billing Meter',
     description: 'Declaratively attaches billing usage-recording triggers to a table. On INSERT the named meter is incremented via record_usage; on DELETE it is decremented (reversal). On UPDATE, if the entity_field changes, the old entity is decremented and the new entity is incremented. Requires a provisioned billing_module for the target database.',
     parameter_schema: {

package/esm/data/data-bulk.d.ts

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

package/esm/data/data-bulk.js

@@ -0,0 +1,37 @@
+export const DataBulk = {
+    name: 'DataBulk',
+    slug: 'data_bulk',
+    category: 'data',
+    display_name: 'Bulk Operations',
+    description: 'Enables bulk mutation smart tags on a table. When provisioned, adds @behavior tags for the selected bulk operations (insert, upsert, update, delete). Requires the graphile-bulk-mutations plugin.',
+    parameter_schema: {
+        type: 'object',
+        properties: {
+            insert: {
+                type: 'boolean',
+                description: 'Enable bulk insert (+bulkInsert)',
+                default: true
+            },
+            upsert: {
+                type: 'boolean',
+                description: 'Enable bulk upsert (+bulkUpsert)',
+                default: false
+            },
+            update: {
+                type: 'boolean',
+                description: 'Enable bulk update (+bulkUpdate)',
+                default: false
+            },
+            delete: {
+                type: 'boolean',
+                description: 'Enable bulk delete (+bulkDelete)',
+                default: false
+            }
+        }
+    },
+    tags: [
+        'bulk',
+        'mutations',
+        'graphile'
+    ]
+};

package/esm/data/data-chunks.d.ts

@@ -11,8 +11,8 @@ import type { NodeTypeDefinition } from '../types';
  * - RLS policies inherited from parent
  * - Optional job trigger for automatic chunking on INSERT/UPDATE
  *
- * This node is also composed internally by DataFileEmbedding (enabled by
+ * This node is also composed internally by ProcessFileEmbedding (enabled by
  * default in extract mode). Use it standalone when you want a chunks table
  * without the full file-embedding pipeline.
  */
-export declare const DataChunks: NodeTypeDefinition;
+export declare const ProcessChunks: NodeTypeDefinition;

package/esm/data/data-chunks.js

@@ -10,19 +10,19 @@
  * - RLS policies inherited from parent
  * - Optional job trigger for automatic chunking on INSERT/UPDATE
  *
- * This node is also composed internally by DataFileEmbedding (enabled by
+ * This node is also composed internally by ProcessFileEmbedding (enabled by
  * default in extract mode). Use it standalone when you want a chunks table
  * without the full file-embedding pipeline.
  */
-export const DataChunks = {
-    name: 'DataChunks',
+export const ProcessChunks = {
+    name: 'ProcessChunks',
     slug: 'data_chunks',
-    category: 'data',
+    category: 'process',
     display_name: 'Chunks',
     description: 'Creates a chunked-embedding child table for any parent table. ' +
         'Provisions the chunks table with content, chunk_index, embedding vector, ' +
         'metadata, HNSW index, inherited RLS, and optional job trigger for ' +
-        'automatic text splitting. Composed internally by DataFileEmbedding ' +
+        'automatic text splitting. Composed internally by ProcessFileEmbedding ' +
         '(enabled by default in extract mode) but can also be used standalone.',
     parameter_schema: {
         type: 'object',

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,25 +103,19 @@ 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.',
                 properties: {
@@ -163,19 +157,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-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/index.d.ts

@@ -2,24 +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 { DataChunks } from './data-chunks';
+export { LimitAggregate } from './data-aggregate-limit-counter';
+export { BillingMeter } from './data-billing-meter';
+export { DataBulk } from './data-bulk';
+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,24 +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 { DataChunks } from './data-chunks';
+export { LimitAggregate } from './data-aggregate-limit-counter';
+export { BillingMeter } from './data-billing-meter';
+export { DataBulk } from './data-bulk';
+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;