node-type-registry 0.33.1 → 0.35.0

package/esm/data/process-image-versions.js

@@ -0,0 +1,136 @@
+/**
+ * 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 const 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/esm/data/search-vector.js

@@ -3,7 +3,7 @@ export const 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: {
@@ -42,11 +42,6 @@ export const 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: {
@@ -65,16 +60,6 @@ export const 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.',

package/esm/module-presets/auth-hardened.js

@@ -46,7 +46,8 @@ export const PresetAuthHardened = {
         'identity_providers_module',
         'webauthn_credentials_module',
         'webauthn_auth_module',
-        'phone_numbers_module'
+        'phone_numbers_module',
+        'devices_module'
     ],
     includes_notes: {
         rate_limits_module: 'Throttling for sign-in, password reset, sign-up, and IP-based gates.',
@@ -55,7 +56,8 @@ export const PresetAuthHardened = {
         webauthn_credentials_module: 'Per-user passkey storage.',
         webauthn_auth_module: 'Passkey challenge + assertion runtime.',
         session_secrets_module: 'Nonces for magic links, email OTP, and WebAuthn challenges.',
-        phone_numbers_module: 'SMS sign-in / MFA support.'
+        phone_numbers_module: 'SMS sign-in / MFA support.',
+        devices_module: 'Device tracking and trusted-device MFA bypass.'
     },
     omits_notes: {
         'memberships_module:org': 'No orgs / teams — use `b2b` when you need multi-tenancy.',

package/esm/module-presets/b2b-storage.js

@@ -58,10 +58,12 @@ export const PresetB2bStorage = {
         'hierarchy_module:org',
         'invites_module:app',
         'invites_module:org',
-        'storage_module'
+        'storage_module',
+        'devices_module'
     ],
     includes_notes: {
-        storage_module: 'File upload infrastructure: app_buckets + app_files tables with RLS. Entity-type storage scopes layered on top via `has_storage=true`.'
+        storage_module: 'File upload infrastructure: app_buckets + app_files tables with RLS. Entity-type storage scopes layered on top via `has_storage=true`.',
+        devices_module: 'Device tracking and trusted-device MFA bypass.'
     },
     omits_notes: {
         crypto_addresses_module: 'Not a web3 preset.'

package/esm/module-presets/b2b.js

@@ -59,7 +59,8 @@ export const PresetB2b = {
         'profiles_module:org',
         'hierarchy_module:org',
         'invites_module:app',
-        'invites_module:org'
+        'invites_module:org',
+        'devices_module'
     ],
     includes_notes: {
         'memberships_module:org': 'Org-scoped membership rows — every user in an org gets one.',
@@ -73,7 +74,8 @@ export const PresetB2b = {
         'profiles_module:org': 'Org-scoped user profile (per org a user belongs to).',
         'hierarchy_module:org': 'Nested org structures (parent / child orgs).',
         'invites_module:app': 'App-level invites (rare — usually platform admin adds another admin).',
-        'invites_module:org': 'Org-level invites (the common case — invite a teammate into a workspace).'
+        'invites_module:org': 'Org-level invites (the common case — invite a teammate into a workspace).',
+        devices_module: 'Device tracking and trusted-device MFA bypass.'
     },
     omits_notes: {
         storage_module: 'Add separately if you need file uploads tied to orgs.',

package/module-presets/auth-hardened.js

@@ -49,7 +49,8 @@ exports.PresetAuthHardened = {
         'identity_providers_module',
         'webauthn_credentials_module',
         'webauthn_auth_module',
-        'phone_numbers_module'
+        'phone_numbers_module',
+        'devices_module'
     ],
     includes_notes: {
         rate_limits_module: 'Throttling for sign-in, password reset, sign-up, and IP-based gates.',
@@ -58,7 +59,8 @@ exports.PresetAuthHardened = {
         webauthn_credentials_module: 'Per-user passkey storage.',
         webauthn_auth_module: 'Passkey challenge + assertion runtime.',
         session_secrets_module: 'Nonces for magic links, email OTP, and WebAuthn challenges.',
-        phone_numbers_module: 'SMS sign-in / MFA support.'
+        phone_numbers_module: 'SMS sign-in / MFA support.',
+        devices_module: 'Device tracking and trusted-device MFA bypass.'
     },
     omits_notes: {
         'memberships_module:org': 'No orgs / teams — use `b2b` when you need multi-tenancy.',

package/module-presets/b2b-storage.js

@@ -61,10 +61,12 @@ exports.PresetB2bStorage = {
         'hierarchy_module:org',
         'invites_module:app',
         'invites_module:org',
-        'storage_module'
+        'storage_module',
+        'devices_module'
     ],
     includes_notes: {
-        storage_module: 'File upload infrastructure: app_buckets + app_files tables with RLS. Entity-type storage scopes layered on top via `has_storage=true`.'
+        storage_module: 'File upload infrastructure: app_buckets + app_files tables with RLS. Entity-type storage scopes layered on top via `has_storage=true`.',
+        devices_module: 'Device tracking and trusted-device MFA bypass.'
     },
     omits_notes: {
         crypto_addresses_module: 'Not a web3 preset.'

package/module-presets/b2b.js

@@ -62,7 +62,8 @@ exports.PresetB2b = {
         'profiles_module:org',
         'hierarchy_module:org',
         'invites_module:app',
-        'invites_module:org'
+        'invites_module:org',
+        'devices_module'
     ],
     includes_notes: {
         'memberships_module:org': 'Org-scoped membership rows — every user in an org gets one.',
@@ -76,7 +77,8 @@ exports.PresetB2b = {
         'profiles_module:org': 'Org-scoped user profile (per org a user belongs to).',
         'hierarchy_module:org': 'Nested org structures (parent / child orgs).',
         'invites_module:app': 'App-level invites (rare — usually platform admin adds another admin).',
-        'invites_module:org': 'Org-level invites (the common case — invite a teammate into a workspace).'
+        'invites_module:org': 'Org-level invites (the common case — invite a teammate into a workspace).',
+        devices_module: 'Device tracking and trusted-device MFA bypass.'
     },
     omits_notes: {
         storage_module: 'Add separately if you need file uploads tied to orgs.',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "node-type-registry",
-  "version": "0.33.1",
+  "version": "0.35.0",
   "description": "Node type definitions for the Constructive blueprint system. Single source of truth for all Authz*, Data*, Relation*, and View* node types.",
   "author": "Constructive <developers@constructive.io>",
   "main": "index.js",
@@ -47,5 +47,5 @@
     "registry",
     "graphile"
   ],
-  "gitHead": "d43f1d7e38cc39a71b4f8d2cafb39f46df12e31a"
+  "gitHead": "50dc1d69049c207b46c237eba1e1b1cb7a5f928f"
 }