node-type-registry 0.34.0 → 0.36.0

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'
+    ]
+};

package/data/search-unified.js

@@ -164,6 +164,18 @@ exports.SearchUnified = {
                     }
                 }
             },
+            embedding_text_field: {
+                type: 'string',
+                format: 'column-ref',
+                description: 'Name of the composite text field created for embedding input',
+                default: 'embedding_text'
+            },
+            composite_format: {
+                type: 'string',
+                enum: ['labeled', 'plain'],
+                description: 'Output format for the composite text field',
+                default: 'labeled'
+            },
             trgm_fields: {
                 type: 'array',
                 items: {

package/data/search-vector.js

@@ -6,7 +6,7 @@ exports.SearchVector = {
     slug: 'search_vector',
     category: 'search',
     display_name: 'Vector Search',
-    description: 'Adds a vector embedding column with HNSW or IVFFlat index for similarity search. Supports configurable dimensions, distance metrics (cosine, l2, ip), stale tracking strategies (column, null, hash), and automatic job enqueue triggers for embedding generation.',
+    description: 'Adds a vector embedding column with HNSW or IVFFlat index for similarity search. Supports configurable dimensions, distance metrics (cosine, l2, ip), per-field {field_name}_updated_at timestamp tracking (read-only in GraphQL), and automatic job enqueue triggers for embedding generation.',
     parameter_schema: {
         type: 'object',
         properties: {
@@ -45,11 +45,6 @@ exports.SearchVector = {
                 description: 'Index-specific options. HNSW: {m, ef_construction}. IVFFlat: {lists}.',
                 default: {}
             },
-            include_stale_field: {
-                type: 'boolean',
-                description: 'When stale_strategy is column, adds an embedding_stale boolean field',
-                default: true
-            },
             source_fields: {
                 type: 'array',
                 items: {
@@ -68,16 +63,6 @@ exports.SearchVector = {
                 description: 'Task identifier for the job queue',
                 default: 'generate_embedding'
             },
-            stale_strategy: {
-                type: 'string',
-                enum: [
-                    'column',
-                    'null',
-                    'hash'
-                ],
-                description: 'Strategy for tracking embedding staleness. column: embedding_stale boolean. null: set embedding to NULL. hash: md5 hash of source fields.',
-                default: 'column'
-            },
             chunks: {
                 type: 'object',
                 description: 'Chunking configuration for long-text embedding. Creates an embedding_chunks record that drives automatic text splitting and per-chunk embedding. Omit to skip chunking.',