@oronts/vendure-data-hub-plugin 0.1.2 → 0.1.4

package/CHANGELOG.md

@@ -2,6 +2,38 @@
 
 All notable changes to the Data Hub Plugin are documented here.
 
+## [0.1.4] - 2026-03-03
+
+### Added
+- **ROUTE step** with condition-based branching: per-branch condition editors using 19 comparison operators (eq, ne, gt, gte, lt, lte, in, notIn, contains, notContains, startsWith, endsWith, regex, exists, notExists, isNull, isEmpty, isNotEmpty, matches)
+- **dependencyOnly edge type** for graph execution: edges that enforce ordering without passing data
+- **Internal queue adapter** for testing sink/message pipelines without external infrastructure
+- **Stale run cleanup**: runs exceeding 1 hour automatically transition to TIMEOUT status
+- **Webhook HMAC-SHA256 signing** for sink webhook deliveries
+- **Export file registration** in REST API: exported files accessible via `/data-hub/files/:id`
+- **Per-branch condition editors** in dashboard route step configuration
+- **Resizable Configure Node panel** in workflow graph editor
+- **45 example pipelines** (previously 28) covering all step types, operators, and adapter combinations
+
+### Fixed
+- 9 critical runtime bugs: feed executor batch accumulation, gate timeout scheduling, slugify regex metacharacter injection, dot-notation field access in nested objects, trigger validation for FILE/MESSAGE types, event subscription field name mismatch, schedule activation field propagation, export format selection, and sink error serialization
+- Order import no longer produces NaN on completed orders with calculated totals
+- Trigger validation is now case-insensitive for trigger type matching
+- Webhook authentication errors now return 401 (was 500) for invalid credentials
+- Meilisearch sink correctly indexes both EN and DE translations
+
+## [0.1.3] - 2026-02-26
+
+### Added
+- **Option group auto-creation** in variant loader: new `optionGroupsField` config auto-creates option groups and options from key-value pairs (e.g. `{ size: 'S', color: 'Blue' }`), assigns them to the parent product, and links variants. Also supports `optionIdsField` (direct IDs) and `optionCodesField` (code lookup)
+- **Stack traces on error records**: failed records now capture JavaScript stack traces for debugging. Visible in dashboard error viewer and dead letter queue
+- **Load strategy support** for all entity loaders: configurable `strategy` field (`UPSERT`, `CREATE`, `UPDATE`) controls whether records are created, updated, or both
+- **Custom fields support** for product, variant, customer, collection, promotion, facet, and facet value loaders via `customFieldsField` config
+- **SSRF protection wiring**: global SSRF config from plugin options now passed to all loader handlers for URL validation
+
+### Fixed
+- SSRF protection config was not propagated from plugin-level `security.ssrf` settings to individual loader handlers
+
 ## [0.1.2] - 2026-02-24
 
 ### Fixed
@@ -155,7 +187,7 @@ Initial production release of the Data Hub Plugin for Vendure.
 - **Typesense** - Open-source search engine
 - **Queue Producer** - RabbitMQ/Redis Streams/SQS message publishing
 - **Webhook** - HTTP POST to external services
-- **PDF Generator** - Generate PDF documents from templates
+- **OpenSearch** - Open-source search and analytics engine
 
 ### Advanced Features
 

package/README.md

@@ -1,6 +1,6 @@
 <p align="center">
   <a href="https://oronts.com">
-    <img src="https://oronts.com/_next/image?url=%2Fimages%2Flogo%2FLogo-white.png&w=256&q=75" alt="Oronts" width="80" height="80">
+    <img src="https://oronts.com/_next/image?url=%2Fimages%2Flogo%2FLogo-white.png&w=256&q=75" alt="Oronts">
   </a>
 </p>
 
@@ -37,18 +37,19 @@ A full-featured ETL (Extract, Transform, Load) plugin for [Vendure](https://www.
 - **Visual Pipeline Builder** - Drag-and-drop workflow editor with live validation
 - **Code-First DSL** - TypeScript API for defining pipelines programmatically
 - **9 Data Extractors** - HTTP/REST API, GraphQL, Vendure Query, File (CSV/JSON/XML/XLSX/NDJSON/TSV), Database (SQL), S3, FTP/SFTP, Webhook, CDC (Change Data Capture)
-- **22 Entity Loaders (16 entity types with multiple operations)** - Products, Variants, Customers, Customer Groups, Collections, Facets, Facet Values, Promotions, Orders (notes, transitions, coupons), Shipping Methods, Stock Locations, Stock/Inventory, Assets, Tax Rates, Payment Methods, Channels, REST POST, GraphQL Mutation
+- **24 Entity Loaders (16 entity types, 4 order operations, 1 deletion, 2 external API, 1 inventory)** - Products, Variants, Customers, Customer Groups, Collections, Facets, Facet Values, Promotions, Orders (upsert, notes, transitions, coupons), Shipping Methods, Stock Locations, Stock/Inventory, Assets, Tax Rates, Payment Methods, Channels, Entity Deletion, REST POST, GraphQL Mutation
 - **61 Transform Operators** - String (12), Date (5), Numeric (9), Logic (4), JSON (4), Data (8), Enrichment (5), Aggregation (8), Validation (2), Script (1), File (3) - **includes HTTP Lookup with caching, circuit breaker, and rate limiting**
 - **4 Feed Generators** - Google Merchant Center, Meta/Facebook Catalog, Amazon Seller Central, Custom Feed (CSV/JSON/XML/TSV)
-- **7 Search & Integration Sinks** - Elasticsearch, OpenSearch, MeiliSearch, Algolia, Typesense, Queue Producer (RabbitMQ/SQS/Redis), Webhook
+- **7 Search & Integration Sinks** - Elasticsearch, OpenSearch, MeiliSearch, Algolia, Typesense, Queue Producer (RabbitMQ/SQS/Redis), Webhook (with HMAC signing)
 - **24 Hook Stages** (18 for step types and 6 global) - Interceptors and scripts to modify data at any pipeline stage
 - **7 Connection Types** - HTTP/REST, S3, FTP, SFTP, Database (PostgreSQL/MySQL/SQLite/MSSQL/Oracle), Message Queue (RabbitMQ/SQS/Redis), Custom
 - **6 Trigger Types** - Manual, Scheduled (cron), Webhook, Vendure Events, File Watch, **Message Queue Consumer**
-- **Bi-directional Queue Support** - Consume from and produce to RabbitMQ (AMQP), Amazon SQS, Redis Streams
+- **Bi-directional Queue Support** - Consume from and produce to RabbitMQ (AMQP), Amazon SQS, Redis Streams, and internal queue adapter
 - **Horizontal Scaling** - Distributed locks via Redis or PostgreSQL for multi-instance deployments
 - **Checkpoint Recovery** - Resume failed pipelines from last successful record
 - **File Upload** - Drag-and-drop CSV/JSON file upload with automatic processing
 - **Real-time Monitoring** - Logs, analytics, error tracking, and dead letter queue
+- **Nested Entity Modes** - Configurable behavior for all nested entities (addresses, facet values, order lines, assets, etc.) to prevent duplicates and provide full control over data management
 
 ## Screenshots
 
@@ -339,7 +340,7 @@ Math operations: `add`, `subtract`, `multiply`, `divide`, `modulo`, `power`, `ro
 | `ifThenElse` | Conditional value | `{ op: 'ifThenElse', args: { condition: { field: 'type', cmp: 'eq', value: 'digital' }, thenValue: true, elseValue: false, target: 'isDigital' } }` |
 | `switch` | Multi-case mapping | `{ op: 'switch', args: { source: 'code', cases: [{ value: 'A', result: 'Active' }], default: 'Unknown', target: 'status' } }` |
 
-Comparison operators: `eq`, `ne`, `gt`, `gte`, `lt`, `lte`, `in`, `notIn`, `contains`, `notContains`, `startsWith`, `endsWith`, `regex`, `exists`, `isNull`
+Comparison operators (19): `eq`, `ne`, `gt`, `gte`, `lt`, `lte`, `in`, `notIn`, `contains`, `notContains`, `startsWith`, `endsWith`, `regex`, `exists`, `notExists`, `isNull`, `isEmpty`, `isNotEmpty`, `matches` (glob)
 
 ### Validation Operators
 
@@ -432,11 +433,12 @@ Execute custom JavaScript for complex transformations:
 | Loader | Adapter Code | Description |
 |--------|--------------|-------------|
 | Product Loader | `productUpsert` | Create/update products with variants, prices, tax, and stock |
-| Variant Loader | `variantUpsert` | Update product variants by SKU with multi-currency prices |
+| Variant Loader | `variantUpsert` | Update product variants by SKU with multi-currency prices and auto-create option groups |
 | Customer Loader | `customerUpsert` | Create/update customers with addresses and group memberships |
 | Customer Group Loader | `customerGroupUpsert` | Create/update customer groups by name; assign customers by email |
 | Collection Loader | `collectionUpsert` | Create/update collections with parent relationships |
 | Promotion Loader | `promotionUpsert` | Create/update promotions with conditions and actions |
+| Order Upsert Loader | `orderUpsert` | Order create/update for migrations with state transitions and line management |
 | Order Note Loader | `orderNote` | Attach notes to orders by code or id |
 | Order Transition Loader | `orderTransition` | Transition orders to new states |
 | Stock Adjust Loader | `stockAdjust` | Adjust inventory levels by SKU and stock location map |
@@ -450,6 +452,7 @@ Execute custom JavaScript for complex transformations:
 | Stock Location Loader | `stockLocationUpsert` | Create/update stock locations and warehouses |
 | Facet Loader | `facetUpsert` | Create/update facets with translations |
 | Facet Value Loader | `facetValueUpsert` | Create/update facet values with translations |
+| Entity Deletion Loader | `entityDeletion` | Soft-delete any of 13 entity types (Products, Variants, Collections, Facets, FacetValues, Customers, CustomerGroups, Promotions, ShippingMethods, PaymentMethods, TaxRates, Assets, StockLocations) by slug, SKU, ID, code, email, or name |
 | GraphQL Mutation Loader | `graphqlMutation` | Execute arbitrary GraphQL mutations against Vendure |
 | Asset Import Loader | `assetImport` | Import assets from URLs or file paths |
 | REST POST Loader | `restPost` | POST/PUT records to external REST endpoints |
@@ -506,25 +509,41 @@ Execute custom JavaScript for complex transformations:
 })
 ```
 
+### Condition-Based Routing (ROUTE Step)
+
+Route records to different branches based on field conditions using 19 comparison operators. Supports AND logic (multiple conditions per branch), automatic `default` branch for unmatched records, and `dependencyOnly` edges for execution ordering without data flow.
+
+```typescript
+.route('split-by-type', {
+    branches: [
+        { name: 'physical', when: [{ field: 'type', cmp: 'eq', value: 'physical' }] },
+        { name: 'digital', when: [{ field: 'type', cmp: 'eq', value: 'digital' }] },
+    ],
+})
+```
+
 ---
 
 ## Hooks
 
-Hooks let you run code at 18 different pipeline stages. Two types:
+Hooks let you run code at 24 different pipeline stages (18 step-level + 6 global). Two types:
 - **Interceptors**: Modify the record array (return modified records)
 - **Observation hooks**: Side effects only (webhooks, events, logging)
 
 ### Hook Stages
 
-**Data Processing:**
+**Data Processing (18 step-level):**
 - `BEFORE_EXTRACT`, `AFTER_EXTRACT`
 - `BEFORE_TRANSFORM`, `AFTER_TRANSFORM`
 - `BEFORE_VALIDATE`, `AFTER_VALIDATE`
 - `BEFORE_ENRICH`, `AFTER_ENRICH`
 - `BEFORE_ROUTE`, `AFTER_ROUTE`
 - `BEFORE_LOAD`, `AFTER_LOAD`
+- `BEFORE_EXPORT`, `AFTER_EXPORT`
+- `BEFORE_FEED`, `AFTER_FEED`
+- `BEFORE_SINK`, `AFTER_SINK`
 
-**Pipeline Lifecycle:**
+**Pipeline Lifecycle (6 global):**
 - `PIPELINE_STARTED`, `PIPELINE_COMPLETED`, `PIPELINE_FAILED`
 - `ON_ERROR`, `ON_RETRY`, `ON_DEAD_LETTER`
 
@@ -850,6 +869,8 @@ The plugin includes a full-featured admin dashboard:
 - **Visual Mode**: Drag-and-drop workflow builder with node palette
 - Live validation with error highlighting
 - Step tester for testing individual steps
+- `dependencyOnly` edges for execution ordering without data flow in graph mode
+- Stale run cleanup with automatic TIMEOUT status for stuck pipeline runs
 
 ### Dry Run
 - Execute pipeline without persisting changes
@@ -862,6 +883,7 @@ The plugin includes a full-featured admin dashboard:
 - Analytics dashboard with metrics
 - Per-pipeline health stats
 - Error rate tracking
+- `completedAt` and `errorMessage` fields on pipeline runs for precise tracking
 
 ### Queue Management
 - View pending, running, and failed jobs
@@ -890,7 +912,7 @@ DataHubPlugin.init({
 
 ### Code-First Connections
 
-Supported connection types: `http`, `postgres`, `mysql`, `s3`, `ftp`, `sftp`
+Supported connection types: `http`, `postgres`, `mysql`, `s3`, `ftp`, `sftp`, `rabbitmq`, `custom`
 
 ```typescript
 DataHubPlugin.init({
@@ -1134,6 +1156,10 @@ const pipeline = createPipeline()
 })
 ```
 
+### Stack Traces
+
+Failed records automatically capture JavaScript stack traces when errors originate from exceptions. Stack traces are stored on the error record and visible in the dashboard error viewer and dead letter queue, aiding production debugging.
+
 ---
 
 ## Requirements

package/dashboard/components/pipelines/PipelineEditor.tsx

@@ -8,6 +8,7 @@ import {
     AlertTriangle,
     Zap,
     Bell,
+    Webhook,
 } from 'lucide-react';
 import { TriggersPanel } from '../shared/triggers-panel';
 import { StepConfigPanel } from '../shared/step-config';
@@ -19,9 +20,10 @@ import {
     PIPELINE_EDITOR_PANEL,
     DEFAULT_STEP_CONFIGS,
 } from '../../constants';
-import { useStepConfigs, useTriggerTypes } from '../../hooks';
+import { useStepConfigs, useTriggerTypes, useHookStages, useHookStageCategories } from '../../hooks';
 import type { MoveDirection, PipelineEditorPanel } from '../../constants';
 import { useAdapterCatalog } from '../../hooks';
+import { FALLBACK_STAGE_CATEGORIES } from '../../constants';
 import type {
     StepType,
     PipelineStepDefinition,
@@ -29,7 +31,7 @@ import type {
     PipelineEditorProps,
     JsonObject,
 } from '../../types';
-import { getCombinedTriggers, updateDefinitionWithTriggers } from '../../utils';
+import { getCombinedTriggers, updateDefinitionWithTriggers, resolveIconName } from '../../utils';
 
 const ADDABLE_STEP_TYPES = Object.keys(DEFAULT_STEP_CONFIGS).filter(
     t => t !== STEP_TYPE.ROUTE && t !== STEP_TYPE.GATE
@@ -157,10 +159,21 @@ export function PipelineEditor({ definition, onChange, issues = [] }: PipelineEd
     // Get combined triggers from both steps and triggers array
     const combinedTriggers = useMemo(() => getCombinedTriggers(definition), [definition]);
 
+    // Hook stage metadata
+    const { hookStages: backendStages } = useHookStages();
+    const { categories: backendCategories } = useHookStageCategories();
+    const stageCategories = useMemo(
+        () => backendCategories.length > 0 ? backendCategories : FALLBACK_STAGE_CATEGORIES,
+        [backendCategories],
+    );
+    const hooks = definition.hooks ?? {};
+    const hookCount = useMemo(() => Object.values(hooks).reduce((sum, arr) => sum + (Array.isArray(arr) ? arr.length : 0), 0), [hooks]);
+
     // Panel switch handlers
     const handleSwitchToSteps = useCallback(() => setActivePanel(PIPELINE_EDITOR_PANEL.STEPS), []);
     const handleSwitchToTriggers = useCallback(() => setActivePanel(PIPELINE_EDITOR_PANEL.TRIGGERS), []);
     const handleSwitchToSettings = useCallback(() => setActivePanel(PIPELINE_EDITOR_PANEL.SETTINGS), []);
+    const handleSwitchToHooks = useCallback(() => setActivePanel(PIPELINE_EDITOR_PANEL.HOOKS), []);
 
     // Settings change handler
     const handleContextChange = useCallback((context: JsonObject) => {
@@ -192,7 +205,8 @@ export function PipelineEditor({ definition, onChange, issues = [] }: PipelineEd
             ...selectedStep,
             key: updated.key,
             type: updated.type as StepType,
-            config: { ...updated.config, adapterCode: updated.adapterCode },
+            adapterCode: updated.adapterCode || selectedStep.adapterCode,
+            config: updated.config,
         });
     }, [selectedStepIndex, selectedStep, updateStep]);
 
@@ -249,6 +263,25 @@ export function PipelineEditor({ definition, onChange, issues = [] }: PipelineEd
                             <Settings className="h-3 w-3 inline mr-1" />
                             Settings
                         </button>
+                        <button
+                            type="button"
+                            role="tab"
+                            aria-selected={activePanel === PIPELINE_EDITOR_PANEL.HOOKS}
+                            aria-controls="panel-hooks"
+                            className={`flex-1 px-3 py-2 text-xs font-medium transition-colors ${
+                                activePanel === PIPELINE_EDITOR_PANEL.HOOKS
+                                    ? 'bg-primary/10 text-primary border-b-2 border-primary'
+                                    : 'text-muted-foreground hover:bg-muted'
+                            }`}
+                            onClick={handleSwitchToHooks}
+                            data-testid="datahub-editor-tab-hooks"
+                        >
+                            <Webhook className="h-3 w-3 inline mr-1" />
+                            Hooks
+                            {hookCount > 0 && (
+                                <span className="ml-1 px-1 py-0.5 text-[10px] rounded-full bg-primary/20 text-primary">{hookCount}</span>
+                            )}
+                        </button>
                     </div>
                 </div>
 
@@ -309,6 +342,58 @@ export function PipelineEditor({ definition, onChange, issues = [] }: PipelineEd
                         onChange={handleContextChange}
                     />
                 )}
+
+                {activePanel === PIPELINE_EDITOR_PANEL.HOOKS && (
+                    <div className="flex-1 overflow-auto">
+                        <div className="p-3 border-b bg-muted/50">
+                            <h3 className="font-semibold text-sm">Pipeline Hooks</h3>
+                            <p className="text-xs text-muted-foreground">
+                                {hookCount > 0 ? `${hookCount} hook${hookCount === 1 ? '' : 's'} configured (read-only)` : 'No hooks configured'}
+                            </p>
+                        </div>
+                        <div className="p-2 space-y-3">
+                            {stageCategories.map(cat => {
+                                const catStages = backendStages.filter(s => s.category === cat.key);
+                                const configuredStages = catStages.filter(s => {
+                                    const stageHooks = (hooks as Record<string, unknown[]>)[s.key];
+                                    return Array.isArray(stageHooks) && stageHooks.length > 0;
+                                });
+                                if (configuredStages.length === 0) return null;
+                                return (
+                                    <div key={cat.key}>
+                                        <div className="flex items-center gap-1.5 mb-1.5 px-1">
+                                            <span className={`text-[10px] px-1.5 py-0.5 rounded-full font-medium ${cat.color}`}>
+                                                {cat.label}
+                                            </span>
+                                        </div>
+                                        <div className="space-y-1">
+                                            {configuredStages.map(stage => {
+                                                const stageHooks = (hooks as Record<string, unknown[]>)[stage.key] ?? [];
+                                                const StageIcon = resolveIconName(stage.icon) ?? Zap;
+                                                return (
+                                                    <div key={stage.key} className="px-2 py-1.5 rounded bg-muted/50 border text-xs">
+                                                        <div className="flex items-center gap-1.5 font-medium">
+                                                            <StageIcon className="h-3 w-3 text-muted-foreground" />
+                                                            {stage.label}
+                                                            <span className="text-muted-foreground">({stageHooks.length})</span>
+                                                        </div>
+                                                    </div>
+                                                );
+                                            })}
+                                        </div>
+                                    </div>
+                                );
+                            })}
+                            {hookCount === 0 && (
+                                <div className="p-4 text-center text-muted-foreground text-xs">
+                                    <Webhook className="h-6 w-6 mx-auto mb-2 opacity-30" />
+                                    <p>No hooks configured.</p>
+                                    <p className="mt-1">Hooks are defined in code via the pipeline builder DSL.</p>
+                                </div>
+                            )}
+                        </div>
+                    </div>
+                )}
             </div>
 
             <div className="flex-1 overflow-auto">
@@ -319,7 +404,7 @@ export function PipelineEditor({ definition, onChange, issues = [] }: PipelineEd
                                 key: selectedStep.key,
                                 type: selectedStep.type,
                                 config: selectedStep.config ?? {},
-                                adapterCode: selectedStep.config?.adapterCode as string | undefined,
+                                adapterCode: selectedStep.adapterCode ?? selectedStep.config?.adapterCode as string | undefined,
                             }}
                             onChange={handleSelectedStepChange}
                             catalog={adapters}
@@ -369,7 +454,7 @@ export function PipelineEditor({ definition, onChange, issues = [] }: PipelineEd
                             )}
                         </div>
                     </div>
-                ) : (
+                ) : activePanel === PIPELINE_EDITOR_PANEL.SETTINGS ? (
                     <div className="p-6">
                         <h3 className="font-semibold mb-4">Pipeline Settings</h3>
                         <p className="text-sm text-muted-foreground">
@@ -406,6 +491,75 @@ export function PipelineEditor({ definition, onChange, issues = [] }: PipelineEd
                             </div>
                         </div>
                     </div>
+                ) : (
+                    <div className="p-6">
+                        <div className="flex items-center gap-2 mb-4">
+                            <Webhook className="h-5 w-5 text-primary" />
+                            <h3 className="font-semibold">Pipeline Hooks</h3>
+                            <span className="text-xs text-muted-foreground">(read-only)</span>
+                        </div>
+                        <p className="text-sm text-muted-foreground mb-4">
+                            Hooks run custom code at specific points during pipeline execution.
+                            They are defined in code via the pipeline builder DSL.
+                        </p>
+                        {hookCount > 0 ? (
+                            <div className="space-y-4">
+                                {stageCategories.map(cat => {
+                                    const catStages = backendStages.filter(s => s.category === cat.key);
+                                    const configuredStages = catStages.filter(s => {
+                                        const stageHooks = (hooks as Record<string, unknown[]>)[s.key];
+                                        return Array.isArray(stageHooks) && stageHooks.length > 0;
+                                    });
+                                    if (configuredStages.length === 0) return null;
+                                    return (
+                                        <div key={cat.key}>
+                                            <div className="flex items-center gap-2 mb-2">
+                                                <span className={`text-xs px-2 py-0.5 rounded-full font-medium ${cat.color}`}>
+                                                    {cat.label}
+                                                </span>
+                                                <span className="text-xs text-muted-foreground">{cat.description}</span>
+                                            </div>
+                                            <div className="space-y-2">
+                                                {configuredStages.map(stage => {
+                                                    const stageHooks = (hooks as Record<string, Array<Record<string, unknown>>>)[stage.key] ?? [];
+                                                    const StageIcon = resolveIconName(stage.icon) ?? Zap;
+                                                    return (
+                                                        <div key={stage.key} className="p-3 rounded-lg border bg-muted/30">
+                                                            <div className="flex items-center gap-2 mb-2">
+                                                                <StageIcon className="h-4 w-4 text-primary" />
+                                                                <span className="text-sm font-medium">{stage.label}</span>
+                                                            </div>
+                                                            <p className="text-xs text-muted-foreground mb-2">{stage.description}</p>
+                                                            <div className="space-y-1">
+                                                                {stageHooks.map((hook, i) => (
+                                                                    <div key={i} className="flex items-center gap-2 text-xs px-2 py-1 rounded bg-background border">
+                                                                        <span className="px-1.5 py-0.5 rounded bg-primary/10 text-primary font-mono">
+                                                                            {String(hook.type || 'UNKNOWN')}
+                                                                        </span>
+                                                                        <span className="text-muted-foreground truncate">
+                                                                            {String(hook.name || hook.scriptName || hook.event || hook.message || '')}
+                                                                        </span>
+                                                                    </div>
+                                                                ))}
+                                                            </div>
+                                                        </div>
+                                                    );
+                                                })}
+                                            </div>
+                                        </div>
+                                    );
+                                })}
+                            </div>
+                        ) : (
+                            <div className="flex flex-col items-center justify-center py-12 text-muted-foreground">
+                                <Webhook className="h-12 w-12 mb-4 opacity-20" />
+                                <p className="text-sm font-medium">No hooks configured</p>
+                                <p className="text-xs mt-1 text-center max-w-xs">
+                                    Add hooks via the pipeline builder DSL using <code className="px-1 py-0.5 bg-muted rounded text-xs">.hooks()</code>
+                                </p>
+                            </div>
+                        )}
+                    </div>
                 )}
             </div>
         </div>

package/dashboard/components/pipelines/ReactFlowPipelineEditor.tsx

@@ -156,7 +156,7 @@ export function ReactFlowPipelineEditor({
                 label,
                 type: category,
                 adapterCode: nodeType,
-                config: { adapterCode: nodeType },
+                config: {},
             },
         };
 
@@ -194,7 +194,7 @@ export function ReactFlowPipelineEditor({
                     label,
                     type: category,
                     adapterCode: nodeType,
-                    config: { adapterCode: nodeType },
+                    config: {},
                 },
             };
 
@@ -487,7 +487,7 @@ function NodePaletteDynamic({ adapters, onDragStart, onAddNode }: { adapters: Ad
                 const items = adapters.filter(a => a.type === adapterType);
                 return {
                     key: category,
-                    label: config.label === 'Source' ? 'Data Sources' : `${config.label}s`,
+                    label: config.label === 'Source' ? 'Data Sources' : config.label === 'Enrich' ? 'Enrichment' : `${config.label}s`,
                     items,
                     category,
                     icon: config.icon,

package/dashboard/components/pipelines/shared/NodePropertiesPanel.tsx

@@ -16,6 +16,9 @@ import { useAdapterCatalog, AdapterMetadata } from '../../../hooks';
 import { StepConfigPanel, StepConfigData, OperatorCheatSheetButton } from '../../shared/step-config';
 import { PANEL_WIDTHS, SCROLL_HEIGHTS } from '../../../constants';
 
+/** Minimum panel width (pixels) when resizing */
+const MIN_PANEL_WIDTH = parseInt(PANEL_WIDTHS.PROPERTIES_MIN, 10) || 380;
+
 export interface NodePropertiesPanelProps {
     node: Node<PipelineNodeData> | null;
     onUpdate: (node: Node<PipelineNodeData>) => void;
@@ -48,6 +51,31 @@ function NodePropertiesPanelComponent({
     const connectionCodes = externalConnectionCodes ?? hookResult.connectionCodes;
     const secretOptions = externalSecretOptions ?? hookResult.secretOptions;
 
+    // Resizable panel width
+    const defaultWidth = parseInt(panelWidth, 10) || 520;
+    const [width, setWidth] = React.useState(defaultWidth);
+    const dragging = React.useRef(false);
+
+    const onResizeStart = useCallback((e: React.MouseEvent) => {
+        e.preventDefault();
+        dragging.current = true;
+        const startX = e.clientX;
+        const startW = width;
+        const onMove = (ev: MouseEvent) => {
+            if (!dragging.current) return;
+            // Panel opens from right — dragging left increases width
+            const delta = startX - ev.clientX;
+            setWidth(Math.max(MIN_PANEL_WIDTH, Math.min(window.innerWidth * 0.9, startW + delta)));
+        };
+        const onUp = () => {
+            dragging.current = false;
+            document.removeEventListener('mousemove', onMove);
+            document.removeEventListener('mouseup', onUp);
+        };
+        document.addEventListener('mousemove', onMove);
+        document.addEventListener('mouseup', onUp);
+    }, [width]);
+
     const data = node?.data;
 
     const selectedAdapter = useMemo(
@@ -73,8 +101,8 @@ function NodePropertiesPanelComponent({
                 ...data,
                 label: updated.key,
                 type: updated.type,
-                config: { ...updated.config, adapterCode: updated.adapterCode },
-                adapterCode: updated.adapterCode,
+                config: updated.config,
+                adapterCode: updated.adapterCode || data.adapterCode,
             },
         });
     }, [node, data, onUpdate]);
@@ -85,9 +113,19 @@ function NodePropertiesPanelComponent({
     return (
         <Sheet open={!!node} onOpenChange={() => onClose()}>
             <SheetContent
-                className="overflow-y-auto p-0"
-                style={{ width: panelWidth, maxWidth: PANEL_WIDTHS.MAX_VW }}
+                side="right"
+                className="overflow-y-auto p-0 !max-w-none"
+                style={{ width: `${width}px`, maxWidth: PANEL_WIDTHS.MAX_VW }}
             >
+                {/* Resize drag handle (left edge) */}
+                <div
+                    className="absolute left-0 top-0 bottom-0 w-1.5 cursor-col-resize z-50
+                               hover:bg-primary/20 active:bg-primary/30 transition-colors"
+                    onMouseDown={onResizeStart}
+                    role="separator"
+                    aria-orientation="vertical"
+                    aria-label="Resize panel"
+                />
                 <SheetHeader className="px-4 py-3 border-b bg-muted/30">
                     <SheetTitle className="flex items-center justify-between">
                         <div className="flex items-center gap-2">

package/dashboard/components/pipelines/shared/StepListItem.tsx

@@ -96,9 +96,9 @@ function StepListItemComponent({
                         {config?.label ?? step.type}
                     </Badge>
                 </div>
-                {step.config?.adapterCode && (
+                {(step.adapterCode || step.config?.adapterCode) && (
                     <p className="text-xs text-muted-foreground truncate">
-                        {String(step.config.adapterCode)}
+                        {String(step.adapterCode || step.config?.adapterCode)}
                     </p>
                 )}
             </div>